Peppol API Voor Factuurautomatisering
Verstuur UBL-facturen via één endpoint, volg bezorging met webhooks en verstuur via Peppol of KSeF met transparante staffelprijzen.
Na het aanmaken van je account neem je contact op met support om de Peppol API voor je bedrijf te laten activeren.
Eén endpoint voor verzenden
Verstuur per request één base64-gecodeerde UBL XML-factuur via POST /v1/peppol/invoice.
Directe statusrespons
Je krijgt meteen een response met submissionId en status sending of failed.
Asynchrone webhook opvolging
Ontvang lifecycle-updates via webhook callbacks terwijl je factuur door het netwerk gaat.
OpenAPI-First integratie
Start vanuit Swagger UI of ruwe OpenAPI JSON en lever snel je eerste integratie op.
API referenties
Swagger UI
Bekijk request- en response-schema’s en test direct vanuit je browser.
https://api.budgetinvoice.com/docs/peppolOpenAPI JSON
Importeer het ruwe schema in Postman, Insomnia of je codegenerator.
https://api.budgetinvoice.com/docs/peppol/openapi.jsonSubmission endpoint
Beveiligd endpoint voor één UBL-factuur per call.
POST https://api.budgetinvoice.com/v1/peppol/invoicecurl --request POST \
--url 'https://api.budgetinvoice.com/v1/peppol/invoice' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"xml": "BASE64_ENCODED_UBL_XML",
"targetNetwork": "auto"
}'Gebruik je API-sleutel in de Authorization header. De API geeft direct status terug met eventueel een foutmelding.
Webhook statusupdates
Na een geaccepteerde submission ontvangt je webhook statusovergangen zoals sending, delivered of failed.
- Configureer productie- en test-webhook URL’s in je Peppol API instellingen.
- Callbacks bevatten submissionId, filename, targetNetwork, recipient, status en updatedAt.
- Verwerk retries idempotent door submissionId als unieke sleutel te gebruiken.
- Bekijk en verstuur mislukte callbacks opnieuw via webhook history in het dashboard.
Webhook best practice
Gebruik HTTPS endpoints en log non-2xx responses voor betrouwbare retries.
Voorbeeld callback payload
JSON{
"submissionId": "bd9f47f3-7bc4-4760-a1dc-8c33df6496f3",
"filename": "invoice-2026-0001.xml",
"status": "delivered",
"targetNetwork": "peppol",
"recipient": {
"scheme": "iso6523-actorid-upis",
"id": "0208:123456789"
},
"updatedAt": "2026-02-28T09:42:11.202Z"
}Staffelprijzen Voor API-Verzendingen
Geen aparte API-toeslag. Je betaalt per verstuurde factuur.
Staffels
Per factuur excl. btw
- Geen minimumvolume
- Betaal per factuur
- Peppol registratie inbegrepen
- Facturen ontvangen en doorsturen inbegrepen
- Geen maandelijkse kosten
Alles wat je nodig hebt om live te gaan
Gebruik de OpenAPI specificatie, test met de voorbeelden en volg asynchrone bezorging via webhooks.
Veelgestelde vragen
Hoe authenticeer ik met de Peppol API?
Stuur je API-sleutel als Bearer token in de Authorization header. Requests zonder geldige sleutel geven een autorisatiefout terug.
Welk formaat accepteert het invoice endpoint?
Het endpoint accepteert per request één base64-gecodeerd UBL XML-document. ZIP-bestanden worden niet geaccepteerd op dit endpoint.
Wanneer ontvang ik webhook callbacks?
Callbacks worden verstuurd zodra de submissionstatus verandert. Gebruikelijke waarden zijn sending, delivered en failed.
Kan ik het target netwerk kiezen?
Ja. Gebruik targetNetwork met de waarden auto, peppol of ksef. Als je niets invult, wordt auto gebruikt.
Lanceer je Peppol API integratie
Gebruik de OpenAPI specificatie, test met de voorbeelden en volg asynchrone bezorging via webhooks.