XRechnung API: E-Rechnungs-Prüfung automatisieren
Statt jede Datei im Browser hochzuladen, prüfen Sie XRechnungen (CII und UBL) und ZUGFeRD-/Factur-X-PDFs per REST: POST an /api/v1/validate, JSON zurück mit valid, Format und jeder verletzten Regel-ID. Kostenlos 50 Prüfungen pro Monat und Schlüssel, Schlüssel sofort ohne Zahlung. Beta, ohne Verfügbarkeitszusage — kein offizieller Dienst der KoSIT und keine Zertifizierung.
Wofür die XRechnung-API gedacht ist
Die API automatisiert die formale Prüfung deutscher E-Rechnungen in Ihrer Software: Eingangsrechnungen vor dem Verbuchen prüfen, einen Check in der CI vor dem Versand an ZRE, OZG-RE oder Peppol einbauen, oder ältere Bestände im Batch nachziehen. Ihre Software sendet die Datei per HTTP und erhält strukturierte Fehler mit Regelnummer — ohne Browser und ohne manuelles Abtippen.
Mehr dazu: API-Dokumentation und Schlüssel
Was geprüft wird — und was nicht
Geprüft werden die veröffentlichten Schematron-Regeln der KoSIT (EN 16931 und, bei XRechnung-Kennung, XRechnung 3.0.2) für CII und UBL. Eine XSD-Schemaprüfung findet nicht statt; das Ergebnis ist daher nicht identisch mit dem vollständigen KoSIT-Prüftool. Bei ZUGFeRD/Factur-X wird nur die erste eingebettete XML geprüft, nicht PDF/A-3 oder XMP-Metadaten. Rechnungsdateien werden nur im Arbeitsspeicher verarbeitet, nicht gespeichert und nicht an KI-Dienste übermittelt.
Mehr dazu: Grenzen der API · XRechnung Fehlercodes
API, Browser-Validator und Reparatur
Der kostenlose Validator unter Prüfen ist dieselbe Schematron-Prüfung für einzelne Dateien im Browser — ohne API-Schlüssel. Die automatische Reparatur unter /service kann behebbare Formatfehler korrigieren und nutzt dafür optional KI; die Validate-API repariert nichts und sendet nichts an KI. Für Entwickler, die viele Dateien oder Pipelines anbinden, ist die API der passende Einstieg.
Mehr dazu: E-Rechnung im Browser prüfen · Was der Validator kontrolliert · Automatisch reparieren
Free-Kontingent und geplante Tarife
Free ist jetzt verfügbar: 50 Prüfungen pro Monat und Schlüssel, höchstens 60 Anfragen pro Minute. 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
Schnellstart in drei Schritten
1. Schlüssel per E-Mail auf der Dokumentationsseite holen. 2. XML als Body oder ZUGFeRD-PDF als Multipart an POST /api/v1/validate senden. 3. curl-, Node-Beispiele und die OpenAPI-3.1-Spezifikation stehen dort.
Mehr dazu: Schnellstart mit curl · OpenAPI JSON · OpenAPI YAML
Gehostete API statt eigenem KoSIT-Prüftool
Sie müssen kein Java-Prüftool betreiben und keine Regelpakete aktualisieren. Dafür entfällt die XSD-Schemaprüfung des KoSIT-Jars, und das Ergebnis ist nicht identisch mit dem vollständigen KoSIT-Prüftool. Die Prüfung ersetzt keine Steuerberatung.
Mehr dazu: Zur API-Dokumentation
Häufige Fragen
Was kostet die XRechnung-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 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 auch gegen XSD-Schemas?
Nein. Es laufen nur die veröffentlichten Schematron-Regeln (EN 16931 und bei XRechnung-Kennung XRechnung 3.0.2). Ohne den XSD-Schritt des KoSIT-Jars ist das Ergebnis nicht identisch mit dem vollständigen KoSIT-Prüftool.
Kann ich ZUGFeRD- oder Factur-X-PDFs prüfen?
Ja. Bei PDFs wird die erste eingebettete Datei als XML geprüft. 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.
Werden meine Rechnungen gespeichert?
Nein. An die API gesendete Rechnungsdateien werden nur im Arbeitsspeicher verarbeitet, nicht gespeichert und nicht an KI-Dienste übermittelt. Einzelheiten stehen in der Datenschutzerklärung.