Peppol-ID controleren en opzoeken


curl "https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=peppol_id&reference=0208%3A0202239951" \
  -H "Authorization: Bearer YOUR_API_KEY"

Voer een Peppol-ID in (schema, dubbele punt, waarde) en zie of het goed gevormd is. Daarna kunt u opzoeken of het in het Peppol-netwerk geregistreerd is.

Hoe een Peppol-ID is opgebouwd

Een Peppol-ID bestaat uit een schema van vier cijfers, een dubbele punt en de waarde, bijvoorbeeld 0106: voor een KvK-nummer en 0208: voor een Belgisch ondernemingsnummer. De controle past de regel van het schema toe, voor zover de Peppol-codelijst of een nationaal nummer er een geeft.

De opzoeking leest in het Peppol-netwerk of het ID op het moment van de controle is geregistreerd. Een bedrijf dat onder dit ID niet wordt gevonden, kan onder een ander ID zijn geregistreerd of facturen buiten Peppol ontvangen. In België is de e-facturatie sinds 1 januari 2026 verplicht voor btw-plichtige B2B-transacties.

Wat de controle zegt

Voor het Peppol-ID zijn er geen controlecijfers om te testen, of niet met bewijs, dus alleen de vorm wordt gecontroleerd.

Wat de controle niet zegt

  • Ze zegt niet dat de referentie is toegekend, geregistreerd of actief is, noch dat een belastingdienst een factuur met die referentie accepteert.
  • Geen live status van een nationale belastingdienst wordt aangeboden.
  • De controle draait in uw browser: wat u intypt wordt niet naar Prometiam gestuurd, behalve een Peppol-ID dat u zelf laat opzoeken.
  • Prometiam is geen Peppol-toegangspunt: het verstuurt, ontvangt of valideert geen facturen.

Dezelfde controle via de API

GET /einvoicing/check met type=peppol_id en reference geeft valid, normalized, basis en, waar de waarde iets codeert, parts. Eén credit per aanroep, fouten zijn gratis.

curl 'https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=peppol_id&reference=0208%3A0202239951' \
  -H 'Authorization: Bearer rk_live_...'

Gerelateerde pagina's

Registreren · API-documentatie

De proefperiode duurt 14 dagen en omvat 500 credits. Een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend; daarna loopt het Starter-plan (9,99 € per maand) tenzij u opzegt.

Veelgestelde vragen

Betekent slagen dat het Peppol-ID bestaat?
Nee. Het betekent dat de waarde goed gevormd is. Een offline controle zegt nooit dat een referentie is toegekend, geregistreerd of actief is.
Wordt dit bij de belastingdienst gecontroleerd?
Nee. Geen live status van een nationale belastingdienst wordt aangeboden; de controle is offline.
Kan ik dit in code doen?
Ja: GET /einvoicing/check?type=peppol_id&reference=... met een API-sleutel, één credit per aanroep.