Ontwikkelaarsvriendelijke Peppol-integratie

De Peppox API Hiermee integreert u Peppol e-facturatie in minuten, in plaats van weken. Verbind uw ERP, boekhoudsysteem of SaaS-platform via één eenvoudige, uniforme REST API – geen SOAP, geen complexiteit.

API-toegang verkrijgen
Deze service is voor ontwikkelaars/integratoren die meerdere bedrijven of rechtspersonen beheren.
Met Peppox kunt u al uw cliënten beheren vanaf één veilige, gebruiksvriendelijke interface.
Maak een speciale Bedrijfsaccount voor elke klant die u beheert en gebruikt u dezelfde eenvoudige API om verzenden en ontvangen hun Peppol-facturen en creditnota's — zonder te worden of registreren bij een toegangspunt.

Voorbeeld: Als uw ERP meerdere bedrijven/klanten host, maakt u voor elk bedrijf/klant een Peppox Company-account aan en verbindt u deze met onze API om namens hen documenten te bezorgen en ontvangen.

Maak verbinding op uw manier - beheerd toegangspunt of uw eigen

Wij maken het leven gemakkelijker voor ontwikkelaars en integratorsAls u nog geen Peppol Access Point heeft, begin dan met het verzenden Peppol-conforme facturen vandaag de dag met behulp van de Peppox beheerd toegangspunt — geen ingewikkelde onboarding.

Heeft u al een toegangspunt? koppel uw referenties en certificaten in ons beveiligde dashboard en je bent klaar. In beide gevallen gebruik je de dezelfde Peppox API en eindpunten — geen codewijzigingen.

Breng uw eigen toegangspunt mee

Behoud uw huidige provider en sluit deze binnen enkele minuten aan, zonder herschrijven of migratieproblemen.

  • Bewaar uw inloggegevens en certificaten veilig in het dashboard
  • Geen codewijziging - dezelfde eindpunten en payloads
  • Geünificeerde logs, leveringstracking en inzicht in fouten

Nog geen toegangspunt?

Gebruik de Peppox beheerd toegangspunt en verstuur uw eerste factuur in twee klikken.

  • Geen aparte AP-contracten of langdurige onboarding
  • Hoogwaardige, veilige routering naar het Peppol-netwerk
  • UBL/PEPPOL BIS-validatie en ondersteuning voor PDF-bijlagen
Dezelfde API voor beide scenario's. Kiezen beheerd of gekoppeld in configuratie — eindpunten blijven identiek.

U kunt op elk gewenst moment van toegangspunt wisselen via het dashboard. Zo behoudt u uw API-aanroepen en hoeft u alleen de configuratie bij te werken.

Twee API-workflows voor ontwikkelaars

Kies hoe u documenten naar Peppol wilt verzenden.

Peppox biedt ontwikkelaars twee krachtige manieren om Peppox e-facturering te integreren. U kunt documenten samenstellen door gestructureerde factuurgegevens te verzenden via onze bestaande API-eindpunten, of gebruikmaken van de nieuwe methode. PDF2Peppol API Om documenten sneller te verzenden vanuit een eenvoudig PDF-bestand.

🧱

1. API voor gestructureerde facturen

Dit is de huidige workflow voor ontwikkelaars. Uw applicatie verzendt handmatig de factuurgegevens: koptekst, klant, leverancier, regels, belastingen, totalen, bijlagen, en genereert vervolgens de Peppol XML.

  • U hebt controle over elk factuurveld.
  • Je verzendt gestructureerde JSON-gegevens.
  • U voegt factuurregels toe via speciale eindpunten.
  • U kunt de PDF bijvoegen indien nodig.
  • Je genereert en verzendt Peppol-compatibele XML.
/v1/factuur/toevoegen /v1/factuurregel/add/{id} /v1/factuur_bijlage_pdf/toevoegen /v1/xml/genereren
📄

2. PDF2Peppol API

Dit is de snelste workflow. Uw applicatie stuurt een PDF-factuur of creditnota naar Peppox. Peppox bereidt de documentgegevens voor, uw systeem controleert deze, bevestigt ze en stuurt ze vervolgens naar Peppox.

  • Geen handmatige XML-generatie
  • U hoeft niet elk factuurveld zelf in kaart te brengen.
  • Werkt met facturen en creditnota's.
  • Verificatiestap vóór verzending
  • Ideaal als uw software al PDF's genereert.
/pdf2peppol/add/ /pdf2peppol/check/ /pdf2peppol/confirm/ /pdf2peppol/send/

Van PDF naar Peppol in een paar API-aanroepen

Met PDF2Peppol hoeft u uw facturatiesysteem niet opnieuw op te bouwen. Als uw ERP-, SaaS-platform of boekhoudsoftware al PDF-facturen of creditnota's genereert, kunt u Peppox gebruiken om dat document om te zetten in een workflow die geschikt is voor verzending via Peppol.

PDF-document Peppox-controle Bevestigen Peppol-bezorging
PDF2Peppol API workflow illustration

Gestructureerde API voor volledige controle door de ontwikkelaar

Deze API-workflow is ideaal wanneer uw applicatie al gestructureerde factuurgegevens bevat. U stuurt JSON naar Peppox – wij verzorgen automatisch de XML-validatie, certificaatverificatie en routering naar toegangspunten.

🔑 Veilige authenticatie

Maak verbinding met uw API-sleutel. Elk verzoek is alleen voor uw account bestemd en gecodeerd.

📤 Factuur-eindpunt

Facturen versturen met POST /v1/facturen/verzenden — wij bezorgen het bij het juiste Access Point.

📡 Webhooks

Ontvang asynchrone meldingen voor leveringsbevestigingen, afwijzingen of fouten.

🧰 SDK's

Gebruik kant-en-klare SDK's voor PHP, Python of Node.js en bespaar dagen aan ontwikkeling.

Voorbeeldverzoek — Factuur versturen

Een eenvoudig voorbeeld met behulp van krulVervang uw inloggegevens en Peppox valideert en bezorgt de factuur automatisch bij het juiste toegangspunt.


curl -X POST https://api.peppox.com/v1/invoices/send \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "access_point": "auto", "invoice": { "invoiceNumber": "INV-2025-1001", "issueDate": "2025-10-12", "currency": "EUR", "buyer": { "vat": "BE0123456789" }, "seller": { "vat": "BE0987654321" }, "lines": [ { "description": "Softwareontwikkeling", "bedrag": 1250,00 }, { "description": "Ondersteunende diensten", "bedrag": 350,00 } ], "bijlagen": [ { "type": "pdf", "fileBase64": "JVBERi0xLjQKJeLjz9M..." } ] } }'

✅ Hetzelfde gesprek werkt met elk toegangspunt — Peppox regelt de routering.

Overzicht van API-eindpunten: Gestructureerde API en PDF2Peppol API

Eindpunt Beschrijving Methode
/v1/factuur/toevoegen Maak een nieuwe factuurkoptekst en sla de leverancier-, klant- en betalingsgegevens op. NA
/v1/factuurregel/add/{id} Voeg een of meerdere product- of serviceregels toe aan een bestaande factuur. NA
/v1/factuur_bijlage_pdf/toevoegen Voeg een PDF-document toe aan een bestaande factuur via uploaden, Base64 of een externe URL. NA
/v1/xml/genereren Genereer een Peppol-compatibel UBL XML-bestand met de factuur, de bijbehorende regels en bijlagen. NA
/v1/webhooks/register Registreer een webhook om bezorgupdates te ontvangen NA
PDF2Peppol API — documenten sneller verzenden vanuit een PDF-bestand
/pdf2peppol/add/ Upload een PDF-factuur of creditnota. Peppox bereidt de documentgegevens voor verwerking voor. NA
/pdf2peppol/check/ Controleer de geëxtraheerde en voorbereide documentgegevens voordat u ze naar Peppol verzendt. KRIJGEN
/pdf2peppol/confirm/ Controleer of de documentgegevens correct zijn en klaar zijn voor verzending door Peppol. NA
/pdf2peppol/send/ Stuur de bevestigde factuur of creditnota naar het Peppol-netwerk. NA