Peppol

​

Introduction

Peppol (Pan-European Public Procurement On-Line) is a global network for electronic document exchange, widely adopted for e-invoicing across multiple countries. It provides a standardized protocol for companies to exchange business documents like invoices, credit notes, and purchase orders.

The Peppol network is particularly popular in:

• Nordic countries (Norway, Finland)
• Asia-Pacific region (Japan, Singapore, Malaysia, Australia, New Zealand)
• Several EU countries for business-to-government invoicing (Germany, Italy, Croatia)

Invopop allows you to send and receive documents through the Peppol network using a single integration while continuing to work with our GOBL format.

This guide walks you through the steps to register a company in Invopop and then issue and receive invoices on its behalf.

​

Setup

Let’s prepare your workspace to work with Peppol. We’ll configure the Peppol app and create four workflows:

• Invoice issuance workflow: Send invoices through the Peppol network
• Invoice reception workflow: Receive invoices from the Peppol network
• Party registration workflow: Programmatically onboard companies (Parties) with Invopop
• Party post-registration workflow: Automatically triggered by the Peppol app after a Party completes registration, used to inform your systems that onboarding is complete

If you only want to send invoices through Peppol, you can skip steps 4, 5, and 6 of the setup. Alternatively, if you only want to receive invoices through Peppol, you can skip step 3.

Congratulations! Your workspace is now configured to send and receive Peppol documents and programmatically onboard Peppol participants with Invopop.

​

Running

After setup, you can perform three key operations with Peppol in Invopop: onboarding entities (parties) so they can use Peppol, sending invoices through Peppol, and receiving Peppol invoices.

​

Registering parties

Business entities are represented in Invopop as GOBL org.party objects, which we call Parties. To register a party:

1. Upload it to the Silo
2. Send it to the party registration workflow

​

Upload a party document

You can upload parties via the Create an Entry API endpoint or manually through the Console. For this guide, we’ll demonstrate the manual process:

1. Find the Contacts section in the sidebar and click Suppliers
2. Click + New Supplier to open the editor
3. Enter the required information (or use the example below)

The mandatory fields for Peppol registration are:

• Fiscal name
• Peppol participant ID

The peppol-visibility field in meta determines the party’s visibility within the Peppol network:

• smp: Published only in the SMP
• smp+sml: Published in the SMP and SML
• smp+sml+peppol: Published in the SMP, SML, and Peppol

Click Build to validate the document, then Save.

​

Send to the registration workflow

Once the document is saved:

1. Click the Select Workflow button
2. Select the Register Supplier workflow created during setup
3. Click Run Workflow

The execution should succeed, and the silo entry’s state will change to “Processing.” Click the Meta tab to see the registration link:

When successful, you’ll see the Peppol Participant ID in the Meta tab of the entry. The party can now send and/or receive invoices in Peppol via Invopop.

​

Sending invoices

To send an invoice, you need to:

1. Store it as a Silo Entry
2. Send it to the Sending Invoice Workflow created during setup

You can perform these steps manually via the Console or programmatically via the API using the Create an Entry and Create a Job endpoints. For API usage, refer to our quickstart guide.

When creating your invoice, ensure you:

1. Set the appropriate $regime field based on the issuer’s country (e.g., NO for Norway, FI for Finland)
2. Add the peppol addon to enable Peppol-specific validations and extensions

​

Receiving invoices

Invopop automatically processes invoices received from the Peppol network using your configured Incoming Workflow.

The workflow converts Peppol documents to GOBL format and creates Silo Entries for each invoice. Configure your workflow with webhooks or Google Drive integration to deliver these invoices to your systems.