Sandbox

Què és el mode Sandbox?

Sandbox és un entorn de prova aïllat que us permet provar B2Brouter — emetre factures, enviar documents, exercitar l’API — sense tocar dades reals, destinataris reals ni el comptador de transaccions de la vostra subscripció.

Cada sandbox és un espai de treball autònom amb les seves pròpies dades: factures, contactes, productes, plantilles i claus d’API viuen separadament del vostre compte de producció. Tot el que creeu al sandbox es queda al sandbox; tot el que creeu a producció es queda a producció.

Per a què serveix el Sandbox:

Provar B2Brouter d’extrem a extrem abans de comprometre’s amb un pla de pagament.
Validar la vostra integració d’API abans d’apuntar-la a producció.
Fer formació, demostracions o proves de concepte sense afectar les vostres dades en viu.
Fer passar documents pel seu cicle de vida (esborrany → enviat → registrat) perquè el vostre codi d’integració pugui exercitar el camí d’èxit de la màquina d’estats.

Nota. De moment, el Sandbox simula únicament el camí feliç. Les operacions d’enviament sempre tenen èxit i els documents sempre arriben al seu estat final — el sandbox no reprodueix respostes de rebuig, fallades de xarxa ni altres condicions d’error. Proveu-les contra la vostra pròpia infraestructura de staging, no contra el Sandbox de B2Brouter.

El que el Sandbox no és:

No és una versió de staging o pre-llançament de B2Brouter. Executa el mateix codi que producció — només difereixen les dades i les integracions sortints.
No és una còpia de seguretat ni una còpia de les vostres dades de producció. Els sandboxes comencen buits (apart d’uns pocs registres inicials creats automàticament des del vostre compte) i són independents.

Primers passos

Crear un sandbox (interfície web)

Inicieu sessió a B2Brouter.
Feu clic al botó Developers (icona de llamp) a la capçalera.
- Si encara no teniu una subscripció d’eDocExchange, s’obre directament el bàner d’integració — el vostre primer sandbox es crea des d’allà.
- Si ja teniu eDocExchange, l’àrea Developers inclou una secció dedicada de Sandbox (icona de caixa); obriu-la.
Feu clic a Crear Sandbox.
Al modal, poseu un nom al vostre sandbox. El valor per defecte és el nom del vostre compte seguit de “Sandbox” — canvieu-lo si voleu gestionar-ne diversos alhora.
Feu clic a Crear. El vostre nou sandbox apareix a la llista.

Després de crear el primer sandbox, el punt d’entrada de Developers es converteix en la llista de Sandboxes per a tothom — mostrant cada sandbox associat al vostre compte o grup d’integració, amb files per obrir, reanomenar o eliminar cadascun.

Podeu tenir fins a 5 sandboxes per compte o grup d’integració. El botó Crear es desactiva quan s’arriba al límit; elimineu un sandbox existent per alliberar un lloc.

Obrir un sandbox

A la llista de Sandboxes, feu clic a la icona d’obertura (↗) al costat del sandbox que voleu usar. B2Brouter us canvia al mode sandbox i aterra a la pàgina de Claus d’API d’aquell sandbox.

Mentre esteu en mode sandbox, un bàner morat recorre la part superior de totes les pàgines recordant-vos en quin entorn esteu. Totes les pàgines que visiteu, totes les accions que feu — facturació, contactes, configuració — operen contra el sandbox fins que en sortiu.

Sortir d’un sandbox

Feu clic a Sortir del Sandbox al bàner morat. Torneu al vostre compte de producció i el bàner desapareix.

Podeu tornar a entrar al mateix sandbox en qualsevol moment des de la llista de Sandboxes — els sandboxes persisteixen fins que els elimineu.

Eliminar o reanomenar un sandbox

Des de la llista de Sandboxes:

Reanomenar: feu clic a la icona de reanomenament, editeu el nom en línia.
Eliminar: feu clic a la icona d’eliminació. Totes les dades d’aquell sandbox (factures, contactes, claus d’API, etc.) s’eliminen permanentment.

Usar l’API al Sandbox

L’encaminament al Sandbox l’impulsa completament la clau d’API. No hi ha cap URL de sandbox separada, cap subdomini sandbox. i cap capçalera d’entorn a configurar. Useu la URL base estàndard de l’API de B2Brouter — https://api.b2brouter.net/ — i:

Claus de producció comencen amb prod_ (o sense prefix per a claus llegades).
Claus de sandbox comencen amb test_.

Quan crideu un endpoint amb una clau test_…, la vostra petició s’atén automàticament des de l’entorn sandbox. Quan crideu amb una clau de producció, va a producció. El mateix endpoint, el mateix cos de la petició — l’encaminament es fa a la clau.

Obtenir una clau d’API de sandbox

Obriu el sandbox que voleu usar (interfície web, vegeu §2.2).
Aterreu automàticament a la seva pàgina de Claus d’API. Si no, navegueu-hi des del menú.
Genereu o copieu la clau d’API. Començarà amb test_.

Passeu aquesta clau a la capçalera X-B2B-API-Key (o el paràmetre de consulta api_key, si el vostre client només suporta paràmetres de consulta) a totes les peticions que vulgueu encaminar al sandbox.

Què funciona

Tots els endpoints d’API que cridaríeu en producció també funcionen al sandbox: crear factures, contactes, grups d’integració, enviar documents, obtenir estats, webhooks, exportar XML, i molt més. El comportament és idèntic excepte per les crides sortints simulades descrites a continuació.

Webhooks

Els Webhooks sí s’activen des del sandbox. Això és intencional — el lliurament de webhooks és quelcom que els integradors han de provar. Configureu una URL de webhook en un grup d’integració de sandbox i rebreu crides allà a mesura que els estats dels documents canvien. Els webhooks de producció i sandbox són independents: es configuren per separat i no es creuen.

Implicacions d’usar el Sandbox

Identitat compartida, dades separades

La vostra identitat d’usuari es comparteix entre producció i sandbox: el mateix login, contrasenya, configuració de 2FA i codis de recuperació funcionen a tots dos. Inicieu sessió una vegada i podeu moure-us lliurement entre entorns.

Tot allò restant està aïllat entre els dos entorns:

Independent a cada entorn — factures, pressupostos, contactes, productes, plantilles, grups d’integració i la seva configuració, claus d’API, webhooks, participants Peppol del costat sandbox.
Únicament a producció — la vostra subscripció real i les dades de facturació, els participants Peppol reals (registrats al Directori / SML / SMP de PEPPOL), els connectors reals (SFTP, B2Bconnector).
Únicament al sandbox — dades de prova que creeu en mode sandbox. Cap d’elles es publica, es factura ni es transmet mai.

Les integracions sortints estan simulades

Quan envieu un document des del sandbox (emeteu una factura, envieu un albarà, genereu un informe fiscal), B2Brouter simula l’enviament i avança el document al seu estat final — sense contactar cap sistema extern.

Concretament:

No s’envien correus electrònics. El lliurament de documents per correu electrònic, correus de restabliment de contrasenya, notificacions d’error: cap d’aquests surt del sandbox.
Sense tràfic PEPPOL. Els vostres documents sandbox no es transmeten a través de la xarxa PEPPOL. Els vostres participants sandbox no estan registrats al Directori, SML ni SMP de PEPPOL.
Sense presentacions reals a l’autoritat fiscal. SII, TicketBAI, Verifactu, Chorus, ZATCA i integracions similars o s’encaminen als propis endpoints de prova de l’autoritat o s’ometen completament — res del que feu al sandbox arriba a una autoritat fiscal de producció.
Sense pagaments. Les crides a Stripe i altres passarel·les de pagament estan desactivades.

El document segueix passant pel seu cicle de vida normal (esborrany → enviat → registrat, etc.) perquè el vostre codi d’integració pugui exercitar la màquina d’estats completa.

Marca d’aigua als documents descarregats

Les factures i pressupostos descarregats des del sandbox porten una marca d’aigua clara — “No vàlida — Factura de proves generada des de B2Brouter Sandbox” — a totes les vistes prèvies HTML i PDF. Això fa que els documents de prova siguin impossibles de confondre amb els reals.

Sense restriccions de subscripció

Al sandbox, totes les funcionalitats de nivell eDocExchange estan disponibles independentment de la vostra subscripció real. Els límits de recompte de transaccions, límits de recompte d’usuaris i comprovacions d’elegibilitat de producte s’eliminen. L’ús del sandbox no compta respecte a la quota de transaccions de la vostra subscripció de producció.

Els sandboxes són descartables

Podeu eliminar i recrear sandboxes lliurement. No hi ha cap càrrec per usar-los. Tracteu-los com a temporals — l’únic límit és el dels sandboxes simultàniament actius per propietari (vegeu §5.3).

Limitacions

Què no està disponible al Sandbox

Lliurament real de documents — els destins PEPPOL, correu electrònic, B2Bconnector i SFTP no estan connectats. Els enviaments sortints estan simulats únicament.
Pagaments reals — el sandbox no pot processar pagaments de subscripció. Les seccions Subscripció / Pagament / Facturació estan ocultes dins del sandbox.
Verificació de l’autoritat fiscal — les comprovacions NIF/cens contra l’AEAT i autoritats similars s’ometen.
Connexions (Transport) — la pestanya Connexions està desactivada al sandbox. Afegiu i configureu transports des de producció.
B2Bconnector i SFTP — aquests canals no funcionen contra un entorn sandbox. Useu l’API o la interfície web per a les proves.
Tancament de compte — no podeu tancar ni reduir el vostre compte des del sandbox. Sortiu primer a producció.

Els canvis de perfil es fan a producció

Per canviar el vostre nom, contrasenya, idioma, zona horària, adreça de correu electrònic o configuració de 2FA, sortiu primer del sandbox. Aquestes accions estan intencionalment desactivades mentre esteu dins del sandbox: la vostra identitat és compartida, de manera que els canvis sempre s’apliquen globalment i s’han de fer des de l’entorn de producció per claredat.

Quota: 5 sandboxes per propietari

Podeu tenir fins a 5 sandboxes actius per compte o grup d’integració. Elimineu-ne un per alliberar un lloc.

Les claus d’API no creuen entorns

Una clau test_… només és vàlida contra l’entorn sandbox, i una clau de producció només és vàlida contra producció. Si envieu una clau de sandbox a un endpoint que es resol a dades de producció (o viceversa), la petició és rebutjada.

Això també significa: no confirmeu claus de sandbox a la vostra configuració de producció, i no enganxeu claus de producció a les vostres eines de sandbox. Manteniu-les separades.

Preguntes freqüents

L’ús del sandbox afectarà la meva quota de subscripció o el recompte de factures? No. El tràfic de sandbox està completament separat de la facturació de producció. Els documents que creeu al sandbox no compten respecte als límits de transaccions, i les peticions d’API de sandbox no apareixen als vostres informes d’ús de producció.

Puc importar dades de producció a un sandbox? No com a clonació d’un clic. Cada nou sandbox comença amb l’estructura bàsica del vostre compte (projecte, empresa, pertinença del propietari) i, per la resta, està buit. Per omplir-lo amb dades realistes, useu l’API o els fluxos d’importació de la interfície web tal com faríeu a producció.

Com distingeixo els documents sandbox dels reals? Tres senyals:

El bàner morat de Sandbox és visible a la part superior de totes les pàgines en mode sandbox.
Totes les factures o pressupostos descarregats porten una marca d’aigua “No vàlida” clara.
Les claus d’API de sandbox comencen amb test_; les claus de producció no.

Puc compartir un sandbox amb un company? Sí. Qualsevol que sigui membre del compte propietari o del grup d’integració veu el sandbox a la seva llista de Sandboxes i pot obrir-lo. No hi ha cap permís per sandbox separat a gestionar.

Què passa amb el meu sandbox si cancel·lo la subscripció? Els sandboxes estan lligats al vostre compte de B2Brouter, no a un nivell de subscripció de pagament. Continuen disponibles independentment del vostre estat de subscripció.

Puc tenir una clau d’API de sandbox amb permisos restringits? Sí — les claus d’API de sandbox suporten el mateix àmbit de permisos (claus restringides, capacitats de secció, etc.) que les claus de producció.

On anar a continuació

Referència d’API: consulteu la documentació de l’API al portal de desenvolupadors.
Heu trobat un problema al sandbox? Obriu un tiquet de suport des del sandbox — arribarà al nostre equip.