Overzicht van de Procurement Service Bus (PSB) API van eConnect: architectuur, mogelijkheden en documenttypen.
De Procurement Service Bus (PSB) is de centrale API-gateway van eConnect waarmee je e-facturen, orders en andere handelsdocumenten verstuurt, ontvangt en verwerkt. De PSB verbindt jouw software met het Peppol-netwerk en andere e-facturatienetwerken via een moderne REST API met OAuth2-beveiliging.
Of je nu een softwareleverancier bent die e-facturatie wil integreren, of een organisatie die documentstromen wil automatiseren: de PSB biedt de infrastructuur om dat betrouwbaar en schaalbaar te doen.
De PSB is meer dan een verzendkanaal. Het is een volwaardig platform voor het verwerken van handelsdocumenten, met functionaliteit die het hele purchase-to-pay traject afdekt.
E-facturatie is de kern. Via de API verstuur je verkoopfacturen naar ontvangers op het Peppol-netwerk en ontvang je inkoopfacturen van leveranciers. De PSB routeert documenten automatisch naar het juiste Access Point en bevestigt de aflevering met real-time statusupdates.
E-ordering gaat verder dan facturatie. De PSB ondersteunt het verzenden en ontvangen van orders, orderbevestigingen, orderwijzigingen en annuleringen. Zowel Peppol Order Only als Order Advanced worden ondersteund, evenals DICO-berichten (inclusief onderhoudsbericht), Coupa en cXML. Orders kunnen met één druk op de knop worden omgezet ("geflipped") naar een factuur.
Self-billing maakt het mogelijk om namens een leverancier facturen aan te maken en te verzenden. Dit is relevant voor organisaties die inkoopfacturen zelf opstellen op basis van ontvangen goederen of diensten.
Validatie biedt een standalone endpoint waarmee je XML-documenten kunt controleren op correctheid zonder ze te verzenden. De Validate API herkent het documentformat automatisch, test tegen de meest recente artefacten en levert gedetailleerde, meertalige feedback per validatieregel.
Transformatie converteert documenten van het ene e-factuurformaat naar het andere. Je levert aan in het formaat dat jouw software produceert en de PSB zorgt automatisch voor de juiste conversie richting de ontvanger. De PSB ondersteunt meer dan 20 standaarden, waaronder UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC en brancheformaten als DICO, SETU en SEEF. Het formaat wordt automatisch gedetecteerd bij upload; je hoeft niet aan te geven welk formaat je aanlevert.
Validated Party Data (VPD) is een GraphQL API waarmee je partijgegevens opvraagt en verifieert. Controleer of een KvK-nummer, OIN of BTW-nummer daadwerkelijk bij een bepaalde organisatie hoort, voordat je een factuur verstuurt. In Control is dezelfde functionaliteit bekend onder de klantgerichte naam Purple Pages.
Intelligent Document Recognition (IDR) converteert PDF-facturen naar gestructureerde XML via OCR en AI. De IDR is direct aanstuurbaar via de PSB API, met instelbare kwaliteitsniveaus en prioriteiten.
De PSB is gebouwd op het Actor-model in een Microsoft Azure Service Fabric cluster. Dat klinkt technisch, maar de voordelen zijn concreet: documenten worden parallel verwerkt over meerdere servers, zonder dat ze op elkaar wachten. Bij een storing op een server wordt de verwerking automatisch voortgezet op een andere node, zonder dataverlies.
In de praktijk betekent dit een verwerkingstijd van minder dan 100 milliseconden per document bij verzending, een bewezen capaciteit van 200.000 berichten per uur en een uptime van 99,99% (ruim acht jaar zonder ongeplande uitval).
De PSB opereert als Peppol Access Point met meerdere Access Points in de standaardconfiguratie. Volume wordt dynamisch verdeeld via betrouwbare queues. Elke tenant is logisch geïsoleerd: het is technisch onmogelijk om bij documenten van een andere tenant te komen. De PSB draait op Microsoft Azure (regio's Nederland en Ierland); alle dataverwerking vindt plaats binnen de EU/EER.
Met een enkele API-integratie krijg je toegang tot meerdere netwerken. De PSB routeert documenten automatisch naar het juiste kanaal op basis van de ontvanger.
De PSB is voorbereid op de Europese ViDA-richtlijn (VAT in the Digital Age), die per 1 juli 2030 Digital Reporting Requirements (DRR) verplicht stelt voor grensoverschrijdende B2B-transacties. Bij het verzenden van een factuur genereert de PSB automatisch de DRR-samenvatting op basis van de factuurgegevens en stuurt deze naar de relevante belastingdienst. Als integrator hoef je hier niets extra voor te doen: je verstuurt je factuur via de reguliere API en de PSB regelt de rapportage.
De PSB implementeert hiervoor het Peppol 5-corner model, waarbij het Access Point de CTC-rapportage (Continuous Transaction Controls) verzorgt namens de verzender. Statusberichten, evidence files en CTC-rapportageberichten zijn inbegrepen in de documentprijs, zonder extra kosten per bericht.
De PSB werkt event-driven. In plaats van periodiek te pollen of er nieuwe documenten zijn, kun je webhooks instellen die je applicatie direct notificeren bij relevante events: een factuur ontvangen, een factuur succesvol afgeleverd, een fout bij verzending, een Invoice Response van de ontvanger.
Hooks ondersteunen meerdere actietypes: HTTPS-webhooks, e-mailnotificaties, SFTP-push, en zelfs batch-verwerking waarbij documenten periodiek als ZIP-archief worden aangeboden. Elk hook-type is beveiligd met HMAC SHA256-handtekeningen.
De PSB gebruikt OAuth 2.0 voor authenticatie, met ondersteuning voor zowel Client Credentials als Resource Owner Password Credentials flows. Alle communicatie verloopt via TLS 1.2 of hoger. Binaire uploads worden automatisch gescand op virussen en malware, en XML-documenten worden gevalideerd tegen standaard regelsets.
Elke tenant opereert in een logisch geïsoleerde omgeving. De PSB verwerkt documenten voor meer dan 20.000 organisaties.
De PSB REST API (v1) is georganiseerd rond de volgende endpoint-groepen:
De volledige endpoint-documentatie met request- en responseformaten is beschikbaar als interactieve Swagger UI. De bijbehorende swagger.json kun je downloaden om client code te genereren.
Ben je klaar om te beginnen? De artikelen hieronder helpen je op weg, van het aanvragen van een testaccount tot het doen van je eerste API-aanroep.
De PSB biedt endpoints voor e-facturatie (verzenden en ontvangen), e-ordering, self-billing, validatie, transformatie, partijgegevens (VPD) en PDF-herkenning (IDR). Met een enkele API-integratie krijg je toegang tot Peppol en andere procurement-netwerken.
De PSB verwerkt documenten in minder dan 100 milliseconden bij verzending, met een bewezen capaciteit van 200.000 berichten per uur. De uptime is 99,99%, met ruim acht jaar zonder ongeplande uitval.
De PSB gebruikt OAuth 2.0 voor authenticatie, met ondersteuning voor zowel Client Credentials als Resource Owner Password Credentials flows. Alle communicatie verloopt via TLS 1.2 of hoger.
Je levert aan in het formaat dat jouw software produceert. De PSB detecteert het documentformaat automatisch en transformeert het naar het formaat dat de ontvanger verwacht. Meer dan 20 standaarden worden ondersteund, waaronder UBL, NLCIUS, BIS Billing V3, PINT, CII, XRechnung, Factur-X, FatturaPA en brancheformaten als DICO en SETU. Je hoeft je geen zorgen te maken over het formaat van de ontvanger.
De PSB is ViDA-ready. Bij het verzenden van een factuur genereert de PSB automatisch de DRR-samenvatting (Digital Reporting Requirement) op basis van de factuurgegevens en stuurt deze naar de relevante belastingdienst. Als integrator hoef je hier niets extra voor te doen. Statusberichten, evidence files en CTC-rapportageberichten zijn inbegrepen in de documentprijs.
Bekijk de interactieve API-documentatie