Sandbox

El Sandbox és un entorn de proves aïllat que et permet provar B2Brouter(emetre factures, enviar documents, testejar l’API) sense tocar dades reals, destinataris reals ni el comptador de transaccions de la teva subscripció.

Què és el Sandbox

• Un espai de treball autònom amb dades separades (factures, contactes, productes, plantilles, claus d’API).
• Et permet fer proves d’extrem a extrem abans de contractar un pla de pagament.
• Serveix per validar la integració amb l’API abans de desplegar a producció.
• Ideal per a formació, demos i proves de concepte.

Comportament de xarxa simulat. Per defecte, els enviaments al sandbox tenen èxit i el document arriba al seu estat final (equivalent a producció). A més, el sandbox pot reproduir el cicle de vida complet de sortida, incloent rebuigs i errors de xarxa, quan envies a un dels destinataris de test documentats més avall. Cap document surt mai a la xarxa real: tot el cicle se simula dins de B2Brouter.

Primers passos

Crear un Sandbox (interfície web)

1. Inicia sessió a B2Brouter.
2. Fes clic al botó Developers (icona de llamp).
3. Fes clic a Create Sandbox.
4. Posa un nom al sandbox.
5. Màxim 5 sandboxes per compte / grup d’integració.

Obrir i sortir

• Fes clic a la icona d’obertura (↗) per entrar en mode sandbox.
• Mentre hi ets, apareix un marc lila a totes les pàgines.
• Fes clic a Exit Sandbox per tornar a producció.

Fer servir l’API al Sandbox

L’enrutament de l’API es fa íntegrament per la clau:

• No cal cap URL ni subdomini de sandbox separat.
• Fes servir la base d’API estàndard de B2Brouter: https://api.b2brouter.net/.
• Les claus de producció comencen per prod_ (o sense prefix, per compatibilitat).
• Les claus de sandbox comencen per test_.

Passa la clau de sandbox mitjançant la capçalera X-B2B-API-Key o el paràmetre de consulta api_key.

Cicle de vida dels documents

Els documents segueixen el mateix cicle de vida que a producció. Amb un destinatari normal, l’enviament arriba fins a:

draft → sent → registered

Amb un destinatari de test (vegeu més avall), el sandbox continua el cicle segons l’escenari associat, de manera asíncrona (les transicions arriben en pocs segons), perquè puguis testejar com el teu sistema gestiona cada resultat:

• Registrat correctament: sent → registered
• Rebutjat: sent → registered → refused
• Error de xarxa (destinatari no registrat): sent → error, amb error_code = PEPPOL_NO_RECEIVER

Com que les transicions són asíncrones, si fas polling pots veure els estats intermedis en successió ràpida; el teu codi ha de tolerar rebre’ls encadenats. Els webhooks es disparen a cada transició, igual que a producció.

Simular respostes de la xarxa (destinataris de test)

Per provar com el teu sistema reacciona davant d’un rebuig o un error de xarxa, envia a un dels destinataris de test predefinits. Funcionen com a test cards: el resultat està determinat pel destinatari, no per cap paràmetre especial. El teu codi d’enviament s’executa exactament igual que a producció.

Cada sandbox nou ja inclou aquests contactes creats automàticament (busca’ls a la teva llista de contactes), i també un canal PEPPOL actiu, de manera que pots enviar sense cap configuració prèvia.

Contacte de test	Canal	Esquema	Identificador (XIN)	Resultat simulat
Test PEPPOL — Registered	PEPPOL	GLN (0088)	9508397101047	sent → registered
Test PEPPOL — Refused	PEPPOL	GLN (0088)	9506215594996	sent → registered → refused
Test PEPPOL — No receiver	PEPPOL	GLN (0088)	9500047420799	sent → error (PEPPOL_NO_RECEIVER)

També pots crear els teus propis contactes amb un d’aquests identificadors: el sandbox reconeix el resultat per l’identificador, no pel contacte concret.

Qualsevol altre destinatari (no llistat aquí) segueix el camí per defecte i arriba a sent/registered amb èxit.

Abast actual de la simulació

El cicle de vida enriquit (registrat/rebutjat/error) està disponible per a factures per PEPPOL. Altres tipus de document i canals completen amb èxit (sent), i alguns casos només distingeixen èxit/error. Encara no se simulen: la recepció de documents entrants, les respostes de comandes (Order response), ni els artefactes de resposta de les autoritats fiscals (CSV/UPO). Aquests arribaran en fases posteriors.

Què se simula (no és real)

• No s’envien correus des del sandbox.
• Sense trànsit real de PEPPOL, cap document travessa la xarxa PEPPOL i mai es consulta l’SMP real. El registre del destinatari i el cicle de vida de la xarxa se simulen íntegrament dins de B2Brouter.
• Sense enviaments reals a autoritats fiscals, SII, TicketBAI, Verifactu, Chorus i ZATCA s’enruten als endpoints de test de l’autoritat o s’ometen.
• No es processen pagaments.

Marca d’aigua als documents

Les factures i pressupostos descarregats porten una marca d’aigua clara: “No vàlida — Factura de prova generada des del Sandbox de B2Brouter”.

Limitacions

No disponible al Sandbox:

• Lliurament real de documents a PEPPOL, correu, B2Bconnector o SFTP.
• Processament real de pagaments.
• Comprovacions de verificació d’autoritats fiscals.
• Pestanya de Connexions (Transport) desactivada. El canal PEPPOL de proves ja ve configurat automàticament: no cal gestionar-lo per poder enviar als destinataris de test.
• Canals B2Bconnector i SFTP.
• Funcions de tancament de compte.

Altres restriccions:

• Els canvis de perfil (nom, contrasenya, 2FA) s’han de fer a producció.
• Les claus d’API no creuen entorns (les claus test_ només funcionen al sandbox).
• No es poden clonar dades de producció al sandbox amb un sol clic.

Webhooks

Els webhooks es disparen des del sandbox de manera intencionada, perquè el lliurament de webhooks és una de les coses que els integradors necessiten provar. Els webhooks de sandbox i de producció són independents i es configuren per separat.

Diferències clau respecte a producció

• La identitat (usuari, contrasenya, 2FA) es comparteix entre entorns.
• La resta de dades estan aïllades.
• L’activitat al sandbox no consumeix quota de subscripció.
• Totes les funcions a nivell d’API estan disponibles independentment del pla contractat.