Peppol API voor het versturen van UBL-facturen
Verstuur e-facturen vanuit je ERP, webshop of eigen facturatiesoftware via één endpoint. Je krijgt direct een status terug en volgt de aflevering met webhooks.
De Peppol API zetten we per bedrijf aan. Maak eerst een account aan en neem daarna contact met ons op. Neem contact op om de API te activeren
Zo werkt de Peppol API
Eén endpoint voor verzenden
Stuur per request één base64-gecodeerde UBL-XML-factuur naar POST /v1/peppol/invoice.
Direct een status
De response bevat een submissionId en de status sending of failed, met een foutmelding als er iets misgaat.
Aflevering via webhooks
Verandert de status, bijvoorbeeld naar delivered of failed, dan krijgt je webhook-URL een callback.
Wanneer kies je de Peppol API?
- Je factureert vanuit je eigen ERP, webshop of platform en wilt elke factuur automatisch via Peppol versturen.
- Je hebt veel zakelijke klanten in België. Belgische btw-plichtige ondernemingen moeten sinds 1 januari 2026, op enkele uitzonderingen na, gestructureerde e-facturen kunnen ontvangen. FOD Financiën: voor wie wordt e-facturatie verplicht?
- Je wilt per verstuurde factuur betalen, zonder vast maandbedrag.
Geen koppeling nodig?
Maak je je facturen in Factuur Simpel zelf? Dan heb je de API niet nodig: Peppol zit in Compleet, zonder kosten per factuur.
Peppol-facturen maken en versturen vanuit Factuur Simpel
Maakt je systeem al UBL-bestanden en upload je die liever dan dat je een koppeling bouwt?
OpenAPI-documentatie en codevoorbeelden
Begin in Swagger UI of importeer de OpenAPI-JSON in je eigen tooling.
API-referenties
Swagger UI
Bekijk de request- en response-schema's en test vanuit je browser.
https://api.factuursimpel.nl/docs/peppolOpenAPI-JSON
Importeer het schema in Postman, Insomnia of je codegenerator.
https://api.factuursimpel.nl/docs/peppol/openapi.jsonEndpoint voor verzenden
Beveiligd endpoint voor één UBL-factuur per request.
POST https://api.factuursimpel.nl/v1/peppol/invoicecurl --request POST \
--url 'https://api.factuursimpel.nl/v1/peppol/invoice' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"xml": "BASE64_ENCODED_UBL_XML",
"targetNetwork": "auto"
}'Zet je API-sleutel in de Authorization-header. API-sleutels maak je aan bij Instellingen > API-sleutels.
Afleverstatus via webhooks
Na een geaccepteerde verzending krijgt je webhook de statuswijzigingen sending, delivered en failed.
- Stel een productie- en een test-webhook-URL in. Live API-sleutels gebruiken de productie-URL, testsleutels de test-URL.
- Een callback bevat submissionId, filename, targetNetwork, recipient, status en updatedAt.
- Per statuswijziging gaat één callback. Mislukte callbacks zie je in de webhookgeschiedenis, waar je ze opnieuw verstuurt.
- Gebruik submissionId als unieke sleutel, zodat een opnieuw verstuurde callback niet dubbel wordt verwerkt.
Beveilig je endpoint
Callbacks hebben geen signature-header. Gebruik een HTTPS-endpoint en controleer elke submissionId tegen je eigen verzendingen.
Voorbeeld van een callback
JSON{
"submissionId": "bd9f47f3-7bc4-4760-a1dc-8c33df6496f3",
"filename": "invoice-2026-0001.xml",
"status": "delivered",
"targetNetwork": "peppol",
"recipient": {
"scheme": "iso6523-actorid-upis",
"id": "0106:12345678"
},
"updatedAt": "2026-02-28T09:42:11.202Z"
}Prijs per verstuurde factuur
Geen maandbedrag en geen aparte API-toeslag. Je betaalt per factuur die je via de API verstuurt.
Staffels per kalendermaand
- 0 - 3.000 facturen
- € 0,35
- 3.001 - 10.000 facturen
- € 0,25
- 10.001 - 50.000 facturen
- € 0,18
- 50.001 - 250.000 facturen
- € 0,15
- Meer dan 250.000 facturen
- € 0,12
Prijs per factuur, excl. btw
Elke staffel heeft een eigen prijs. Verstuur je 5.000 facturen in een maand, dan betaal je 3.000 × € 0,35 + 2.000 × € 0,25 = € 1.550,00 excl. btw.
- Geen minimumvolume
- Geen maandbedrag
- Peppol-registratie inbegrepen
- Facturen ontvangen en doorsturen inbegrepen
- Zelfde prijs als bulkverzending
Zo ga je live
- Maak gratis een account aan en zet Peppol aan in je instellingen.
- Neem contact met ons op. Wij activeren de Peppol API en de prijs per factuur voor je bedrijf.
- Maak een API-sleutel aan bij Instellingen > API-sleutels en stel je webhook-URL's in.
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 endpoint?
Per request één base64-gecodeerd UBL-XML-document. ZIP-bestanden accepteert dit endpoint niet; daarvoor gebruik je bulkverzending.
Wanneer krijg ik webhook-callbacks?
Zodra de status van een verzending verandert. De statussen zijn sending, delivered en failed. Per statuswijziging gaat één callback.
Kan ik het doelnetwerk kiezen?
Ja. Geef targetNetwork mee met auto, peppol of ksef. Laat je het veld weg, dan wordt auto gebruikt.
Hoe activeer ik de Peppol API?
Maak een account aan en neem contact met ons op. Wij zetten de API en de prijs per factuur voor je bedrijf aan. Daarna maak je een API-sleutel aan bij Instellingen > API-sleutels en stel je je webhook-URL's in.
Wat kost de Peppol API?
Je betaalt per verstuurde factuur, van € 0,35 tot € 0,12 excl. btw. De prijs per factuur daalt per staffel naarmate je in een kalendermaand meer facturen verstuurt. Er is geen maandbedrag en geen minimumvolume.
Start je Peppol-koppeling
Bekijk de OpenAPI-specificatie, test met de codevoorbeelden en neem contact op om de API voor je bedrijf te activeren.