Sandbox

Was ist der Sandbox-Modus?

Sandbox ist eine isolierte Testumgebung, in der Sie B2Brouter ausprobieren können — Rechnungen ausstellen, Dokumente senden, die API testen — ohne echte Daten, echte Empfänger oder die Anzahl der Transaktionen Ihres Abonnements zu berühren.

Jede Sandbox ist ein in sich geschlossener Arbeitsbereich mit eigenen Daten: Rechnungen, Kontakte, Produkte, Vorlagen und API-Schlüssel leben vollständig getrennt von Ihrem Produktionskonto. Alles, was Sie in der Sandbox erstellen, bleibt in der Sandbox; alles, was Sie in Production erstellen, bleibt in Production.

Wofür Sandbox gedacht ist:

B2Brouter End-to-End ausprobieren, bevor Sie sich für einen kostenpflichtigen Plan entscheiden.
Ihre API-Integration validieren, bevor Sie sie gegen Production richten.
Schulungen, Demos oder Proof-of-Concept-Arbeiten durchführen, ohne Ihre Live-Daten zu beeinflussen.
Dokumente durch ihren Lebenszyklus (draft → sent → registered) führen, damit Ihr Integrationscode den Erfolgsweg der State Machine durchlaufen kann.

Hinweis. Momentan simuliert Sandbox nur den Happy Path. Send-Operationen sind immer erfolgreich und Dokumente erreichen immer ihren Endzustand — Sandbox bildet keine Ablehnungen, Netzwerkfehler oder andere Fehlerbedingungen nach. Testen Sie diese gegen Ihre eigene Staging-Infrastruktur, nicht gegen die B2Brouter-Sandbox.

Was Sandbox nicht ist:

Es ist keine Staging- oder Pre-Release-Version von B2Brouter. Es läuft derselbe Code wie in Production — nur die Daten und ausgehenden Integrationen unterscheiden sich.
Es ist weder ein Backup noch eine Kopie Ihrer Produktionsdaten. Sandboxes starten leer (abgesehen von einigen Startdatensätzen, die aus Ihrem Konto initialisiert werden) und sind unabhängig.

Erste Schritte

Eine Sandbox erstellen (Web UI)

Melden Sie sich bei B2Brouter an.
Klicken Sie im Header auf die Schaltfläche Developers (Blitzsymbol).
- Wenn Sie noch kein eDocExchange-Abonnement haben, öffnet sich direkt das Integrationsbanner — von dort aus wird Ihre erste Sandbox erstellt.
- Wenn Sie bereits eDocExchange haben, enthält der Developers-Bereich einen eigenen Abschnitt Sandbox (Box-Symbol); öffnen Sie ihn.
Klicken Sie auf Create Sandbox.
Geben Sie im Modal Ihrer Sandbox einen Namen. Standardmäßig wird Ihr Kontoname gefolgt von “Sandbox” verwendet — ändern Sie ihn, wenn Sie mehrere parallel verwalten möchten.
Klicken Sie auf Create. Ihre neue Sandbox erscheint in der Liste.

Nachdem Ihre erste Sandbox erstellt wurde, wird der Zugangspunkt Developers für alle zur Sandboxes-Liste — dort werden alle Sandboxes angezeigt, die mit Ihrem Konto oder Ihrer Integrationsgruppe verknüpft sind, mit Zeilen zum Öffnen, Umbenennen oder Löschen jeder einzelnen.

Sie können bis zu 5 Sandboxes pro Konto oder Integrationsgruppe haben. Die Schaltfläche Create wird deaktiviert, sobald das Limit erreicht ist; löschen Sie eine bestehende Sandbox, um einen Platz freizugeben.

Eine Sandbox öffnen

Klicken Sie in der Sandboxes-Liste auf das Open-Icon (↗) neben der Sandbox, die Sie verwenden möchten. B2Brouter schaltet in den Sandbox-Modus und landet auf der Seite mit den API-Schlüsseln für diese Sandbox.

Während Sie sich im Sandbox-Modus befinden, wird oben auf jeder Seite ein violettes Banner angezeigt, das Sie daran erinnert, in welcher Umgebung Sie sich befinden. Jede Seite, die Sie aufrufen, jede Aktion, die Sie ausführen — Rechnungsstellung, Kontakte, Einstellungen — arbeitet gegen die Sandbox, bis Sie sie wieder verlassen.

Eine Sandbox verlassen

Klicken Sie im violetten Banner auf Exit Sandbox. Sie kehren zu Ihrem Produktionskonto zurück und das Banner verschwindet.

Sie können dieselbe Sandbox jederzeit über die Sandboxes-Liste wieder öffnen — Sandboxes bleiben bestehen, bis Sie sie löschen.

Eine Sandbox löschen oder umbenennen

Aus der Sandboxes-Liste:

Umbenennen: Klicken Sie auf das Umbenennen-Symbol und bearbeiten Sie den Namen inline.
Löschen: Klicken Sie auf das Löschsymbol. Alle Daten in dieser Sandbox (Rechnungen, Kontakte, API-Schlüssel usw.) werden dauerhaft entfernt.

Die API in der Sandbox verwenden

Das Sandbox-Routing wird vollständig durch den API-Schlüssel gesteuert. Es gibt keine separate Sandbox-URL, keine sandbox.-Subdomain und keinen Umgebungs-Header, den Sie setzen müssten. Verwenden Sie die Standard-Base-URL der B2Brouter-API — https://api.b2brouter.net/ — und:

Production-Schlüssel beginnen mit prod_ (oder ohne Präfix bei Legacy-Schlüsseln).
Sandbox-Schlüssel beginnen mit test_.

Wenn Sie einen Endpunkt mit einem test_…-Schlüssel aufrufen, wird Ihre Anfrage automatisch in der Sandbox-Umgebung verarbeitet. Mit einem Produktionsschlüssel geht sie nach Production. Derselbe Endpunkt, derselbe Request-Body — das Routing erfolgt über den Schlüssel.

Einen Sandbox-API-Schlüssel erhalten

Öffnen Sie die Sandbox, die Sie verwenden möchten (Web UI, siehe §2.2).
Sie landen automatisch auf der Seite mit den API-Schlüsseln. Falls nicht, navigieren Sie dorthin über das Menü.
Erzeugen oder kopieren Sie den API-Schlüssel. Er beginnt mit test_.

Übergeben Sie diesen Schlüssel im Header X-B2B-API-Key (oder im Query-Parameter api_key, wenn Ihr Client nur Query-Parameter unterstützt) bei jeder Anfrage, die in die Sandbox geroutet werden soll.

Was funktioniert

Jeder API-Endpunkt, den Sie in Production verwenden würden, funktioniert auch in der Sandbox: Rechnungen erstellen, Kontakte anlegen, Integrationsgruppen anlegen, Dokumente senden, Status abrufen, Webhooks, XML exportieren und so weiter. Das Verhalten ist identisch, außer bei den unten beschriebenen simulierten ausgehenden Aufrufen.

Webhooks

Webhooks werden aus der Sandbox ausgelöst. Das ist beabsichtigt — die Webhook-Zustellung ist etwas, das Integratoren testen müssen. Konfigurieren Sie eine Webhook-URL für eine Sandbox-Integrationsgruppe und Sie erhalten Aufrufe dorthin, sobald sich Dokumentstatus ändern. Production- und Sandbox-Webhooks sind unabhängig: Sie werden getrennt konfiguriert und überschneiden sich nicht.

Auswirkungen der Verwendung von Sandbox

Gemeinsame Identität, getrennte Daten

Ihre Benutzeridentität ist gemeinsam zwischen Production und Sandbox: dieselbe Anmeldung, dasselbe Passwort, dieselbe 2FA-Konfiguration und dieselben Wiederherstellungscodes funktionieren in beiden Umgebungen. Sie melden sich einmal an und können frei zwischen den Umgebungen wechseln.

Alles andere ist zwischen beiden Umgebungen isoliert:

Unabhängig in jeder Umgebung — Rechnungen, Angebote, Kontakte, Produkte, Vorlagen, Integrationsgruppen und deren Konfiguration, API-Schlüssel, Webhooks, PEPPOL-Teilnehmer auf Sandbox-Seite. Wenn Sie etwas in einer Umgebung anlegen, wird es in der anderen nicht sichtbar.
Nur Production — Ihr echtes Abonnement und Abrechnungsdaten, echte PEPPOL-Teilnehmer (registriert in PEPPOL Directory / SML / SMP), echte Connectoren (SFTP, B2Bconnector).
Nur Sandbox — Testdaten, die Sie im Sandbox-Modus erstellen. Nichts davon wird jemals veröffentlicht, abgerechnet oder übertragen.

Ausgehende Integrationen werden simuliert

Wenn Sie ein Dokument aus der Sandbox senden (eine Rechnung ausstellen, einen Lieferschein versenden, einen Tax Report erzeugen), simuliert B2Brouter den Versand und bringt das Dokument in seinen Endzustand — ohne ein externes System zu kontaktieren.

Konkret:

Es werden keine E-Mails versendet. Dokumentzustellung per E-Mail, Passwort-Reset-E-Mails, Fehlerbenachrichtigungen: nichts davon verlässt die Sandbox.
Kein PEPPOL-Traffic. Ihre Sandbox-Dokumente werden nicht über das PEPPOL-Netzwerk übertragen. Ihre Sandbox-Teilnehmer werden nicht im PEPPOL Directory, SML oder SMP registriert.
Keine echten Übermittlungen an Steuerbehörden. SII, TicketBAI, Verifactu, Chorus, ZATCA und ähnliche Integrationen werden entweder an Test-Endpunkte der Behörde selbst geroutet oder vollständig übersprungen — nichts, was Sie in der Sandbox tun, erreicht eine Produktions-Steuerbehörde.
Keine Zahlungen. Stripe- und andere Payment-Gateway-Aufrufe sind deaktiviert.

Das Dokument durchläuft trotzdem seinen normalen Lebenszyklus (draft → sent → registered usw.), sodass Ihr Integrationscode die vollständige State Machine testen kann.

Wasserzeichen auf heruntergeladenen Dokumenten

Rechnungen und Angebote, die aus der Sandbox heruntergeladen werden, tragen ein deutlich sichtbares Wasserzeichen — “No vàlida — Factura de proves generada des de B2Brouter Sandbox” — auf jeder HTML-Vorschau und jedem PDF. So können Testdokumente nicht mit echten verwechselt werden.

Keine Abonnementbeschränkungen

In der Sandbox sind alle Funktionen der eDocExchange-Stufe verfügbar, unabhängig von Ihrem realen Abonnement. Transaktionslimits, Benutzerlimits und Produktberechtigungsprüfungen werden aufgehoben. Die Sandbox-Nutzung wird nicht auf das Transaktionskontingent Ihres Produktionsabonnements angerechnet.

Sandboxes sind Wegwerf-Umgebungen

Sie können Sandboxes frei löschen und neu erstellen. Für ihre Nutzung fallen keine Kosten an. Behandeln Sie sie als temporär — die einzige Grenze ist die maximale Anzahl gleichzeitig aktiver Sandboxes pro Besitzer (siehe §5.3).

Einschränkungen

Was in der Sandbox nicht verfügbar ist

Echte Dokumentzustellung — PEPPOL-, E-Mail-, B2Bconnector- und SFTP-Ziele sind nicht verbunden. Ausgehende Sendungen werden nur simuliert.
Echte Zahlungen — in der Sandbox können keine Abonnementzahlungen verarbeitet werden. Die Bereiche Subscription / Payment / Billing sind innerhalb der Sandbox ausgeblendet.
Überprüfung durch Steuerbehörden — NIF-/Registerprüfungen bei der AEAT und ähnlichen Behörden werden übersprungen.
Connections (Transport) — der Tab Connections ist in der Sandbox deaktiviert. Fügen Sie Transports in Production hinzu und konfigurieren Sie sie dort.
B2Bconnector und SFTP — diese Kanäle funktionieren nicht gegen eine Sandbox-Umgebung. Verwenden Sie für Tests die API oder die Web UI.
Kontoschließung — Sie können Ihr Konto nicht innerhalb der Sandbox schließen oder downgraden. Verlassen Sie zuerst die Sandbox.

Profiländerungen erfolgen in Production

Um Ihren Namen, Ihr Passwort, Ihre Sprache, Zeitzone, E-Mail-Adresse oder 2FA-Konfiguration zu ändern, verlassen Sie zuerst die Sandbox. Diese Aktionen sind absichtlich deaktiviert, solange Sie sich in der Sandbox befinden: Ihre Identität ist gemeinsam, daher gelten Änderungen global und sollten der Übersichtlichkeit halber in der Produktionsumgebung vorgenommen werden.

Kontingent: 5 Sandboxes pro Besitzer

Sie können bis zu 5 aktive Sandboxes pro Konto oder Integrationsgruppe haben. Löschen Sie eine, um einen Platz freizugeben.

API-Schlüssel funktionieren nicht umgebungsübergreifend

Ein test_…-Schlüssel ist nur in der Sandbox-Umgebung gültig, und ein Produktionsschlüssel nur in Production. Wenn Sie einen Sandbox-Schlüssel an einen Endpunkt senden, der Produktionsdaten adressiert (oder umgekehrt), wird die Anfrage abgelehnt.

Das bedeutet auch: Committen Sie keine Sandbox-Schlüssel in Ihre Produktionskonfiguration und verwenden Sie keine Produktionsschlüssel in Ihren Sandbox-Tools. Halten Sie beides getrennt.

Häufig gestellte Fragen

Beeinflusst die Sandbox-Nutzung mein Abonnementskontingent oder die Anzahl meiner Rechnungen? Nein. Sandbox-Traffic ist vollständig von der Produktionsabrechnung getrennt. Dokumente, die Sie in der Sandbox erstellen, zählen nicht zu den Transaktionslimits, und Sandbox-API-Requests erscheinen nicht in Ihren Produktions-Nutzungsberichten.

Kann ich Produktionsdaten in eine Sandbox importieren? Nicht als Ein-Klick-Klon. Jede neue Sandbox startet mit der Grundstruktur Ihres Kontos (Projekt, Unternehmen, Mitgliedschaft des Eigentümers) und ist ansonsten leer. Um sie mit realistischen Daten zu füllen, verwenden Sie die API oder die Import-Flows der Web UI genau wie in Production.

Wie unterscheide ich Sandbox-Dokumente von echten? Drei Hinweise:

Das violette Sandbox-Banner ist oben auf jeder Seite im Sandbox-Modus sichtbar.
Jede heruntergeladene Rechnung oder jedes Angebot trägt ein deutliches “No vàlida”-Wasserzeichen.
Sandbox-API-Schlüssel beginnen mit test_; Produktionsschlüssel tun das nicht.

Kann ich eine Sandbox mit einem Teamkollegen teilen? Ja. Jeder, der Mitglied des besitzenden Kontos oder der Integrationsgruppe ist, sieht die Sandbox in seiner Sandboxes-Liste und kann sie öffnen. Es gibt keine separate Berechtigung pro Sandbox.

Was passiert mit meiner Sandbox, wenn ich mein Abonnement kündige? Sandboxes sind an Ihr B2Brouter-Konto gebunden, nicht an ein kostenpflichtiges Abonnement. Sie bleiben unabhängig vom Status Ihres Abonnements verfügbar.

Kann ich einen Sandbox-API-Schlüssel mit eingeschränkten Berechtigungen haben? Ja — Sandbox-API-Schlüssel unterstützen denselben Berechtigungsumfang (eingeschränkte Schlüssel, Bereichskapazitäten usw.) wie Produktionsschlüssel.

Wohin als Nächstes?

API-Referenz: Siehe die API-Dokumentation im Developer-Portal.
Problem in der Sandbox gefunden? Öffnen Sie ein Support-Ticket direkt aus der Sandbox — es erreicht unser Team.