Peppol API voor Belgische e-facturatie vanuit uw eigen software
Laat uw ERP, webshop of eigen facturatieprogramma UBL-facturen rechtstreeks via Peppol versturen. U krijgt meteen een status terug en volgt de aflevering met webhooks.
De Peppol API zetten wij per onderneming 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.
Meteen een status
De response bevat een submissionId en de status sending of failed, met een foutmelding als er iets misloopt.
Aflevering via webhooks
Wijzigt de status, bijvoorbeeld naar delivered of failed, dan krijgt uw webhook-URL een callback.
Wanneer kiest u de Peppol API?
- Uw kmo factureert vanuit een eigen ERP, webshop of platform en u wilt elke factuur automatisch via Peppol versturen.
- Sinds 1 januari 2026 sturen Belgische btw-plichtige ondernemingen elkaar gestructureerde e-facturen. Uw klanten zijn standaard bereikbaar op schema 0208 met hun ondernemingsnummer, zodat uw software het Peppol-ID zelf kan samenstellen. FOD Financiën: voor wie wordt e-facturatie verplicht?
- U betaalt liever per verstuurde factuur, zonder vast maandbedrag.
Geen koppeling nodig?
Maakt u uw facturen in Factuur Simpel zelf? Dan hebt u de API niet nodig: Peppol zit in Compleet, zonder kosten per factuur.
Peppol-facturen maken en versturen met uw facturatieprogramma
Maakt uw ERP al UBL-bestanden en uploadt u die liever dan dat u een koppeling bouwt?
OpenAPI-documentatie en codevoorbeelden
Begin in Swagger UI of importeer de OpenAPI-JSON in uw eigen tooling.
API-referenties
Swagger UI
Bekijk de request- en response-schema's en test vanuit uw browser.
https://api.factuursimpel.be/docs/peppolOpenAPI-JSON
Importeer het schema in Postman, Insomnia of uw codegenerator.
https://api.factuursimpel.be/docs/peppol/openapi.jsonEndpoint voor verzenden
Beveiligd endpoint voor één UBL-factuur per request.
POST https://api.factuursimpel.be/v1/peppol/invoicecurl --request POST \
--url 'https://api.factuursimpel.be/v1/peppol/invoice' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"xml": "BASE64_ENCODED_UBL_XML",
"targetNetwork": "auto"
}'Zet uw API-sleutel in de Authorization-header. API-sleutels maakt u aan bij Instellingen > API-sleutels.
Afleverstatus via webhooks
Na een geaccepteerde verzending krijgt uw 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 ziet u in de webhookgeschiedenis, waar u ze opnieuw verstuurt.
- Gebruik submissionId als unieke sleutel, zodat een opnieuw verstuurde callback niet dubbel wordt verwerkt.
Beveilig uw endpoint
Callbacks hebben geen signature-header. Gebruik een HTTPS-endpoint en controleer elke submissionId tegen uw 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": "0208:0123456789"
},
"updatedAt": "2026-02-28T09:42:11.202Z"
}Prijs per verstuurde factuur
Geen maandbedrag en geen aparte API-toeslag. U betaalt per factuur die u 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. Verstuurt u 5.000 facturen in een maand, dan betaalt u 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 gaat u live
- Maak gratis een account aan en zet Peppol aan in uw instellingen.
- Neem contact met ons op. Wij activeren de Peppol API en de prijs per factuur voor uw onderneming.
- Maak een API-sleutel aan bij Instellingen > API-sleutels en stel uw webhook-URL's in.
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 endpoint?
Per request één base64-gecodeerd UBL-XML-document. ZIP-bestanden accepteert dit endpoint niet; daarvoor gebruikt u bulkverzending.
Wanneer krijg ik webhook-callbacks?
Zodra de status van een verzending wijzigt. 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 u 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 uw onderneming aan. Daarna maakt u een API-sleutel aan bij Instellingen > API-sleutels en stelt u uw webhook-URL's in.
Wat kost de Peppol API?
U betaalt per verstuurde factuur, van € 0,35 tot € 0,12 excl. btw. De prijs per factuur daalt per staffel naarmate u in een kalendermaand meer facturen verstuurt. Er is geen maandbedrag en geen minimumvolume.
Start uw Peppol-koppeling
Bekijk de OpenAPI-specificatie, test met de codevoorbeelden en neem contact op om de API voor uw onderneming te activeren.