Ce que demande Billbee
D'après son centre d'aide, en allemand, l'API Billbee demande la clé API de l'application et, en plus, votre nom d'utilisateur Billbee et un mot de passe API spécial qui vous identifie comme marchand. Ce mot de passe doit faire au moins 12 caractères et ne peut pas contenir de deux-points. Billbee ajoute que l'accès à l'API n'a aucune restriction d'accès.
Depuis le 1er novembre 2025, d'après sa page sur le prix de l'API, les 100 000 premiers appels par mois restent gratuits pour chaque connexion ou outil. Chaque outil reçoit exactement une clé API, et la facture va toujours au titulaire de la connexion.
La clé est celle de FlexigoTech et vos identifiants vont à FlexigoTech Cloud
Comme Billbee délivre une clé par outil, la clé du connecteur est celle de FlexigoTech. Chaque appel de votre Odoo à Billbee passe par FlexigoTech Cloud, sur nos serveurs en Allemagne, qui ajoute votre nom d'utilisateur et votre mot de passe API, conservés chiffrés, avec cette clé. Un appel ne part que s'il existe un essai ou un abonnement FlexigoTech Cloud actif.
Le Mot de passe API est en écriture seule et n'est pas conservé dans Odoo. Quand vous l'enregistrez sur le compte dans Billbee › Configuration › Comptes, votre nom d'utilisateur, qui reste sur la fiche, et le mot de passe partent ensemble vers FlexigoTech Cloud. Avant cela, vous cochez que vous acceptez que FlexigoTech Cloud conserve vos identifiants Billbee et que les appels passent par lui. L'aide du champ rappelle qu'il s'agit du mot de passe API, distinct de celui de connexion, d'au moins 12 caractères et sans deux-points.

Billbee › Configuration › Comptes : le compte connecté, avec les identifiants enregistrés dans FlexigoTech Cloud et la date du dernier test.Tester la connexion
Tester la connexion lit une page avec une seule commande de Billbee. Si Billbee répond, le compte passe à Connecté, enregistre la date du test et la fiche se recharge toute seule. S'il répond 401 ou 403, le compte passe à Erreur d'authentification et vous demande de vérifier le nom d'utilisateur et le mot de passe API.
Seul un administrateur Odoo peut appeler Billbee avec ces identifiants. Les tâches planifiées, l'avis de commandes et l'expédition envoyée quand une livraison est validée appellent en tant que système. Si vous archivez le compte, Odoo cesse d'appeler Billbee avec ce compte : c'est l'interrupteur qui arrête tout.
Le quota d'appels : ne demander que ce qui a changé
Pour consommer peu d'appels, chaque passe de commandes ne demande que les commandes modifiées depuis la précédente, et la tâche de stock n'envoie que les produits dont le nombre a changé, jusqu'à 100 par appel. Le connecteur ne compte pas les appels : l'appel de consommation de Billbee est dans son code, mais aucun écran ni aucune tâche ne l'utilise. Les appels sont quand même écrits dans Billbee › Journal de synchronisation, avec la méthode, le chemin, le code de réponse et les millisecondes.
Quand quelque chose échoue
Si Billbee répond 429, trop d'appels, Odoo réessaie jusqu'à 5 fois, en attendant le temps que Billbee demande ou un délai qui double à chaque tentative, 300 secondes au plus à chaque fois. Une erreur 5xx de Billbee est réessayée jusqu'à 3 fois. Une pause de FlexigoTech Cloud n'est pas réessayée.
Odoo ne suit pas les redirections : si Billbee en renvoyait une, l'appel est refusé avec une erreur, pour que les identifiants ne partent pas ailleurs.
Chaque erreur du journal crée une activité pour le responsable du compte (s'il n'y en a pas, pour la personne qui travaillait). Le nettoyage quotidien supprime les lignes du journal de plus de 90 jours.

L'avis de commandes
Avec Enregistrer le webhook auprès de Billbee (meilleur effort), sur le compte, Odoo enregistre dans Billbee l'avis de nouvelles commandes. Avant de l'accepter, Billbee vérifie l'adresse, et Odoo ne répond avec le même texte que si l'adresse porte le secret du compte. Ensuite, chaque avis fait lire cette commande à Odoo ou, s'il ne la trouve pas, lance la passe de commandes sur le moment. Même si l'avis n'est pas enregistré, les commandes arrivent avec la tâche toutes les 15 minutes.
Ce que fait chaque passe avec les commandes est dans les commandes Billbee dans Odoo, et le vocabulaire de Billbee dans qu'est-ce que Billbee.
Nous l'avons testé avec un compte Billbee
Le 17-11-2026, avec un compte de test marchand Billbee et le service de test de FlexigoTech Cloud, nous avons testé de bout en bout la connexion, le stock, les commandes et l'expédition sur Odoo 20, sans erreur. Le 18-11-2026, avec la version 1.2.11 sur Odoo 17, 18, 19 et 20, nous avons enregistré l'avis de commandes, et Billbee a d'abord vérifié l'adresse. Sur Odoo 17, 18 et 20, une commande créée ensuite dans Billbee est arrivée dans Odoo.
Questions sur l'API Billbee et Odoo
Ai-je besoin de ma propre clé API Billbee ?
Non. La clé est celle de l'intégration, et elle appartient à FlexigoTech. Vous saisissez votre nom d'utilisateur Billbee et un mot de passe API, que vous créez dans Billbee à part de votre mot de passe de connexion.
Où est conservé mon mot de passe API ?
Dans FlexigoTech Cloud, chiffré. Dans votre Odoo, le champ est en écriture seule : vous pouvez le modifier, mais pas le lire.
Combien ça coûte ?
Le module coûte 9 € par version d'Odoo sur Odoo Apps. Il fonctionne avec FlexigoTech Cloud, à partir de 49 €/mois : plan Connecteur Standard à 49 €/mois ou 490 €/an, ou Pro à 98 €/mois ou 980 €/an, HT. L'essai dure 14 jours, gratuit et sans carte. Il comprend 2 mois d'accompagnement pour la mise en service et, tant que vous restez abonné, les mises à jour et le support, selon les conditions de vente 2.2. Tout est sur la page du connecteur Billbee.
Avec quelles versions d'Odoo fonctionne-t-il ?
Odoo 17, 18, 19 et 20, sur Odoo.sh ou sur votre propre serveur. Il ne fonctionne pas sur Odoo Online. Votre compte Billbee, avec son nom d'utilisateur et un mot de passe API, et son abonnement sont à part.
À lire aussi
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées
Sources
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
- Code du module : flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:342
- hilfe.billbee.io/article/1505-nutzung-der-billbee-api
- hilfe.billbee.io/article/1506-preisgestaltung-der-billbee-api
- Test réel de FlexigoTech avec un compte de test Billbee (17 et 18-11-2026)
- flexigotech.com/fr/connecteur-billbee-odoo.html
- www.billbee.io/
- www.billbee.io/en
