Structured e-invoices by email for buyers that are not on Peppol
Set `doctypeId` on an email-only send and the email carries the invoice as validated XML, in the format you choose, not only a PDF. A Peppol send with an email fallback now emails buyers that are not on Peppol straight away.
Not every buyer who needs a structured e-invoice is on Peppol. Some mandates don't prescribe a channel: in Germany, for example, an XRechnung or Peppol BIS invoice sent by email counts as an e-invoice for domestic B2B, and a PDF does not. Other buyers simply want the XML, so their accounting software can import the invoice instead of someone typing it over from a PDF. You can now send these buyers a structured e-invoice by email, on its own or as a fallback for Peppol.
What changed
- Structured documents by email: On a send with
recipient: null, setdoctypeIdto the format you want, such as Peppol BIS 3, or XRechnung for German buyers (see the German formats guide). The invoice is written in that format, validated as it would be for a Peppol recipient, stored with the document, and attached to the email as XML, next to the PDF when you generate or attach one. A document that fails validation is refused with a400that lists what to fix. WithoutdoctypeId, the email carries the PDF as before. - Buyer's electronic address: An e-invoice names the buyer's electronic address. Without a Peppol recipient, Recommand takes it from
buyer.enterpriseNumberwithenterpriseNumberScheme, elsebuyer.vatNumber(with its country prefix), else the first address inemail.to. Peppol BIS does not accept an email address there, so for a buyer without a usable VAT or company number, choose a format that does, such as XRechnung or CII. - Email fallback without a Peppol attempt: When Peppol confirms that a buyer is not registered, the email fallback goes out straight away, with the XML attached, and the Peppol delivery reports
recipient_not_found, so you can see why the invoice went by email. - French regulated invoices cannot be sent by email only: they have to go through an accredited platform over Peppol.
Why this matters
You can reach every business customer, on Peppol or not, with a structured e-invoice through one API call. Address the buyer on Peppol, for example by its VAT number, and add an email address: buyers on Peppol receive the invoice over Peppol, and the others receive it by email with the XML, without you checking first who is on Peppol.
What you need to do
Nothing, unless one of these applies:
- You already pass
doctypeIdon email-only sends, for example the default Peppol BIS 3 identifier. Those invoices are now validated and the email carries the XML as well. A Peppol BIS invoice for a buyer without a usable VAT or company number is refused with a400: add the number, or leavedoctypeIdout to keep sending a PDF only. - You act on delivery failures. A send to an address that is not on Peppol now reports
recipient_not_found, where it used to reporttransport. Without email delivery, the response stays a422, and its message now says the recipient is not registered on Peppol.
The email delivery guide covers both routes in detail, and the German getting started guide shows them for German buyers.