Peppol Network

Peppol simplifies trade between suppliers and buyers by providing a standardized way to exchange electronic business documents, both domestically and across borders. Document exchange between parties takes place via Peppol Access Points, which connect buyers and suppliers to the Peppol network.

Maventa is a certified Peppol Access Point, registered in the Peppol network as Visma Software International AS. This means that by integrating with Maventa, you can easily offer Peppol connectivity to your customers.

Invoice sending in Peppol

• Sending invoices through the Peppol network does not require separate registration. Maventa customers can send invoices to Peppol in the same way they send invoices to any other operator.

• To send an invoice, the sender provides the recipient’s Peppol address and sets PEPPOL as the operator.

  • Peppol address is the recipient’s electronic invoicing address within the Peppol network. It consists of an identifier prefix and a company identification number.

    • The identifier prefix indicates the type of identifier used. The identifiers used vary by country. For more details, see the official code list: https://docs.peppol.eu/poacc/billing/3.0/codelist/ICD/
    • The company identification number uniquely identifies the company (e.g. an organisation number).
    • For example in Norway, Peppol address is formed based on organisation number, prefix used for Norwegian organisation number is 0192. For Norwegian company whose organisation number would be 123456789 Peppol address would be 0192:123456789

• To check whether a company can receive invoices via the Peppol network, you can use Maventa’s Peppol participant lookup tool or GET /v1/lookup/receivers method (see the Manual lookup with API chapter below).

• Invoices are transmitted in Peppol-compliant formats. If the original invoice is not in a Peppol format, Maventa will convert it before sending.
• All invoices sent to the Peppol network are validated against Peppol format rules. Invoices that fail validation cannot be sent.
• More information about Peppol formats is available at: https://peppol.eu/what-is-peppol/peppol-profiles-specifications/

Manual lookup with API

To perform the lookup yourself before sending, use the GET /v1/lookup/receivers method. You can search using identifiers like the company name, business ID (VAT number or national business registry number), or e-invoice address (e.g., OVT, GLN).

API Parameters

• network:

PEPPOL – for recipients in the Peppol network INTERNAL – for recipients within Maventa’s internal network EXTERNAL – for recipients in external registries, such as Finnish or Swedish operator networks SPROOM - for recipient behind Sproom and Nemhandel

• eia: Use this field if you have the recipient’s full e-invoice address (EIA)
• bid: Use this field if you only have the recipient’s business ID
• name: Use this field if you only know recipient’s name
• country: Use the recipient’s ISO country code to narrow down the results

The purpose of the lookup is to determine whether the recipient is able to receive electronic invoices and through which delivery route. It also helps identify the recipient’s e-invoicing address, for example a Peppol participant identifier such as 9925:be000000000b21. Additionally, the lookup shows which Peppol document types the recipient supports (INVOICE or CREDIT_NOTE).

https://ax.maventa.com/v1/lookup/receivers?network=PEPPOL,INTERNAL,EXTERNAL&name=3478209-8&country=FI&page=1&per_page=100

[
  {
    "eia": "0216:003734782098",
    "network": "PEPPOL",
    "operator": "PEPPOL",
    "document_types": [
      {
        "document_type": "CREDIT_NOTE",
        "document_identifier": "urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2::CreditNote##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
        "process_identifier": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
      },
      {
        "document_type": "INVOICE",
        "document_identifier": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
        "process_identifier": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
      }
    ],
    "participant": {
      "name": "Maventa Oy",
      "country": "FI"
    }
  }
]

Invoice receiving in Peppol

• To receive invoices through the Peppol network, a company must be registered as a Peppol receiver. Registration is free of charge. Invoice receiving is billed according to the applicable price list.
• Once registered, the company can receive electronic invoices from any sender connected to the Peppol network.

• During registration, the company selects which document types it wants to receive. Available profiles depend on the country:

  • All companies registering to receive invoices will register for the common Peppol BIS formats used across all countries. Some countries also support additional, country-specific formats that are registered at the same time. See the supported format from country-specific guides.

  • If a company wants to receive self-billing invoices, it can register an additional profile to receive self-billing invoices and credit notes.

  • After registration, the company’s details are published in the Peppol Directory. The Peppol Directory serves as a shared address book listing all registered receivers and their supported document types and version

Register company as Peppol receiver

Once a company account has been registered with Maventa, and company has enabled receiving (VISMA network), they can be registered as a Peppol receiver by creating a Peppol profile. When profile registration is done, Maventa performs the registration in the Peppol SMP (Service Metadata Provider), which is then synchronized with the central Peppol address book, the Peppol Directory.

Create Peppol profile for invoices and creditnotes

Call POST /v1​/company​/profiles

Required information:

• Supported company profiles
  • for invoices and credit notes: INVOICE_AND_CREDIT_NOTE
• Network: PEPPOL

After registration is ready you will be returned the identifier/Peppol address that company was registered with.

To follow up when the registration has been succesfully completed you can register a webhook. Use the event type NETWORKS to get notification of all changes in the registration statuses.

Use GET /v1/company/profiles to see the active profiles for PEPPOLnetwork.

Create Peppol profile for self-billing invoices

Call POST /v1​/company​/profiles

Required information:

• Supported company profiles
  • for self-billing invoice: SELF_BILLING_INVOICE
  • for self-billing credit notes: SELF_BILLING_CREDIT_NOTE
• Network: PEPPOL

Use GET /v1/company/profiles to see the active profiles for PEPPOL network.

Supported countries and identifiers

Maventa creates the registration with the following identifiers (schemes):

• Norway - Organisation number (prefix 0192)
• Finland - OVT (prefix 0216)
• Sweden - Organisation number (prefix 0007)
• Denmark - CVR (prefix 0184)
• Netherlands - KVK or VAT number (prefix 0106 or 9944 - depending which is used to register company account to Maventa)
• Germany - VAT number (prefix 9930)
• Belgium - Organisation number CBE (prefix 0208)
• Estonia - VAT number (prefix 9931)
• Latvia - VAT number (prefix 9939)

Delete registration

To remove registration from Peppol network call DELETE /v1​/company​/profiles and give the profile id for the registration you want to delete.

Recommended routine and notes

Best practices before registration

Before creating the registration it is good practise to check the existing registrations for the company:

• If company is already registered you are good to go
• If not, if there are any old inactive registrations e.g. failed ones delete them and then create a new registration