ZUGFeRD
ZUGFeRD is the module's default format. It combines a readable Magento invoice PDF with embedded CII XML, so the recipient can view one document while accounting software extracts its structured data.
Output
| Property | Supported behavior |
|---|---|
| Format version | ZUGFeRD 2.5 |
| Syntax | UN/CEFACT Cross Industry Invoice (CII) |
| Document type | Hybrid PDF with embedded XML |
| Separate XML | Yes with permanent storage |
| Invoice and credit memo | Both supported |
During generation, the module first builds the structured document, renders Magento's normal invoice or credit-memo PDF, and then uses the hybrid builder to embed the XML. If PDF preparation fails, inspect the Magento PDF path and extension logs; a valid XML document does not by itself prove that a hybrid PDF was created.
Profiles
The shared ZUGFeRD/Factur-X profile selector offers:
| Admin value | Purpose |
|---|---|
| MINIMUM | Header-level information only |
| BASIC WL | Basic data without the full EN 16931 line-detail model |
| BASIC | Basic invoice profile |
| EN 16931 | EN 16931-aligned profile and module default |
| EXTENDED | Broader data model for recipients that explicitly require it |
The current selector does not offer a separate COMFORT or XRECHNUNG value. Choose EN 16931 for the normal EN 16931 profile. Use the dedicated XRechnung format when the recipient wants XRechnung XML.
Configure ZUGFeRD
- Set Default B2B Format to ZUGFeRD 2.5.
- Select the profile confirmed by the recipient.
- Keep invoice document type
380unless the business process calls for another supported code. - Complete seller VAT, address and payment details.
- Generate a manual sample with shipping, discounts and the VAT rates you really use.
Credit memos use document type 381 or 384 from the credit-memo settings and the same store-level format/profile.
Files and email
Permanent storage normally creates XML and PDF below var/einvoice/ in Magento's private var/ directory; credit memos use its creditmemo subdirectory. The Automatic email strategy attaches the hybrid PDF. Choose Both only when the recipient genuinely wants the PDF and separate XML.
Validation
The formatter checks XML structure and can run the bundled profile XSD. Test the resulting hybrid file with the recipient's validator as well. XSD success does not test every business rule, the embedded-file relationship or the receiver's import behavior.
Common problems
XML exists but PDF is missing
Confirm that Magento can render its normal invoice PDF, the horstoeko/zugferd dependency is installed, storage is writable, and the document status contains a PDF path.
Recipient expects XRechnung
Do not select a different ZUGFeRD profile and assume it becomes XRechnung. Choose the dedicated XRechnung format and version required by the recipient.