Entorns
B2Brouter té tres entorns. Tria’n un en funció del que estàs intentant fer.
| Entorn | URL base | Prefix de clau d’API | Quan usar-lo |
|---|---|---|---|
| Sandbox | https://api.b2brouter.net | test_… | Desenvolupament diari, validació de payloads, incorporació, integracions petites |
| Staging | https://api-staging.b2brouter.net | stag_… | Integracions grans, proves entre sistemes, simulacions d’alt volum, fluxos complets |
| Producció | https://api.b2brouter.net | prod_… (o sense prefix per a llegat) | Tràfic en viu |
Sandbox — comença aquí
Section titled “Sandbox — comença aquí”Sandbox és l’entorn recomanat per al desenvolupament inicial i les proves diàries. Està aïllat, és gratuït i està disponible immediatament — no cal cap tiquet de configuració.
Propietats principals:
- Usa la mateixa URL base que producció (
https://api.b2brouter.net). L’encaminament cap a sandbox el determina completament la clau d’API: les claus que comencen ambtest_van a sandbox; totes les altres van a producció. - Els enviaments sortints (correu electrònic, Peppol, presentacions a l’autoritat fiscal) estan simulats — els documents avancen pel seu cicle de vida sense contactar cap sistema real.
- Totes les funcionalitats d’eDocExchange estan disponibles independentment de la teva subscripció real.
- L’ús no compta respecte a la teva quota de transaccions de producció.
Consulta Sandbox per a les instruccions de configuració i una referència completa de funcionalitats.
Staging — per a integracions grans o àmplies
Section titled “Staging — per a integracions grans o àmplies”Staging és un entorn de prova complet amb el seu propi domini (api-staging.b2brouter.net) i la seva pròpia base de dades. Usa’l quan:
- Necessites provar una integració gran amb múltiples comptes, grans volums de transaccions o fluxos complexos entre sistemes.
- Necessites un entorn compartit persistent per a un equip de desenvolupament.
- Estàs integrant-te amb una autoritat específica d’un país el punt de prova de la qual (DGFiP QAS, KSeF test, ZATCA sandbox, etc.) es connecta a l’entorn staging de B2Brouter.
Per començar amb staging, registra’t a l’app de staging i obre un tiquet de suport per sol·licitar els permisos d’API necessaris — els comptes de staging comencen amb accés limitat.
Nota. Per a tot allò restant — provar l’API, validar payloads, escriure proves d’integració, incorporació — usa Sandbox. Staging requereix més configuració i és més adequat per a escenaris de proves més amplis.
Producció
Section titled “Producció”Entorn en viu. Totes les transaccions reals, la facturació i els registres Peppol es fan aquí. No s’ha d’usar per a desenvolupament ni proves.