Ik heb gestructureerde factuurgegevens
Maak de hoofding, voeg elke regel toe, koppel eventueel de visuele PDF en genereer daarna het Peppol UBL-document.
Bekijk dit proces →
Peppox Developer Platform
Stuur uw eerste factuur via Peppol, stap voor stap.
Kies de route die bij uw systeem past: van de eerste API-call tot de opvolging van de levering.
PEPPOX / INTEGRATION FLOW
- 01Dashboard
- 02API-sleutel
- 03Factuur
- 04Valideren
- 05Peppol
READY TO BUILD
01 · Voor de eerste call
Vier zaken die u één keer voorbereidt
Werk eerst uw account en leveranciersprofiel af. Daarna gebruikt uw toepassing dezelfde gegevens voor elk document.
- 01
Maak uw Peppox-account
Registreer de juridische onderneming die documenten verstuurt.
- 02
Vul het leveranciersprofiel in
Bedrijfs-, btw-, bank- en Peppol-routeringsgegevens komen uit uw account.
- 03
Open de integratieomgeving
Test veilig met de dashboardtools voordat u naar productie gaat.
- 04
Kopieer uw API-sleutel
Bewaar hem uitsluitend op uw server; nooit in browser- of mobiele code.
02 · Kies de kortste route
Vertrek van de gegevens die u al hebt
Ik maak al een PDF
Upload de PDF, laat Peppox de gegevens uitlezen, controleer en bevestig ze en verstuur via Peppol.
Bekijk dit proces →03 · PDF2Peppol
Een volledige verzending in vier API-calls
De meest directe gedocumenteerde route wanneer uw systeem al PDF-facturen maakt.
- 01
Upload de PDF
Stuur een bestand, Base64-inhoud of URL en bewaar de queue_guid.
POST/pdf2peppol/add - 02
Controleer de uitgelezen gegevens
Vraag de status op tot de verwerking klaar is en controleer koper, totalen, btw en regels.
GET/pdf2peppol/check - 03
Bevestig het document
Bevestig pas wanneer alle uitgelezen factuurgegevens correct zijn.
POST/pdf2peppol/confirm - 04
Verstuur naar Peppol
Verstuur het bevestigde document en bewaar de document-GUID.
POST/pdf2peppol/send - 05
Volg de levering
Gebruik de lijst met verzonden documenten of het dashboard voor de eindstatus.
GET/doc-sent/header/list
Minimaal voorbeeld
Upload → check → confirm → send
Vervang de voorbeeldwaarden door uw sleutel en de identificatoren uit de vorige call.
pdf2peppol.sh
curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
-F "supplier_id=YOUR_SUPPLIER_ID" \
-F "pdf=@invoice.pdf" \
-F "network=integration"
# Save queue_guid, then check it
curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=YOUR_SUPPLIER_ID&queue_guid=QUEUE_GUID"
curl -X POST "https://api.peppox.com/pdf2peppol/confirm/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID","confirmed":1}'
curl -X POST "https://api.peppox.com/pdf2peppol/send/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID"}'04 · Gestructureerde factuur-API
Bouw een Peppol-klare factuur uit uw gegevens
Ideaal wanneer uw ERP elk factuurveld en elke regel al gestructureerd bewaart.
- 01
Maak de hoofding
Stuur klant, datums, valuta, betaling en levering en bewaar invoice_guid.
POST/invoice/add - 02
Voeg de regels toe
Herhaal de call voor elk product of elke dienst.
POST/invoice_line/add - 03
Koppel de PDF (optioneel)
Voeg de leesbare factuur toe via bestand, Base64 of URL.
POST/invoice_attach_pdf/add - 04
Genereer UBL XML
Peppox combineert hoofding, regels en bijlage; succes geeft XML_BUILT.
POST/xml/generate - 05
Volg en beheer
Bekijk document en status in het dashboard of via de API voor verzonden documenten.
GET/doc-sent/header/list
API NOTE
Belangrijk: de gepubliceerde referentie voor gestructureerde facturen beschrijft XML-generatie, maar momenteel geen aparte finale /send-endpoint. Gebruik PDF2Peppol voor een expliciete verzendcall of voltooi de verzending via de geconfigureerde Peppox-workflow of het dashboard.
05 · Endpointoverzicht
Alle endpoints in duidelijke taal
01Facturen
POST/invoice/addMaak een factuurhoofding en ontvang invoice_guid.
POST/invoice_line/addVoeg een regel toe aan een factuur.
POST/invoice_attach_pdf/addKoppel of vervang de factuur-PDF.
02UBL-generatie
POST/xml/generateGenereer Peppol-compatibele UBL XML.
03Creditnota’s
POST/creditnote/addMaak een creditnotahoofding.
POST/creditnote_line/addVoeg een regel toe aan een creditnota.
POST/creditnote_attach_pdf/addKoppel of vervang de creditnota-PDF.
04Verzonden documenten
GET/doc-sent/header/listLijst verzonden hoofdingen met filters en paginering.
GET/doc-sent/lines/listHaal de regels van een verzonden document op.
05Ontvangen documenten
GET/doc-received/header/listLijst ontvangen hoofdingen met filters en paginering.
GET/doc-received/lines/listHaal de regels van een ontvangen document op.
06PDF2Peppol
POST/pdf2peppol/addUpload een PDF en start de extractie.
GET/pdf2peppol/checkControleer status en uitgelezen velden.
POST/pdf2peppol/confirmBevestig de gecontroleerde gegevens.
POST/pdf2peppol/sendVerstuur het bevestigde document via Peppol.
06 · Testen zonder code
Begrijp elke aanvraag in het dashboard voordat u code schrijft
Het Peppox-dashboard bevat begeleide formulieren die de API’s voor u aanroepen. Test echte documenten, ontdek verplichte parameters en begrijp het JSON-antwoord vóór u uw ERP koppelt.
- 01Kies een endpoint en vul de velden in
- 02Voer de aanvraag uit zonder testclient
- 03Bekijk GUID’s, JSON en fouten
- 04Valideer het proces in de integratieomgeving
- 05Neem de werkende aanvraag over in uw backend
- 06Volg verzonden en ontvangen documenten
Bewaar deze identificatoren
De integratiestatus blijft eenvoudig
invoice_guidVerbindt hoofding, regels, PDF en gegenereerde XML.
queue_guidVerbindt de vier PDF2Peppol-calls tijdens de extractie.
document-GUIDVerbindt het einddocument met levering en reconciliatie.
Als een aanvraag mislukt
400Controleer ontbrekende of ongeldige velden.401Controleer API-sleutel en omgeving.404Controleer de GUID uit de vorige call.429Vertraag en probeer opnieuw met oplopende wachttijd.500Log de aanvraag, probeer veilig opnieuw en contacteer Peppox als het blijft duren.