Aller au contenu principal
Billbee

L'API Billbee depuis Odoo : la clé, votre mot de passe API, le quota d'appels et les erreurs

Pour parler à l'API Billbee, il faut trois choses : la clé de l'intégration, votre nom d'utilisateur Billbee et un mot de passe API. Avec le connecteur Odoo, FlexigoTech fournit la clé, et votre nom d'utilisateur et votre mot de passe partent une seule fois, chiffrés, vers FlexigoTech Cloud.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 20 novembre 2026

L'essentiel

Module
Billbee
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
5 min

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.

Le compte Billbee dans Odoo
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.

Odoo connecté à FlexigoTech Cloud
La section FlexigoTech Cloud des paramètres d'Odoo : la base de données connectée et le connecteur Billbee en essai.

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

Commandes Billbee dans Odoo : client, lignes par SKU et TVA correcte dans VentesComment le connecteur amène les commandes Billbee dans Ventes d'Odoo : toutes les 15 minutes, client, livraison, lignes par SKU, TVA et automatisation.Le stock d'Odoo dans Billbee : le chiffre envoyé, sa fréquence et les écartsQuel stock le connecteur Odoo envoie à Billbee, pourquoi il retire les commandes Billbee non confirmées et ce que fait la comparaison toutes les six heures.Billbee et l'expédition depuis Odoo : une commande en deux livraisons et ce que Billbee en voitCe qu'Odoo envoie à Billbee quand vous validez chaque livraison : le numéro de suivi, le transporteur, le statut expédié seulement à la fin et l'étiquette.Qu'est-ce que Billbee, et ce que devient chacun de ses mots dans OdooCe qu'est Billbee, qui l'utilise et ce que veulent dire ses mots (statut, réclamation, Freier Provider, mot de passe API) quand vous le connectez à Odoo.
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