Konto
Deutsch

XRechnung Validator

XRechnung vor dem Versand prüfen oder eine abgewiesene Rechnung verstehen. Offizielle KoSIT-Prüfung, Ergebnis in Sekunden.

Dateien werden nur im Arbeitsspeicher verarbeitet und nie gespeichert.

Was geprüft wird

Verwendet wird der KoSIT-Validator 1.6 mit der Konfiguration XRechnung 3.0.2, exakt wie bei ZRE und OZG-RE.

Häufige Fehler

RegelBedeutungBehebung
BR-DE-15Leitweg-ID / Käuferreferenz fehltVom Empfänger erfragen, in BT-10 eintragen
BR-DE-2Kontakt des Verkäufers fehltName, Telefon oder E-Mail ergänzen
BR-CO-15Bruttobetrag ≠ Netto + SteuerRundung in der Software korrigieren
BR-CO-10Summe der Positionen ≠ NettobetragPositionsbeträge prüfen
BR-DE-21Falsche CustomizationIDAktuelle XRechnung-Version verwenden
no scenario matchedDokumenttyp oder Version unbekanntSoftware aktualisieren

Fehler oder Warnung: was muss korrigiert werden?

Der KoSIT-Validator unterscheidet drei Ergebnisse. Fehler (fatal) führen zur Abweisung an jedem Rechnungsportal; typisch sind fehlende Pflichtfelder, falsche Summen und ungültige Codes. Warnungen weisen auf Abweichungen hin, die nicht zur Abweisung führen, etwa veraltete Codelisten oder Empfehlungen zur Käuferreferenz; sie sollten dennoch bereinigt werden, weil kommende Versionen der XRechnung sie zu Fehlern machen können. Konform bedeutet, dass die Datei alle Regeln der Konfiguration XRechnung 3.0.2 erfüllt. Jede Meldung enthält Regel-ID, Text und XPath zum betroffenen Element, sodass der Absender die Stelle in seiner Software direkt findet.

Wichtig für Empfänger: Eine abgewiesene XRechnung ist keine ordnungsgemäße Rechnung; die Zahlungsfrist beginnt erst mit einer korrigierten Fassung. Senden Sie dem Lieferanten den Bericht, nicht nur den Hinweis „Datei fehlerhaft“.

Für Entwickler und Rechnungssoftware

Dieselbe Prüfung ist als HTTP-API verfügbar: Datei per POST senden, strukturierten Bericht als JSON erhalten, inklusive Regel-ID, Meldung, Schweregrad und XPath. Damit lässt sich die Prüfung in den Rechnungsausgang oder den Posteingang integrieren.

Häufige Fragen

Welche XRechnung-Version wird geprüft?

Die Konfiguration XRechnung 3.0.2 des KoSIT, gültig seit 2024, mit den Codelisten der aktuellen Veröffentlichung. Ältere Dateien (2.x) werden erkannt und mit Hinweis auf die veraltete Version geprüft.

Ist das Ergebnis identisch mit dem Validator der Rechnungsportale?

Ja, es wird dieselbe Software (KoSIT-Validator) mit derselben Konfiguration eingesetzt. Abweichungen kann es nur geben, wenn ein Portal noch eine ältere Konfiguration verwendet.

Prüft der Validator auch ZUGFeRD-PDFs?

Ja. Das eingebettete XML wird aus dem PDF gelesen und wie eine XRechnung-CII geprüft. Die PDF/A-3-Konformität des Containers selbst wird nicht geprüft.

Was ist der Unterschied zwischen Fehler und Warnung?

Fehler führen zur Ablehnung der Rechnung. Warnungen weisen auf Empfehlungen hin, die nicht verpflichtend sind, etwa fehlende optionale Angaben.

Für Entwickler: dieselbe Engine als API

curl -F file=@invoice.pdf https://einvoicechecker.com/v1/validate
curl -F file=@invoice.xml https://einvoicechecker.com/v1/parse
curl -F file=@invoice.xml "https://einvoicechecker.com/v1/render?lang=de" -o invoice.html