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 uw account contacteert u support om de Peppol API voor uw onderneming te laten activeren.
Eén endpoint voor verzenden
Verstuur per request één base64-gecodeerde UBL XML-factuur via POST /v1/peppol/invoice.
Directe statusrespons
U krijgt meteen een response met submissionId en status sending of failed.
Asynchrone webhook opvolging
Ontvang lifecycle-updates via webhook callbacks terwijl uw factuur door het netwerk gaat.
OpenAPI-First integratie
Start vanuit Swagger UI of ruwe OpenAPI JSON en lever snel uw eerste integratie op.
API referenties
Swagger UI
Bekijk request- en response-schema’s en test direct vanuit uw browser.
https://api.budgetinvoice.com/docs/peppolOpenAPI JSON
Importeer het ruwe schema in Postman, Insomnia of uw 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 uw API-sleutel in de Authorization header. De API geeft direct status terug met eventueel een foutmelding.
Webhook statusupdates
Na een geaccepteerde submission ontvangt uw webhook statusovergangen zoals sending, delivered of failed.
- Configureer productie- en test-webhook URL’s in uw 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. U 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 u nodig heeft 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 uw 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 u niets invult, wordt auto gebruikt.
Lanceer uw Peppol API integratie
Gebruik de OpenAPI specificatie, test met de voorbeelden en volg asynchrone bezorging via webhooks.