Werkzeug
XRechnung-Validator (KoSIT)
Definition
Der XRechnung-Validator ist ein von KoSIT entwickeltes und als Open-Source veröffentlichtes Kommandozeilen-Tool zur Prüfung von XRechnung-Dokumenten auf Konformität. Er prüft sowohl die XML-Schemavalidität (XSD) als auch die inhaltlichen Geschäftsregeln mittels Schematron. Das Tool wird regelmäßig aktualisiert, wenn neue XRechnung-Versionen erscheinen, und ist Referenzimplementierung für die Validierung.
Hintergrund & Kontext
Der KoSIT-Validator ist die offizielle Referenzimplementierung zur Prüfung elektronischer Rechnungen in Deutschland. Er ist als quelloffenes Java-Werkzeug verfügbar und arbeitet konfigurationsgesteuert: Die eigentlichen Prüfregeln stecken nicht im Validator selbst, sondern in einer separaten „validator-configuration“ (für XRechnung: validator-configuration-xrechnung), die die XSD-Schemata und Schematron-Regeln eines bestimmten Standardstands bündelt. Die Prüfung läuft in zwei Stufen: Zuerst prüft der Validator die XML-Schemavalidität (XSD) — ist das Dokument überhaupt eine wohlgeformte, strukturell korrekte UBL- oder CII-Datei? Anschließend wertet er die Schematron-Regeln aus, also die inhaltlichen Geschäftsregeln der EN 16931 (BR-, BR-CO-, BR-S- …) und der deutschen Erweiterung (BR-DE-). Das Ergebnis ist ein maschinenlesbarer Prüfbericht (Validation Report) mit der Gesamtaussage „conformant“ oder „not conformant“ sowie einer Liste der verletzten Regeln samt Fundstelle. Da die Empfangsplattformen ZRE und OZG-RE dieselbe Logik verwenden, lässt sich mit dem Validator vorab prüfen, ob eine Rechnung dort akzeptiert würde.
In der Praxis — ein Beispiel
Vor dem Versand prüft ein Entwickler seine generierte XRechnung lokal mit dem KoSIT-Validator und der aktuellen XRechnung-Konfiguration. Der Bericht meldet einen Verstoß gegen BR-DE-2 (fehlende Käuferreferenz). Der Entwickler ergänzt die Leitweg-ID in BT-10 und prüft erneut; nun lautet das Ergebnis „conformant“. Erst dann übermittelt er die Datei über Peppol an die Behörde — und vermeidet so eine spätere Ablehnung durch das Empfangsportal.
Häufige Fehler
- •Den Validator mit veralteter Konfiguration betreiben: Nach einem XRechnung-Update können bisher gültige Rechnungen fehlschlagen.
- •„conformant“ bedeutet technische Konformität, nicht inhaltliche Richtigkeit — falsche, aber formal gültige Beträge erkennt der Validator nicht.
Häufig gestellte Fragen
Ersetzt eine „conformant“-Meldung die fachliche Prüfung?
Nein. Der Validator prüft Struktur und Geschäftsregeln, nicht aber, ob die Rechnungsinhalte sachlich korrekt sind. Eine formal gültige Rechnung kann inhaltlich falsch sein.
Welche Konfiguration brauche ich für XRechnung?
Die validator-configuration-xrechnung in der Version, die dem von Ihrem Empfänger akzeptierten XRechnung-Stand entspricht. Sie enthält die passenden XSD- und Schematron-Regeln.