Send via Peppol
This guide describes how to send a document (invoice or credit note) through the Peppol network.
Prerequisites
- Document created or uploaded in xTool (see Create documents).
- Document in a Peppol-supported format (e.g. Peppol BIS Billing, XRechnung UBL). See Formats.
- Recipient Peppol ID (scheme + value) correctly set in the document (e.g. in buyer/recipient party). The recipient must be reachable on Peppol (see Peppol Lookup).
!!! tip "Test network" For development and testing use the Peppol test network. See Peppol — networks.
Web
- Open the document in the Documents list.
- Click "Send via Peppol" (or similar).
- Confirm. The document is submitted to Peppol; status changes (e.g. to sent or delivered) according to Status lifecycle.
API
Send a POST request to the document send endpoint with the document ID and body:
- Endpoint:
POST /api/v2/documents/{document_id}/send(or equivalent). - Body:
{"transaction_type": "send.peppol"}(and any other required parameters).
The response confirms the send; the document status is updated. Poll the document or use webhooks (if available) to get the final delivery status.
See API reference for the exact endpoint and parameters.
After sending
- Status: Check the document status and status log (web or API). See Status lifecycle.
- Errors: If status is failed, open the document and check the log for the error message (e.g. recipient not found, validation error).