ZUGFeRD Ratgeber
ZUGFeRD Schemavalidierung: Fehler verstehen und lösen
Die ZUGFeRD Schemavalidierung prüft, ob Ihre E-Rechnungen dem Standard entsprechen. Doch was tun, wenn Validierungsfehler auftreten? In diesem Guide finden Sie konkrete Lösungen für typische Fehler und optimieren Ihre Rechnungsprozesse.
Ein häufiger Fehler bei der ZUGFeRD Schemavalidierung ist eine fehlerhafte XML-Struktur. Prüfen Sie, ob alle Pflichtfelder gemäß EN 16931 enthalten sind. Ein Validator mit den Schematron-Regeln der EN 16931 liefert detaillierte Fehlermeldungen. Achten Sie darauf, dass die XML-Datei korrekt in das PDF/A-3 eingebettet ist – als factur-x.xml (bei ZUGFeRD 2.0 zugferd-invoice.xml, im Profil XRECHNUNG xrechnung.xml) mit dem MIME-Typ text/xml, dem passenden AFRelationship-Eintrag und den Factur-X-XMP-Metadaten – und dass die XML-Daten den vorgegebenen XSD-Schemas entsprechen. Fehler bei Encoding (UTF-8) oder Datumsformaten (in der CII-Syntax JJJJMMTT mit format="102") können ebenfalls die Validierung scheitern lassen.
Häufige Fragen
Was bedeutet ein XSD-Schema-Fehler bei ZUGFeRD?
Ein XSD-Schema-Fehler weist darauf hin, dass Ihre XML-Datei nicht den Vorgaben des ZUGFeRD-Standards entspricht. Überprüfen Sie, ob das XML-Tagging korrekt ist und ob alle Pflichtfelder gemäß dem Profil (z. B. BASIC, EN 16931) enthalten sind. Tools wie xmllint oder Online-Validatoren können helfen.
Wie behebe ich Fehler bei der XML-Encoding-Validierung?
Stellen Sie sicher, dass Ihre XML-Datei im UTF-8-Format codiert ist. Prüfen Sie außerdem, ob keine ungültigen Sonderzeichen oder Leerzeichen enthalten sind. In den meisten Editoren wie Notepad++ oder VS Code können Sie das Encoding explizit auf UTF-8 setzen.
Welche Pflichtfelder sind für EN 16931 relevant?
Pflichtfelder umfassen u. a. Rechnungsnummer (BT-1, rsm:ExchangedDocument/ram:ID), Rechnungsdatum (BT-2, ram:IssueDateTime/udt:DateTimeString), Dokumenttyp (BT-3, ram:TypeCode), Währung (BT-5, ram:InvoiceCurrencyCode), Verkäufer (BG-4, ram:SellerTradeParty), Käufer (BG-7, ram:BuyerTradeParty), die Steueraufschlüsselung (BG-23, ram:ApplicableTradeTax) und die Summen (BG-22, ram:SpecifiedTradeSettlementHeaderMonetarySummation). Die vollständige Liste enthält die EN 16931-1; das Profil EN 16931 von ZUGFeRD bildet diese Felder in der CII-Syntax ab.
Wie teste ich meine ZUGFeRD-Datei vor der Validierung?
Prüfen Sie die XML-Datei gegen das EN-16931-Schematron und das PDF/A-3 mit veraPDF, etwa mit Open-Source-Validatoren wie Mustang. Bei häufigen Fehlern empfiehlt sich ein fester Validierungsschritt in Ihrem Rechnungsprozess.
Warum schlägt die Validierung trotz korrekter Felder fehl?
Neben den Pflichtfeldern können auch Formatfehler die Validierung blockieren. Prüfen Sie z. B., ob Datumsangaben in der CII-Syntax im Format JJJJMMTT (Attribut format="102") vorliegen, Zahlenwerte korrekt mit Punkt statt Komma (z. B. 1234.56) formatiert sind und ob keine unzulässigen Leerzeichen enthalten sind.
Verwandte Ratgeber
Kostenloses Werkzeug