↓ Zum Hauptinhalt springen
csv2zugferd

docs

ZUGFeRD Rechnung validieren – kostenlose Prüf-Tools

ZUGFeRD-Dateien kostenlos validieren: Mustang-CLI lokal ohne Upload, ELSTER E-Rechnungsportal und e-rechnungs-checker.de prüfen die erzeugte XML-Datei auf Konformität.

csv2zugferd erzeugt die ZUGFeRD-XML-Datei und bettet sie in die PDF/A-3-Ausgabe ein. Die fachliche und technische Prüfung liegt beim Anwender. Drei kostenlose Validierungs-Tools erleichtern diesen Schritt: eines läuft lokal ohne Upload, zwei im Browser.

Mustang-CLI (lokal, ohne Upload)
#

Das Mustang-CLI des Open-Source-Projekts Mustangproject prüft ZUGFeRD-, Factur-X- und XRechnung-Dateien vollständig lokal: XML-Schema, EN-16931-Schematron und XRechnung-Regeln. Für PDF/A-3-Dateien wird zusätzlich die PDF/A-Konformität mit veraPDF geprüft. Rechnungsdaten verlassen den Rechner nicht. Voraussetzung ist Java 17 oder neuer.

java -Xmx1G -Dfile.encoding=UTF-8 -jar Mustang-CLI-2.26.0.jar --no-notices --action validate --source output\DEMO-2026-0001.pdf

Die Ausgabe ist ein XML-Bericht mit <summary status="valid"/> oder status="invalid" und den verletzten Regeln. Der Exit-Code ist 0 bei gültiger Datei, damit lässt sich die Prüfung in Skripte und Batch-Läufe einbauen.

Die Testsuite von csv2zugferd validiert alle mitgelieferten Beispielkonfigurationen mit genau diesem Werkzeug. Die Demo-Rechnungen und die Testdaten bestehen die Prüfung im Profil Extended.

Hinweis vor dem Hochladen
#

Rechnungen enthalten typischerweise sensible Geschäftsdaten: Empfängername und -adresse, Leistungsbeschreibung, Beträge und Steuernummern. Vor dem Hochladen einer echten Rechnung:

  • Datenschutzerklärung und Nutzungsbedingungen des jeweiligen Dienstes prüfen.
  • Für erste Tests eine Rechnung mit fiktiven Testdaten verwenden, keine Produktivdaten.
  • Interne Richtlinien zum Umgang mit Rechnungsdaten beachten.

ELSTER E-Rechnungsportal
#

Das E-Rechnungsportal der Finanzverwaltung nimmt ZUGFeRD- und XRechnung-Dateien entgegen und prüft sie auf strukturelle Konformität.

E-Rechnungsportal auf elster.de öffnen →

Geeignet für: ZUGFeRD 2.x, XRechnung — keine Anmeldung für die Prüffunktion erforderlich.

e-rechnungs-checker.de
#

Ein schneller Online-Validator für strukturierte Rechnungsformate. Lädt die XML- oder PDF/A-3-Datei hoch und zeigt Konformitätsfehler im Detail an.

e-rechnungs-checker.de öffnen →

Was die Tools prüfen
#

Alle drei Werkzeuge prüfen die strukturelle Konformität der XML-Daten gegen die ZUGFeRD- bzw. EN-16931-Spezifikation:

  • Pflichtfelder vorhanden und korrekt befüllt
  • Feldformate (Datum, Betrag, Steuersatz)
  • Namespace und Schema-Version
  • bei PDF/A-3: korrekte Einbettung des XML-Anhangs

Was sie nicht prüfen: inhaltliche oder steuerliche Richtigkeit der Rechnungsdaten — das liegt beim Anwender.

Empfohlener Ablauf
#

  1. csv2zugferd erzeugt die Ausgabedatei (PDF/A-3 oder XML).
  2. Ausgabedatei lokal mit Mustang-CLI prüfen oder im ELSTER-Portal bzw. auf e-rechnungs-checker.de hochladen.
  3. Konformitätsfehler beheben — meist im YAML-Mapping oder in den CSV-Quelldaten.
  4. Erst nach erfolgreicher Prüfung produktiv einsetzen. Für wiederkehrende Läufe eignet sich Mustang-CLI, weil es sich per Exit-Code in Skripte einbinden lässt.

Haftungsausschluss
#

Eine fehlerfreie Validierung bestätigt die strukturelle Konformität der Datei — nicht die steuerliche oder rechtliche Richtigkeit der Rechnungsdaten. csv2zugferd wird ohne Gewähr bereitgestellt.

Für die inhaltliche Richtigkeit, Vollständigkeit und steuerliche Bewertung der Rechnungsdaten bleibt der Anwender verantwortlich. Eine strukturell konforme ZUGFeRD-Datei ist keine Garantie dafür, dass die ausgewiesenen Beträge, Steuersätze oder Empfängerdaten korrekt sind. Das Tool ersetzt keine steuerliche, rechtliche oder fachliche Beratung. Weitere Angaben finden Sie im Impressum und in der Datenschutzerklärung.