Unterstützte Formate

xingen akzeptiert Rechnungsdaten über mehrere Eingabekanäle und exportiert eine validierte Rechnung in zwei festen Ausgabeformaten. XML/PDF-Uploads werden automatisch erkannt — Sie müssen das Format nie selbst angeben; SAP- und JSON-Einreichungen nutzen stattdessen einen eigenen Endpunkt.

Eingabe

UBL 2.1 XML

OASIS Universal Business Language — die Basissyntax für XRechnung und PEPPOL BIS Billing 3.0.

• Endpunkt: POST /v1/invoices/validate (multipart/form-data, Feld file)

CII XML (UN/CEFACT Cross Industry Invoice)

Die alternative XML-Syntax für EN 16931, ebenfalls gültig für XRechnung. Manche deutschen ERP-Systeme erzeugen CII statt UBL.

• Endpunkt: derselbe wie UBL — das Format wird automatisch am Wurzelelement erkannt

ZUGFeRD-PDF/A-3

Ein Hybrid-PDF, das CII-XML in eine PDF/A-3-Datei einbettet. xingen erkennt das PDF anhand seiner Dateisignatur, extrahiert das eingebettete XML und validiert dieses.

• Endpunkt: derselbe wie UBL/CII — die .pdf als Feld file hochladen

SAP-IDoc-XML

SAPs INVOIC-IDoc-Format. Wird vor Anwendung der EN-16931-Regeln in xingens kanonisches Rechnungsmodell konvertiert.

• Endpunkt: POST /v1/invoices/validate/idoc

SAP OData (SupplierInvoice)

Ein SAP-S/4HANA-OData-SupplierInvoice-Entity-Payload, direkt als JSON übermittelt — kein Datei-Export nötig.

• Endpunkt: POST /v1/invoices/validate/odata

Strukturiertes JSON

Ihre eigenen Rechnungsdaten (Rechnungsnummer, Parteien, Positionen), direkt übermittelt, ohne selbst XML zu erzeugen.

• Endpunkt: POST /v1/invoices

Einfache PDF (KI-Extraktion)

Eine einfache, nicht standardisierte Rechnungs-PDF — auch gescannte oder bildbasierte PDFs — ganz ohne eingebettetes XML. xingen nutzt Claude AI, um die Rechnungsfelder zu extrahieren, und validiert das Ergebnis anschließend wie jede andere Einreichung. Verfügbar über die Dashboard-Oberfläche oder direkt über die API.

• Endpunkt: POST /v1/invoices/extract (multipart/form-data, Feld file, optional tier mit FAST/ACCURATE)

Ausgabe

xingen exportiert eine validierte Rechnung in zwei festen Formaten. Für Rechnungen, die bereits in einem strukturierten Format vorliegen (UBL, CII, IDoc, OData, JSON), gibt es keinen allgemeinen Umformatierungs-Endpunkt — die beiden folgenden Exporte gelten nur für eine bereits eingereichte und validierte Rechnung. Die Ausnahme ist eine einfache PDF, die über POST /v1/invoices/extract eingereicht wird: Genau dafür ist dieser Endpunkt da — sie in eine ZUGFeRD-PDF umzuwandeln.

• ZUGFeRD-PDF — GET /v1/invoices/{id}/download — PDF/A-3 mit eingebettetem CII-XML
• SAP-IDoc-XML — GET /v1/invoices/{id}/download/idoc

Validierungsprofile

Der Parameter profile bestimmt, welches Regelwerk auf die geparste Rechnung angewendet wird — unabhängig vom oben genannten Eingabeformat:

Details zur Plan-Beschränkung finden Sie unter Authentifizierung.