In tien minuten je eerste e-factuur via de eConnect API. Vraag een API-key aan, haal een OAuth2-token op en verstuur je eerste document. Werkt vanuit elke taal die HTTP en JSON ondersteunt.
Open de Getting started gids
Direct proberen in Swagger
Begin altijd in de acceptatieomgeving. Je test- en productiecredentials zijn strikt gescheiden, dus een testkoppeling kan nooit per ongeluk een echte factuur versturen. Pas als je flow stabiel werkt schakel je over naar productie met dezelfde integratiepatronen.
Vraag een sandbox-account aan en genereer in het platform een API-key. Bewaar de key versleuteld; je gebruikt hem alleen om tokens op te halen.
Wissel de API-key in op het identity-endpoint voor een Bearer-token. Tokens hebben een beperkte geldigheid; ververs ze in je client of middleware.
POST een UBL-factuur naar de juiste endpoint en ontvang direct een document-ID. De webhook bevestigt aflevering op het Peppol-netwerk.
Eén regel om je token op te halen, één POST om je eerste factuur te versturen. Werkt vanuit elke shell.
Officiële bindings met ondersteuning voor authenticatie, documenttypes, webhooks en error handling.
Officiële .NET-binding met dezelfde API-dekking als de PHP-route.
Download de Swagger-spec en genereer een client in Python, Go, Java, TypeScript of een andere taal naar keuze.
Begin met curl voor een snelle proof-of-concept en stap daarna over naar een SDK voor productie. PHP en .NET hebben officiële bindings; voor andere talen genereer je een client uit de OpenAPI-spec.
Bekijk SDK's en CLI
Een werkende verzending is het begin. Voor een productie-stabiele integratie sluit je webhooks aan voor real-time statusupdates, bouw je foutafhandeling met retries op 5xx-responses, en valideer je documenten vooraf via de Validate API zodat alleen valide bestanden je eigen pipeline verlaten.
Webhooks instellen
Nee, voor de proof-of-concept werkt de live Swagger UI op psb.econnect.eu zonder account. Je kunt requests bekijken en de structuur testen. Voor echte testcalls vraag je een sandbox-account aan.
Alle gangbare e-facturatieformaten: UBL Peppol BIS Billing 3.0, NLCIUS, XRechnung, FatturaPA en meer. Voor het volledige overzicht zie documentformaten.
Ja, dat is de aanbevolen aanpak. In de sandbox stuur je een testfactuur naar je eigen Peppol-identifier of een testreceiver. De PSB bevestigt ontvangst via webhook of polling.
4xx-fouten wijzen op validatie of autorisatie en horen niet blind te worden geretried. Bij 5xx-fouten herhaal je met exponential backoff. Webhooks geven je daarnaast asynchroon door wat er fout ging in de verwerking. Zie foutafhandeling.
Ja, via de Validate API. Stuur een document in en je krijgt een isValid-boolean plus alle assertions per validatielaag. Handig om mapping-fouten te vinden voordat je productieverkeer raakt. Zie Validate API.
Stel je vraag
Vraag een sandbox-account aan en doe binnen tien minuten je eerste API-call.
Vraag sandbox-toegang aan
Open de Getting started gids