You can now attach an invoice XML file to email invoices. This enables the receiving party to obtain structured XML data instead of a PDF, making it easier to import the invoice directly into their invoicing systems when the receiving system can not receive conventional e-invoices. This feature was initially requested by the Netherlands, where Peppol does not support departmental divisions due to the lack of separate Peppol IDs. By attaching the XML to the email, departments can still receive structured invoice data and manually import it into their systems. Although developed for Dutch use case, this functionality is available for all countries without any restrictions.
To enable XML attachment for email invoice, use the email_settings[xml_format] parameter in the POST /v1/invoices request and specify the desired XML format (see list of available formats in the Swagger documentation).
Note! When this parameter is provided, the invoice will be sent only via email. The email route is forced, and no other delivery channels are attempted even if the email sending fails.
PDF handling and size limitation
- If an XML file is attached to the email, a separate PDF will not be attached.
- Exception: if the selected XML format supports embedding a PDF (e.g., UBL based format), the PDF image will be included inside the XML file.
- If the sender’s email sending setting allows invoice download via a link, the PDF will still be available from the link, even if it is not attached to the email.
- The maximum allowed email size is 5 MB. If the total email size exceeds this limit, the invoice sending will fail
The cost of this feature is the same as for sending an e-invoice in the respective country.