In a ZUGFeRD or Factur-X invoice the XML is an attachment inside the PDF. So that programs find it, the specification fixes its file name.
Which name applies
By the Factur-X 1.09.2 / ZUGFeRD 2.5.2 specification:
| Profile | Name of the XML |
|---|---|
| MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED | factur-x.xml |
| XRECHNUNG | xrechnung.xml |
"The XML file is always embedded with the name "factur-x.xml". The only exception to this is the
reference profile XRECHNUNG, where the name must be "xrechnung.xml"." A PDF in the XRECHNUNG profile
must not contain a factur-x.xml.
Only names from the HybridDocumentFilename code list are allowed (rule BR-HYBRID-13, error); the same
list also has order-x.xml for orders, not for invoices. The name should also match the entry in the
PDF's XMP metadata (BR-HYBRID-14, warning).
Older files
ZUGFeRD 2.0 used the name zugferd-invoice.xml. Such files still exist; some programs read them, but
the current code list no longer has the name.
Common causes
- The program attaches the XML under its own name, e.g.
invoice.xmlor the invoice number. - The XML was attached later with a PDF tool without updating the XMP metadata.
What our check does
We look for the XML under factur-x.xml, xrechnung.xml and zugferd-invoice.xml. Problems with the
PDF's XMP metadata are reported by the check against FeRD's rules in the "PDF and ZUGFeRD" section of
the report.
Sources: Factur-X 1.09.2 / ZUGFeRD 2.5.2 (embedding, rules BR-HYBRID-13 and -14, code list HybridDocumentFilename).