Error codes · zugferd

ZUG-FILENAME-001In your invoicing software

ZUGFeRD/Factur-X Wrong Embedded XML Filename

This is the rejection, word for word: „[ZUG-FILENAME-001] The embedded XML in your ZUGFeRD/Factur-X PDF has the wrong filename. It must be exactly factur-x.xml since ZUGFeRD 2.1.“

PDF/A-3 allows any attachment name, but ZUGFeRD 2.1+ mandates factur-x.xml (case-sensitive). Both /F and /UF in the filespec dictionary must match.

What to have readyNothing. The file has to be re-exported from your invoicing software; we check it again afterwards.
What we doRename the embedded XML to factur-x.xml and update fx:DocumentFileName XMP property.
If you enter it yourself in your invoicing software
Before
/F (ZUGFeRD-invoice.xml)
After
/F (factur-x.xml)
What the finding looks likeExample
FindingStructure invalid · ZUG-FILENAME-001
From youA re-exported file
ThenRe-export
ProofSHA-256 and /verify link after the check