E-Rechnung lokal prüfen

Diese Seite zeigt, wie Sie Java lokal installieren, den KoSIT Validator herunterladen und
die XML Ihrer E-Rechnung selbst validieren können.

Java lokal
KoSIT Validator
XML prüfen
XRechnung / EN 16931

Wichtiger Hinweis

Der KoSIT Validator prüft in der Regel XML-Dateien und nicht direkt das PDF.
Für eine PDF-Datei mit eingebetteter XML ist oft ein separates Werkzeug nötig, zum Beispiel
Mustang CLI. Wenn Sie nur die E-Rechnungs-XML testen möchten, ist der KoSIT Validator richtig.

Schritt-für-Schritt

Java installieren

Installieren Sie eine aktuelle Java-Version, zum Beispiel ein LTS-Java wie Java 17
oder höher.

Download von Adoptium oder Oracle
Nach der Installation im Terminal prüfen: java -version
Wenn der Befehl nicht gefunden wird, JAVA_HOME und PATH prüfen

KoSIT Validator herunterladen

Laden Sie den KoSIT Validator von GitHub herunter und entpacken Sie das ZIP-Archiv in einen
lokalen Ordner, zum Beispiel C:\Validator.

Repository: itplr-kosit/validator
Wichtige Dateien liegen meist im Download-/Release-Paket
Start erfolgt je nach Paket über eine Batch-Datei oder ein JAR

Richtiges Szenario wählen

Für eine normale E-Rechnungs-XML wählen Sie das passende XML-Szenario, zum Beispiel
EN 16931 oder XRechnung CII.

EN 16931: für allgemeine E-Rechnungen / ZUGFeRD Factur-X
XRechnung: für deutsche öffentliche Auftraggeber
PEPPOL: wenn der Empfänger Peppol fordert

XML-Datei prüfen

Validieren Sie die aus dem Add-In erzeugte XML-Datei direkt im KoSIT Validator.
Die XML-Datei liegt typischerweise neben der PDF-Datei.

Beispiel:
Rechnung 26-039-130_En16931.xml

Wenn der Validator Fehler meldet, sind das in der Regel fachliche Pflichtfelder oder Profilregeln.

Wenn Sie das PDF prüfen möchten

Für eine PDF mit eingebetteter XML reicht der KoSIT Validator allein oft nicht aus.
In diesem Fall nutzen Sie zusätzlich ein Werkzeug, das das PDF entpackt und die XML extrahiert,
zum Beispiel Mustang CLI.

Typischer Ablauf:

PDF erzeugen
XML aus dem PDF extrahieren oder direkt die XML-Datei neben dem PDF prüfen
Mit dem KoSIT Validator das XML prüfen

Empfohlene Ordnerstruktur

C:\Validator\ – KoSIT Validator entpackt
C:\Validator\scenarios\ – Szenario-/Konfigurationsdateien
C:\Rechnungen\ – Ihre Testdateien
C:\Rechnungen\Rechnung 26-039-130_En16931.xml – zu prüfende XML

Kurzbefehle

Java prüfen:

java -version

Beispiel für die lokale Prüfung:

java -jar validator.jar -s <Szenario> -f <Datei.xml>

Der konkrete Startbefehl hängt von dem von Ihnen heruntergeladenen KoSIT-Paket ab.