Onder de motorkap van de PSB: hoe eConnect miljoenen documenten per jaar verwerkt

Als je via eConnect een factuur verstuurt, duurt het minder dan 100 milliseconden voordat die factuur is verwerkt en onderweg is naar de ontvanger. Achter die snelheid zit een doordachte architectuur die we de Procurement Service Bus noemen, kortweg PSB. In dit artikel lichten we de motorkap op en laten we zien welke keuzes ervoor zorgen dat het platform dag in, dag uit betrouwbaar draait.

De PSB is meer dan een Peppol Access Point. Het is een volledig beheerde integratiehub die de schakel vormt tussen e-delivery-netwerken en de interne systemen van onze klanten. Facturen, orders, creditnota's, timecards: alles passeert dezelfde verwerkingsmotor. Of een document via Peppol, via een ander procurement-netwerk of per e-mail moet worden afgeleverd, de PSB bepaalt automatisch het juiste kanaal en het juiste formaat.

Die architecturale keuze is bewust. Veel Peppol-providers bieden alleen een doorgeefluik: document erin, document eruit. Wij wilden meer. We wilden een platform dat documenten ook valideert, transformeert, routeert en verrijkt. Een platform waar softwarepartners met één integratie toegang krijgen tot alle netwerken, zonder voor elk kanaal een aparte koppeling te bouwen.

De PSB is gebouwd op Service Fabric volgens het Actor-model. Elk document wordt verwerkt door een onafhankelijke actor: een zelfstandige eenheid die zijn eigen state beheert en onafhankelijk van andere actoren functioneert. Dat betekent dat duizenden documenten tegelijkertijd worden verwerkt, zonder dat ze op elkaar hoeven te wachten. Er zijn geen gedeelde databases die vertraging veroorzaken, geen locks die processen blokkeren.

Bij een storing op een server wordt de actor automatisch herstart op een andere node, zonder dataverlies. De state van elke actor wordt synchroon opgeslagen op minimaal drie locaties. Dat klinkt als een technisch detail, maar het betekent in de praktijk dat een hardwarestoring voor de verzender en ontvanger onzichtbaar is.

Updates aan de software worden uitgerold als rolling upgrades: nodes worden één voor één bijgewerkt. Als een node na de update niet correct functioneert, wordt automatisch teruggerold. In de hele levensduur van de PSB is er nooit een deployment geweest die downtime heeft veroorzaakt.

De PSB distribueert verkeer over meerdere redundante Access Points, doorgaans vijf tot zeven. Bij onderhoud aan een Access Point worden minimaal vier andere actief gehouden. Deze opzet zorgt voor een natuurlijke spreiding van het verkeer en voor maximale beschikbaarheid.

Daarnaast beheert eConnect een eigen SMP (Service Metadata Publisher), verdeeld over tien partities met elk minimaal twee standby-replicas. De SMP is de Peppol-component die bepaalt hoe een organisatie bereikbaar is. Doordat we een eigen SMP draaien met caching, zijn we niet afhankelijk van de uptime van andere providers voor het opzoeken van ontvangstgegevens. Dat maakt het routeringsproces sneller en betrouwbaarder.

Een van de krachtigste kenmerken van de PSB is multi-channel routering. Via één REST API-integratie bereikt een organisatie ontvangers op Peppol, maar ook op andere procurement-netwerken zoals Coupa, Tungsten en SAP Ariba, of via SFTP, HTTPS en e-mail als fallback.

De PSB kiest automatisch het beste kanaal. Het uitgangspunt is altijd Peppol (#PeppolFirst): als de ontvanger op Peppol geregistreerd staat, wordt daar afgeleverd. Is dat niet het geval, dan controleert de PSB of de ontvanger via een ander netwerk bereikbaar is. Pas als laatste optie wordt de factuur per e-mail verstuurd.

Tegelijkertijd wordt het document automatisch getransformeerd naar het formaat dat de ontvanger verwacht. Een factuur in NLCIUS naar een Duitse ontvanger die XRechnung verwacht? Automatisch geconverteerd. Een cXML-document voor een ontvanger op Coupa? Dezelfde automatische transformatie. De verzender hoeft maar in één formaat aan te leveren.

Alle klanten van eConnect draaien op dezelfde cloud-infrastructuur, maar de logische scheiding is compleet. Het is technisch onmogelijk om bij documenten van een andere klant te komen. Elke organisatie opereert in een volledig afgeschermde omgeving.

Deze aanpak is een bewuste keuze. Een gedeelde, goed beveiligde infrastructuur is naar onze overtuiging veiliger dan fysiek gescheiden omgevingen die elk apart moeten worden onderhouden en beveiligd. Beveiligingsupdates, patches en verbeteringen worden in één keer doorgevoerd voor alle klanten, in plaats van per installatie.

De architectuurkeuzes vertalen zich naar concrete prestaties:

• Verwerkingstijd bij verzending: minder dan 100 milliseconden per document
• Bewezen capaciteit: 200.000 berichten per uur
• Uptime sinds februari 2018: geen enkele service-onderbreking, ruim acht jaar
• Contractuele SLA: 99,99% beschikbaarheid
• Volume: meer dan 12 miljoen documenten per jaar voor meer dan 20.000 organisaties

Wie met e-facturatie werkt, kent het probleem: een Access Point dat tijdelijk onbereikbaar is vanwege gepland onderhoud of onverwachte drukte. Facturen die in een wachtrij belanden, statusberichten die niet aankomen, klanten die bellen. Bij eConnect is dat nooit voorgekomen. De combinatie van rolling upgrades (geen onderhoudsmomenten met downtime), meerdere redundante Access Points en automatische load distribution zorgt ervoor dat het verkeer altijd doorstroomt, ook tijdens updates.

Die betrouwbaarheid is ook architecturaal verankerd: de PSB-backbone en de Control-webinterface zijn bewust gescheiden qua beschikbaarheid. Bij een cloudstoring in oktober 2025 bleef de PSB volledig actief, terwijl de webinterface en de eConnect-website tijdelijk onbereikbaar waren. Voor organisaties die via de API integreren, was er op dat moment geen onderbreking.

De PSB-architectuur is specifiek ontworpen met softwarepartners in gedachten. Boekhoud-, ERP- en facturatiepakketten integreren via een gedocumenteerde REST API met OAuth2-beveiliging, volledige Swagger/OpenAPI-documentatie en SDK's voor PHP en .NET. Softwareleveranciers die dat willen, kunnen de PSB aanbieden onder hun eigen merk via het white-label model, inclusief eigen inlogpaden en huisstijl.

Dat partnermodel verklaart ook waarom de architectuur zo is opgezet. Een softwarepartner die vandaag 500 klanten koppelt en volgend jaar 5.000, moet erop kunnen vertrouwen dat het platform meegroeit. Met het Actor-model, de meerdere Access Points en de automatische load distribution is die schaalbaarheid geen belofte maar een eigenschap van het ontwerp.

eConnect verwerkt ongeveer 30% van alle Peppol-registraties in Nederland en circa 40% van het Nederlandse Peppol-transactievolume. Die positie is niet ontstaan door marketing, maar door een infrastructuur die doet wat ze belooft: documenten snel, betrouwbaar en in het juiste formaat afleveren, ongeacht het netwerk.

De PSB is het fundament waarop al het andere is gebouwd. Het eConnect-platform, de documentvalidator, de factuurverwerking en de integraties met meer dan honderd softwarepakketten draaien allemaal op dezelfde motor.

Benieuwd hoe de PSB past bij jouw organisatie of softwareproduct? Plan een kennismaking.