AI Feed for invoices

Polski Pro 1.10.0 añade un endpoint REST que devuelve una factura individual como Markdown. Los agentes de IA (bots de contabilidad, atención al cliente, asistentes de compra) reciben datos estructurados de la factura sin necesidad de analizar el PDF.

Endpoint

GET /wp-json/polski-pro/v1/invoices/{id}/markdown
Accept: text/markdown

Respuesta:

Content-Type: text/markdown; charset=UTF-8
Cache-Control: private, no-store

El cuerpo es Markdown con front matter YAML, un bloque de partes (NIP), una tabla de líneas en Markdown y los totales.

Autenticación

Rol	Acceso
Administrador / manage_woocommerce	cualquier factura
Propietario del pedido autenticado	solo sus propias facturas
Anónimo / otros usuarios	401 / 403

Las facturas contienen datos personales y fiscales, por lo que el endpoint está cerrado de forma intencionada a las llamadas anónimas. Autentíquese con una cookie de sesión de WordPress o una contraseña de aplicación (REST application password).

Qué contiene la respuesta

Front matter YAML

---
number: "FV/2026/05/001"
type: "faktura_vat"
status: "issued"
order_id: "555"
currency: "PLN"
net_total: "200.00"
vat_total: "46.00"
gross_total: "246.00"
issued_at: "2026-05-01T10:00:00+00:00"
nip_seller: "5260250274"
nip_buyer: "7010019999"
ksef_reference: "KSEF-123"
ksef_status: "sent"
---

Bloque de partes

• Seller NIP / Buyer NIP

Tabla de líneas (Markdown)

| # | Description | Qty | Unit | Net price | VAT % | VAT amount | Gross price |

Totales

• Net total / VAT total / Gross total con moneda

Datos adicionales (cuando estén presentes)

• KSeF reference / status
• Motivo de la corrección (para facturas rectificativas)

Filtro para desarrolladores

add_filter('polski-pro/ai_feed/invoice_markdown', static function (string $document, \Polski\Pro\Invoice\Model\Invoice $invoice): string {
    if ($invoice->type === \Polski\Pro\Invoice\Model\InvoiceType::FakturaVAT) {
        $document .= "\n\n## Internal note\n\n- Auto-issued on order payment.\n";
    }
    return $document;
}, 10, 2);

Ejemplo con curl (administrador autenticado)

curl -u admin:apppassword \
  -H "Accept: text/markdown" \
  https://shop.test/wp-json/polski-pro/v1/invoices/42/markdown

Relacionado

• AI Feed (FREE) - módulo que sirve entradas, páginas y productos de WooCommerce como Markdown
• Facturas en PDF - generación y envío de facturas en PDF
• KSeF - integración con el sistema nacional polaco de facturación electrónica

Preguntas frecuentes

¿Funciona el endpoint sin autenticación?

No. Las facturas contienen datos personales y números de identificación fiscal. Los clientes anónimos reciben 401.

¿Puedo usar una REST application password?

Sí. WordPress 5.6+ admite contraseñas de aplicación. Genere una en Usuarios > Editar > Contraseñas de aplicación y pásela mediante Authorization: Basic.

¿Puedo descargar el Markdown de una factura desde wp-admin?

No hay un botón independiente. La URL es estable - /wp-json/polski-pro/v1/invoices/<id>/markdown - así que puede guardarla en marcadores o incrustarla en herramientas de contabilidad.

¿Qué ocurre con las facturas rectificativas?

Las facturas rectificativas también son compatibles. El front matter incluye original_invoice_id, y el bloque “Datos adicionales” contiene correction_reason.