Praxis

ZUGFeRD validieren: Kostenlose Tools und häufige Fehler

Letzte Aktualisierung: 1. Mai 2026

Kurzfassung: Eine ZUGFeRD-Datei kann optisch korrekt aussehen, aber ein ungültiges eingebettetes XML enthalten. Validatoren prüfen das maschinell — und das solltest du vor dem Versand tun, besonders wenn du die Datei selbst erzeugst.

Warum Validierung wichtig ist

Eine ZUGFeRD-Rechnung ist eine PDF-Datei mit einem unsichtbar eingebetteten XML-Dokument. Die PDF-Seite kann tadellos aussehen — der XML-Anteil kann trotzdem fehlerhafte oder fehlende Pflichtfelder enthalten.

Das Problem: Buchhaltungssoftware beim Empfänger verarbeitet das XML automatisch. Enthält es Fehler, bricht die Verarbeitung ab oder liefert falsche Werte. Im schlimmsten Fall verbucht der Empfänger falsche Beträge oder die Rechnung wird gar nicht erkannt.

Validierung ist deshalb besonders wichtig, wenn du ZUGFeRD-Dateien programmatisch erzeugst oder eine neue Software zum ersten Mal nutzt.

Was prüft ein Validator?

Ein vollständiger ZUGFeRD-Validator prüft mehrere Ebenen:

XML-Wohlgeformtheit: Ist das XML syntaktisch korrekt? Sind alle Tags geschlossen?
Schema-Konformität: Entspricht das XML dem UN/CEFACT-Schema, auf dem ZUGFeRD basiert?
EN-16931-Regeln: Sind alle Pflichtfelder der EU-Norm vorhanden und korrekt befüllt?
Geschäftsregeln: Stimmen Berechnungen? Ist das Profil korrekt angegeben?

Kostenlose Validatoren im Überblick

Tool	Was wird geprüft	Besonderheit
Mustangproject Validator	ZUGFeRD 1.x, 2.x, Factur-X, XRechnung	Open Source (Java), auch als CLI nutzbar
FeRD-Validierungsservice	ZUGFeRD 2.x, EN 16931	Online, keine Registrierung, vom Forum e-Rechnung DE
Ecosio E-Rechnung-Validator	ZUGFeRD, XRechnung, Factur-X	Online, detaillierte Fehlerberichte
KoSIT-Validator	XRechnung (auch ZUGFeRD mit Plug-in)	Referenz-Validator für Deutschland, Open Source
X-Ray-Viewer (diese Seite)	ZUGFeRD 1.x und 2.x Inhalte anzeigen	Zeigt Felder, kein vollständiger Schema-Validator

Empfehlung für Entwickler: Der Mustangproject-Validator lässt sich als Java-CLI oder Maven-Abhängigkeit einbinden — ideal für automatisierte Tests in der CI/CD-Pipeline.

Den X-Ray-Viewer zur Inhaltsprüfung nutzen

Der X-Ray-Viewer auf dieser Seite ist kein vollständiger Validator — er extrahiert und zeigt die Inhalte des eingebetteten XML. Das ist nützlich, um schnell zu prüfen:

Ist überhaupt ein XML eingebettet?
Sind Rechnungsnummer, Datum, Beträge korrekt?
Welches ZUGFeRD-Profil ist angegeben?
Ist die IBAN vorhanden?

Für eine vollständige Schema-Validierung vor dem Produktiveinsatz solltest du zusätzlich einen der oben genannten Validatoren nutzen.

Häufige Fehler in ZUGFeRD-Dateien

Falsches Profil angegeben: Die Datei enthält Felder des EXTENDED-Profils, im XML-Header steht aber "BASIC". Führt zu Validierungsfehlern.
Fehlende Pflichtfelder: Zum Beispiel kein Fälligkeitsdatum oder keine Steuernummer/USt-IdNr.
Falsches Datumsformat: Datumsfelder müssen im Format YYYYMMDD vorliegen, nicht DD.MM.YYYY.
Falsche Zeichenkodierung: Umlaute in Firmennamen, die nicht UTF-8-kodiert sind, führen zu ungültigem XML.
Betrag-Rundungsfehler: Summen müssen exakt zur Summe der Positionen passen — Cent-Differenzen durch Floating-Point-Rechnung.
Leere eingebettete Datei: Die PDF enthält einen Anhang namens "factur-x.xml", aber die Datei ist leer oder nicht vorhanden.

Häufige Fragen

Muss ich jede Rechnung validieren?
Wenn du dieselbe Software für alle Rechnungen nutzt und sie einmal erfolgreich validiert hast, reicht regelmäßiges Stichproben-Prüfen. Bei programmatisch erzeugten Rechnungen solltest du einen Validator in den Build-Prozess integrieren.

Reicht es, die XML-Datei mit einem Text-Editor zu öffnen?
Nein. Ein Text-Editor zeigt syntaktische Fehler, prüft aber nicht die Geschäftsregeln der EN-16931-Norm. Du kannst falsche oder fehlende Werte mit bloßem Auge nicht erkennen.

Weiterführend: ZUGFeRD X-Ray-Viewer · Was ist ZUGFeRD?