Testen Sie Ihre Integration sicher in einer isolierten Umgebung, bevor Sie in die Produktion gehen. Ein Testkonto bietet Zugang zur gleichen API wie die Produktion, aber Dokumente verbleiben im Peppol-Testnetzwerk und erreichen nie echte Empfänger.

Testkonto anfordern

API-Dokumentation ansehen

was ist die Sandbox
Eine sichere Akzeptanzumgebung

Die Sandbox ist die Akzeptanzumgebung des Procurement Service Bus (PSB). Sie validieren, senden und empfangen dort Dokumente mit dem gleichen API-Flow wie in der Produktion. Token-Anforderungen, API-Aufrufe und Webhooks verhalten sich identisch. Der Unterschied liegt im Routing: Dokumente, die von einem Testkonto gesendet werden, verbleiben im Peppol-Testnetzwerk und berühren nie das Produktions-Peppol-Netzwerk.

Dadurch können Sie Mapping, Fehlerbehandlung, Statuslogik und Webhook-Flows testen, ohne Kunden oder operative Prozesse zu gefährden. Ihre Test- und Produktionszugangsdaten bleiben strikt getrennt, sodass eine Testverbindung nie versehentlich eine echte Rechnung senden kann.

OAuth2-Zugangsdaten

Eine clientId und ein clientSecret, mit denen Sie über den Identity Server ein Bearer-Token anfordern. Der Client-Credentials-Flow ist Standard für Server-zu-Server-Integrationen.

Dedizierte Test-Endpunkte

Separate URLs für PSB API, Identity Server, VPD-Service und Mailhook-Adresse. Strikt von der Produktion getrennt, sodass Konfigurationsfehler keine Auswirkungen auf den Live-Betrieb haben.

Vollständige API-Funktionalität

Validate API, Transform API, Webhooks, Peppol-Registrierung über SMP/SML-Test, Dokumentversand und -empfang. Alles funktioniert wie in der Produktion.

Eigene Testpartei

Eine registrierte Peppol-Partei im Testnetzwerk, mit der Sie Dokumente senden und empfangen. Keine Auswirkungen auf Ihre Produktionsregistrierung.

was Sie erhalten
Was ist in einem Testkonto enthalten?

Nach Genehmigung Ihres Antrags erhalten Sie Zugang zur vollständigen Akzeptanzumgebung und allen zugehörigen Endpunkten.

anfordern
Wie fordern Sie ein Testkonto an?

Ein Testkonto starten Sie über den Sandbox-Assistenten. Schließen Sie den Assistenten ab, um OAuth2-Zugangsdaten und eine Testpartei im Peppol-Testnetzwerk anzufordern. Wählen Sie die Art der Integration, die Sie aufbauen (eigene Integration, Software-Connector, White-Label-PSB-Partner).

Für Partner- oder NDA-Trajekte mit begleiteter Einrichtung können Sie weiterhin ein Kennenlerngespräch vereinbaren.

KomponenteAkzeptanz (Sandbox)ProduktionPSB APIaccp-psb.econnect.eupsb.econnect.euIdentity Serveraccp-identity.econnect.euidentity.econnect.euVPD-Serviceaccp-vpd.econnect.eu/graphql/v1vpd.econnect.eu/graphql/v1Mailhook E-Mail@accp.econnect.email@econnect.email
Endpunkte
Akzeptanz- vs. Produktions-Endpunkte

Halten Sie in Ihrer Konfiguration immer eine klare Trennung zwischen den verwendeten Sets aufrecht. Verwechseln Sie Akzeptanz nie mit Produktion.

zur Produktion
Von der Sandbox zur Produktion

Nach einer erfolgreichen Akzeptanzphase wechseln Sie kontrolliert zur Produktion mit denselben Integrationsmustern, die Sie bereits getestet haben. Sie bauen keine zweite Integration; Sie tauschen die Endpunkte und Zugangsdaten aus. Das hält den Release-Prozess vorhersehbar und kurz.

Der übliche Weg ist: Integration gegen die Sandbox, End-to-End-Tests (Senden, Empfangen, Status, Fehlerszenarien), Monitoring und Logging einrichten, und erst dann Produktionszugangsdaten aktivieren. Bei komplexeren Projekten (White-Label, hohe Volumina, mehrere Dokumenttypen) unterstützen eConnect-Spezialisten den Übergang.

Häufig gestellte Fragen
Kostet ein Sandbox-Konto etwas?

Das Anfordern und Verwenden eines Sandbox-Kontos ist während eines laufenden Integrationsprojekts kostenlos. Die Umgebung ist dazu gedacht, Ihre Integration in die Produktion zu bringen. Die Konditionen besprechen Sie beim Kennenlerngespräch, zusammen mit der Einrichtung Ihres Produktionskontos.

Kennenlerngespräch vereinbaren

Kann ich Dokumente in der Sandbox an echte Empfänger senden?

Nein. Dokumente, die von einem Sandbox-Konto gesendet werden, verbleiben im Peppol-Testnetzwerk und erreichen nie echte Produktionsempfänger. Das ist der eigentliche Zweck der Sandbox: Sie können frei testen, ohne versehentlich eine echte Rechnung, Bestellung oder Statusnachricht zu senden.

Für einen End-to-End-Test, der auch andere Systeme betrifft (z. B. ein empfangendes ERP), können Sie in der Sandbox eine eigene empfangende Partei registrieren und Dokumente an Ihre eigene Testpartei senden.

Funktionieren alle API-Funktionen in der Sandbox genauso wie in der Produktion?

Ja. Die Sandbox ist eine vollständige Akzeptanzumgebung. OAuth2-Token-Flow, REST-API-Aufrufe, Webhooks, Validierung, Transformation, Peppol-Registrierung und Mailhooks verhalten sich identisch. Der Unterschied liegt in den Zugangsdaten, den Endpunkten (accp--Präfix) und der Trennung des Peppol-Traffics.

Dadurch können Sie in der Sandbox bauen, bis Ihre Integration vollständig stabil ist, und müssen beim Go-live keine funktionalen Überraschungen erwarten.

Wie lange dauert eine Integration in der Sandbox?

Ihren ersten funktionierenden API-Aufruf erledigen Sie oft an einem Tag. Eine vollständige Integration bis zur Produktionsreife dauert durchschnittlich zwei bis vier Wochen, abhängig von Umfang, Dokumenttypen und interner Testabdeckung.

Benötige ich ein Produktionskonto, um eine Sandbox anzufordern?

Nein. Sie können eine Sandbox ohne Produktionskonto anfordern, zum Beispiel als Softwareanbieter, der eine Peppol-Verbindung untersucht, oder als White-Label-Partner in einer Erkundungsphase.

Wie trenne ich Test- und Produktionszugangsdaten in meiner Anwendung?

Halten Sie in Ihrer Konfiguration immer zwei separate Sets bereit: eines für accp--Endpunkte mit Ihren Sandbox-Zugangsdaten, eines für die Produktion. Viele Teams verwenden separate Umgebungsvariablen oder Secrets pro Umgebung.

bereit?
Bereit, Ihre Integration zu testen?

Fordern Sie ein Testkonto an und bauen Sie Ihre Integration sicher in der PSB-Akzeptanzumgebung auf.

Testkonto anfordern

Kennenlerngespräch vereinbaren