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 three 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

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

The Peppol app is designed to only send and receive the document, generating and importing the appropriate file is delegated to format specific apps such as Oasis UBL or UN/CEFACT CII. This is done to keep the Peppol app simple and focused on the Peppol protocol, while allowing you to use the format that best suits your needs.

Connect the Peppol app

Within the Console, navigate to Configuration → Apps
Find the Peppol app in the list
Click Connect to activate it. The Peppol app should now appear in the list of Enabled apps

Configure a workflow to issue invoices

Now we’ll create the workflow that converts invoices to a valid Peppol format and sends them through the Peppol network. In this example, we’ll generate a Peppol BIS Billing UBL 3.0 document.

Skip this step if you only want to receive invoices via Peppol.

Peppol issue invoice workflow

This workflow convert a GOBL document into the Peppol format and sends it to the network

Peppol issue invoice workflow

This workflow convert a GOBL document into the Peppol format and sends it to the network

Copy and paste into a new Empty Invoice workflow code view.

Example Peppol send invoice workflow with states

{
  "name": "Peppol send invoice",
  "description": "Send Peppol BIS invoice through Peppol network",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "33e23480-10ab-11f0-a09e-7b63571a4ae2",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `processing`{.state .processing}",
      "config": {
        "state": "processing"
      }
    },
    {
      "id": "2354afd0-10ab-11f0-a09e-7b63571a4ae2",
      "name": "Add Sequential Code",
      "provider": "sequence.enumerate",
      "summary": "Dynamic · PPL · PPL000001",
      "config": {
        "name": "PPL",
        "padding": 6,
        "prefix": "PPL",
        "start": 1
      }
    },
    {
      "id": "fb06b190-10aa-11f0-a09e-7b63571a4ae2",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "fc5aa8d0-10aa-11f0-a09e-7b63571a4ae2",
      "name": "Generate Peppol Document",
      "provider": "peppol.generate"
    },
    {
      "id": "075442a0-10ab-11f0-a09e-7b63571a4ae2",
      "name": "Send Peppol Document",
      "provider": "peppol.send"
    },
    {
      "id": "3037a310-10ab-11f0-a09e-7b63571a4ae2",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `sent`{.state .sent}",
      "config": {
        "state": "sent"
      }
    }
  ],
  "rescue": [
    {
      "id": "39513240-10ab-11f0-a09e-7b63571a4ae2",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Use the Console to build a workflow of the Invoice type. Include these essential steps:

Set State - to Processing.
Sign Envelope - Signs the GOBL document (can be substituted with Add Sequential Code with the Sign Document option enabled)
Generate UBL document - Converts the GOBL document to a Peppol BIS Billing UBL 3.0 document and attaches it to the original invoice entry.
Send Peppol document - Sends the generated XML attachment through the Peppol network
Set State - to Sent.

Finally, in the Error Handling area, add the Set State action and select Error.

Configure a workflow to receive invoices

Peppol receive document workflow

This workflow receives incoming documents from the Peppol network and converts them to the GOBL format.

Peppol receive document workflow

This workflow receives incoming documents from the Peppol network and converts them to the GOBL format.

Copy and paste into a new Empty Invoice workflow code view.

Example Peppol receive invoice workflow with states

{
  "name": "Peppol receive invoice",
  "description": "Imports a Peppol document, with example webhook",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "db61c3c0-0fb5-11f0-b078-9fc456829eca",
      "name": "Import Peppol Document",
      "provider": "peppol.import"
    },
    {
      "id": "dd14a3e0-0fb5-11f0-b078-9fc456829eca",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `registered`{.state .registered}",
      "config": {
          "state": "registered"
      }
    },
    {
      "id": "b1876b40-1249-11f0-92a9-ad32af0711b7",
      "name": "Send Webhook",
      "provider": "webhook",
      "summary": "https://example.com/webhook",
      "config": {
          "callback_url": "https://example.com/webhook"
      }
    }
  ],
  "rescue": [
    {
      "id": "e109d2e0-0fb5-11f0-b078-9fc456829eca",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
          "state": "error"
      }
    }
  ]
}

In Console create a new workflow and select Empty Invoice workflow in the template selector, then add the following steps:

Import Peppol Document - no configuration.
Import UBL Document - no configuration.
Set State - to Registered.
Send Webhook (optional) - let your services know a Peppol document was received.

Finally, in the Error Handling area, add the Set State action and select `Error`.

Configure the Peppol app

Within the Console, navigate to Configuration → Apps, find the Peppol App and click Configure. You’ll need to set two fields:

Incoming Workflow: Select the Receive Invoice Workflow created in Step 3. This is where the app will send incoming invoices (expenses) received from the Peppol network.

Configure a Party registration workflow

This workflow onboards companies (Peppol participants) to Invopop before they can issue or receive invoices. If you’re managing your own invoices only, you may use this workflow just once. However, if you’re offering Peppol to your customers through Invopop (white-label use case), you’ll run this workflow for each merchant you onboard.

Peppol supplier registration workflow

Onboards Peppol participants by sending a registration link

Peppol supplier registration workflow

Onboards Peppol participants by sending a registration link

Copy and paste into a new Empty Party workflow code view.

Example Peppol register party invoice workflow with states

{
  "title": "Peppol Register Party",
  "description": "Onboards participants before they can issue or receive invoices",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "7a5a4db0-0fae-11f0-b37b-0be1c251a274",
      "name": "Register Peppol Party",
      "provider": "peppol.register",
      "summary": "Enable with groups: ubl-invoice",
      "config": {
        "doc_groups": [
          "ubl-invoice"
        ],
        "visibility": "smp+sml+peppol",
        "disable": false
      }
    },
    {
      "id": "7c2fa9f0-0fae-11f0-b37b-0be1c251a274",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `registered`{.state .registered}",
      "config": {
        "state": "registered"
      }
    }
  ],
  "rescue": [
    {
      "id": "a34e83f0-25dc-11f0-b641-350e77c28eed",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Before starting, review the workflows guide to understand the general setup process.

In Console, create a new workflow and choose Empty Party workflow as the base. Then name the workflow with a descriptive label such as “Register Peppol participant”.

This worfkow is composed by these steps:

Register Peppol Party - the configuration of this step will depend on on the formats you want to work with and if you want to send, receive or both.
Set State - select Registered.

Finally, in the Error Handling area, add the Set State action and select Error.

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:

Upload it to the Silo
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:

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

The mandatory fields for Peppol registration are:

Fiscal name
Peppol participant ID

Tax ID is optional, but recommended.

Click Build to validate the document, then Save.

Example: Supplier

Peppol party example

{
    "$schema": "https://gobl.org/draft-0/org/party",
    "name": "Invopop S.L.",
    "tax_id": {
        "country": "ES",
        "code": "B85905495"
    },
    "inboxes": [
        {
            "key": "peppol",
            "scheme": "9920",
            "code": "B85905495"
        }
    ],
    "addresses": [
        {
            "num": "42",
            "street": "Calle Pradillo",
            "locality": "Madrid",
            "region": "Madrid",
            "code": "28002"
        }
    ],
    "emails": [
        {
            "addr": "billing+test@example.com"
        }
    ],
}

Send to the registration workflow

Once the document is saved:

Click the Select Workflow button
Select the Register Supplier workflow created during setup
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:

Store it as a Silo Entry
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:

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

Example: Peppol Invoice

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "ES",
    "type": "standard",
    "series": "INV",
    "code": "PP000003",
    "issue_date": "2025-04-03",
    "currency": "EUR",
    "tax": {
        "rounding": "currency"
    },
    "supplier": {
        "uuid": "0195f6ab-1292-7000-9ecb-84732e730ddf",
        "name": "Cyberdyne Systems Spain S.L.",
        "tax_id": {
            "country": "ES",
            "code": "B98602642"
        },
        "addresses": [
            {
                "street": "Paseo de la Castellana 120",
                "locality": "Madrid",
                "region": "Madrid",
                "code": "28020",
                "country": "ES"
            }
        ],
        "emails": [
            {
                "addr": "billing@cyberdynesys.com"
            }
        ]
    },
    "customer": {
        "name": "Invopop S.L.",
        "tax_id": {
            "country": "ES",
            "code": "B85905495"
        },
        "addresses": [
            {
                "street": "Calle Pradillo 42",
                "locality": "Madrid",
                "region": "Madrid",
                "code": "28002",
                "country": "ES"
            }
        ],
        "emails": [
            {
                "addr": "billing+test@invopop.com"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "12",
            "item": {
                "name": "Sambox services",
                "price": "145.00",
                "unit": "one"
            },
            "sum": "1740.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "percent": "21.0%",
                    "ext": {
                        "untdid-tax-category": "S"
                    }
                }
            ],
            "total": "1740.00"
        }
    ]
}

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.

FAQ

Please contact the Invopop support team if you have any questions that are not listed here.

What visibility do I need to have in my Peppol Party?

How can I disable Peppol for a Party?

API

Silo

Transform

Sequences

Access

Apps

Utils

Peppol Guide

Introduction

Setup

Peppol issue invoice workflow

Peppol issue invoice workflow

Peppol receive document workflow

Peppol receive document workflow

Finally, in the Error Handling area, add the Set State action and select `Error`.

Peppol supplier registration workflow

Peppol supplier registration workflow

Running

Registering parties

Upload a party document

Send to the registration workflow

Sending invoices

Receiving invoices

FAQ

API

Silo

Transform

Sequences

Access

Apps

Utils

​Introduction

​Setup

Peppol issue invoice workflow

Peppol issue invoice workflow

Peppol receive document workflow

Peppol receive document workflow

​Finally, in the Error Handling area, add the Set State action and select Error.

Peppol supplier registration workflow

Peppol supplier registration workflow

​Running

​Registering parties

​Upload a party document

​Send to the registration workflow

​Sending invoices

​Receiving invoices

​FAQ

Introduction

Setup

Finally, in the Error Handling area, add the Set State action and select `Error`.

Running

Registering parties

Upload a party document

Send to the registration workflow

Sending invoices

Receiving invoices

FAQ