Peppol integreren in uw software: architectuur en API-keuze

Peppol inbouwen in uw ERP of softwareproduct? Vergelijk vier architectuurpatronen en ontdek waar u op let bij de API van een serviceprovider.

Terug naar Kennisbank

Wie Peppol wil inbouwen in een ERP-systeem, boekhoudpakket of eigen softwareproduct, staat voor twee keuzes. De eerste is architectonisch: hoe verbindt uw software zich met het Peppol-netwerk? De tweede is praktisch: aan welke eisen moet de API van een serviceprovider voldoen om die verbinding betrouwbaar en schaalbaar te maken? Deze pagina zet de vier gangbare architectuurpatronen naast elkaar en geeft een checklist voor de beoordeling van een API. Veldmapping en validatieregels op detailniveau vallen buiten deze pagina. Meer over de onderliggende norm leest u op de pagina over de EN 16931.

Vier architectuurpatronen

Er is geen patroon dat altijd de beste keuze is. De juiste keuze hangt af van uw schaal, de gewenste controle over het proces en de capaciteit die u hebt voor eigen onderhoud.

Connector in het pakket

Een kant-en-klare Peppol-connector die als plugin of module wordt ingebouwd, vaak aangeboden door een serviceprovider of derde partij. Past bij: snel live, weinig eigen onderhoud. Voordeel: korte time-to-market, beproefde functionaliteit. Nadeel: minder ruimte voor maatwerk, afhankelijk van de roadmap van de leverancier.

Koppeling via de API van een serviceprovider

Uw software communiceert rechtstreeks met de API van een serviceprovider, die de aansluiting op het netwerk verzorgt. Past bij: zelf bepalen hoe verzenden, ontvangen en statusopvolging werken. Voordeel: volledige controle over proces en foutafhandeling. Nadeel: u bouwt en onderhoudt de integratielaag zelf.

Eigen middleware

Een zelfgebouwde of ingekochte tussenlaag die meerdere systemen en eventueel meerdere serviceproviders ontsluit via één interne interface. Past bij: grotere organisaties met meerdere bronsystemen. Voordeel: onafhankelijkheid van één provider, centrale logging. Nadeel: hogere initiële investering en meer beheer.

Zelf serviceprovider worden

U bouwt of beheert zelf een Access Point en SMP en wordt via een Peppol-autoriteit lid van het netwerk. U hebt maximale controle, maar draagt ook alle verplichtingen: testen en certificering, de identificatie van uw eindgebruikers, beschikbaarheid, beveiliging (in Nederland ISO 27001) en de verplichte rapportages aan OpenPeppol. Past bij partijen voor wie Peppol een kernonderdeel van de dienstverlening is. Zie Wat is een Peppol Access Point? en Certified Serviceprovider worden.

Waar u op let bij een API

Kiest u voor een koppeling via een API, direct of via middleware, dan bepaalt de kwaliteit van die API grotendeels hoeveel werk de integratie kost en hoe stabiel ze blijft. Loop deze punten na bij elke kandidaat-API.

Verzenden en ontvangen

  • Validatie vóór verzending, met bruikbare foutmeldingen.
  • Hoe inkomende e-facturen bij u binnenkomen (push of pull), inclusief het originele bestand.
  • Webhooks of statusberichten, en ondersteuning voor Invoice Response.

Eindgebruikers

  • Registratie en beheer van Peppol ID’s via de API.
  • Multi-tenant: meerdere klanten onder één aansluiting, elk met een eigen Peppol ID.
  • Wie de identificatie van uw eindgebruikers uitvoert, en of dat via de API kan.
  • Kunt u registraties meenemen naar een andere provider? In Nederland moet de oude provider binnen drie werkdagen meewerken.

Landen en formaten

  • Peppol BIS Billing 3.0 en nationale varianten zoals XRechnung en NLCIUS.
  • Hoe nieuwe versies worden doorgevoerd.
  • Of landen met een eigen systeem worden gedekt, zoals de plateforme agréée in Frankrijk.

Techniek en beheer

  • Een sandbox die het netwerk nabootst.
  • Versiebeleid.
  • Rate limits.
  • Bescherming tegen dubbel versturen.
  • ISO 27001 of een gelijkwaardige verklaring.

Meer over formaten leest u in Factuurformaten en Peppol documenttypen en standaarden.

Testen vóór livegang

Een werkende API-koppeling betekent nog niet dat het hele proces werkt. Test end-to-end in de sandbox met een paar vaste handelspartners voordat u een klant live zet. Controleer daarbij verzenden én ontvangen, de verwerking van statusberichten en de afhandeling van afgewezen documenten.

Rol daarna gefaseerd uit. Begin met één klant of één documentstroom, bijvoorbeeld alleen uitgaande facturen, en schaal op zodra die stabiel draait. Zo blijven fouten beperkt tot een kleine groep en leert u van de praktijk voordat uw volledige klantenbestand overgaat.

Wat dit betekent voor integrators

Vertaal de architectuurkeuze en de API-checklist naar concrete actiepunten.

  • Bepaal welk architectuurpatroon past bij uw schaal: één integratie of meerdere klanten en tenants
  • Vraag elke kandidaat-API-provider naar de beschikbaarheid van een sandbox, de foutafhandeling en de ondersteuning voor multi-tenant
  • Plan vóór livegang een testtraject met echte handelspartners
  • Leg vast hoe de registratie van Peppol ID’s in uw onboardingproces wordt geautomatiseerd
  • Leg vast wie de identificatie van uw eindklanten doet

Vind serviceproviders met een API in de vergelijker (filter op de categorie Peppol Access point as a Service).

Wat dit betekent voor softwareleveranciers

Voor softwareleveranciers is de keuze ook een productbeslissing. Grofweg zijn er drie routes, dezelfde als op Starten met Peppol: zelf serviceprovider worden, de functionaliteit van een serviceprovider via een API inbouwen (eventueel white-label, onder uw eigen naam), of samenwerken met een externe dienst waarop u aansluit. Zelf serviceprovider worden geeft maximale controle, maar u neemt ook de certificering en het blijvende beheer op u. Inbouwen via een API houdt de gebruikerservaring in uw eigen product en besteedt de aansluiting op het netwerk uit. Een externe dienst vraagt de minste investering, maar geeft u de minste regie.

Weeg af welke rol e-facturatie in uw propositie speelt: is het een kernfunctie waarmee u zich onderscheidt, of een basisvoorziening die gewoon moet werken?

Afsluiting

Een goede Peppol-integratie begint bij een bewuste architectuurkeuze en een kritische beoordeling van de API waarop u bouwt. Welk patroon u ook kiest, de vragen uit de checklist bepalen hoe schaalbaar en onderhoudbaar uw oplossing wordt. Meer over factuurformaten en documenttypen leest u op Factuurformaten en Peppol documenttypen en standaarden. Zoekt u serviceproviders met een API? Bekijk de vergelijker op peppol.nu.

Een API-provider zoeken?

Vind in de vergelijker serviceproviders die Peppol als dienst via een API aanbieden.

Peppol.nu - Jouw gids in de wereld van elektronische facturatie