Skip to main content

Peppol Compliant Invoices

Geoff Mina avatar
Written by Geoff Mina
Updated over 2 weeks ago

Streamline your international billing by sending Peppol-compliant UBL 2.1 XML invoices alongside your standard PDF versions.


What is Peppol?


Peppol (Pan-European Public Procurement On-Line) is an international standard that allows businesses to exchange electronic documents (like invoices) over its network. It uses the UBL (Universal Business Language) format to ensure that different accounting systems can "read" and process your invoices automatically without manual data entry.
​

Enabling Peppol for a Client


If you have a client that requires Peppol-compliant invoices, you can enable this at the client level.

  1. Navigate to Clients and select the specific client.

  2. In the client settings, locate the Peppol Compliant toggle.

  3. When enabled, every invoice sent to this client via email will automatically include a Peppol XML attachment in addition to the standard PDF.

Sending Peppol Invoices on Demand

You don't have to enable the global setting for a client to send a Peppol invoice. When sending an invoice manually or via the API, you can explicitly choose to include the Peppol version.

  • Manual Send: When preparing to email an invoice, you will see an option to "Include Peppol XML".

  • API: Use the includePeppol: true flag in your SendInvoice request object to trigger the dual-attachment flow.

Manual Download

If you or your client need to access the XML file directly without sending an email:

  1. Open the Invoice details page.

  2. Click the Download dropdown menu.

  3. Select Download Peppol XML.

Technical Details for Compliance

Our Peppol implementation follows the Peppol BIS Billing 3.0 profile. Key technical details included in the generated XML:

  • Format: UBL 2.1 (Invoice Type 380).

  • Electronic Address: Uses the Tax ID provided in your Account and Client settings.

  • Norway Specifics: For Norwegian suppliers, we automatically append "Foretaksregisteret" to the legal name and format the VAT number with the NO prefix and MVA suffix (Scheme 0192) as required by local regulations.

  • Late Fees: Late fees are fully integrated as separate line items, with tax treatment (taxable vs. exempt) automatically handled based on your workspace preferences.

Frequently Asked Questions

Does this replace my PDF invoice? No. The Peppol XML is sent with your PDF. Your client will receive two attachments: the human-readable PDF they are used to, and the machine-readable XML for their accounting system.
​

What if I don't have a Tax ID for my client? While a Tax ID is highly recommended for Peppol compliance, the system will generate a fallback reference (e.g., BUYER-REF-123) to ensure the document remains valid for upload, though some strict networks may require a valid government-issued ID.

Did this answer your question?