Umgebungen
B2Brouter hat drei Umgebungen. Wählen Sie je nachdem, was Sie tun möchten.
| Umgebung | Base URL | API-Key-Präfix | Wann verwenden |
|---|---|---|---|
| Sandbox | https://api.b2brouter.net | test_… | Tägliche Entwicklung, Payload-Validierung, Onboarding, kleine Integrationen |
| Staging | https://api-staging.b2brouter.net | stag_… | Große Integrationen, systemübergreifende Tests, Hochvolumen-Simulationen, vollständige End-to-End-Flows |
| Production | https://api.b2brouter.net | prod_… (oder kein Präfix bei Legacy-Schlüsseln) | Live-Traffic |
Sandbox — hier beginnen
Section titled “Sandbox — hier beginnen”Sandbox ist die empfohlene Umgebung für die erste Entwicklung und tägliche Tests. Sie ist isoliert, kostenlos nutzbar und sofort verfügbar — es ist kein Setup-Ticket erforderlich.
Wichtige Eigenschaften:
- Verwendet dieselbe Base URL wie Production (
https://api.b2brouter.net). Das Routing zur Sandbox wird vollständig über den API-Schlüssel bestimmt: Schlüssel, die mittest_beginnen, gehen in die Sandbox; alle anderen nach Production. - Ausgehende Sendungen (E-Mail, PEPPOL, Übermittlungen an Steuerbehörden) werden simuliert — Dokumente durchlaufen ihren Lebenszyklus, ohne ein reales System zu kontaktieren.
- Alle eDocExchange-Funktionen sind verfügbar, unabhängig von Ihrem tatsächlichen Abonnement.
- Die Nutzung wird nicht auf Ihr Produktions-Transaktionskontingent angerechnet.
Siehe Sandbox für Einrichtungsanweisungen und eine vollständige Funktionsreferenz.
Staging — für große oder breite Integrationen
Section titled “Staging — für große oder breite Integrationen”Staging ist eine vollständige Testumgebung mit eigener Domain (api-staging.b2brouter.net) und eigener Datenbank. Verwenden Sie sie, wenn:
- Sie eine große Integration mit mehreren Konten, hohem Transaktionsvolumen oder komplexen systemübergreifenden Abläufen testen müssen.
- Sie eine persistente gemeinsam genutzte Umgebung für ein Entwicklungsteam benötigen.
- Sie sich mit einer länderspezifischen Behörde integrieren, deren eigener Test-Endpunkt (DGFiP QAS, KSeF test, ZATCA sandbox usw.) mit der Staging-Umgebung von B2Brouter verbunden ist.
Um mit Staging zu beginnen, registrieren Sie sich in der Staging-App und eröffnen Sie anschließend ein Support-Ticket, um die erforderlichen API-Berechtigungen anzufordern — Staging-Konten starten mit eingeschränktem Zugriff.
Hinweis. Für alles andere — API ausprobieren, Payloads validieren, Integrationstests schreiben, Onboarding — verwenden Sie stattdessen Sandbox. Staging erfordert mehr Setup und eignet sich besser für breitere Testszenarien.
Production
Section titled “Production”Live-Umgebung. Alle echten Transaktionen, Abrechnungen und PEPPOL-Registrierungen finden hier statt. Nicht für Entwicklung oder Tests verwenden.