Factur-X API: Hybrid-PDFs nach EN 16931 per REST prüfen
Factur-X ist der französische und internationale Name für das hybride EN-16931-Format: lesbares PDF mit eingebetteter CII-XML (Einbettungsname factur-x.xml). Statt jede Datei im Browser zu öffnen, prüfen Sie Factur-X-PDFs per REST: POST an /api/v1/validate, JSON zurück mit valid, Format (typisch CII) und jeder verletzten Regel-ID. Ausgewertet wird die erste eingebettete Datei; PDF/A-3, XMP und der Einbettungsname werden nicht geprüft. Die Prüfung nutzt die veröffentlichten KoSIT-Schematron-Regeln (EN 16931) — keine französischen Plattform-, SIREN- oder CTC-Regeln und keine Gewähr für französische Pflichtanforderungen. Kostenlos 50 Prüfungen pro Monat und Schlüssel. Beta, ohne Verfügbarkeitszusage — kein offizieller Dienst der KoSIT und keine Zertifizierung.
Factur-X: PDF plus CII nach EN 16931
Factur-X verbindet ein menschenlesbares PDF mit maschinenlesbarer CII-Rechnungs-XML nach der europäischen Norm EN 16931. Typische Profile heißen BASIC, EN 16931 und EXTENDED; MINIMUM und BASIC WL gelten nicht als E-Rechnung und scheitern an EN-16931-Regeln — das ist korrekt. EXTENDED-Dateien können zusätzlich CII-Syntaxwarnungen (CII-SR) auslösen, die die Schematron-Prüfung meldet; eine eigene EXTENDED-Profilvalidierung gibt es nicht. Die API nimmt das hybride PDF so entgegen, wie ERP, Archiv oder CI es liefern. Herausgeber des Standards sind FNFE-MPE und FeRD; sie sind keine Partner dieses Angebots.
Mehr dazu: API-Dokumentation und Schlüssel · Factur-X erstellen
Naming: Factur-X international, ZUGFeRD in Deutschland
In Frankreich und international ist Factur-X der übliche Name; in Deutschland sagt man meist ZUGFeRD. Ab ZUGFeRD 2.1 / Factur-X 1.0 ist der technische Kern derselbe. Wer die deutsche Bezeichnung sucht, findet den API-Überblick unter ZUGFeRD API. Unser Validator und die API sind auf die veröffentlichten KoSIT-Regeln ausgelegt und geben keine Gewähr für französische Pflichtanforderungen, Plattform agréée oder SIREN.
Mehr dazu: ZUGFeRD API · Kurzfassung auf Englisch
Grenzen der Schematron-Prüfung
Geprüft werden die veröffentlichten Schematron-Regeln der KoSIT (EN 16931 und, bei XRechnung-Kennung im Profil, XRechnung 3.0.2) für die ausgelesene CII- oder UBL-XML. Eine XSD-Schemaprüfung findet nicht statt; das Ergebnis ist nicht identisch mit dem vollständigen KoSIT-Prüftool. Profile werden nicht gesondert validiert — alle laufen gegen denselben EN-16931-Kern. Bei PDFs wird nur die erste eingebettete Datei als XML gelesen; der Dateiname der Einbettung ist kein Prüfkriterium. PDF/A-3 und XMP-Metadaten werden nicht geprüft. Liegt vor der Rechnungs-XML ein anderer Anhang, laden Sie die extrahierte XML direkt hoch. Rechnungsdateien werden nur im Arbeitsspeicher verarbeitet, nicht gespeichert und nicht an KI-Dienste übermittelt. Die Prüfung ersetzt keine Steuerberatung. Einzeldateien können Sie auch im Browser prüfen; die Validate-API repariert nichts und sendet nichts an KI (anders als die optionale Reparatur unter /service).
Mehr dazu: Grenzen der API · Im Browser prüfen · Automatisch reparieren
Free jetzt, bezahlte Tarife geplant
Free ist jetzt verfügbar: 50 Prüfungen pro Monat und Schlüssel, höchstens 60 Anfragen pro Minute, Dateigröße max. 2,5 MB. Bezahlte Tarife sind geplant und noch nicht buchbar; den aktuellen Stand zu Limits und Preisen finden Sie nur auf der API-Dokumentationsseite. Das Angebot ist Beta ohne Verfügbarkeitszusage; bei Missbrauch können Schlüssel gesperrt werden.
Mehr dazu: Limits und Tarife
Factur-X-PDF in drei Schritten prüfen
1. Schlüssel per E-Mail auf der Dokumentationsseite holen. 2. Factur-X-PDF als Multipart-Feld file an POST /api/v1/validate senden (max. 2,5 MB) — oder die CII-XML als Body mit Content-Type application/xml. 3. In der JSON-Antwort prüfen Sie valid sowie format (bei Factur-X typisch CII) und die Regel-IDs. curl-, Node-Beispiele und OpenAPI 3.1 stehen auf der Dokumentationsseite.
Mehr dazu: Schnellstart mit curl · OpenAPI JSON · OpenAPI YAML
Häufige Fragen
Was kostet die Factur-X-API?
Der Free-Tarif ist kostenlos: 50 Prüfungen pro Monat und Schlüssel, ohne Zahlungsmittel. Bezahlte Tarife sind geplant und noch nicht buchbar; den aktuellen Stand sehen Sie auf der API-Dokumentationsseite.
Ist Factur-X dasselbe wie ZUGFeRD?
Ab ZUGFeRD 2.1 / Factur-X 1.0 ja: derselbe technische Standard. International und in Frankreich heißt es Factur-X, in Deutschland meist ZUGFeRD. Den deutschsprachigen API-Überblick finden Sie unter /zugferd-api.
Prüft die API französische Anforderungen (Plattform agréée, SIREN)?
Nein. Es laufen nur die veröffentlichten KoSIT-Schematron-Regeln (EN 16931 und bei XRechnung-Kennung XRechnung 3.0.2). Französische Plattform-, CTC- oder SIREN-Prüfungen gibt es nicht; keine Gewähr für französische Pflichtanforderungen.
Ist das ein offizieller oder zertifizierter KoSIT-Dienst?
Nein. Es ist ein eigenes Angebot und führt die veröffentlichten KoSIT-Schematron-Regeln aus. Das ist keine Zertifizierung und kein behördlicher Dienst.
Prüft die API PDF/A-3, XMP und den Einbettungsnamen?
Nein. Bei PDFs wird nur die erste eingebettete Datei als XML geprüft. PDF/A-3, XMP-Metadaten und der Dateiname der Einbettung (factur-x.xml) werden nicht validiert.
Werden meine Rechnungen gespeichert?
Nein. An die Validate-API gesendete Rechnungsdateien werden nur im Arbeitsspeicher verarbeitet, nicht gespeichert und nicht an KI-Dienste übermittelt. Einzelheiten stehen in der Datenschutzerklärung.