Maventa now delivers email invoices as a ZUGFeRD hybrid PDF: a PDF/A-3 invoice with the EN 16931 CII XML embedded in it. You can also request it explicitly when sending an invoice.
- When the sender and receiver are both in Germany (DE) and you have not set an email XML format, the email gets the ZUGFeRD PDF as its attachment instead of the regular invoice image.
- To request ZUGFeRD for any invoice, set the email XML format to
ZUGFERD_HYBRID:- REST API:
email_settings[xml_format]in POST /v1/invoices - SOAP API: in the
invoice_put_invoice_with_metadatametadata JSON:{"routing": {"email_settings": {"xml_format": "ZUGFERD_HYBRID"}}}
- REST API:
- The invoice’s attachments are embedded in the ZUGFeRD XML. They are not attached to the email separately.
- The receiver can also download the ZUGFeRD PDF from the invoice link page.
- Additionally, the supported values of
email_settings[xml_format]have been limited to a commonly used subset of all formats
Why: German buyers expect a structured e-invoice, and ZUGFeRD gives them one that is still readable as a normal PDF.
Customer impact: No action is needed. German domestic email invoices get the ZUGFeRD PDF automatically.
Limitations: If the ZUGFeRD PDF is larger than the email attachment size limit, the email is sent without attachments and includes the invoice link. If you requested ZUGFERD_HYBRID explicitly, the send fails instead.