Was ist ein ZUGFeRD-PDF und warum schlägt die Validierung fehl?
Das ZUGFeRD-Format (Zentraler User Guide Forum elektronische Rechnung Deutschland) ist ein Standard für elektronische Rechnungen. Es handelt sich um ein Hybrid-Format: Für den Menschen gibt es die sichtbare PDF-Rechnung, für Maschinen ist eine strukturierte XML-Datei unsichtbar im PDF eingebettet. Schlägt die Validierung (z. B. beim Finanzamt oder im ERP-System des Kunden) fehl, bedeutet das, dass entweder die Container-Datei (das PDF selbst) oder der Inhalt (die XML) die strengen gesetzlichen Spezifikationen verletzt.
Die häufigsten Ursachen im Detail
1. Fehlende PDF/A-3-Konformität
Ein ZUGFeRD-Dokument darf kein normales PDF sein. Es muss zwingend im Format PDF/A-3 (meist PDF/A-3b oder PDF/A-3u) gespeichert werden. Dieses Format ist für die Langzeitarchivierung optimiert und erlaubt es als einziges, externe Dateien (wie die XML) einzubetten. Wenn Schriften nicht eingebettet sind oder transparente Elemente genutzt werden, schlägt die PDF/A-3-Validierung fehl.
2. Fehlerhafter XML-Dateiname und Einbettung
Die Spezifikation schreibt exakt vor, wie die eingebettete XML-Datei heißen muss. Bei ZUGFeRD 2.x muss der Name exakt factur-x.xml lauten (bei älteren ZUGFeRD 1.0 Versionen hieß sie zugferd-invoice.xml). Zudem muss der XML-Anhang im PDF-Container als "Alternative" (Relationship-Typ: Alternative) deklariert sein, damit automatisierte Systeme sie als Rechnungsdaten erkennen.
3. Falsche XML-Struktur & Fehlerhafte Namespaces
Die XML-Struktur muss dem europäischen Standard EN 16931 entsprechen. Häufige Fehler sind:
- Falsche Namespaces: Die URLs im Kopf der XML (z. B.
xmlns:ram="..."oderxmlns:rsm="...") haben Tippfehler oder passen nicht zur verwendeten ZUGFeRD-Version. - Ungültige IDs: Umsatzsteuer-Identifikationsnummern (USt-IdNr.) oder Leitwege IDs entsprechen nicht dem geforderten Schema oder sind fehlerhaft formatiert.
4. Berechnungs- und Rundungsfehler
Die XML-Datei verzeiht keine Cent-Abweichungen. Die Summe der Einzelpositionen (Netto + Steuer) muss rechnerisch absolut exakt mit den Gesamtsummen im XML-Header übereinstimmen. Schon Rundungsdifferenzen ab der dritten Nachkommastelle führen zur Ungültigkeit.
🛠️ Checkliste zur Fehlerbehebung
- Validierungs-Tools nutzen: Nutze kostenfreie Prüftools (wie den VeraPDF-Validator für das PDF/A-3-Format oder den Kosit-Validator für die XML-Struktur), um den genauen Fehlercode auszulesen.
- PDF-Bibliothek prüfen: Wenn du die PDF per PHP generierst (z. B. mit TCPDF oder FPDF), stelle sicher, dass der PDF/A-3-Modus explizit aktiviert ist und alle verwendeten Schriften (TrueType) vollständig eingebettet werden.
- Profil abgleichen: Prüfe, welches ZUGFeRD-Profil genutzt wird (z. B.
MINIMUM,BASIC,EN 16931 / COMFORToderEXTENDED). Die XML-Struktur muss exakt zum deklarierten Profil passen.
💡 Gut zu wissen (ZUGFeRD & Factur-X):
Seit der Version ZUGFeRD 2.0 ist das deutsche Format vollständig identisch mit dem französischen Standard Factur-X. Beide basieren auf derselben technischen Spezifikation, weshalb die XML-Datei im PDF standardmäßig auch als factur-x.xml benannt wird.