Environnements
B2Brouter propose trois environnements. Choisissez celui qui correspond à ce que vous souhaitez faire.
| Environnement | Base URL | Préfixe de clé API | Quand l’utiliser |
|---|---|---|---|
| Sandbox | https://api.b2brouter.net | test_… | Développement quotidien, validation de payloads, onboarding, petites intégrations |
| Staging | https://api-staging.b2brouter.net | stag_… | Grandes intégrations, tests inter-systèmes, simulations à fort volume, flux complets de bout en bout |
| Production | https://api.b2brouter.net | prod_… (ou sans préfixe pour les clés historiques) | Trafic réel |
Sandbox — commencez ici
Section titled “Sandbox — commencez ici”Sandbox est l’environnement recommandé pour le développement initial et les tests quotidiens. Il est isolé, gratuit et disponible immédiatement, sans ticket de configuration.
Caractéristiques principales :
- Utilise la même base URL que la production (
https://api.b2brouter.net). Le routage vers sandbox est entièrement déterminé par la clé API : les clés commençant partest_vont vers sandbox ; toutes les autres vont vers la production. - Les envois sortants (e-mail, PEPPOL, soumissions aux autorités fiscales) sont simulés : les documents progressent dans leur cycle de vie sans contacter de système réel.
- Toutes les fonctionnalités eDocExchange sont disponibles, quel que soit votre abonnement réel.
- L’utilisation n’est pas comptabilisée dans votre quota de transactions de production.
Consultez Sandbox pour les instructions de configuration et une référence complète des fonctionnalités.
Staging — pour les intégrations larges ou complexes
Section titled “Staging — pour les intégrations larges ou complexes”Staging est un environnement de test full-stack avec son propre domaine (api-staging.b2brouter.net) et sa propre base de données. Utilisez-le lorsque :
- Vous devez tester une grande intégration avec plusieurs comptes, de gros volumes de transactions ou des flux complexes entre systèmes.
- Vous avez besoin d’un environnement partagé persistant pour une équipe de développement.
- Vous vous intégrez avec une autorité spécifique à un pays dont l’endpoint de test (DGFiP QAS, KSeF test, sandbox ZATCA, etc.) se connecte à l’environnement staging de B2Brouter.
Pour commencer avec staging, inscrivez-vous sur l’application staging puis ouvrez un ticket de support pour demander les autorisations API nécessaires. Les comptes staging démarrent avec des accès limités.
Remarque. Pour tout le reste, essayer l’API, valider des payloads, écrire des tests d’intégration, faire l’onboarding, utilisez plutôt le Sandbox. Staging demande plus de configuration et convient mieux à des scénarios de test plus larges.
Production
Section titled “Production”Environnement réel. Toutes les transactions, la facturation et les enregistrements PEPPOL réels s’y déroulent. Ne l’utilisez pas pour le développement ou les tests.