Onboarding Setup

Register your company as a legal entity on the Peppol network and get your Peppol identifier — the first step before sending invoices.

What is a Legal Entity?

To send invoices on the Peppol network, your company must be registered as a legal entity. This is the official identity that appears as the sender on every invoice you send.

Required fields

companyName — your registered business name
street — street address
city — city
postalCode — postal / ZIP code
country — ISO 3166-1 alpha-2 country code (e.g. BE, NL, FR)

You can update your legal entity details anytime from the Peppol identity page in the console, and your integration can read them back at any time with GET /v1/identity — any API key works.

Peppol Identifier

A Peppol Identifier is your address on the Peppol network — it's how other participants find and send documents to you. The format is {EAS scheme}:{endpoint ID}.

Common EAS schemes

Scheme	Country	Description	Example value
`0208`	Belgium	KBO/BCE enterprise number — digits only, no `BE` prefix	`0685660237`
`0106`	Netherlands	KVK number — digits only	`12345678`
`0190`	Netherlands	OIN (Overheids Identificatie Nummer) — 20 digits	`00000001234567890000`
`9944`	Netherlands	VAT number (BTW-nummer) — the `NL` prefix is required, as Peppol rule PEPPOL-COMMON-R056-1 pins the format. Register this alongside your KVK or OIN, never instead of it: rule NL-R-003 needs the KVK or OIN. Both `9944` and `0106` are verified automatically; `0190` requires support	`nl123456789b01`
`0184`	Denmark	CVR number (Danish Central Business Register) — the `DK` prefix is optional	`12345678`
`0009`	France	SIRET number — 14 digits	`12345678200002`
`0007`	Sweden	Organisationsnummer — 10 digits, with a Luhn check digit	`5561234567`
`9935`	Ireland	VAT number — the `IE` prefix is required	`IE1234567T`
`9930`	Germany	USt-IdNr — the `DE` prefix is required	`DE123456788`
`9932`	United Kingdom	VAT registration number (also written `GB:VAT`) — the `GB` prefix is required	`GB123456789`
`0088`	International	EAN / GLN (GS1) — 13 digits, check digit validated	`5412345000013`

The country prefix is part of the value, not decoration. Ireland, Germany and the United Kingdom identify a participant by its VAT number, and the value must carry the country letters. Registering 1234567T instead of IE1234567T is rejected on format before anything else is checked. The registry schemes above (0208, 0106, 0009, 0007) are the opposite — digits only, no letters.

For example, a Belgian company with KBO number 0685.660.237 would use the Peppol ID 0208:0685660237 — the same number with the punctuation removed.

In sandbox mode a test Peppol ID is created for you automatically, so you can send straight away without registering anything. It is a routing identifier: it carries no tax identity, so invoices that include VAT need a VAT number registered on your Peppol identity as well. See the Sandbox guide. Any identifier you register yourself must match the format above, in sandbox as in production.

Sandbox vs Production

Sandbox

Company name and address can be test values — they are not checked against a registry
A test Peppol ID is auto-created during onboarding; additional registered identifiers can change the sender's tax profile
Read GET /v1/identity before the first send and copy sandboxFirstSend.line onto every line
The profile uses O/0 for a routing-only sender and AE/0 when the provider inventory carries a Tax Identifier
Any identifier you register must match the format above — the country prefix rules apply here too
Invoices are validated and processed but never reach the live Peppol network
See Sandbox for rate limits and detailed limitations

Production

Use your real company details (registered name, address)
Provide your actual Peppol Identifier (e.g. KBO, SIRET, KVK number)
Invoices are delivered on the live Peppol network
Requires a paid plan (Starter, Pro, or Business)

Production identities are registered on the live Peppol network. Make sure to use your real, registered company details.

Step-by-step Walkthrough

The onboarding wizard appears automatically when you create a new organization. Here's what to expect:

1. Create an account
Sign up at console.getpeppr.dev and create a new organization.
2. Complete the onboarding form
The wizard asks for your company name, street address, city, postal code, and country. In sandbox mode, you can use test values.
3. Click "Complete Setup"
Behind the scenes, getpeppr creates your legal entity and registers a Peppol identifier. In sandbox, this happens instantly with auto-generated test credentials.
4. Create an API key
Once onboarding is complete, head to the API Keys page in the console to create your first sk_sandbox_... key.

The entire sandbox setup takes under a minute. You'll be ready to send your first test invoice right away.

What Happens Next?

After sandbox setup

Your sandbox Peppol ID is active immediately. You can start sending test invoices using the SDK or the API. Head to the Authentication guide to create your API key, then follow Send an Invoice to send your first document.

Finding recipients

Need to find a recipient's Peppol ID before sending an invoice? Use the Peppol Directory search to look up participants by name, country, or VAT number — and import them directly into your contact list. See the Contacts & Directory guide for details.

Moving to production

When you're ready to go live, upgrade to a paid plan from the console. You'll need to update your legal entity with real company details and provide your actual Peppol identifier (your country's business registration number in the correct EAS scheme). See Going to Production for the full checklist.

Getting Started

Authentication