Wurde Ihre JTL-Wawi ZUGFeRD-Rechnung mit der Fehlermeldung „XMP Metadata: Version contains invalid value“ / „Invalid XMP Metadata not found“ von einem Geschäftspartner oder einem Validator abgewiesen?
Gerade seit Einführung der E-Rechnungspflicht 2025 ist dieser Fehler für viele JTL-Nutzer ein echtes Ärgernis. Er bedeutet meist, dass die Rechnung zwar optisch korrekt aussieht, aber technisch nicht den strengen Normen für den automatisierten Empfang entspricht. Die gute Nachricht: Sie müssen dafür weder ein riskantes JTL-Wawi Update durchführen noch mühsam Ihre Rechnungsvorlagen auf Version 2.0 umstellen.
Was steckt hinter der Fehlermeldung?
Wer E-Rechnungen im ZUGFeRD- oder Factur-X-Format versendet, muss exakte technische Standards einhalten. Die Meldung „XMP Metadata: Version contains invalid value“ ist ein häufiger Stolperstein bei der Prüfung durch den KOSIT-Validator oder Systeme wie DATEV und SAP.
Was kompliziert klingt, ist meist ein Abstimmungsproblem: Die Informationen in der „Hülle“ (dem PDF) passen nicht exakt zu den eingebetteten Rechnungsdaten (dem XML).
Warum ist dieser Fehler bei ZUGFeRD-Rechnungen kritisch?
Eine valide E-Rechnung besteht aus zwei untrennbaren Teilen:
- Dem sichtbaren PDF/A-3.
- Der eingebetteten factur-x.xml.
Damit das Empfängersystem die Rechnung automatisch einlesen kann, müssen in den sogenannten XMP-Metadaten des PDFs exakte Informationen über die verwendete Version stehen. Meldet der Validator einen Fehler, „glaubt“ er dem PDF nicht, welche ZUGFeRD-Version enthalten ist. Das Ergebnis: Die Rechnung gilt als invalide und wird im Zweifel nicht bezahlt – selbst wenn die XML-Datei intern fehlerfrei ist.
Die 3 häufigsten Ursachen in der Praxis
- Veraltete Versions-Präfixe: Ältere ZUGFeRD 1.0-Versionen nutzen oft das Präfix
zf:. Moderne Standards (ab ZUGFeRD 2.x) verlangen jedoch das Präfixfx:(Factur-X). - Widerspruch zur Spezifikation: Ein bekannter Bug in vielen ERP-Exporten schreibt den Wert
2p0(für Version 2.0) in die Metadaten, obwohl der Validator strikt den Wert1.0(für das Schema) oder exakt2.0erwartet. - Fehlendes Extension Schema: Ohne ein korrekt definiertes „Extension Schema“ im PDF-Header erkennt der Reader die ZUGFeRD-Felder nicht an und markiert jeden Wert als „ungültig“.
Typische Fehlermeldungen aus dem ValiTool
In der Praxis liefert das ValiTool bei Unstimmigkeiten zwischen den PDF-Metadaten und der eingebetteten XML-Datei genau die folgenden konkreten Warnungen und Fehler:
Warnung: [VD-Valitool-H-024] - Der Wert der im PDF angegebenen Version des hybriden Dokuments passt nicht zur Version des XML-Formates XRechnung 3.0.2 CII.
Warnung: [VD-Valitool-H-025] - Der Wert der im PDF angegebenen Version des hybriden Dokuments soll >>3.0<< sein. Angegeben ist .
Error: [VD-Valitool-H-023] - Der Wert der im PDF angegebenen Version des hybriden Dokuments ist ungültig.
Was bedeuten diese ValiTool-Meldungen genau?
[VD-Valitool-H-025]&[VD-Valitool-H-023]: Das ValiTool liest die XMP-Metadaten der PDF-Datei aus und erwartet dort eine explizite Versionsangabe (bei XRechnung 3.0.2 beispielsweise exakt den Wert3.0). Ist dieses Feld im PDF leer (Angegeben ist .) oder fehlerhaft formatiert, bricht die Validierung mit dem Error[VD-Valitool-H-023]ab.[VD-Valitool-H-024]: Das Prüftool gleicht den Wert im PDF-Header mit der tatsächlich eingebetteten XML-Datei (z. B.xrechnung.xml/factur-x.xml) ab. Wenn im XML der Standard XRechnung 3.0.2 genutzt wird, das PDF aber keine oder eine abweichende Version ausweist, schlägt dieser Abgleich fehl.
Das Ergebnis: Obwohl die eingebettete XML-Datei fachlich und strukturell völlig korrekt sein kann, wird das Rechnungs-PDF aufgrund der fehlenden oder falschen XMP-Metadaten im ValiTool als invalide eingestuft.
Die Lösung: hph.JTL.ZUGFeRD Addon
Statt Zeit und Nerven in die manuelle Anpassung von Vorlagen zu investieren oder auf komplexe Core-Updates der JTL-Wawi zu warten, bietet unser Addon hph.JTL.ZUGFeRD eine sofortige Lösung:
- Korrekte Einbettung: Wir sorgen für die technisch saubere Integration der
factur-x.xmlin Ihr Rechnungs-PDF. - Validierungssicher: Alle XMP-Metadaten werden normkonform gesetzt, sodass Fehler wie „invalid value“ der Vergangenheit angehören.
- Minimaler Aufwand: Kein Update der JTL-Wawi oder der Rechnungsvorlage auf Version 2.0 nötig.
Fazit: Saubere Metadaten sind Pflicht
In der modernen B2B-Welt ist die E-Rechnung kein „Nice-to-have“ mehr. Automatisierte Buchhaltungssysteme verweigern bei Metadaten-Fehlern konsequent die Annahme.
Sorgen Sie für einen reibungslosen Rechnungsprozess und zufriedene Geschäftspartner. Mit unserem Addon für die JTL-Wawi sind Sie auf der sicheren Seite.
Möchten Sie Ihre JTL-Wawi sofort E-Rechnungs-konform machen? Nutzen Sie noch heute unser hph.JTL.ZUGFeRD Addon!