Validierung & Fehler 8 Min. LesezeitVeröffentlicht am

ZUGFeRD-Fehler beheben: Profil, PDF/A und XML-Meldungen erklärt

ZUGFeRD-Fehler nach Kategorie: originale Meldungstexte von Mustang und veraPDF, Ursache und Lösung für Profil, PDF/A-3, Dateiname und XML-Regeln.

docutools.pro Editorial TeamRedaktion

Das Wichtigste in Kürze

  • ZUGFeRD-Fehler fallen in vier Gruppen: fehlende oder falsch benannte XML, XMP-Metadaten, PDF/A-3-Konformität und Regelverstöße in der XML.
  • Laut ZUGFeRD-FAQ des FeRD sind reine PDF/A-Fehler nur als Warnung zu beachten, solange die XML gültig ist und sich extrahieren lässt.
  • Pro PDF ist genau eine Rechnungs-XML zulässig, benannt factur-x.xml oder beim Profil XRECHNUNG xrechnung.xml.
  • BR-DE-Meldungen bei einer Datei im Profil EN 16931 sind kein Fehler der Rechnung: Jedes Profil wird mit seinem eigenen Regelwerk geprüft.
  • Korrigiert wird immer im Rechnungsprogramm, nie in der fertigen PDF, weil jede Nachbearbeitung Einbettung und PDF/A-Status gefährdet.
Inhalt

ZUGFeRD-Fehler entstehen an vier Stellen: Die Rechnungs-XML fehlt oder heißt falsch, die XMP-Metadaten passen nicht, das PDF ist nicht PDF/A-3-konform oder die XML verletzt Schema- und Geschäftsregeln ihres Profils. Entscheidend ist die XML. Reine PDF/A-Mängel sind laut FeRD nur Warnungen, Regelverstöße in der XML dagegen echte Fehler.

Dieser Beitrag ordnet die Meldungstexte, die Sie in Prüfberichten tatsächlich sehen, einer Ursache und einer Lösung zu. Wie eine vollständige Prüfung Schritt für Schritt abläuft, zeigt unser Beitrag ZUGFeRD validieren. Hier geht es um den Moment danach: Der Bericht ist rot, und Sie wollen wissen, was zu tun ist.

Welche Fehlermeldungen tauchen in ZUGFeRD-Prüfberichten auf?

Die beiden verbreiteten freien Prüfprogramme sind der Mustang-Validator (prüft PDF, XMP und XML) und veraPDF (prüft nur PDF/A). Ihre Meldungen sind englisch und knapp. Die folgenden Texte stammen aus dem Quellcode von Mustang und aus dem PDF/A-3b-Prüfprofil von veraPDF auf GitHub. Es sind Meldungsvorlagen, keine Ausgabe eines echten Prüflaufs:

Mustang:  XML data not found in rechnung.pdf: did you specify a pdf or xml file
          and does the xml file contain an embedded XML file?
Mustang:  XMP Metadata: DocumentFileName contains invalid value
Mustang:  XMP Metadata: ConformanceLevel contains invalid value
Mustang:  Not a PDF/A-3
Mustang:  Unsupported profile type urn:...
Mustang:  Factur-X/ZUGFeRD and Order-X are always strictly CII only, no UBL allowed.
Mustang:  No rules matched, XML too minimal?
veraPDF:  6.2.11.4.1-1  The font program is not embedded
veraPDF:  6.8-3  The file specification dictionary for an embedded file does not
          contain the AFRelationship key or it has invalid value type
veraPDF:  6.6.2.3.1-1  XMP property is either not predefined, or is not defined
          in any XMP extension schema

Mustang schreibt jede Meldung als Element error, warning oder notice mit einer Typnummer in den XML-Bericht, zum Beispiel type="19" für den Dateinamen. veraPDF nennt die Klausel der Norm ISO 19005-3 und die Testnummer.

Die vier Fehlergruppen im Überblick

GruppeTypische MeldungHäufigste UrsacheGewicht
1. XML fehlt oder heißt falsch„XML data not found“, „DocumentFileName contains invalid value“PDF nachträglich bearbeitet, falscher ExportnameFehler: ohne XML keine E-Rechnung
2. XMP-Metadaten„ConformanceLevel contains invalid value“, veraPDF 6.6.2.3.1-1Profil in den Metadaten fest hinterlegt, Erweiterungsschema fehltFehler in Mustang
3. PDF/A-3„Not a PDF/A-3“, veraPDF 6.2.11.4.1-1, 6.8-3Export ohne PDF/A-Einstellung, fremde Schriftenlaut FeRD Warnung, Empfänger kann Korrektur verlangen
4. XML-Schema und Geschäftsregeln„Unsupported profile type“, BR-CO-10, BR-CO-15falsches Profil in BT-24, Rundung, fehlende FelderFehler

Die Reihenfolge entspricht der Prüfreihenfolge: Fehlt die XML, laufen die übrigen Prüfungen ins Leere. Beheben Sie deshalb immer zuerst die Gruppe mit der kleinsten Nummer.

Gruppe 1: Die XML fehlt oder hat den falschen Namen

Meldung „XML data not found“

Mustang findet in der PDF keinen Anhang, den es als Rechnungs-XML erkennt. Die Ursachen, nach Häufigkeit:

  1. Die PDF wurde nach dem Erzeugen bearbeitet: zusammengefügt, gestempelt, geschwärzt oder über einen PDF-Drucker neu ausgegeben. Seitenbasierte Werkzeuge übernehmen nur die Seiten, nicht die Anhänge. Was dabei genau passiert, beschreibt der Beitrag ZUGFeRD-PDF zusammenfügen.
  2. Die Rechnung wurde gar nicht als ZUGFeRD exportiert, sondern als normale PDF. Das Rechnungsbild sieht identisch aus.
  3. Die XML ist eingebettet, aber unter einem Namen, den das Prüfprogramm nicht sucht.

Lösung: Erzeugen Sie die Datei im Rechnungsprogramm neu, mit der Exportoption für ZUGFeRD oder Factur-X. Als Empfänger fordern Sie die unbearbeitete Originaldatei an.

Meldung „DocumentFileName contains invalid value“

Mustang akzeptiert in den XMP-Metadaten nur diese Dateinamen: factur-x.xml, xrechnung.xml, zugferd-invoice.xml, ZUGFeRD-invoice.xml und order-x.xml. Hängt eine XML-Datei mit anderem Namen an, kommt zusätzlich der Hinweis „Potentially incorrectly named XML file attachments detected“.

Laut ZUGFeRD-FAQ des FeRD ist in der aktuellen Version pro PDF genau ein Rechnungsdatendokument zulässig, bezeichnet als factur-x.xml oder, beim Profil XRECHNUNG, xrechnung.xml. Die Namen zugferd-invoice.xml (ZUGFeRD 2.0) und ZUGFeRD-invoice.xml (ZUGFeRD 1.0) stammen aus älteren Versionen.

Lösung: Stellen Sie den Exportnamen im Programm um. Der Name muss an zwei Stellen übereinstimmen: als Dateiname des Anhangs und im XMP-Feld fx:DocumentFileName.

Gruppe 2: XMP-Metadaten passen nicht zur XML

Die XMP-Metadaten sind ein XML-Block im PDF, der Profil, Dateiname, Dokumenttyp und Version der eingebetteten Rechnung ausweist. Mustang meldet hier unter anderem:

MeldungBedeutungLösung
ConformanceLevel not found / contains invalid valueProfilangabe fehlt oder ist unbekannterlaubt sind MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED, XRECHNUNG (sowie ältere Werte wie COMFORT)
DocumentType not found / invalidDokumenttyp fehltINVOICE für Rechnungen
Version not found / contains invalid valueVersionsangabe fehltbei Factur-X-Namensraum 1.0
Could not parse XMP metadata (XML invalid)XMP-Block ist kein gültiges XMLErzeuger-Bibliothek aktualisieren

veraPDF meldet zusätzlich 6.6.2.3.1-1, wenn die Eigenschaften im Namensraum urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0# nicht in einem PDF/A-Erweiterungsschema beschrieben sind. Dieses Schema verlangt PDF/A für jede Eigenschaft außerhalb der vordefinierten Namensräume.

Ein häufiger Sonderfall: Die Metadaten sagen „EN 16931“, die XML trägt in BT-24 aber eine BASIC- oder XRECHNUNG-Kennung. Das passiert, wenn die XMP-Vorlage fest im Programm hinterlegt ist und das Profil später geändert wurde. Welche Kennung in BT-24 zu welchem Profil gehört, steht in der Tabelle im Beitrag ZUGFeRD-Profile und -Versionen.

Gruppe 3: Die PDF ist nicht PDF/A-3-konform

Mustang meldet „Not a PDF/A-3“, wenn veraPDF keine Konformität zu PDF/A-3 feststellt. Die Einzelursachen liefert veraPDF. Die fünf häufigsten Regeln aus dem Prüfprofil PDF/A-3b:

veraPDF-RegelMeldung (gekürzt)UrsacheLösung
6.2.11.4.1-1The font program is not embeddedSchrift wie Arial nur referenziertSchriften beim Export einbetten
6.2.4.3-2DeviceRGB colour space is used without RGB output intent profilekein OutputIntent mit ICC-ProfilPDF/A-Export mit sRGB-Profil
6.8-1MIME type of an embedded file is missing or invalidAnhang ohne SubtypeMIME-Typ setzen, für die XML etwa text/xml
6.8-3… does not contain the AFRelationship key …XML nicht als zugehörige Datei markiertAFRelationship setzen, etwa Alternative
6.6.4-2The "part" property … is %1 instead of 3Datei als PDF/A-1 oder PDF/A-2 ausgewiesenals PDF/A-3 erzeugen

Wie schwer wiegt das? Das FeRD zitiert in seiner ZUGFeRD-FAQ einen Hinweis aus der Spezifikation: Seit dem 01.01.2025 ist in Deutschland die eingebettete XML die Rechnung. Ist sie gültig und lässt sie sich extrahieren, handelt es sich um eine gültige E-Rechnung. Technische PDF/A-Fehler sind danach nur als Warnung zu beachten. Der Empfänger kann trotzdem eine korrigierte, PDF/A-konforme Fassung anfordern. Als Aussteller beheben Sie diese Fehler also, aber sie machen die Rechnung nicht wertlos.

Die Regel 6.8-3 ist dabei die gefährlichste: Fehlt die Verknüpfung, behandeln manche Eingangssysteme die XML als beliebigen Anhang und finden die Rechnung nicht.

Gruppe 4: Die XML verletzt Schema oder Geschäftsregeln

„Unsupported profile type“

Mustang kennt für ZUGFeRD 2.x eine feste Liste von Kennungen in BT-24, etwa urn:cen.eu:en16931:2017 für EN 16931. Steht dort etwas anderes, zum Beispiel ein Tippfehler oder eine Peppol-Kennung, meldet es „Unsupported profile type“ mit dem gefundenen Wert. Die XRECHNUNG-Kennung erkennt Mustang gesondert und prüft dann zusätzlich mit den Regeln der KoSIT.

Lösung: Profil im Programm richtig wählen. Wählen Sie für steuerliche Zwecke nicht MINIMUM oder BASIC WL: Laut FeRD werden ZUGFeRD-Dateien erst ab Version 2.0.1 und ohne diese beiden Profile als E-Rechnung anerkannt. Die Einzelheiten zu BASIC WL stehen im Beitrag ZUGFeRD BASIC WL.

„strictly CII only, no UBL allowed“

Eine ZUGFeRD-PDF darf nur eine XML in der Syntax UN/CEFACT CII enthalten. Steckt eine UBL-Rechnung im PDF, lehnt Mustang ab. Für eine UBL-XRechnung gibt es kein hybrides Format: Sie wird als reine XML-Datei versendet.

Regelverstöße der EN 16931

Hier landen Rechenfehler und fehlende Pflichtfelder. Die Meldung enthält die Regel-ID und den offiziellen Regeltext, zum Beispiel:

RegelOffizieller Text (EN 16931, gekürzt)Typische Ursache
BR-CO-10Sum of Invoice line net amount (BT-106) = Σ Invoice line net amount (BT-131)Summe aus ungerundeten Positionen gebildet
BR-CO-15Invoice total amount with VAT (BT-112) = BT-109 + BT-110Brutto aus anderer Rundung berechnet
BR-CO-26Seller identifier (BT-29), BT-30 and/or Seller VAT identifier (BT-31) shall be presentweder USt-IdNr. noch Kennung des Verkäufers

Details und Korrekturwege zu den Summenregeln finden Sie unter BR-CO-10 und in unserer Übersicht der XRechnung Fehlercodes. Wie Rundungsdifferenzen entstehen, erklärt der Beitrag zu den häufigsten XRechnung-Fehlern. Die EN-16931-Regeln sind für ZUGFeRD und XRechnung identisch.

BR-DE-Meldungen bei einer Datei im Profil EN 16931

Das ist der häufigste Fehlalarm. Mustang prüft Dateien in den Profilen BASIC und EN 16931 zusätzlich gegen die XRechnung-Regeln, stuft die Treffer aber nur als notice ein. Mit der Option --no-notices blendet es sie aus. Das FeRD stellt in seiner FAQ klar: Eine gültige Rechnung im Profil EN 16931 oder EXTENDED kann bei einer Prüfung nur nach XRechnung-Regeln Fehler erzeugen, ohne dass sie fehlerhaft oder unzulässig ist. Jedes Format wird mit seinem eigenen Regelwerk geprüft.

Relevant werden BR-DE-Regeln nur, wenn Ihr Kunde ausdrücklich eine XRechnung verlangt, etwa eine Behörde. Dann brauchen Sie das Profil XRECHNUNG oder eine reine XRechnung.

Ist jeder Prüffehler steuerlich ein Problem?

Nein. Das BMF unterscheidet Formatfehler, Geschäftsregelfehler und Inhaltsfehler mit unterschiedlichen Folgen für den Status als E-Rechnung und für den Vorsteuerabzug. Die Zuordnung mit Beispielen und Entscheidungstabelle steht im Beitrag Formatfehler oder Inhaltsfehler. Für ZUGFeRD lässt sich daraus ableiten: Fehlt die XML oder ist sie syntaktisch kaputt, liegt keine E-Rechnung vor. PDF/A-Mängel bei intakter XML bewertet das FeRD als Warnung.

So vermeiden Sie ZUGFeRD-Fehler an der Quelle

MaßnahmeVerhindert
Profil EN 16931 als Standard einstellen, XRECHNUNG nur für Behörden„Unsupported profile type“, Fehlalarme durch BR-DE
Exportname factur-x.xml bzw. xrechnung.xml prüfen„DocumentFileName contains invalid value“
PDF/A-3-Export mit eingebetteten Schriften und sRGB-ProfilveraPDF 6.2.11.4.1-1 und 6.2.4.3-2
Fertige Rechnungs-PDFs nie nachbearbeiten„XML data not found“
Summen aus gerundeten Positionsbeträgen bildenBR-CO-10, BR-CO-15
Nach jedem Software-Update eine Testrechnung prüfenneue Fehler durch geänderte Bibliotheken

Für den letzten Punkt lohnt ein eigener Testablauf, wie ihn der Beitrag E-Rechnung testen beschreibt. Den aktuellen Stand der Prüfprogramme sollten Sie dabei mitprüfen: Laut Changelog des Projekts ist Mustang 2.27.0 vom 09.10.2026 die neueste Version und nutzt die XRechnung-Schematron-Version 2.6.

So prüfen Sie eine ZUGFeRD-Rechnung mit docutools.pro

  1. Öffnen Sie das Werkzeug zum ZUGFeRD-XML extrahieren und klicken Sie auf „PDF auswählen“. Die PDF wird in Ihrem Browser verarbeitet. Erscheint „E-Rechnungs-XML gefunden“ mit dem Namen unter „Anhang“, ist Gruppe 1 erledigt. Unter „Weitere Anhänge in dieser PDF“ sehen Sie zusätzliche Dateien.
  2. Laden Sie die XML mit „XML herunterladen“ herunter und prüfen Sie im Tab „XML-Quelltext“ die Kennung in BT-24.
  3. Laden Sie die XML in den ZUGFeRD-Validator hoch. Die Datei wird zur Prüfung an unseren Server übertragen. Die „KoSIT-Prüfung“ läuft wie beim KoSIT-Validator (Konfiguration 2026-08-31): Das Profil EN 16931 wird nur mit den EN-16931-Regeln geprüft, das Profil XRECHNUNG zusätzlich mit den BR-DE-Regeln. Für BASIC, EXTENDED, MINIMUM und BASIC WL gibt es dort kein Prüfszenario, die Datei wird ohne Regelprüfung abgewiesen. Diese Profile prüfen Sie mit Mustang.
  4. Lesen Sie das Ergebnis: „KoSIT-konform“ oder „Nicht KoSIT-konform“ mit den Regel-IDs. Im kostenlosen Tarif sind 2 Uploads pro Tag bis 500 KB möglich, unbegrenzte Uploads gibt es im Pro-Tarif.

PDF/A-3 und XMP prüfen weder Extraktor noch Viewer. Dafür nutzen Sie veraPDF oder Mustang. Weitere Anleitungen finden Sie in der Kategorie Validierung und Fehler.

Quellen

Stand: November 2026

Dieser Beitrag dient der allgemeinen Information und ersetzt keine Steuer- oder Rechtsberatung.

Schlagwörter:ZUGFeRDValidierungPDF/A-3MustangveraPDF

Tools zu diesem Artikel

Häufige Fragen

Ist eine ZUGFeRD-Rechnung mit PDF/A-Fehlern ungültig?

Nicht automatisch. Das FeRD schreibt in seiner ZUGFeRD-FAQ, dass eine Rechnung gültig ist, wenn die eingebettete XML alle für Deutschland geltenden Geschäftsregeln erfüllt und sich aus dem PDF extrahieren lässt. Technische PDF/A-Fehler sind danach nur als Warnung zu beachten. Der Empfänger kann aber eine korrigierte, PDF/A-konforme Fassung anfordern, deshalb sollten Aussteller sie trotzdem beheben.

Warum findet mein Programm keine XML in der ZUGFeRD-PDF?

Meist wurde die PDF nach dem Erzeugen bearbeitet, über einen PDF-Drucker neu ausgegeben oder mit anderen Dateien zusammengefügt. Dabei geht der eingebettete Anhang verloren. Seltener heißt der Anhang anders als vorgesehen, etwa invoice.xml statt factur-x.xml. Prüfen Sie die Originaldatei des Absenders und fordern Sie im Zweifel eine neue, unbearbeitete PDF an.

Welche Meldung bekomme ich bei ZUGFeRD 1.0?

Das hängt vom Prüfprogramm ab. Der Mustang-Validator erkennt ZUGFeRD 1.0 am Wurzelelement CrossIndustryDocument und prüft gegen das alte Schema. Steuerlich ist die Version nicht mehr ausreichend: Laut FeRD werden ZUGFeRD-Dateien erst ab Version 2.0.1 als E-Rechnung anerkannt, ohne die Profile MINIMUM und BASIC WL. Fordern Sie beim Absender eine Rechnung in einer aktuellen Version an.

Darf eine ZUGFeRD-PDF mehrere XML-Anhänge enthalten?

Nur eine Rechnungs-XML. Laut ZUGFeRD-FAQ des FeRD ist pro PDF/A-3-Dokument genau ein Rechnungsdatendokument zulässig, benannt factur-x.xml oder xrechnung.xml. Weitere Anhänge wie Lieferscheine oder Zeitnachweise dürfen zusätzlich im PDF stecken. In den Profilen EN 16931 und EXTENDED können solche Unterlagen außerdem Base64-codiert in der XML selbst mitgeschickt werden.

Muss ich eine ZUGFeRD-Rechnung vor dem Versand validieren?

Eine gesetzliche Pflicht gibt es nicht. Das FeRD verweist aber auf die FAQ des Bundesfinanzministeriums, die eine Validierung schon bei Erstellung und Versand empfiehlt. Wer sorgfältig validiert, darf sich laut FeRD-Zitat aus dem BMF-Schreiben vom 15.10.2025 auf das technische Ergebnis verlassen und sollte den Prüfbericht als Nachweis aufbewahren.

ThemenseiteMehr zu Validierung & FehlerE-Rechnungen gegen die KoSIT-Regeln prüfen und Validierungsfehler verstehen und beheben, mit konkreten Lösungen je Regel.