Titelbild für den Artikel: KoSIT Validator: Offizielle XRechnung Prüfung – Anleitung
Zurück zum BlogHow-To & Problemlöser

KoSIT Validator: Offizielle XRechnung Prüfung – Anleitung

Wie funktioniert der offizielle KoSIT Validator von itplr-kosit (GitHub)? Nutzung der Prüfsoftware für XRechnungen, EN16931 und einfache Online-Alternative

RechneX Redaktion15. Februar 20265 Min. Lesezeit

Wer in Deutschland E-Rechnungen an Behörden oder B2B-Kunden sendet, kommt an einem Begriff nicht vorbei: KoSIT (Koordinierungsstelle für IT-Standards). Sie stellt die offiziellen Regeln und Prüfmodule bereit, die letztlich maschinell entscheiden, ob eine XML-Rechnung gültig ist oder wegen Syntax-Fehlern abgelehnt wird.

Doch wie nutzen Sie diesen "KoSIT Validator"? Muss man Informatik studiert haben, um ihn bedienen zu können? In diesem Artikel zeigen wir Ihnen den offiziellen Open-Source-Weg über GitHub – und eine deutlich einfachere Alternative für Nicht-Programmierer. Wenn Sie direkt in den passenden Online-Workflow springen wollen, gehen Sie zu E-Rechnung validieren.

Wenn Sie die Prüfung nicht manuell im Browser, sondern direkt in ERP, Shop oder Plattform einbauen möchten, ist unsere KoSIT Validator API für E-Rechnung, XRechnung und ZUGFeRD der passende Enterprise-Einstieg.

Was ist der KoSIT Validator?

Der offizielle KoSIT Validator ist keine App mit grafischer Benutzeroberfläche, sondern ein technisches Kommandozeilen-Tool (CLI) auf Java-Basis. Es wurde primär für Software-Entwickler und Behörden konzipiert, um sicherzustellen, dass elektronische Rechnungen (XML-Dateien) exakt der Norm EN 16931 und dem deutschen Standard XRechnung entsprechen.

Das Tool führt drei harte Checks durch:

  1. XML-Syntax: Ist die Datei maschinell lesbar und korrekt geformt?

  2. Schema-Validierung: Stimmt die hierarchische Struktur (UBL 2.1 oder UN/CEFACT CII)?

  3. Schematron-Regeln: Werden alle logischen Geschäftsregeln eingehalten? (z.B. "Wenn die Steuerkategorie auf 'Standard' steht, muss der Umsatzsteuersatz zwingend vorhanden sein").

Anleitung: Den KoSIT Validator lokal nutzen (Entwickler-Weg)

Wenn Sie technisch versiert sind oder als Entwickler eine Faktura-Software bauen, können Sie den Validator lokal auf Ihrem Server oder PC ausführen. Alles Nötige liegt Open-Source auf GitHub in der Organisation itplr-kosit bereit.

Voraussetzungen (System environment):
* Installierte Java Runtime Environment (JRE 17+).
* Grundkenntnisse im Umgang mit der Kommandozeile (Terminal / CMD).

Schritt-für-Schritt Einrichtung:

  1. Download des Tools: Laden Sie das Kernanwendung (validator) als kompiliertes .jar-File von der KoSIT GitHub-Seite (itplr-kosit/validator) herunter.

  2. Download der XRechnung-Regeln: Die nackte .jar weiß noch nichts von Rechnungen. Sie benötigen zusätzlich das Regelwerk für Rechnungen aus dem Repository validator-configuration-xrechnung.

  3. Zusammenführen: Entpacken Sie die Konfiguration ("Szenarien") und legen Sie diese in den gleichen Ordner wie die Executable-Jar.

  4. Befehl ausführen: Öffnen Sie das Terminal in diesem lokalen Pfad und starten Sie die Prüfung einer Beispiel-XML-Datei (laden Sie sich dafür am besten unsere kostenlose Beispiel-XRechnung herunter) mit folgendem Befehl:

bash
java -jar validationtool-1.5.0-standalone.jar -s scenarios.xml -h "meine_rechnung.xml"

  1. Prüfbericht lesen: Nach wenigen Millisekunden generiert das Tool lokal einen HTML-Report im gleichen Ordner. Diesen Bericht müssen Sie im Browser öffnen. Darin finden Sie dann standardisierte Fehlercodes (z.B. BR-DE-17 - Leitweg-ID fehlt), falls die Rechnung Durchfällt.
Das logistische Problem: Für Geschäftsführer, Buchhalter oder Anwender, die "nur mal kurz" prüfen wollen, ob ihre Export-Rechnung rechtens ist, ist dieser Setup-Aufwand über GitHub, Java und Command Line unverhältnismäßig hoch.

Die einfache Alternative: Rechnex Online Validator

Warum Java installieren und Kommandozeilen tippen, wenn es auch grafisch geht? Unser Kostenloser XRechnung Validator nutzt im Hintergrund auf unseren Servern exakt dieselbe offizielle KoSIT-Prüfengine – aber wir haben eine moderne, benutzerfreundliche Oberfläche darübergelegt.

MerkmalKoSIT CLI (Lokal via GitHub)Rechnex Validator (Online)
EinrichtungJava-Installation, ZIP-KonfigurationKeine (Direkt im Browser öffnen & los)
BedienungKommandozeilen (Terminal)Bequemes Drag & Drop
FeedbackVerschachtelter HTML-Report lokalSofortige, leicht verdauliche Fehleranzeige (Rot/Grün)
KostenKostenlos (Open Source)100% Kostenlos
Updates (Szenarien)Manuelle GitHub-Pulls nötig bei neuen NormenImmer automatisch aktuell auf unserem Server
### So prüfen Sie Ihre Rechnung in 3 Sekunden:
  1. Öffnen Sie den Validator in Ihrem Browserfenster.
  2. Ziehen Sie Ihre fertige XML-Datei (XRechnung) oder Ihr ZUGFeRD-PDF direkt in das Ablagefeld. (Keine Datei zur Hand? Nutzen Sie unsere XRechnung-Beispieldatei zum Testen!)
  3. Unser Backend lässt die KoSIT-Engine laufen und übersetzt Ihnen das Ergebnis:
* Grüner Haken: Ihre Rechnung entspricht der EN 16931 und dem XRechnung-Standard. Sie können versenden. * Roter Fehler: Wir zeigen Ihnen transparent an, welche Regel laut KoSIT verletzt wurde (z.B. Pflichtfeld Käufer fehlt).

Fazit: Profi-Standards für alle nutzbar gemacht

Der KoSIT Validator ist der unumstrittene "Goldstandard" für die formelle Abnahme von E-Rechnungen im deutschen B2G- und B2B-Datenverkehr gemäß EN16931. Nur wer diese Hürde nimmt, löst zuverlässig Bezahlungen bei öffentlichen Trägern aus.
Sie als Anwender müssen ihn jedoch nicht mühsam als Code selbst einrichten. Verwenden Sie unsere Web-Schnittstelle, um sich sekundenschnell abzusichern. So bleibt Ihr Fokus auf dem Geschäft, nicht auf IT-Administration.

XRechnung technisch validieren

Prüfen Sie kostenlos, ob Ihr XML-Export den strengen Vorgaben der Koordinierungsstelle für IT-Standards entspricht.

Tags:

KoSITValidatorAnleitungXRechnungPrüfberichtXMLitplr-kositEN16931

XRechnung vor dem Versand kostenlos prüfen

XML auf EN 16931 und KoSIT-Regeln prüfen