Peppol Network

Peppol eases the trade between suppliers and buyers by providing a standardised way for exchanging trading documents electronically within countries and cross-border. Sending and receiving between recipients takes place over Peppol Access Points that connect the buyers and suppliers to the network.

Maventa is one of the cerfified Peppol Access Points. This means that when you are integrated to Maventa you can easily provide connection to Peppol to your customers.

Invoice sending in Peppol

Sending in Peppol network doesn’t require registration, Maventa customers can send invoices to Peppol network in the same way as to any other operator
To send the invoice, sender gives the recipient’s Peppol address and sets PEPPOL as the operator information.
- Peppol address is the recipient’s electronic invoice address in the Peppol network. It consists of an identifier prefix and company identification number
  - Identifier prefix is a code that tells what the type of the identifier is in question
  - Company identification number is the identifier of the company e.g. organisation number
- Identifiers used are depending on country, see https://docs.peppol.eu/poacc/billing/3.0/codelist/ICD/ for more information
  - 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 look up Peppol recipients (to see if a company can receive invoices in the Peppol network) you can use Maventa Finder
Invoices are sent over network in Peppol formats. If the original invoice is not in Peppol format, it will be converted before the send by Maventa.
Invoices going to Peppol are validated against the format validation rules, invoices that are not valid cannot be sent in Peppol network.
- See more information about Peppol formats at https://peppol.eu/what-is-peppol/peppol-profiles-specifications/

Invoice receiving in Peppol

To receive invoices in Peppol, company needs to be registered as Peppol receiver
Registration is free of charge and invoice receiving is billed according to the used price scheme for e-invoices
After registration company can receive electronic invoices from all companies that have capabilities to send over Peppol network
When registering to Peppol company chooses what kind of documents to receive
The available profiles to register are dependent on country
- All companies registered to receive invoices will register the common Peppol BIS formats that can be used in all countries. Some countries have country specific formats that will be registered at the same time.
When company is registered their information is added to Peppol Directory. Peppol Directory is the common address book that lists all network receivers and their receiving capabilities. By looking at the Peppol Directory you can find all the document types and versions a specific company is registered to receive.

Register company as Peppol receiver

APIs to use

REST API - See API documentation - Invoices and other documents
SOAP API - See API documentation - Enable/disable, invoices only

After company account is registered to Maventa you can register the company as Peppol receiver. When you call the API, Maventa makes the registration to Peppol SMP (Service Metadata Provider) that is then synced to common Peppol address book Peppol Directory.

If the company is already registered to receive invoices or other document types through another Access Point than Maventa this registration needs to be removed by the old Access Point before Maventa can do the registration.

Create registration

To create registration to Peppol:

REST API

SOAP API

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.

FIX_PENDING_INCLUDE_JSON

Call enable_operator with enabled=true

This will create the registration automatically for profile INVOICE_AND_CREDIT_NOTE
The method returns OK if the registration was successful. Note that the identifier/Peppol address is not returned for this method

Supported countries and identifiers used in registration

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)

If you want to register a participant outside of these countries or with a different identifier please contact Maventa.

Get information of existing registrations in Maventa

REST API

To fetch information of Peppol registrations use method GET /v1/company/profiles
To fetch more information of a specific registration use method GET/v1/company/profiles/{id}

Monitor registrations

REST API

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.

Delete registration

To remove registration from Peppol network:

REST API

SOAP API

Call DELETE /v1/company/profiles and give the profile id for the registration you want to delete.

Call enable_operator with enabled=false

This will delete the registration for the profile INVOICE_AND_CREDIT_NOTE.

Recommended routine and notes

Company email requirement

Company email needs to be set on Maventa account to make the registration (at minimum in Norway).

Registration timing

Registrations happen usually straight away, but if there are issues with the Peppol register there can be a delay of couple of days before the actual registration happens.

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

Existing registrations at other Access Points

If company is already registered to receive invoices but to another Access Point than Maventa the registration will fail and user needs to contact their old Access Point to deregister the company before the registration in Maventa can take place.