Staat je software niet in de lijst met kant-en-klare koppelingen, of bouw je zelf een applicatie die facturen moet versturen en ontvangen via Peppol? Dan kun je rechtstreeks integreren met de eConnect Procurement Service Bus (PSB). De PSB is het technische systeem achter alle eConnect-koppelingen, bereikbaar via psb.econnect.eu. Het eConnect-platform (platform.econnect.eu) is de klantinterface waar je onder andere verbindingssleutels aanmaakt en je instellingen beheert. De PSB biedt drie verbindingsmethoden: een moderne REST API, SFTP en HTTPS.

Welke methode het beste past, hangt af van je architectuur, beveiligingseisen en het verwachte volume. Voor elke methode vind je de technische documentatie op de PSB-ontwikkelportal.

De meest gebruikte methode voor nieuwe integraties. De PSB REST API biedt endpoints voor het verzenden, ontvangen en beheren van facturen, orders en responses. Authenticatie verloopt via OAuth2, met twee beschikbare flows: Resource Owner Password Credentials en Client Credentials. Tokens vraag je aan via POST /connect/token op identity.econnect.eu. Optioneel kan een Subscription-Key header worden meegegeven voor organisatie-specifieke toegang.

Geschikt voor: SaaS-applicaties, webapplicaties, microservices en moderne architecturen.

Documentatie: PSB API & Swagger UI: interactieve API-documentatie, OpenAPI-specificatie en Swagger Editor.

Bestanden uitwisselen via een beveiligde SFTP-verbinding. De PSB ondersteunt twee flows: From SFTP (periodiek ophalen van bestanden van jouw SFTP-server) en To SFTP (documenten pushen naar jouw server bij ontvangst). Beide flows worden geconfigureerd via SFTP-hooks in de PSB.

Geschikt voor: enterprise-omgevingen met batch-verwerking, ERP-systemen als SAP en Unit4 ERP CR.

Documentatie: PSB API & hooks: zoek naar SFTP-hooks in de Hook-endpoints.

Een directe HTTPS-verbinding voor het uitwisselen van facturen. De PSB ontvangt documenten via HTTPS POST en levert ze af via webhooks of HTTPS inbound. Ondersteunt IP-whitelisting en OAuth2.

Geschikt voor: enterprise-koppelingen met specifieke beveiligingseisen.

Documentatie: PSB API & webhooks: HTTPS inbound/outbound en webhook-configuratie.

Technisch: De PSB communiceert intern via het Peppol AS4-protocol met andere Access Points. Dit is geen verbindingsmethode die je als klant kiest; het wordt automatisch gebruikt wanneer je facturen via Peppol verstuurt.

Voor elke integratie met de PSB heb je het volgende nodig:

• Een eConnect-account met minimaal een Professional-abonnement voor SFTP en HTTPS (maatwerk-integraties vereisen een Enterprise-abonnement)
• OAuth2-credentials (client_id en client_secret) voor de PSB REST API
• Voor enterprise-protocollen: een subscription key via de salesafdeling

De snelste manier om te starten is via de REST API: open psb.econnect.eu, verken de Swagger UI en maak je eerste API-call. Meer uitleg vind je in de API & integratie sectie van deze documentatie.

Voor SFTP of HTTPS-koppelingen neem je contact op met de salesafdeling van eConnect voor een intakegesprek. Tijdens dat gesprek worden de technische details, het verwachte volume en de beveiligingseisen besproken. De technische specificaties staan in de PSB API-documentatie.

Tip: Bouw je een integratie voor een softwarepakket dat door meerdere klanten wordt gebruikt? Neem dan contact op met het partnerteam van eConnect. Als partner kun je de koppeling éénmalig bouwen en beschikbaar maken voor al je klanten.

Klaar om te starten? Open de PSB API-documentatie of lees het PSB-overzicht voor meer context.

• PSB API-overzicht
• Overzicht: hoe kun je software koppelen met eConnect?
• Verbindingssleutels aanmaken in eConnect
• Webhooks instellen en beveiligen