Saltar al contenido principal
Billbee

La API de Billbee desde Odoo: la clave, tu contraseña de API, el cupo de llamadas y qué pasa cuando algo falla

Para hablar con la API de Billbee hacen falta tres cosas: la clave de la integración, tu usuario de Billbee y una contraseña de API. Con el conector de Odoo, la clave la pone FlexigoTech, y tu usuario y tu contraseña viajan una vez, cifrados, a FlexigoTech Cloud.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 20 de noviembre de 2026

Lo esencial

Módulo
Billbee
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

Lo que pide Billbee

Según su ayuda, en alemán, la API de Billbee pide la clave de API de la aplicación y, además, tu usuario de Billbee y una contraseña de API especial, que te identifica como comerciante. Esa contraseña tiene que tener al menos 12 caracteres y no puede llevar dos puntos. Billbee añade que el acceso por la API no tiene restricciones.

Desde el 1 de noviembre de 2025, según su página sobre el precio de la API, las primeras 100.000 llamadas al mes siguen siendo gratis por cada conexión o herramienta. Cada herramienta tiene exactamente una clave de API, y la factura va siempre al titular de la conexión.

La clave es de FlexigoTech y tus credenciales van a FlexigoTech Cloud

Como Billbee da una clave por herramienta, la del conector es de FlexigoTech. Cada llamada de tu Odoo a Billbee pasa por FlexigoTech Cloud, en nuestros servidores de Alemania, que le pone tu usuario y tu contraseña de API, guardados cifrados, junto con esa clave. Sin la prueba o la suscripción a FlexigoTech Cloud no sale ninguna llamada.

La Contraseña de API es de solo escritura y no se guarda en Odoo. Al guardarla en la cuenta de Billbee › Configuración › Cuentas, tu usuario, que sí se queda en la ficha, y la contraseña van juntos a FlexigoTech Cloud. Antes hay que marcar que aceptas que FlexigoTech Cloud guarde tus credenciales de Billbee y que las llamadas pasen por él. La ayuda del campo te recuerda que es la contraseña de API, aparte de la de entrar, de 12 caracteres como mínimo y sin dos puntos.

La cuenta de Billbee en Odoo
Billbee › Configuración › Cuentas: la cuenta conectada, con las credenciales guardadas en FlexigoTech Cloud y la fecha de la última prueba.

Probar la conexión

Probar conexión lee de Billbee una página de un solo pedido. Si Billbee contesta, la cuenta pasa a Conectado, guarda la fecha de la prueba y la ficha se recarga sola. Si contesta 401 o 403, la cuenta pasa a Error de autenticación y te pide revisar el usuario y la contraseña de API.

Solo un administrador de Odoo puede llamar a Billbee con esas credenciales. Las tareas programadas, el aviso de pedidos y el envío que sale al validar una entrega llaman como el sistema. Si archivas la cuenta, Odoo deja de llamar a Billbee con ella: es el interruptor para pararlo todo.

El cupo de llamadas: pedir solo lo que cambió

Para gastar pocas llamadas, cada pasada de pedidos pide solo los que cambiaron desde la anterior, y la tarea del stock manda solo los productos cuyo número cambió, hasta 100 por llamada. El conector no cuenta las llamadas: la de consumo de Billbee está en su código, pero ninguna pantalla ni tarea la usa. Las llamadas quedan, eso sí, en Billbee › Registro de sincronización, con el método, la ruta, el código de respuesta y los milisegundos.

Cuando algo falla

Si Billbee contesta 429, demasiadas llamadas, Odoo lo reintenta hasta 5 veces, con la espera que pida Billbee o con una que se dobla en cada intento, como mucho 300 segundos cada una. Un error 5xx de Billbee se reintenta hasta 3 veces. Una pausa de FlexigoTech Cloud no se reintenta.

Odoo no sigue redirecciones: si Billbee contestara con una, la llamada se rechaza con error, para no mandar las credenciales a otro sitio.

Cada error del registro crea una actividad para el responsable de la cuenta (si no tiene, para quien estaba trabajando). La limpieza diaria borra las líneas del registro de más de 90 días.

Odoo conectado con FlexigoTech Cloud
La sección FlexigoTech Cloud de los ajustes de Odoo: la base de datos conectada y el conector de Billbee en su prueba.

El aviso de pedidos

Con Registrar webhook en Billbee (mejor esfuerzo), en la cuenta, Odoo registra en Billbee el aviso de pedidos nuevos. Antes de aceptarlo, Billbee comprueba la dirección, y Odoo le contesta con el mismo texto solo si la dirección lleva el secreto de la cuenta. Después, cada aviso hace que Odoo lea ese pedido o, si no lo encuentra, lance en ese momento la pasada de pedidos. Sin el aviso, los pedidos llegan igual con la tarea de cada 15 minutos.

Qué hace cada pasada con los pedidos está en los pedidos de Billbee en Odoo, y el vocabulario de Billbee, en qué es Billbee.

Lo probamos con una cuenta de Billbee

El 17-11-2026, con una cuenta de prueba de comerciante de Billbee y el servicio de pruebas de FlexigoTech Cloud, probamos en Odoo 20 de punta a punta la conexión, el stock, los pedidos y el envío, sin fallos. El 18-11-2026, con la versión 1.2.11 en Odoo 17, 18, 19 y 20, registramos el aviso de pedidos, y Billbee comprobó antes la dirección. En Odoo 17, 18 y 20, un pedido creado después en Billbee entró en Odoo.

Preguntas sobre la API de Billbee y Odoo

¿Necesito mi propia clave de API de Billbee?

No. La clave es la de la integración, de FlexigoTech. Tú pones tu usuario de Billbee y una contraseña de API, que creas en Billbee aparte de la de entrar.

¿Dónde se guarda mi contraseña de API?

En FlexigoTech Cloud, cifrada. En tu Odoo el campo es de solo escritura: puedes cambiarla, pero no leerla.

¿Cuánto cuesta?

El módulo cuesta 9 € por versión de Odoo en Odoo Apps. Funciona con FlexigoTech Cloud, desde 49 €/mes: plan Conector Estándar a 49 €/mes o 490 €/año, o Pro a 98 €/mes o 980 €/año, sin IVA. La prueba es de 14 días, gratis y sin tarjeta. Incluye 2 meses de soporte para dejarlo en marcha y, mientras sigas suscrito, las actualizaciones y el soporte, según las condiciones de contratación 2.2. Todo está en la página del conector de Billbee.

¿Con qué versiones de Odoo funciona?

Con Odoo 17, 18, 19 y 20, en Odoo.sh o en tu propio servidor. No funciona en Odoo Online. Tu cuenta de Billbee, con su usuario y una contraseña de API, y su plan van aparte.

Sigue leyendo

Pedidos de Billbee en Odoo: de Billbee a Ventas, con el cliente, las líneas por SKU y el IVA bien puestoCómo trae el conector los pedidos de Billbee a Ventas de Odoo: cada 15 minutos, con cliente y entrega, líneas por SKU, el IVA incluido y la automatización.El stock de Odoo en Billbee: el número que le llega, cada cuánto y qué pasa si no cuadraQué stock manda el conector de Odoo a Billbee, por qué resta los pedidos de Billbee aún sin confirmar y qué hace la comparación de cada 6 horas.Envíos de Billbee desde Odoo: un pedido que sale en dos entregas y lo que ve Billbee en cada unaQué manda Odoo a Billbee al validar cada entrega de un pedido: el seguimiento, el transportista, el estado enviado solo al final y la etiqueta.Qué es Billbee y qué es cada una de sus palabras en OdooQué es Billbee, quién lo usa y qué significan sus palabras (estado, reclamación, Freier Provider, contraseña de API) cuando lo conectas con Odoo.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes

  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
  • Código del módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
  • Código del módulo: 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
  • Prueba real de FlexigoTech con una cuenta de prueba de Billbee (17 y 18-11-2026)
  • flexigotech.com/conector-billbee-odoo.html
  • flexigotech.com/condiciones-contratacion.html
  • www.billbee.io/
  • www.billbee.io/en