Salta al contingut principal
Billbee

L'API de Billbee des d'Odoo: la clau, la teva contrasenya d'API, la quota de crides i els errors

Per parlar amb l'API de Billbee calen tres coses: la clau de la integració, el teu nom d'usuari de Billbee i una contrasenya d'API. Amb el connector d'Odoo, la clau la posa FlexigoTech, i el teu nom d'usuari i la teva contrasenya viatgen una sola vegada, xifrats, a FlexigoTech Cloud.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 20 de novembre de 2026

L'essencial

Mòdul
Billbee
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

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.

El compte de Billbee a Odoo
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.

Odoo connectat a FlexigoTech Cloud
La secció FlexigoTech Cloud dels ajustos d'Odoo: la base de dades connectada i el connector de Billbee en prova.

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

Comandes de Billbee a Odoo: de Billbee a Vendes, amb el client, línies per SKU i l'IVA correcteCom el connector porta les comandes de Billbee a Vendes d'Odoo: cada 15 minuts, amb client i lliurament, línies per SKU, IVA inclòs i automatització.L'estoc d'Odoo a Billbee: el número que hi arriba, cada quant i què passa si no quadrenQuin estoc envia el connector d'Odoo a Billbee, per què resta les comandes de Billbee sense confirmar i què fa la comparació cada sis hores.Billbee i els enviaments des d'Odoo: una comanda que surt en dos lliuraments i què veu Billbee en cadascunQuè envia Odoo a Billbee en validar cada lliurament d'una comanda: el número de seguiment, el transportista, l'estat enviat només al final i l'etiqueta.Què és Billbee, i què és a Odoo cadascuna de les seves paraulesQuè és Billbee, qui l'utilitza i què volen dir les seves paraules (estat, reclamació, Freier Provider, contrasenya d'API) quan el connectes a Odoo.
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