Què demana Billbee
Segons el seu centre d'ajuda, en alemany, l'API de Billbee necessita la clau d'API de l'aplicació i, a més, el teu nom d'usuari de Billbee i una contrasenya d'API especial que t'identifica com a comerciant. Aquesta contrasenya ha de tenir com a mínim 12 caràcters i no pot contenir dos punts. Billbee afegeix que l'accés a l'API no té cap restricció d'accés.
Des de l'1 de novembre de 2025, segons la seva pàgina sobre el preu de l'API, les primeres 100.000 crides al mes continuen sent gratuïtes per a cada connexió o eina. Cada eina té exactament una clau d'API, i la factura va sempre al titular de la connexió.
La clau és de FlexigoTech i les teves credencials van a FlexigoTech Cloud
Com que Billbee emet una clau per eina, la clau del connector és de FlexigoTech. Cada crida del teu Odoo a Billbee passa per FlexigoTech Cloud, als nostres servidors d'Alemanya, que hi afegeix el teu nom d'usuari i la teva contrasenya d'API, desats xifrats, juntament amb aquesta clau. Una crida només surt si hi ha una prova o una subscripció de FlexigoTech Cloud activa.
El camp Api Password és només d'escriptura i no es desa a Odoo. Quan el deses al compte a Billbee › Configuration › Accounts, el teu nom d'usuari, que sí que es queda al registre, i la contrasenya van junts a FlexigoTech Cloud. Abans, marques que acceptes que FlexigoTech Cloud guardi les teves credencials de Billbee i que les crides hi passin. L'ajuda del camp recorda que és la contrasenya d'API, separada de la d'accés, de com a mínim 12 caràcters i sense dos punts.

Billbee › Configuration › Accounts: el compte connectat, amb les credencials desades a FlexigoTech Cloud i la data de l'última prova.Provar la connexió
Test Connection llegeix una pàgina amb una sola comanda de Billbee. Si Billbee respon, el compte passa a Connected, desa la data de la prova i el registre es torna a carregar sol. Si respon 401 o 403, el compte passa a Authentication error i et demana que revisis el nom d'usuari i la contrasenya d'API.
Només un administrador d'Odoo pot cridar Billbee amb aquestes credencials. Les tasques programades, l'avís de comandes i l'enviament que surt en validar un lliurament criden com a sistema. Si arxives el compte, Odoo deixa de cridar Billbee amb aquest compte: és l'interruptor que ho atura tot.
La quota de crides: demanar només el que ha canviat
Per gastar poques crides, cada passada de comandes demana només les comandes que han canviat des de l'anterior, i la tasca d'estoc envia només els productes amb un número que ha canviat, fins a 100 per crida. El connector no compta les crides: la crida de consum de Billbee és al seu codi, però cap pantalla ni cap tasca no la fa servir. Les crides queden igualment escrites a Billbee › Sync Log, amb el mètode, el camí, el codi de resposta i els mil·lisegons.
Quan alguna cosa falla
Si Billbee respon 429, massa crides, Odoo torna a provar-ho fins a 5 vegades, i espera el que demana Billbee o un temps que es duplica a cada intent, com a màxim 300 segons cada vegada. Un error 5xx de Billbee es reintenta fins a 3 vegades. Una pausa de FlexigoTech Cloud no es reintenta.
Odoo no segueix redireccions: si Billbee en respongués una, la crida es rebutja amb un error, perquè les credencials no vagin a parar a cap altre lloc.
Cada error del registre crea una activitat per al responsable del compte (si no n'hi ha, per a qui estava treballant). La neteja diària esborra les línies del registre de més de 90 dies.

L'avís de comandes
Amb Register Webhook with Billbee (best-effort), al compte, Odoo registra a Billbee l'avís de comandes noves. Abans d'acceptar-lo, Billbee revisa l'adreça, i Odoo respon amb el mateix text només si l'adreça porta el secret del compte. A partir d'aquí, cada avís fa que Odoo llegeixi aquella comanda o, si no la troba, que llanci en aquell moment la passada de comandes. Encara que l'avís no estigui registrat, les comandes arriben igualment amb la tasca cada 15 minuts.
El que fa cada passada amb les comandes és a comandes de Billbee a Odoo, i el vocabulari de Billbee a què és Billbee.
Ho hem provat amb un compte de Billbee
El 17-11-2026, amb un compte de prova de comerciant de Billbee i el servei de prova de FlexigoTech Cloud, vam provar de punta a punta la connexió, l'estoc, les comandes i l'enviament a Odoo 20, sense errors. El 18-11-2026, amb la versió 1.2.11 a Odoo 17, 18, 19 i 20, vam registrar l'avís de comandes, i Billbee va revisar primer l'adreça. A Odoo 17, 18 i 20, una comanda creada després a Billbee va entrar a Odoo.
Preguntes sobre l'API de Billbee i Odoo
Necessito una clau d'API de Billbee pròpia?
No. La clau és de la integració, i és de FlexigoTech. Hi introdueixes el teu nom d'usuari de Billbee i una contrasenya d'API, que crees a Billbee a part de la contrasenya d'accés.
On es desa la meva contrasenya d'API?
A FlexigoTech Cloud, xifrada. Al teu Odoo el camp és només d'escriptura: la pots canviar, però no llegir.
Quant costa?
El mòdul costa 9 € per versió d'Odoo a Odoo Apps. Funciona amb FlexigoTech Cloud, des de 49 €/mes: pla Connector Estàndard a 49 €/mes o 490 €/any, o Pro a 98 €/mes o 980 €/any, sense IVA. La prova és de 14 dies, gratis i sense targeta. Inclou 2 mesos de suport per deixar-lo en marxa i, mentre continuïs subscrit, les actualitzacions i el suport, segons les condicions de contractació 2.2. Tot és a la pàgina del connector de Billbee.
En quines versions d'Odoo funciona?
A Odoo 17, 18, 19 i 20, a Odoo.sh o al teu propi servidor. No funciona a Odoo Online. El teu compte de Billbee, amb el seu usuari i una contrasenya d'API, i el seu pla van a part.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
- Codi del mòdul: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
- Codi del mòdul: 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
- Prova real de FlexigoTech amb un compte de prova de Billbee (17 i 18-11-2026)
- flexigotech.com/ca/connector-billbee-odoo.html
- www.billbee.io/
- www.billbee.io/en
