KoSIT-Validator

Wenn von einer „offiziellen Prüfung” einer XRechnung die Rede ist, ist fast immer der KoSIT-Validator gemeint. Die Koordinierungsstelle für IT-Standards (KoSIT) gibt den Standard XRechnung heraus und veröffentlicht dazu ein Prüfwerkzeug samt Regelwerk. Sie können es selbst auf Ihrem Rechner oder Server betreiben – oder über XRIO nutzen, ohne Java, ohne Updates und mit Befunden, die Ihre Software oder Ihre KI direkt weiterverarbeiten kann.

Validator und Prüfkonfiguration

Der KoSIT-Validator besteht aus zwei Teilen, die getrennt veröffentlicht werden:

Teil	Was er ist	Quelle
Validator	Java-Programm, enthält selbst keine Regeln	GitHub itplr-kosit/validator, Apache-Lizenz 2.0
Prüfkonfiguration XRechnung	Szenarien, XML-Schemas, Schematron-Regeln, Berichtsvorlage	GitHub itplr-kosit/validator-configuration-xrechnung

Ein Szenario legt fest, welche Regeln für welche Datei gelten. Der Validator erkennt das passende Szenario an der Spezifikationskennung im XML (BT-24): Eine XRechnung in UBL bekommt andere Prüfschritte als eine XRechnung in CII oder eine reine EN-16931-Rechnung. Die Konfiguration für XRechnung 3.0.2 bringt Szenarien für XRechnung in UBL (Rechnung und Gutschrift) und in CII mit, für die XRechnung-Extension und für reine EN-16931-Rechnungen, wie sie etwa in einer ZUGFeRD-PDF stecken. Für Peppol BIS Billing gibt es eine eigene Konfiguration.

Was der KoSIT-Validator prüft

Eine Datei durchläuft mehrere Prüfschritte nacheinander:

Prüfschritt	Regelwerk	Typische Regel-IDs
Syntax	XML-Schema für UBL 2.1 oder UN/CEFACT CII	Meldungen des XML-Schemas
EN 16931	Schematron der europäischen Norm (CEN)	BR-…, BR-CO-…, BR-CL-…, UBL-SR-…, CII-SR-…
XRechnung	Schematron der deutschen CIUS	BR-DE-…, PEPPOL-EN16931-R…

Das Ergebnis ist ein Prüfbericht: je Prüfschritt die Zahl der Fehler, Warnungen und Informationen, dann jeder Befund mit Code, Grad, Regeltext und Pfad im XML. Am Ende steht eine Bewertung, etwa „Es wird empfohlen das Dokument zurückzuweisen.” bei einem Fehler wie BR-DE-15 (Käuferreferenz fehlt). Das BMF nennt eine geeignete Validierungsanwendung als Weg, Format- und Geschäftsregelfehler festzustellen (BMF-Schreiben vom 15.10.2024 in der Fassung vom 15.10.2025, Rn. 6a und 6b).

Den KoSIT-Validator selbst betreiben

Sie brauchen Java ab Version 11, das Validator-Paket und die Prüfkonfiguration, beides von den Release-Seiten auf GitHub. Stand Oktober 2026 sind das der Validator 1.6.3 und die Konfiguration vom 31. August 2026 für XRechnung 3.0.2.

1. Herunterladen und entpacken. Validator-ZIP und Konfigurations-ZIP in denselben Ordner entpacken; dort liegt dann unter anderem die Datei scenarios.xml.

2. Prüfen auf der Kommandozeile. Der Schalter -s nennt die Szenarien, -r den Ordner der Konfiguration, -h schreibt den Bericht zusätzlich als HTML:

   java -jar validator-<version>-standalone.jar -s scenarios.xml -r . -h rechnung.xml

   Der Bericht landet in rechnung-report.xml und rechnung-report.html. Der Rückgabewert ist 0, wenn alle Dateien annehmbar sind, sonst die Zahl der abgelehnten Dateien.

3. Oder als Dienst. Mit -D startet der Validator als HTTP-Server, standardmäßig auf localhost, Port 8080; -H und -P ändern Adresse und Port. Die Datei schicken Sie per POST als Anfrage-Inhalt:

   java -jar validator-<version>-standalone.jar -s scenarios.xml -r . -D
   curl --data-binary @rechnung.xml -H "Content-Type: application/xml" http://localhost:8080/

   Status 200 heißt annehmbar, 406 nicht annehmbar; der Prüfbericht steht im Antworttext.

Beim Selbstbetrieb bleiben einige Aufgaben bei Ihnen: neue Releases von Validator und Konfiguration einspielen, das XML aus ZUGFeRD-PDFs herauslösen, den XML-Bericht in Ihrer Software auswerten und den Dienst absichern – der HTTP-Modus bringt keine Anmeldung mit.

Ohne Einrichtung: der KoSIT-Validator über XRIO

XRIO betreibt den KoSIT-Validator mit der Prüfkonfiguration XRechnung 3.0.2 und stellt ihn über Portal, REST-API und MCP bereit. Mehr zu Ablauf und Ergebnis steht beim XRechnung-Validator.

	Selbst betreiben	Über XRIO
Einrichtung	Java, Validator, Konfiguration, Updates	kostenloses Konto
Eingabe	XML-Datei	XML oder PDF – das XML einer ZUGFeRD-PDF liest XRIO selbst aus
ZUGFeRD-Profile MINIMUM, BASIC WL	passen zu keinem Szenario der Konfiguration	eigener Befund mit Verweis auf das BMF-Schreiben
Ergebnis	XML- und HTML-Bericht	JSON mit Urteil und Befunden: Regel, Feld (BT), Stelle, Originalwortlaut, Quelle
Zugang	Kommandozeile oder eigener HTTP-Dienst	Portal, POST /v1/invoices/validate, MCP-Werkzeug validate_invoice
Kosten	Software kostenlos, Betrieb bei Ihnen	0,05 € netto pro Prüfung

Ein Aufruf genügt:

curl --data-binary @rechnung.xml \
  -H "Authorization: Bearer xrio_live_…" \
  https://api.xrio.de/v1/invoices/validate

Ein Befund aus der Antwort:

{
  "rule": "BR-DE-15",
  "businessTerm": "BT-10",
  "level": "error",
  "location": "/ubl:Invoice[1]",
  "xpath": "/ubl:Invoice[1]",
  "requirement": "Das Element \"Buyer reference\" (BT-10) muss übermittelt werden.",
  "source": "XRechnung (KoSIT)"
}

Die Anforderung steht im Wortlaut der offiziellen Quelle: Regeln der EN 16931 auf Englisch, die BR-DE-Regeln auf Deutsch. Ihre KI kann über MCP außerdem jede Regel kostenlos mit lookup_rule nachschlagen. Die geprüfte Datei verarbeitet XRIO im Arbeitsspeicher und verwirft sie danach; im Verlauf Ihres Kontos steht nur, wann geprüft wurde und mit welchem Ergebnis.

Was eine Prüfung über XRIO kostet

Eine Prüfung kostet 0,05 € netto aus Ihrem Guthaben, ohne Abo; die 5 € Startguthaben nach der Bestätigung Ihrer E-Mail reichen für 100 Prüfungen. Nichts kosten das Prüfen einer Datei, die XRIO für Ihr Konto erstellt hat, eine PDF ohne E-Rechnung und Aufrufe, die an einem Fehler scheitern. Erstellen Sie die E-Rechnung gleich mit XRIO, prüft der KoSIT-Validator jede Datei vor der Ausgabe, und XRIO liefert seinen Prüfbericht mit – siehe XRechnung erstellen. Alle Preise stehen unter Preise.

Gültig heißt nicht steuerlich richtig

Der Validator prüft Format und Geschäftsregeln. Ob der Steuersatz zur Leistung passt oder die Leistungsbeschreibung stimmt, kann er nicht beurteilen. Das BMF formuliert es so: Eine Validierung ersetzt nicht die Pflicht des Empfängers, die Rechnung auf Vollständigkeit und Richtigkeit zu prüfen, sondern unterstützt ihn dabei. Auf das technische Ergebnis einer geeigneten Validierungsanwendung darf sich ein Unternehmer bei Beachtung der Sorgfaltspflichten eines ordentlichen Kaufmanns verlassen; den Validierungsbericht zum Nachweis aufzubewahren, bietet sich an (BMF-Schreiben vom 15.10.2024 in der Fassung vom 15.10.2025, Rn. 35a).