Test je integratie veilig in een geïsoleerde omgeving voordat je naar productie gaat. Een testaccount geeft toegang tot dezelfde API als productie, maar documenten blijven op het Peppol testnetwerk en bereiken nooit echte ontvangers.
Vraag een testaccount aan
Bekijk de API-documentatie
De sandbox is de acceptatieomgeving van de Procurement Service Bus (PSB). Je valideert, verzendt en ontvangt er documenten met dezelfde API-flow als in productie. Token-aanvragen, API-calls en webhooks gedragen zich identiek. Het verschil zit in de routering: documenten verstuurd vanuit een testaccount blijven binnen het Peppol testnetwerk en raken nooit het productie-Peppol-netwerk.
Daardoor kun je mapping, foutafhandeling, statuslogica en webhook-flows uittesten zonder risico voor klanten of operationele processen. Je test- en productiecredentials blijven strikt gescheiden, zodat een testkoppeling nooit per ongeluk een echte factuur kan versturen.
Een clientId en clientSecret waarmee je via de Identity Server een Bearer-token aanvraagt. Voor server-naar-server integraties is de Client Credentials-flow standaard.
Aparte URLs voor PSB API, Identity Server, VPD-service en mailhook-adres. Strikt gescheiden van productie, zodat configuratiefouten geen impact hebben op live verkeer.
Validate API, Transform API, webhooks, Peppol-registratie via SMP/SML-test, documentverzending en -ontvangst. Alles werkt zoals in productie.
Een geregistreerde Peppol-partij in het testnetwerk waarmee je documenten verzendt en ontvangt. Geen impact op je productie-registratie.
Na goedkeuring van je aanvraag krijg je toegang tot de complete acceptatieomgeving en alle bijbehorende endpoints.
Een testaccount loopt vandaag via sales en delivery. Je neemt contact op via het contactformulier of plant een kennismaking. Sales bespreekt met jou welk type integratie je bouwt (eigen integratie, softwarekoppeling, white-label PSB-partner) en wat de scope is; delivery maakt vervolgens je credentials en testparty aan.
Tijdens het gesprek bespreek je de architectuur, het beoogde volume, eventuele white-label of multi-tenant eisen, en of je naast acceptatie ook direct productiecredentials wilt voorbereiden. Zo voorkom je dat je tijdens je integratietraject opnieuw moet wachten op nieuwe credentials.
We werken aan een eenvoudiger aanvraagproces voor developers, zodat je in de toekomst sneller en zelfstandiger kunt starten zonder eerst een sales- en delivery-traject te doorlopen.
accp-psb.econnect.eupsb.econnect.euaccp-identity.econnect.euidentity.econnect.euaccp-vpd.econnect.eu/graphql/v1vpd.econnect.eu/graphql/v1@accp.econnect.email@econnect.emailHoud in je configuratie altijd duidelijk gescheiden welke set je gebruikt. Verwar acceptatie nooit met productie.
Na een succesvolle acceptatiefase schakel je gecontroleerd over naar productie met dezelfde integratiepatronen die je al hebt getest. Je bouwt geen tweede integratie; je wisselt de endpoints en credentials. Dat houdt het release-traject voorspelbaar en kort.
De gebruikelijke route is: integreren tegen de sandbox, end-to-end testen (verzenden, ontvangen, statussen, foutscenario's), monitoring en logging inrichten, en pas dan productiecredentials activeren. Bij complexere trajecten (white-label, hoge volumes, meerdere documenttypen) ondersteunen eConnect-specialisten de overgang.
Aan het aanvragen en gebruik van een sandbox-account zijn geen kosten verbonden tijdens een lopend integratietraject. De omgeving is bedoeld om je integratie naar productie te brengen. De voorwaarden bespreek je tijdens het kennismakingsgesprek, samen met de inrichting van je productieaccount.
Nee. Documenten verstuurd vanuit een sandbox-account blijven binnen het Peppol testnetwerk en bereiken nooit echte productie-ontvangers. Dat is de hele bestaansreden van de sandbox: je kunt vrij testen zonder per ongeluk een echte factuur, order of statusbericht te versturen.
Voor een end-to-end test die ook andere systemen raakt (bijvoorbeeld een ontvangend ERP), kun je in de sandbox een eigen ontvangende party registreren en documenten naar je eigen testparty sturen.
Ja. De sandbox is een volledige acceptatieomgeving. OAuth2-tokenflow, REST API-calls, webhooks, validatie, transformatie, Peppol-registratie en mailhooks gedragen zich identiek. Het verschil zit in de credentials, de endpoints (accp- prefix) en de scheiding van Peppol-verkeer.
Daardoor kun je in de sandbox bouwen tot je integratie volledig stabiel is, en hoef je tijdens go-live geen functionele verrassingen te verwachten. Volg de stappen in de getting started gids voor je eerste API-call.
Een eerste werkende API-call doe je vaak binnen een dag. Een volledige integratie tot productieklaar duurt gemiddeld twee tot vier weken, afhankelijk van scope, documenttypen en interne testdekking. Veel klanten beginnen met één afgebakende use case (bijvoorbeeld verkoopfacturen verzenden), brengen die naar productie, en breiden daarna gefaseerd uit met inkoopfacturen, orders of self-billing.
Nee. Je kunt een sandbox aanvragen zonder productieaccount, bijvoorbeeld als softwareleverancier die een Peppol-koppeling onderzoekt of als white-label partner in een verkenningsfase. Tijdens het traject leg je vast wanneer je productiecredentials nodig hebt; deze kunnen apart worden aangemaakt of meegenomen in dezelfde aanvraag.
Houd in je configuratie altijd twee aparte sets: één voor accp--endpoints met je sandbox-credentials, één voor productie. Veel teams werken met aparte environment-variabelen of secrets per omgeving en bouwen een controle in die voorkomt dat productiecredentials worden ingeladen tijdens een test-run. Dit patroon staat verder uitgewerkt in authenticatie.
Vraag een testaccount aan en bouw veilig je integratie op de acceptatieomgeving van de PSB.
Vraag een testaccount aan
Plan een kennismaking