---
title: "Added ZUGFeRD hybrid PDF to email invoices for German domestic invoices"
canonical: https://documentation.maventa.com/changelogs/developer-changelog/2026-11-19-added-zugferd-hybrid-pdf-to-email-invoices-for-german-domestic-invoices/
---

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](https://swagger.maventa.com)
  - SOAP API: in the `invoice_put_invoice_with_metadata` metadata JSON: `{"routing": {"email_settings": {"xml_format": "ZUGFERD_HYBRID"}}}`
- 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.
