Ce que demande l'API de B2Brouter
Pour utiliser l'API de B2Brouter, il vous faut un compte B2Brouter et sa clé API. Vous copiez la clé depuis l'onglet Developers du même environnement B2Brouter que celui où vous travaillez. Une clé de test ne marche pas en production, et inversement.
Chaque appel porte aussi la version de l'API. Le connecteur la fixe sur toutes les requêtes : « X-B2B-API-Version: 2026-06-26 ». Si vous modifiez cette valeur dans Odoo, ce doit être une date au format AAAA-MM-JJ. Avec un autre format, Odoo ne l'enregistre pas.
Les trois environnements et leurs adresses
B2Brouter a trois environnements. La production et le sandbox utilisent la même adresse, https://api.b2brouter.net. C'est le préfixe de la clé qui décide où arrive l'appel. Le staging a sa propre adresse, https://api-staging.b2brouter.net.
Le connecteur vérifie le préfixe à l'enregistrement de la clé, puis avant chaque requête :
- En production, il accepte les clés qui commencent par prod_ et les anciennes clés sans préfixe.
- En sandbox, il n'accepte que les clés qui commencent par test_.
- En staging, il accepte stag_ et test_.
La raison est simple. Une clé de production collée dans le sandbox enverrait de vraies factures sans que personne ne s'en aperçoive. Le connecteur l'arrête avant.
En sandbox, les envois sont simulés, les paiements sont désactivés et les aperçus PDF portent le filigrane « test invoice ». C'est l'endroit pour essayer votre configuration sans rien envoyer pour de vrai.
Comment Odoo se connecte à l'API
Le connecteur fournit un assistant dans B2Brouter › Se connecter à B2Brouter. Ses étapes sont Bienvenue, Environnement, Récupérez votre clé API, Connexion et Terminé.
- Installez le connecteur sur Odoo 17, 18, 19 ou 20 et activez l'abonnement FlexigoTech Cloud. Le connecteur en a besoin pour fonctionner.
- Choisissez l'environnement : production, sandbox ou staging.
- Copiez la clé API depuis l'onglet Developers de ce même environnement et collez-la.
- En tant qu'administrateur, donnez votre consentement. FlexigoTech Cloud garde la clé chiffrée et ne la reçoit qu'après ce consentement.
- Testez la connexion. S'il manque la clé, Odoo vous le signale avant d'appeler B2Brouter.

Webhooks signés et tâches planifiées
B2Brouter signale les changements par webhook. Le connecteur les reçoit sur une adresse propre à chaque enregistrement, avec un jeton impossible à deviner. Il vérifie aussi la signature HMAC-SHA256 de chaque notification avec le secret de cet enregistrement. Ce qui arrive s'affiche dans B2Brouter › Documents › Événements de webhook.
Les webhooks ne remplacent pas les vérifications régulières. Le connecteur exécute ces tâches :
- Envoyer la file des documents, toutes les 5 minutes.
- Traiter les événements de webhook, toutes les 5 minutes.
- Interroger l'état des factures, toutes les 15 minutes.
- Mettre à jour les listes de codes, chaque semaine.
Les listes de codes viennent de l'API elle-même : schémas, types de document, pays, devises, états de facture, langues et types de transport.
Quand quelque chose échoue : l'ID de requête
Chaque réponse de B2Brouter porte un identifiant de requête. Le connecteur garde le dernier dans le champ Dernier ID de requête de la connexion. Si vous ouvrez une demande auprès du support de B2Brouter, donnez-leur cette valeur. Ils retrouvent votre appel sans que vous ayez à reproduire l'erreur.

Ce qu'il vous faut et ce qui n'est pas inclus
Il vous faut votre propre compte B2Brouter et sa clé API. Les frais de B2Brouter ne sont pas inclus. Le connecteur est sur Odoo Apps pour Odoo 17, 18, 19 et 20, et il fonctionne avec l'abonnement FlexigoTech Cloud. Les détails de l'intégration sont sur la page du connecteur.
Puis-je tester l'API de B2Brouter sans envoyer de vraies factures ?
Oui. Choisissez l'environnement sandbox et une clé qui commence par test_. Les envois sont simulés et les PDF portent le filigrane de facture de test.
Où se trouve la spécification de l'API ?
Le connecteur travaille avec la version 2026-06-26. Sa spécification OpenAPI est publiée sur app.b2brouter.net.
Odoo garde-t-il ma clé B2Brouter ?
C'est FlexigoTech Cloud qui la garde, chiffrée, et seulement après le consentement d'un administrateur sur cette connexion.
Dois-je programmer quelque chose pour utiliser l'API ?
Non. Le connecteur fait les appels, signature et version comprises. Vous choisissez l'environnement et vous collez la clé.
À lire aussi
Vérifié dans le code du connecteur (version 20.0)
Sources
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): README.md
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
- Code du module : b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml
