Onboarding Setup

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)

Those are the console wizard's field names. The API equivalent, POST /v1/onboarding/legal-entity, takes partyName, line1, city, zip and country — see the API reference.

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

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.

UK companies with no VAT number

The UK VAT registration threshold is £90,000 a year, so a great many British companies have no VAT number and cannot use 9932. That does not put them outside Peppol. Use the D-U-N-S Number (0060) instead: an international scheme the network routes, which Dun & Bradstreet issues automatically to registered UK companies. Yours almost certainly exists already, and looking it up is free — search by company name or by registration number on the D&B lookup tool. If it is not there, requesting one is also free and D&B answers within five working days.

Register it the way you would any other identifier: 0060 and your nine digits, with no prefix. If you later cross the VAT threshold, add 9932 alongside it rather than replacing it.

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 Business plan (Starter, Pro, or Business) or a live Platform contract

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

1. 1. Create an account

   Sign up at console.getpeppr.dev and create a new organization.

2. 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. 3. Click "Create sandbox identity" (in production the button reads "Register your identity")

   Behind the scenes, getpeppr creates your legal entity and registers a Peppol identifier. In sandbox, this happens instantly with auto-generated test credentials.

4. 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.

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.