Peppox API v1

Krachtige Peppol API voor bedrijven en integrators

Peppox Biedt een eenvoudige en krachtige REST API om uw factureringssoftware, ERP-systeem, SaaS-platform of aangepaste applicatie te verbinden met de Peppol-netwerk.

Verkoopfacturen verzenden, creditnota's aanmaken, UBL XML genereren, PDF's bijvoegen, verzonden documenten ophalen en inkoopfacturen ontvangen - allemaal via één uniforme API.

POST /invoice/add Autorisatie: Bearer YOUR_API_KEY Content-Type: application/json { "issue_date": "2026-04-28", "customer": { "endpoint_id": "0208:0123456789", "name": "Customer Company", "country": "BE" } }

Kies het juiste account voor uw integratie.

Peppox is beschikbaar voor beide integratoren En individuele bedrijvenOf u nu meerdere klanten beheert of alleen uw eigen bedrijf, dezelfde API geeft u toegang tot Peppol.

Dezelfde API. Ander gebruik. Integrators kunnen meerdere bedrijven beheren, terwijl bedrijfsaccounts de API kunnen gebruiken voor hun eigen Peppol-documenten.

Alles wat je nodig hebt om de e-facturering van Peppol te automatiseren

Peppox vereenvoudigt elke stap van elektronische facturering: documentcreatie, XML-generatie, PDF-bijlage, Peppox-levering, statuscontrole en het ophalen van inkoopfacturen.

📤 Verkoopfacturen verzenden

Maak factuurheaders aan, voeg factuurregels toe, voeg een PDF-bestand bij en genereer Peppol-compatibele XML van uw gegevens.

🧾 Maak creditnota's aan

Genereer en verstuur creditnota's met dezelfde eenvoudige workflow als voor verkoopfacturen.

📄 Genereer UBL XML

Converteer uw factuur- of creditnotagegevens rechtstreeks vanuit de API naar Peppol-compatibele UBL XML.

📎 PDF-bestanden bijvoegen

Voeg factuur- of creditnota-pdf's toe via de uploadfunctie, Base64-codering of een externe HTTPS-bestands-URL.

📬 Verzonden documenten ophalen

Lijst met verzonden factuurheaders en -regels om de levering, de Peppol-status, klantgegevens en documentgeschiedenis te verifiëren.

📥 Ontvang aankoopfacturen

Haal de kop- en regelgegevens van inkoopfacturen op die u via Peppol van uw leveranciers hebt ontvangen.

🔍 Zoeken, filteren en sorteren

Gebruik filters op datum, status, documenttype, trefwoord, paginering en sortering voor verzonden en ontvangen documenten.

🔐 API-sleutelverificatie

Authenticeer veilig met uw Peppox API-sleutel met behulp van bearer-autorisatie of API-sleutelparameters.

Een eenvoudige workflow voor ontwikkelaars

Peppox is ontworpen om eenvoudig te integreren. U maakt het document aan, voegt de regels toe, koppelt indien nodig de PDF, genereert de XML en Peppox regelt de verbinding met Peppol.

1

Maak het document aan

Voeg een koptekst voor een verkoopfactuur of creditnota toe met klant-, betalings- en leveringsgegevens.

2

Voeg documentregels toe

Voeg producten, diensten, aantallen, prijzen, btw-tarieven en artikelreferenties toe.

3

Voeg een PDF-bestand toe

Upload een PDF-bestand, verstuur het als Base64 of geef een beveiligde externe URL op.

4

XML genereren

Peppox genereert het Peppol-compatibele UBL XML-document.

5

Volgen en ophalen

Volg de verzonden documenten en haal de via Peppol ontvangen aankoopfacturen op.

Belangrijkste API-eindpunten

De Peppox API is overzichtelijk ingedeeld in endpoints voor factuurbeheer, creditnota's, XML-generatie, verzonden documenten en ontvangen inkoopfacturen.

NA

/factuur/toevoegen

Maak een koptekst voor een verkoopfactuur aan in conceptstatus.

NA

/factuurregel/toevoegen

Een regel toevoegen aan een bestaande verkoopfactuur.

NA

/factuur_bijlage_pdf/toevoegen

Voeg een PDF-bestand toe aan een bestaande verkoopfactuur.

NA

/xml/genereren

Genereer een Peppol-compatibel UBL XML-bestand.

NA

/creditnote/add

Maak een koptekst voor een creditnota.

NA

/creditnote_line/add

Een regel toevoegen aan een bestaande creditnota.

KRIJGEN

/doc-sent/header/list

Lijst met verzonden factuurheaders, inclusief filters en Peppol-status.

KRIJGEN

/doc-sent/lines/list

De regels van een verzonden factuur ophalen.

KRIJGEN

/doc-received/header/list

Lijst met de kopteksten van de ontvangen inkoopfacturen.

KRIJGEN

/doc-received/lines/list

De regels van een ontvangen inkoopfactuur ophalen.

Openbare API-documentatie

Bekijk de Peppox API-documentatie.

De API-documentatie van Peppox is openbaar beschikbaar voor ontwikkelaars, integrators en bedrijven. Ga naar de API-pagina om alle beschikbare eindpunten, voorbeeldverzoeken, parameters en reacties te ontdekken.

Of u nu verkoopfacturen wilt versturen, creditnota's wilt aanmaken, verzonden documenten wilt ophalen of inkoopfacturen wilt ontvangen, de documentatie helpt u te begrijpen hoe u uw software met Peppox aan Peppox kunt koppelen.

Schone JSON, eenvoudige verzoeken

Peppox accepteert schone JSON-payloads en standaard HTTP-verzoeken. Ontwikkelaars kunnen het verzenden en ontvangen van Peppox snel integreren in bestaande platforms zonder dat ze meerdere providerspecifieke API's hoeven te leren.

  • REST API met JSON-payloads
  • Eenvoudige authenticatie met API-sleutel
  • Duidelijke document-GUID's voor het bijhouden van gegevens
  • Compatibel met PHP, Python, Node.js, Java, .NET en elke HTTP-client.
Maak een verkoopfactuur aan
curl -X POST "https://api.peppox.com/invoice/add/" \
-H "Autorisatie: Drager YOUR_API_KEY" \
-H "Content-Type: application/json" \
-D '{
"uitgiftedatum": "2026-04-28",
"due_date": "2026-05-28",
"valuta": "EUR",
"klant": {
"endpoint_id": "0208:0123456789",
"naam": "Klantenbedrijf",
"land": "BE"
}
}'
Lijst met ontvangen inkoopfacturen
curl "https://api.peppox.com/doc-received/header/list/?supplier_id=YOUR_SUPPLIER_ID"

Peppol-documenten verzenden, ontvangen en verifiëren

Peppox is niet alleen geschikt voor het versturen van facturen. Uw applicatie kan ook verzonden documenten opvragen, de status ervan controleren en inkoopfacturen van leveranciers importeren.

Voor uitgaande documenten

Uw applicatie kan verkoopfacturen en creditnota's versturen, de leveringsstatus controleren en de documentgeschiedenis opvragen wanneer dat nodig is.

  • Kop- en regelnummers van verkoopfacturen
  • Creditnota-kopteksten en -regels
  • PDF-bijlagen
  • UBL XML-generatie
  • Lijst met verzonden documenten en verificatie van de Peppol-status

Voor inkomende documenten

Uw applicatie kan via Peppol ontvangen inkoopfacturen ophalen en importeren in uw ERP-, boekhoudsysteem of interne validatieworkflow.

  • Ontvangen kopteksten van inkoopfacturen
  • Ontvangen inkoopfactuurregels
  • Informatie over leveranciers en klanten
  • Totaalbedrag btw, te betalen bedrag en betalingsgegevens
  • Zoeken op datum, status, documenttype en trefwoord
Begin vandaag nog met bouwen.

Verbind uw software met Peppol via één API.

Maak een integratoraccount aan om meerdere bedrijven te koppelen, of maak een bedrijfsaccount aan om uw eigen Peppol-documenten rechtstreeks via Peppol te verzenden en te ontvangen.