Invoir
  1. Start
  2. Ratgeber
  3. ZUGFeRD validieren

ZUGFeRD validieren und die typischen Fehler beheben

Eine hybride Rechnung kann am PDF scheitern, an den Metadaten, die PDF und XML verbinden, oder am XML selbst. Der kostenlose Validator prüft alles in einem Durchgang und zeigt, welche Ebene gescheitert ist. Hier steht, was jede Ebene prüft und wie Sie die Fehler beheben.

Stand 19. Oktober 2026

Die vier Prüfebenen

EbenePrüftWerkzeug
1. PDF/A-3Das PDF entspricht ISO 19005-3veraPDF
2. Hybrid-MetadatenXMP beschreibt die ZUGFeRD-Daten; der Anhang ist da, mit richtigem Namen und richtiger BeziehungMustang
3. XML-SchemaDas XML entspricht dem XSD seines ProfilsMustang
4. GeschäftsregelnSchematron des Profils, einschließlich der EN-16931-RegelnMustang
 
curl https://validate.invoir.dev/api/v1/validate \
  -H "Authorization: Bearer inv_IHR_KEY" \
  -F [email protected]

Der JSON-Bericht hat einen Eintrag pro Ebene, in dieser Reihenfolge, jeweils mit den Befunden (API-Doku, Englisch). Dateien werden im Arbeitsspeicher verarbeitet und nie gespeichert.

PDF/A-3-Fehler

Die Datei ist gar kein PDF/A-3
Ein normales PDF oder PDF/A-1 bzw. PDF/A-2 (die keine beliebigen eingebetteten Dateien erlauben). Das XMP muss pdfaid:part 3 angeben, und die Datei muss tatsächlich konform sein. Die meisten PDF-Bibliotheken brauchen dafür einen ausdrücklichen PDF/A-3-Modus.
Schriften nicht eingebettet
Der häufigste PDF/A-Fehler. Jede Schrift muss eingebettet sein, auch Helvetica oder Arial, die viele Bibliotheken standardmäßig verwenden. Nutzen Sie im Template eine eingebettete TrueType- oder OpenType-Schrift.
Kein Output Intent
PDF/A verlangt einen Output Intent mit ICC-Farbprofil (meist sRGB), sobald Gerätefarben verwendet werden.
Verbotene Funktionen
Verschlüsselung, JavaScript, externe Inhalte und manche Transparenzeinstellungen sind in PDF/A nicht erlaubt.

Fehler in Metadaten und Anhang

Kein Erweiterungsschema für Factur-X im XMP
PDF/A verlangt, dass eigene XMP-Eigenschaften beschrieben werden. Die Factur-X-Eigenschaften (Dokumenttyp INVOICE, Dateiname, Version, Profil) brauchen ihren Block mit dem Erweiterungsschema.
Profil passt nicht zum XML
Im XMP steht EN 16931, die Kennung im XML sagt BASIC, oder umgekehrt. Schreiben Sie beides aus derselben Einstellung.
Falscher Dateiname des Anhangs
Aktuelle Versionen erwarten factur-x.xml (und xrechnung.xml im Profil XRECHNUNG); ZUGFeRD 2.0 nutzte zugferd-invoice.xml. Der Name im XMP muss zum Anhang passen.
Anhang nicht verknüpft
PDF/A-3 verlangt, dass das eingebettete XML als zugehörige Datei des Dokuments eingetragen ist, mit AFRelationship und MIME-Typ (text/xml).

XML-Fehler

Schemafehler im Profil
Jedes Profil hat ein eigenes XSD. Ein Element, das in EN 16931 erlaubt ist, kann in BASIC oder BASIC WL verboten sein. Geben Sie das Profil an, das zu den geschriebenen Daten passt.
CII-Details
Datum als <udt:DateTimeString format="102">20261019</udt:DateTimeString>; Elemente in der Reihenfolge des Schemas; die Namensräume rsm, ram, udt und qdt der aktuellen CII-Version.
Geschäftsregeln der EN 16931
Meist Summen und Steuer: BR-CO-15, BR-CO-13, BR-CO-17, BR-S-08; dazu die Identifikation: BR-S-02 (USt-IdNr. des Verkäufers), BR-CO-26. Lösungen auf der Seite EN 16931 (Englisch) und unter XRechnung validieren.

Was kein Validator prüft

Das XML in einem PDF zeigt der Viewer für eingebettetes XML, per API POST /api/v1/extract. Hintergrund zum Format: ZUGFeRD erklärt.

Datei im Browser prüfen – oder per API. Der kostenlose Validator prüft nach den offiziellen Regeln (KoSIT, CEN- und Peppol-Schematron, Mustang, veraPDF) und nennt jeden Fehler mit Regel-ID. Es wird nichts gespeichert. Dieselbe Prüfung gibt es als einen HTTP-Aufruf mit kostenlosem API-Key: 25 Dokumente im Monat, ohne Kreditkarte.

Zum kostenlosen Validator Kostenlosen API-Key holen

Quellen

Weitere Ratgeber