Skip to content

Peppol

Peppol is a network for e-invoicing and other B2B documents. Participants are identified by Peppol ID. xTool can send and receive documents via Peppol. See Send by Peppol and Receive by Peppol.

Peppol ID

A Peppol ID has two parts:

  • Scheme — The type of identifier (e.g. 9930 for German VAT ID).
  • Value — The identifier itself (e.g. DE123456789).

It is often written as scheme::value or in URI form.

  • Your organisation — Configure your organisation's Peppol ID(s) in organisation settings. They are used for receiving: when a message arrives, xTool matches the receiver ID to your organisation. See Organisation and users.
  • Recipient (when sending) — The document metadata must contain the recipient's Peppol ID (receiver_id with scheme and value). Use Peppol Lookup to verify that the participant is registered and which document types they support before sending.

Networks: test and production

  • Test network — For development and integration. No real delivery to business partners. Use it for development and testing.
  • Production — Live network. Real delivery. Use only when you are ready for production.

Many API and lookup endpoints accept a network parameter (e.g. prod or test). Always use test for integration and switch to prod only when ready.

!!! important "Use test first" Use the Peppol test network for development and testing. Switch to production only when you are ready for live traffic.

Peppol Lookup (API)

The Peppol Lookup API lets you query the network:

  • Check existence — Is the participant registered? (Parameters: scheme, value, network, uri_scheme.)
  • Business card — Participant details.
  • Document types — Which document types the participant supports.
  • Endpoints — SMP endpoints for the participant.

Use check existence (and if needed document types) before sending to avoid failed deliveries. See API Reference for Peppol Lookup and Send by Peppol.

Supported formats for Peppol

Peppol typically uses Peppol BIS Billing (invoice and credit note, UBL and CII), Peppol BIS Self Billing, and XRechnung (UBL). The Formats table (Peppol column) shows which formats support send/receive via Peppol.

How sending and receiving work (overview)

  • Send — You trigger send → xTool validates the document → sends it via the access point to the recipient. Document status moves to send.completed or send.failed.
  • Receive — An incoming message arrives at xTool's access point → xTool matches the receiver Peppol ID to an organisation → creates an inbound document. Document status moves to receive.completed or receive.failed.