Sandbox

Qu’est-ce que le mode Sandbox ?

Sandbox est un environnement de test isolé qui vous permet d’essayer B2Brouter, émettre des factures, envoyer des documents, tester l’API, sans toucher à des données réelles, à de vrais destinataires ni au compteur de transactions de votre abonnement.

Chaque sandbox est un espace de travail autonome avec ses propres données : factures, contacts, produits, modèles et clés API vivent séparément de votre compte de production. Tout ce que vous créez en sandbox reste en sandbox ; tout ce que vous créez en production reste en production.

À quoi sert Sandbox :

Essayer B2Brouter de bout en bout avant de passer à une offre payante.
Valider votre intégration API avant de la connecter à la production.
Réaliser des formations, démos ou preuves de concept sans affecter vos données réelles.
Faire passer les documents par leur cycle de vie (draft → sent → registered) pour que votre code d’intégration puisse exercer le chemin nominal de la machine d’états.

Remarque. Pour le moment, Sandbox simule uniquement le happy path. Les opérations d’envoi réussissent toujours et les documents atteignent toujours leur état final. Sandbox ne reproduit ni rejets, ni pannes réseau, ni autres conditions d’erreur. Testez ces cas sur votre propre infrastructure de staging, pas sur le Sandbox de B2Brouter.

Ce que Sandbox n’est pas :

Ce n’est pas une version de préproduction ou de pré-release de B2Brouter. Il exécute le même code que la production ; seules les données et les intégrations sortantes diffèrent.
Ce n’est pas une sauvegarde ni une copie de vos données de production. Les sandboxes démarrent vides (à l’exception de quelques enregistrements initiaux amorcés depuis votre compte) et sont indépendants.

Premiers pas

Créer un sandbox (interface web)

Connectez-vous à B2Brouter.
Cliquez sur le bouton Developers (icône éclair) dans l’en-tête.
- Si vous n’avez pas encore d’abonnement eDocExchange, cela ouvre directement la bannière d’intégration. Votre premier sandbox se crée depuis là.
- Si vous disposez déjà d’eDocExchange, la zone Developers inclut une section dédiée Sandbox (icône de boîte) ; ouvrez-la.
Cliquez sur Create Sandbox.
Dans la fenêtre modale, donnez un nom à votre sandbox. Par défaut, il reprend le nom de votre compte suivi de “Sandbox”. Modifiez-le si vous souhaitez en gérer plusieurs à la fois.
Cliquez sur Create. Votre nouveau sandbox apparaît dans la liste.

Après la création de votre premier sandbox, l’entrée Developers devient pour tout le monde la liste des sandboxes, montrant chaque sandbox associé à votre compte ou groupe d’intégration, avec des lignes permettant de les ouvrir, renommer ou supprimer.

Vous pouvez avoir jusqu’à 5 sandboxes par compte ou groupe d’intégration. Le bouton de création est désactivé une fois la limite atteinte ; supprimez un sandbox existant pour libérer un emplacement.

Ouvrir un sandbox

Dans la liste des sandboxes, cliquez sur l’icône d’ouverture (↗) à côté du sandbox que vous souhaitez utiliser. B2Brouter bascule en mode sandbox et vous amène sur la page des clés API de ce sandbox.

Pendant que vous êtes en mode sandbox, une bannière violette en haut de chaque page vous rappelle l’environnement dans lequel vous vous trouvez. Chaque page visitée, chaque action effectuée, facturation, contacts, paramètres, s’applique au sandbox jusqu’à votre sortie.

Quitter un sandbox

Cliquez sur Exit Sandbox dans la bannière violette. Vous revenez à votre compte de production et la bannière disparaît.

Vous pouvez réentrer dans le même sandbox à tout moment depuis la liste des sandboxes. Les sandboxes persistent jusqu’à leur suppression.

Supprimer ou renommer un sandbox

Depuis la liste des sandboxes :

Renommer : cliquez sur l’icône de renommage et modifiez le nom en ligne.
Supprimer : cliquez sur l’icône de suppression. Toutes les données de ce sandbox (factures, contacts, clés API, etc.) sont supprimées définitivement.

Utiliser l’API en Sandbox

Le routage vers sandbox est entièrement piloté par la clé API. Il n’existe pas d’URL sandbox distincte, pas de sous-domaine sandbox. ni d’en-tête d’environnement à définir. Utilisez l’URL standard de l’API B2Brouter, https://api.b2brouter.net/, et :

Les clés de production commencent par prod_ (ou n’ont pas de préfixe pour les clés historiques).
Les clés sandbox commencent par test_.

Lorsque vous appelez un endpoint avec une clé test_…, votre requête est automatiquement servie depuis l’environnement sandbox. Avec une clé de production, elle part en production. Même endpoint, même corps de requête : le routage dépend uniquement de la clé.

Obtenir une clé API sandbox

Ouvrez le sandbox que vous souhaitez utiliser (interface web, voir §2.2).
Vous arrivez automatiquement sur sa page de clés API. Sinon, accédez-y depuis le menu.
Générez ou copiez la clé API. Elle commencera par test_.

Passez cette clé dans l’en-tête X-B2B-API-Key (ou dans le paramètre de requête api_key si votre client ne prend en charge que les query params) pour chaque requête que vous souhaitez router vers sandbox.

Ce qui fonctionne

Chaque endpoint API que vous utiliseriez en production fonctionne aussi en sandbox : création de factures, de contacts, de groupes d’intégration, envoi de documents, récupération des états, webhooks, export XML, etc. Le comportement est identique à l’exception des appels sortants simulés décrits ci-dessous.

Webhooks

Les webhooks sont bien déclenchés depuis sandbox. C’est intentionnel : la livraison de webhooks fait partie des choses que les intégrateurs doivent tester. Configurez une URL webhook sur un groupe d’intégration sandbox et vous recevrez des appels à mesure que les états des documents changent. Les webhooks de production et de sandbox sont indépendants : ils se configurent séparément et ne se mélangent pas.

Implications de l’utilisation de Sandbox

Identité partagée, données séparées

Votre identité utilisateur est partagée entre la production et le sandbox : le même identifiant, le même mot de passe, la même configuration 2FA et les mêmes codes de récupération fonctionnent dans les deux. Vous vous connectez une seule fois et pouvez passer librement d’un environnement à l’autre.

Tout le reste est isolé entre les deux environnements :

Indépendants dans chaque environnement : factures, devis, contacts, produits, modèles, groupes d’intégration et leur configuration, clés API, webhooks, participants PEPPOL côté sandbox. Créer l’un de ces éléments dans un environnement ne le rend pas visible dans l’autre.
Production uniquement : votre abonnement réel et vos données de facturation, les vrais participants PEPPOL (enregistrés dans PEPPOL Directory / SML / SMP), les vrais connecteurs (SFTP, B2Bconnector).
Sandbox uniquement : les données de test que vous créez en mode sandbox. Rien n’est jamais publié, facturé ou transmis.

Les intégrations sortantes sont simulées

Lorsque vous envoyez un document depuis sandbox (émettre une facture, envoyer un bon d’expédition, générer une déclaration fiscale), B2Brouter simule l’envoi et fait avancer le document jusqu’à son état final, sans contacter de système externe.

Concrètement :

Aucun e-mail n’est envoyé. Livraison de documents par e-mail, e-mails de réinitialisation de mot de passe, notifications d’erreur : rien ne sort du sandbox.
Aucun trafic PEPPOL. Vos documents sandbox ne sont pas transmis sur le réseau PEPPOL. Vos participants sandbox ne sont pas enregistrés dans PEPPOL Directory, SML ou SMP.
Aucune soumission réelle aux autorités fiscales. SII, TicketBAI, Verifactu, Chorus, ZATCA et les intégrations similaires sont soit routés vers les endpoints de test des autorités, soit entièrement ignorés ; rien de ce que vous faites en sandbox n’atteint une autorité fiscale de production.
Aucun paiement. Les appels à Stripe et autres passerelles de paiement sont désactivés.

Le document parcourt néanmoins son cycle de vie normal (draft → sent → registered, etc.) afin que votre code d’intégration puisse exercer la machine d’états complète.

Filigrane sur les documents téléchargés

Les factures et devis téléchargés depuis sandbox comportent un filigrane explicite, “No vàlida — Factura de proves generada des de B2Brouter Sandbox”, sur chaque aperçu HTML et chaque PDF. Cela rend impossible toute confusion entre documents de test et documents réels.

Aucune limitation liée à l’abonnement

En sandbox, toutes les fonctionnalités du niveau eDocExchange sont disponibles, quel que soit votre abonnement réel. Les limites de nombre de transactions, de nombre d’utilisateurs et les vérifications d’éligibilité produit sont levées. L’utilisation du sandbox n’est pas comptabilisée dans le quota de transactions de votre abonnement de production.

Les sandboxes sont jetables

Vous pouvez supprimer et recréer librement des sandboxes. Leur utilisation est gratuite. Considérez-les comme temporaires ; la seule limite concerne le nombre de sandboxes actifs simultanément par propriétaire (voir §5.3).

Limitations

Ce qui n’est pas disponible en Sandbox

Livraison réelle des documents : les destinations PEPPOL, e-mail, B2Bconnector et SFTP ne sont pas connectées. Les envois sortants sont uniquement simulés.
Paiements réels : sandbox ne peut pas traiter les paiements d’abonnement. Les sections Subscription / Payment / Billing sont masquées dans sandbox.
Vérification auprès des autorités fiscales : les contrôles NIF/recensement auprès de l’AEAT et autorités similaires sont ignorés.
Connections (Transport) : l’onglet Connections est désactivé en sandbox. Ajoutez et configurez les transports depuis la production.
B2Bconnector et SFTP : ces canaux ne fonctionnent pas contre un environnement sandbox. Utilisez l’API ou l’interface web pour les tests.
Fermeture du compte : vous ne pouvez pas fermer ni rétrograder votre compte depuis sandbox. Revenez d’abord en production.

Les modifications du profil se font en production

Pour modifier votre nom, mot de passe, langue, fuseau horaire, adresse e-mail ou configuration 2FA, quittez d’abord le sandbox. Ces actions sont volontairement désactivées lorsque vous êtes dans sandbox : votre identité est partagée, donc ces changements s’appliquent globalement et doivent être effectués depuis l’environnement de production pour plus de clarté.

Quota : 5 sandboxes par propriétaire

Vous pouvez avoir jusqu’à 5 sandboxes actifs par compte ou groupe d’intégration. Supprimez-en un pour libérer un emplacement.

Les clés API ne traversent pas les environnements

Une clé test_… n’est valide que pour l’environnement sandbox, et une clé de production n’est valide que pour la production. Si vous envoyez une clé sandbox à un endpoint qui résout des données de production (ou l’inverse), la requête sera rejetée.

Cela signifie aussi : ne versionnez pas de clés sandbox dans votre configuration de production et ne collez pas de clés de production dans vos outils sandbox. Gardez-les séparées.

Questions fréquentes

L’utilisation du sandbox affectera-t-elle mon quota d’abonnement ou mon nombre de factures ? Non. Le trafic sandbox est totalement séparé de la facturation de production. Les documents que vous créez en sandbox ne comptent pas dans les limites de transactions, et les requêtes API sandbox n’apparaissent pas dans vos rapports d’usage de production.

Puis-je importer des données de production dans un sandbox ? Pas sous la forme d’un clone en un clic. Chaque nouveau sandbox démarre avec la structure de base de votre compte (projet, entreprise, appartenance du propriétaire) et est sinon vide. Pour le peupler avec des données réalistes, utilisez l’API ou les flux d’import de l’interface web comme vous le feriez en production.

Comment distinguer les documents sandbox des documents réels ? Trois indices :

La bannière Sandbox violette est visible en haut de chaque page en mode sandbox.
Chaque facture ou devis téléchargé comporte un filigrane clair “No vàlida”.
Les clés API sandbox commencent par test_, contrairement aux clés de production.

Puis-je partager un sandbox avec un collègue ? Oui. Toute personne membre du compte propriétaire ou du groupe d’intégration voit le sandbox dans sa liste de sandboxes et peut l’ouvrir. Il n’existe pas de permission spécifique par sandbox à gérer séparément.

Que se passe-t-il pour mon sandbox si j’annule mon abonnement ? Les sandboxes sont liés à votre compte B2Brouter, pas à un niveau d’abonnement payant. Ils restent disponibles quel que soit l’état de votre abonnement.

Puis-je avoir une clé API sandbox avec des permissions restreintes ? Oui. Les clés API sandbox prennent en charge le même périmètre de permissions que les clés de production (clés restreintes, capacités par section, etc.).

Où aller ensuite

Référence API : consultez la documentation API sur le portail développeur.
Vous avez trouvé un problème dans sandbox ? Ouvrez un ticket de support depuis le sandbox ; il arrivera à notre équipe.