Prüfen und Auslesen

Vor dem Ausstellen prüfen

POST /invoices/validate nimmt denselben Inhalt wie das Ausstellen und liefert die berechneten Summen und alle Befunde, ohne etwas zu speichern. Nutzen Sie es für die Vorschau in Ihrer Software. Es zählt als Prüfung in Ihrem Verbrauch (nicht in der Sandbox).

Empfangene E-Rechnungen prüfen

POST /inbound/parse liest eine empfangene E-Rechnung: XRechnung (UBL- oder CII-XML) oder ZUGFeRD/Factur-X (PDF). Senden Sie die Datei als Anfrageinhalt mit Content-Type application/xml, text/xml, application/pdf oder application/octet-stream.

curl -s -X POST $BASE/inbound/parse -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/pdf' --data-binary @rechnung.pdf

Die Antwort enthält das erkannte Format, eine Zusammenfassung in Klartext, die Rechnungsdaten (Nummern, Parteien, Summen, Positionen), alle Befunde mit Regelcodes und eine lesbare HTML-Ansicht. Accept-Language: en liefert Englisch, alles andere Deutsch. Nichts wird gespeichert.

POST /inbound/render macht aus derselben Datei ein lesbares PDF für Ihre Buchhaltung.

Grenzen

Dateien bis 20 MB (2 MB auf der aktuellen Instanzgröße), sonst 413 document.too-large; andere Inhaltstypen 415. XML wird ohne externe Entitäten gelesen. Bei Auslastung: 503 inbound.busy mit Retry-After.