Peppol Network
Peppol provides a standardised way to exchange electronic business documents between buyers and suppliers, both domestically and across borders. Document exchange takes place through Peppol
Maventa is a certified Peppol Access Point, registered in the Peppol network as Visma Software International AS. By integrating with Maventa, you can offer Peppol connectivity to your customers.
Sending invoices via Peppol
Sending invoices through the Peppol network does not require separate registration. Maventa customers can send invoices to Peppol recipients the same way they send invoices through any other network.
To send an invoice via Peppol, provide the recipient’s Peppol address and set PEPPOL as the operator.
Peppol addresses
A Peppol address is the recipient’s electronic invoicing address within the Peppol network. It consists of two parts:
- Identifier prefix — indicates the type of identifier used. The prefix varies by country. See the official ICD code list for details.
- Company identification number — uniquely identifies the company (for example, an organisation number).
For example, in Norway the prefix for organisation numbers is 0192. A Norwegian company with organisation number 123456789 would have the Peppol address 0192:123456789.
Recipient lookup
To check whether a company can receive invoices via Peppol, use Maventa’s Peppol participant lookup tool or the GET /v1/lookup/receivers API method.
The lookup confirms whether the recipient is registered in the Peppol network and returns their Peppol address and supported document types (such as INVOICE or CREDIT_NOTE).
For detailed instructions on using the lookup API — including parameters, request examples, and automatic routing — see the recipient lookup and routing section in the invoice sending guide.
When searching for Peppol recipients through the lookup API, there is a known limitation. To perform a Peppol Directory lookup, use the name field for either the recipient’s name or business ID. The bid field does not currently work for Peppol lookups. This will be corrected in a future version of the API.
Testing Peppol sending
The Maventa testing environment is connected to the Peppol test network, so Peppol sends are processed as real transactions within the test network. You can register one of your test accounts as a Peppol receiver — the registration is created in the Peppol test environment. Then send an invoice to that account from another test account to verify the full Peppol flow end to end. You can also use Peppol’s public test endpoints to send test invoices without needing a real Peppol recipient.
Format handling
Invoices sent through Peppol must comply with Peppol format rules. If the original invoice is not in a Peppol format, Maventa converts it automatically before sending. All invoices are validated against Peppol rules before transmission — invoices that fail validation cannot be sent.
For more information about Peppol formats, see the Peppol profiles and specifications.
Receiving invoices via Peppol
To receive invoices through the Peppol network, a company must be registered as a Peppol receiver.
Once registered, the company can receive electronic invoices from any sender connected to the Peppol network. The company’s details are published in the Peppol Directory, which serves as a shared address book listing all registered receivers, their supported document types, and format versions.
Document types
During registration, the company selects which document types it wants to receive:
-
Invoices and credit notes — Registering with the
INVOICE_AND_CREDIT_NOTEprofile automatically registers both document types: Peppol BIS Billing UBL Invoice V3 (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) and Peppol BIS Billing UBL Credit Note V3 (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). Some countries also support additional, country-specific formats that are included automatically. See the country-specific guides for supported formats. - Self-billing — Companies that want to receive self-billing invoices can register an additional profile for self-billing invoices and credit notes.
Registering as a Peppol receiver
Once a company account has been created in Maventa and receiving is enabled (VISMA network), the company can be registered as a Peppol receiver by creating a Peppol profile.
Maventa registers the company in the Peppol
If the company is already registered to receive invoices through a different Access Point, that registration must be removed by the previous Access Point before Maventa can complete the new registration.
Company email requirement
The company email must be set on the Maventa account before registration (required at minimum in Norway).
Register for invoices and credit notes
Call POST /v1/company/profiles with the following parameters:
-
profile:
INVOICE_AND_CREDIT_NOTE -
network:
PEPPOL
After registration completes, the response includes the Peppol address the company was registered with.
To receive notifications when registration completes, register a webhook with the NETWORKS event type.
Use GET /v1/company/profiles to view active profiles for the PEPPOL network.
Register for self-billing
Call POST /v1/company/profiles with the following parameters:
-
profile:
SELF_BILLING_INVOICEorSELF_BILLING_CREDIT_NOTE -
network:
PEPPOL
Use GET /v1/company/profiles to view active profiles for the PEPPOL network.
Remove a registration
To remove a company from the Peppol network, call DELETE /v1/company/profiles with the profile ID of the registration to delete.
Supported countries and identifiers
Maventa registers companies with the following identifiers (schemes):
| Country | Identifier | Prefix |
|---|---|---|
| Finland |
|
0216 |
| Sweden | Organisation number | 0007 |
| Norway | Organisation number | 0192 |
| Denmark |
|
0184 |
| Netherlands |
|
|
| Belgium | Organisation number ( |
0208 |
| Germany | VAT number | 9930 |
| Estonia | VAT number | 9931 |
| Latvia | VAT number | 9939 |
To register a participant outside of these countries or with a different identifier, contact Maventa.
Registration timing
Registrations are usually processed immediately. If there are issues with the Peppol register, there may be a delay of up to a few days.
Before registering
Before creating a new registration, check the company’s existing registrations:
- If the company is already registered through Maventa, no further action is needed.
- If the company is registered through a different Access Point, the previous registration must be removed before Maventa can complete the new one. The company needs to contact the previous Access Point to deregister.