Peppol-kennisbank
Begrijp het netwerk achter elke Peppox-integratie
Zoek praktische richtlijnen over standaarden, identifiers, discovery, transport, validatie, operations en landmodellen.
BAS
Basisprincipes
Overzicht op hoofdlijnen van Peppol, governance en kernconcepten.
Wat is Peppol en wie beheert het?
Peppol is een gereguleerd, interoperabel raamwerk en netwerk voor het uitwisselen van gestructureerde zakelijke documenten (bijv. e-facturen, creditnota’s, MLR). Het wordt gecoördineerd door OpenPeppol, een non-profitvereniging die specificaties vastlegt en Access Points en SMPs certificeert.
Welke voordelen biedt Peppol ten opzichte van point-to-point-integraties?
Peppol gebruikt een “één keer koppelen, velen bereiken”-model via gecertificeerde Access Points, waardoor maatwerksinterfaces worden verminderd, gedeelde validatieregels (EN 16931, BIS/PINT) worden afgedwongen, grensoverschrijdende interoperabiliteit wordt verbeterd en gestandaardiseerde vindbaarheid en veilige transportlaag mogelijk worden gemaakt.
Is Peppol verplicht binnen de EU?
Er is geen eenduidig EU-breed Peppol-mandaat. De EU vereist EN 16931 voor e-facturen binnen overheidsopdrachten; veel landen voeren nationale B2B-verplichtingen in. Peppol wordt breed toegepast als de manier om aan deze verplichtingen te voldoen en interoperabel te werken.
Welke documenten komen het meest voor op Peppol?
Invoice en CreditNote (BIS Billing 3.0 / PINT), Message Level Response (MLR) en Invoice Response. Ook logistieke documenten bestaan in de Peppol Post-Award-set.
Wat is het ‘four-corner model’?
Afzender → Verzendend Access Point → Ontvangend Access Point → Ontvanger. Discovery (SML→SMP) wordt gebruikt om vóór levering de mogelijkheden en het beveiligde eindpunt van de ontvanger te vinden.
IDE
Identificatiecodes (ISO 6523)
Inzicht in deelnemersidentificatiecodes en veelvoorkomende valkuilen.
Hoe worden ontvangers geïdentificeerd?
Peppol gebruikt ISO 6523-schema’s (ICD + waarde), opgemaakt als iso6523-actorid-upis::ICD:WAARDE (bijv. GLN = 0088, Belgische CBE = 0208).
Welk identificatieschema moet ik gebruiken?
Gebruik het schema dat overeenkomt met uw officiële identificatiecode (bijv. GLN 0088, België 0208 voor BCE/CBE). Uw Access Point of de richtlijnen van de nationale autoriteit moeten het juiste schema bevestigen.
Veelvoorkomende fouten met identificatiecodes
BTW-nummers en ondernemingsregister-ID’s door elkaar halen; voorloopnullen verwijderen; een landelijk BTW-formaat onder de verkeerde ICD gebruiken; testidentificaties gebruiken in productie.
Directory versus registratie
Zichtbaar zijn in een directory of lookup-tool is niet hetzelfde als een geldig SMP-record hebben voor een specifiek document/proces. Controleer altijd de SMP-mogelijkheden van de ontvanger.
DIS
Discovery (SMP/SML)
Hoe SML en SMP samenwerken.
Wat is het verschil tussen SML en SMP?
SML (Service Metadata Locator) koppelt een deelnemers-ID aan zijn SMP. De SMP (Service Metadata Publisher) slaat de ondersteunde documenttypes, proces-ID’s en eindpunten van de deelnemer op.
Wat moet ik controleren in een SMP-record?
Correcte documentTypeID, processID, actief eindpunt met peppol-transport-as4-v2_0 en een geldig certificaat. Controleer de omgeving (test versus productie).
Waarom mislukken opvragingen soms met 404 of 429?
404 = er is geen mogelijkheid gepubliceerd voor die deelnemer/dat document in die SMP. 429 = rate limiting door publieke eindpunten; vertraag het tempo of gebruik de API van uw provider.
DOC
Documenten & profielen
BIS Billing 3.0, PINT en gerelateerde profielen.
Wat is Peppol BIS Billing 3.0?
Een CIUS van EN 16931 die definieert hoe UBL Invoice en Credit Note via Peppol worden uitgewisseld, met aanvullende regels en codelijsten om interoperabiliteit te waarborgen.
Wat is PINT en wanneer wordt het gebruikt?
Het Peppol International Invoice Model (PINT) harmoniseert e-facturatie wereldwijd en vormt de basis voor landspecifieke specialisaties (bijv. PINT A-NZ, PINT MY, SG BIS).
Wat zijn ProcessIDs en waarom zijn ze belangrijk?
ProcessIDs (bijv. cenbii-procid-ubl::urn:fdc:peppol.eu:2017:poacc:billing:3:1.0) geven bedrijfsprocessen weer die gekoppeld zijn aan een documentprofiel; deze moeten overeenkomen met de SMP-vermelding van de ontvanger.
MLR vs Invoice Response
MLR biedt technische/zakelijke feedback; Invoice Response biedt zakelijke bevestigingen (bijv. acceptatie/afwijzing met redenen). Controleer de SMP-ondersteuning.
VAL
Validatie & codelijsten
EN 16931 + BIS/PINT laten slagen voor validatie.
Veelvoorkomende oorzaken van validatiefouten
Onjuiste belastingcategorieën; ongeldige eenheidscodes; verschillen in valuta/afronding; ontbrekende BT- identifiers; onjuiste landspecifieke extensies; bijlagen van niet-toegestane typen.
Welke codelijsten falen vaak?
UN/ECE eenheidscodes, ISO-valutacodes, btw-categorieën, betaalmiddelcodes, landspecifieke lijsten (bijv. Noorwegen EHF-specifieke vereisten; Singapore, A-NZ PASR/PINT).
Hoe los je EN 16931- versus BIS-fouten op?
Valideer eerst tegen EN 16931 en daarna tegen de Peppol BIS/PINT-regels. Gebruik officiële validators en, waar beschikbaar, landspecifieke validators (bijv. EHF-validator in Noorwegen).
TRA
Transport & beveiliging (AS4, PKI)
AS4-transport en basisprincipes van OpenPeppol PKI.
Welk transport wordt gebruikt?
Peppol gebruikt het AS4-profiel (peppol-transport-as4-v2_0) met ondertekening en encryptie tussen Access Points.
Veelvoorkomende AS4-leveringsproblemen
Verlopen of bijna verlopen certificaten; onjuiste endpoint-URL; TLS-/cipher-mismatch; klokafwijking; grote payloads zonder compressie; te lage retry-instellingen.
Hoe zit het met certificaten en PKI?
AP/SMP-certificaten moeten voldoen aan het OpenPeppol PKI-beleid. Volg notBefore/notAfter, ketenvaliditeit, OCSP/CRL-status en plan vernieuwingen tijdig.
ONB
Onboarding & testen
Van sandbox naar productie.
Checklist om te starten
Kies een gecertificeerde AP, registreer een ISO 6523-ID, stel SMP-capaciteiten in, valideer UBL's (EN 16931 + BIS/PINT), piloteer MLR/Invoice Response en ga daarna live.
Test- versus productieomgevingen
Gebruik gescheiden test-SML- en SMP-omgevingen en AP-endpoints. Hergebruik testidentifiers nooit in productie.
Best practices voor cutover
Voer een dual-run uit met voorbeeldhandelspartners, monitor MLR/fouten, bevestig afhankelijkheden voor fiscale rapportage en communiceer de tijdlijnen aan handelspartners.
OPS
Operations & monitoring
Wat te meten en hoe te reageren.
Wat moeten we dagelijks monitoren?
Validatieresultaten, SMP-wijzigingen, endpointgezondheid, AS4-herpogingen, feedback via MLR/Invoice Response, certificaatverloop en berichtlatentie.
Hoe om te gaan met rate limits en openbare lookups?
Cache resultaten, respecteer rate limits, geef voorkeur aan API's aan de providerzijde en vermijd het scrapen van openbare endpoints tijdens piekuren.
Bewaartermijnen en audit trails
Bewaar berichtmetadata (hash, tijdstempels, verzender-/ontvanger-ID's, document-ID's), validatierapporten en MLR/IR-antwoorden volgens beleid en wetgeving.
PRI
Gegevensbescherming & juridisch
GDPR, lokale wetgeving en verantwoordelijkheden.
Is Peppol GDPR-conform?
Peppol definieert veilig transport en identifiers, maar compliance blijft uw verantwoordelijkheid: rechtsgrondslag, bewaartermijnen, rechten van betrokkenen en een DPIA waar vereist.
Vervangt Peppol fiscale rapportage?
Nee. Sommige landen vereisen aanvullende e-reporting/CTC-processen. Controleer nationale verplichtingen naast documenttransport en validatie.
TRO
Probleemoplossing
Veelvoorkomende problemen en snelle controles.
Bezorging mislukt, maar de deelnemer wordt online “gevonden”
Een hit in de directory bewijst geen geschiktheid. Controleer in SMP het exacte documentTypeID en processID. Zorg ervoor dat uw AP het vermelde AS4-endpoint target.
Validatie mislukt op totalen of btw
Controleer afronding (regel- vs factuurniveau), valutaprecisie, consistentie van btw-categorieën en de verdeling van kortingen/toeslagen volgens de regels van EN 16931.
Bijlagen afgewezen
Alleen bepaalde MIME-types en groottes zijn toegestaan. Zorg ervoor dat base64-codering/-metadata correct zijn en dat bestandsnamen indien vereist ASCII-veilig zijn.
429 Te Veel Verzoeken van publieke eindpunten
Beperk de snelheid, voeg backoff toe en geef de voorkeur aan de API's van uw provider. Bundel SMP-opzoekingen en cache de resultaten.
COU
Landprofielen & Lokale Modellen
Hoe Peppol of EN 16931 lokaal wordt gebruikt.
België
B2B e-facturatie wordt verplicht vanaf 1 jan 2026 (gefaseerd). Peppol is bevestigd als de standaard voor het uitgeven van gestructureerde facturen. B2G is al van kracht.
Duitsland
Vanaf 1 jan 2025 moeten bedrijven EN 16931 e-facturen kunnen ontvangen; uitgifteplichten worden tot 2028 gefaseerd ingevoerd. XRechnung/ZUGFeRD sluiten aan op EN 16931.
Frankrijk
E-facturatie/e-rapportage wordt vanaf sept 2026 gefaseerd ingevoerd; DGFiP is de Peppol Authority. Het model omvat PPF/PDP en Peppol-interoperabiliteit.
Noorwegen
EHF Billing 3.0 is gebouwd op Peppol BIS 3.0; uitgebreid gebruik in de publieke en private sector.
Singapore (InvoiceNow)
Nationaal e-factureren op basis van Peppol; IMDA is de autoriteit. Er zijn handleidingen beschikbaar voor dienstverleners en btw-overwegingen.
Australië & Nieuw-Zeeland
PINT A-NZ is het huidige model; de A-NZ BIS 3.0-uitbreiding is in 2025 buiten gebruik gesteld om de migratie naar PINT te ondersteunen.
Maleisië
PINT Maleisië-specialisaties (Billing/Self-billing) gepubliceerd onder OpenPeppol Post-Award-documentatie.
Italië
Nationaal B2B gebruikt SDI (FatturaPA). Peppol kan worden gebruikt voor grensoverschrijdende transacties of met partners/AP's die dit ondersteunen, maar SDI blijft nationaal verplicht.
DEV
Tips voor Ontwikkelaars & Operations
Praktische richtlijnen voor implementatoren.
Veilige SMP-opzoekpatronen
Bundel en cache opzoekingen; respecteer SML/SMP TTL; gebruik waar beschikbaar de API's van de provider; controleer zowel documentTypeID als processID.
Certificaten beheren
Monitor geldigheidsperiodes, automatiseer verlengingsmeldingen, verifieer ketens en test eindpunten na rollover. Houd klokken synchroon (NTP).
Observeerbaarheid
Log correlatie-ID's, deelnemer-ID's, document-ID's, SMP-URL, endpoint-URL, validatieresultaten en MLR/IR-payloads om audits te ondersteunen.
Veerkracht
Gebruik exponentiële backoff voor AS4-herpogingen, implementeer idempotentie aan de verzendzijde en bewaak throughput-/latentie-SLA's.
GLO
Woordenlijst
Access Point (AP)
Gecertificeerde gateway die AS4-berichten valideert en uitwisselt in het Peppol-netwerk.
SMP / SML
SMP slaat mogelijkheden/eindpunten op; SML verwijst via DNS naar de juiste SMP.
BIS Billing 3.0
Peppol CIUS van EN 16931 voor Invoice en CreditNote.
PINT
Peppol International Invoice Model; basis voor wereldwijde/landelijke specialisaties.
AS4
Beveiligd en betrouwbaar berichttransportprofiel dat door Peppol AP's wordt gebruikt.