Kostenloses Tool · XRechnung 3.0
XRechnung Validator
Prüfen Sie eine XRechnung gegen das XML-Schema, die Geschäftsregeln der EN 16931 und die nationalen XRechnung-Regeln (BR-DE). Die Prüfung läuft mit dem KoSIT-Validator und der XRechnung-Konfiguration der KoSIT, für UBL und CII.
Die Datei wird nur für diese Prüfung an die vatcheckapi-API übertragen, dort flüchtig verarbeitet und nie gespeichert. Technische Prüfung, keine Steuerberatung.
Was der XRechnung-Validator prüft
XRechnung ist der deutsche Standard für E-Rechnungen, eine nationale Ausprägung (CIUS) der europäischen Norm EN 16931. Die Prüfung läuft in drei Stufen:
- XML: Die Datei muss wohlgeformtes XML ohne DOCTYPE sein. Fehler kommen mit Zeile und Spalte.
- XML-Schema: UBL Invoice oder CreditNote bzw. UN/CEFACT Cross Industry Invoice (CII). Scheitert das Schema, werden die Geschäftsregeln nicht geprüft; das Ergebnis sagt das mit der Warnung
BUSINESS_RULES_SKIPPED. - Geschäftsregeln: die Regeln der EN 16931, etwa die Rechenregeln
BR-CO-…, und die nationalen XRechnung-RegelnBR-DE-…, für die Extension auchBR-DEX-….
Welche Regeln gelten, bestimmt die Rechnung selbst über ihre Spezifikationskennung (BT-24). Bei XRechnung 3.0 lautet sie:
urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0
Fehlt die Kennung, meldet das Tool BR-01. „Prüfen als: XRechnung“ fragt zusätzlich, ob die Datei wirklich eine XRechnung ist: Gibt sie ein anderes Format an, etwa reines EN 16931, meldet das Ergebnis FORMAT_MISMATCH.
UBL oder CII?
XRechnung gibt es in zwei Syntaxen mit demselben Inhalt: UBL (Invoice und CreditNote) und UN/CEFACT CII. Beide werden geprüft; die Syntax erkennt das Tool am Wurzelelement der Datei. Ein ZUGFeRD-PDF mit dem Profil XRECHNUNG enthält eine XRechnung in CII und wird ebenfalls mit den XRechnung-Regeln geprüft, dazu PDF/A-3 und die eingebettete Datei (siehe ZUGFeRD Validator).
Unterstützte Versionen
| XRechnung | Status |
|---|---|
| 3.0 in UBL und CII, auch Extension und CVD | geprüft mit der XRechnung-Konfiguration der KoSIT |
| 3.0 Extension als UBL-Gutschrift (CreditNote) | erkannt, nicht geprüft |
| frühere Versionen (z. B. 2.x) | erkannt, nicht geprüft |
Nicht geprüfte Versionen meldet das Ergebnis mit UNSUPPORTED_PROFILE. Die genauen Versionen der Regelwerke einer Prüfung stehen unter ruleset_version, auch im herunterladbaren Prüfbericht.
Häufige Fehler
BR-DE-15: Die Käuferreferenz (BT-10) fehlt, bei öffentlichen Auftraggebern meist die Leitweg-ID.BR-CO-…: Summen und Beträge passen nicht zusammen, zum BeispielBR-CO-10: Die Summe der Positionsbeträge stimmt nicht.cvc-…: Das XML entspricht nicht dem Schema, etwa ein fehlendes oder falsch platziertes Element. Zeile und Spalte stehen in der Fundstelle.NOT_WELL_FORMED: Die Datei ist kein gültiges XML, oft durch eine abgeschnittene Datei oder falsche Zeichenkodierung.FORMAT_MISMATCH: Die Datei ist gültig, aber keine XRechnung, sondern zum Beispiel eine Rechnung nach reiner EN 16931.
Die nationalen Regeln melden auf Deutsch, die EN 16931 und das XML-Schema auf Englisch. Die Liste aller eigenen Codes steht in der Dokumentation (englisch).
XRechnung per API prüfen
curl "https://api.vatcheckapi.com/v2/einvoice/validate?format=xrechnung&language=de" \
-H "apikey: YOUR-API-KEY" \
-H "Content-Type: application/xml" \
--data-binary @xrechnung.xml
Eine XML-Rechnung zählt als 1 Anfrage, auch eine ungültige; nicht geprüfte Dateien (UNSUPPORTED_PROFILE, INVOICE_TOO_COMPLEX) zählen nicht. Details in der Dokumentation (englisch). Die Prüfung läuft unverändert mit dem KoSIT-Validator und der XRechnung-Konfiguration (Apache License 2.0) sowie den EN-16931-Validierungsartefakten von CEN und Europäischer Kommission (EUPL 1.2). Das Ergebnis ist eine technische Prüfung, keine Steuerberatung.
Häufige Fragen
Wie prüfe ich eine XRechnung?
Welche XRechnung-Versionen werden geprüft?
UNSUPPORTED_PROFILE. Welche Konfiguration genau lief, steht im Ergebnis unter ruleset_version.Was bedeutet BR-DE-15?
Warum sind manche Meldungen deutsch und andere englisch?
Kann ich eine XRechnung als PDF prüfen?
Werden meine Rechnungen gespeichert?
Ist das Ergebnis eine steuerliche Prüfung?
API zur E-Rechnungsprüfung
XRechnungen direkt in Ihrer Software prüfen
Die vatcheckapi-API prüft XRechnung, ZUGFeRD / Factur-X und EN 16931 und liefert das Ergebnis als JSON, mit jeder Regel-ID, Fundstelle und Zeile. Senden Sie die XML als Request-Body, als Upload oder Base64-kodiert als JSON.
/v2/einvoice/validate Dokumentation E-Rechnungs-API (englisch) Gesamte Dokumentation
150 kostenlose Anfragen pro Monat. Eine XRechnung zählt als 1 Anfrage. Keine Kreditkarte nötig.
POST https://api.vatcheckapi.com/v2/einvoice/validate?format=xrechnung&language=de
{
"valid": false,
"format": "xrechnung",
"syntax": "UBL",
"profile": "XRECHNUNG",
"version": "3.0",
"container": "xml",
"errors": [
{
"rule_id": "BR-DE-15",
"severity": "error",
"message": "Das Element \"Buyer reference\" (BT-10) muss übermittelt werden.",
"message_language": "de",
"source": "business_rules",
"location": "/ubl:Invoice[1]"
}
],
"warnings": [
{
"rule_id": "BR-DE-TMP-32",
"severity": "information",
"message": "Eine Rechnung sollte zur Angabe des Liefer-/Leistungsdatums entweder BT-72 \"Actual delivery date\", BG-14 \"Invoicing period\" oder in jeder Rechnungsposition BG-26 \"Invoice line period\" enthalten.",
"message_language": "de",
"source": "business_rules",
"location": "/ubl:Invoice[1]"
}
],
"language": "de"
}