AI Feed for invoices

Polski Pro 1.10.0 ergänzt einen REST-Endpoint, der eine einzelne Rechnung als Markdown zurückgibt. KI-Agenten (Buchhaltungs-Bots, Kundenservice, Käufer-Assistenten) erhalten strukturierte Rechnungsdaten, ohne das PDF parsen zu müssen.

Endpoint

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

Antwort:

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

Der Body ist Markdown mit YAML-Front-Matter, einem Parteien-Block (NIP), einer Markdown-Positionstabelle und den Summen.

Authentifizierung

Rolle	Zugriff
Administrator / manage_woocommerce	jede Rechnung
Authentifizierter Bestellinhaber	nur eigene Rechnungen
Anonym / andere Benutzer	401 / 403

Rechnungen enthalten personenbezogene und steuerliche Daten, daher ist der Endpoint für anonyme Aufrufer bewusst gesperrt. Authentifizieren Sie sich mit einem WordPress-Session-Cookie oder einem Anwendungspasswort (REST application password).

Was die Antwort enthält

YAML-Front-Matter

---
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"
---

Parteien-Block

• Seller NIP / Buyer NIP

Positionstabelle (Markdown)

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

Summen

• Net total / VAT total / Gross total mit Währung

Zusätzliche Angaben (falls vorhanden)

• KSeF reference / status
• Korrekturgrund (für Korrekturrechnungen)

Entwickler-Filter

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);

Beispiel mit curl (authentifizierter Admin)

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

Verwandt

• AI Feed (FREE) - Modul, das Beiträge, Seiten und WooCommerce-Produkte als Markdown ausliefert
• PDF-Rechnungen - Rechnungen als PDF erzeugen und versenden
• KSeF - Integration mit dem polnischen nationalen E-Rechnungssystem

FAQ

Funktioniert der Endpoint ohne Authentifizierung?

Nein. Rechnungen enthalten personenbezogene Daten und Steuernummern. Anonyme Clients erhalten 401.

Kann ich ein REST application password verwenden?

Ja. WordPress 5.6+ unterstützt Anwendungspasswörter. Erzeugen Sie eines unter Benutzer > Bearbeiten > Anwendungspasswörter und übergeben Sie es per Authorization: Basic.

Kann ich das Markdown einer Rechnung aus wp-admin herunterladen?

Es gibt keine separate Schaltfläche. Die URL ist stabil - /wp-json/polski-pro/v1/invoices/<id>/markdown - Sie können sie also als Lesezeichen speichern oder in Buchhaltungswerkzeuge einbetten.

Was ist mit Korrekturrechnungen?

Korrekturrechnungen werden ebenfalls unterstützt. Das Front-Matter enthält original_invoice_id, und der Block “Zusätzliche Angaben” enthält correction_reason.