Qué es la API de BambooHR
BambooHR la llama API abierta y dice que sirve para integrar otras aplicaciones con BambooHR. Cada empresa tiene su propia dirección: según su documentación, el subdominio es el texto que va delante de .bamboohr.com en la dirección con la que entras.
El conector monta cada llamada como https://{subdominio}.bamboohr.com más la ruta. Nunca usa otra dirección que le devuelva BambooHR, y comprueba el servidor después de montar la URL, para que ninguna llamada salga hacia otro sitio.
Sin clave de API: OAuth
Mucha gente busca cómo generar una clave de API en BambooHR. Con este conector no la necesitas. La documentación de BambooHR explica un flujo OAuth para las aplicaciones, y es el que usa la app de FlexigoTech:
- En
BambooHR › Configuración › Conectar BambooHRescribes tu subdominio. - Confirmas que tus empleados saben que vas a conectar los dos sistemas.
- Un administrador de BambooHR aprueba la app en la pantalla de BambooHR.
FlexigoTech Cloud se encarga de los tokens que BambooHR emite para nuestra app y renueva el acceso cada hora. Tu Odoo guarda ese acceso en campos que solo leen los administradores y llama a BambooHR directamente. Tus empleados, sus ausencias y sus horas no pasan por FlexigoTech Cloud. Si BambooHR contesta con un 401, el conector refresca el acceso una vez y repite la llamada una vez.
Qué rutas de la API llama
- Empleados cambiados
- GET /api/v1/employees/changed con el parámetro since: qué empleados han cambiado desde la última vez.
- Datos de los empleados
- POST /api/v2/datasets/employee/data, por páginas.
- Ausencias
- /api/v1/time-off/requests, para leer las solicitudes y, si lo activas, escribirlas.
- Webhooks
- POST /api/v1/webhooks, para dar de alta el webhook del conector.
Cada llamada lleva Authorization: Bearer, Accept: application/json y un X-Request-ID propio. No sigue redirecciones. Espera 10 segundos para conectar y 60 para leer, 120 en las descargas.

BambooHR › Supervisión › Llamadas a la API: cada llamada con su método, su ruta, su estado y su X-Request-ID. Una de ellas acabó en error y se ve en rojo.Los límites: 429, Retry-After y errores
La conexión tiene un Máx. de solicitudes por segundo, que viene en 5. Ese ritmo se reparte entre las cuatro clases de trabajo del conector: la cola, la sincronización, las tareas diarias y las semanales.
Cuando BambooHR contesta con un 429, el conector hace esto:
- Con Retry-After, toda la conexión espera lo que dice BambooHR, entre 1 y 3600 segundos, o 60 si no lo dice. Después va a la mitad de ritmo durante 10 minutos.
- Si el 429 llega sin Retry-After al dar de alta un empleado (POST /api/v1/employees), es el tope de empleados de tu cuenta de BambooHR, y no se reintenta.
- Con un 500, un 502, un 503 o un fallo de red, espera 1 minuto, 5 minutos, 30 minutos, 2 horas y 6 horas. El sexto intento ya cuenta como fallo.
Cada llamada deja una fila en Llamadas a la API, con el método, la plantilla de la ruta, el estado, el request id, los milisegundos y el Retry-After. Nunca guarda los cuerpos, los tokens ni la consulta.
Webhooks: solo avisan de un cambio
El conector da de alta su propio webhook en BambooHR. Los avisos llegan firmados, y el receptor contesta en menos de un segundo sin escribir nada en la conexión. Un aviso solo pone en marcha la lectura: la API sigue mandando, y la consulta de cada 15 minutos sigue en marcha aunque falle un webhook. De cada aviso guarda el tipo, la hora, el companyId, el employeeId y los campos cambiados, durante 8 días.

BambooHR › Supervisión › Eventos de webhook: dos avisos employee.updated, ya procesados, con el ID de empleado de BambooHR.Estas son las tareas programadas que trabajan con la API:
- La cola, cada minuto: los avisos de los webhooks y lo que Odoo tiene que mandar a BambooHR.
- La sincronización incremental, cada 15 minutos.
- Las tareas diarias, a las 02:00 de la hora de cada compañía.
- La conciliación, una vez por semana.
Las ausencias van por esta misma API, y cómo llegan a Odoo lo contamos en las ausencias de BambooHR en Odoo.
Preguntas sobre la API de BambooHR y Odoo
¿Necesito una clave de API de BambooHR?
No. La conexión usa OAuth: escribes tu subdominio en Odoo y un administrador de BambooHR aprueba la app de FlexigoTech.
¿Pasan mis datos por FlexigoTech Cloud?
No. Tu Odoo llama directamente a la API de BambooHR. FlexigoTech Cloud autoriza la conexión, renueva el acceso, vigila la sincronización y te avisa cuando falla.
¿Cuánto cuesta?
La licencia del módulo cuesta 9 € por versión de Odoo en Odoo Apps. Además necesita FlexigoTech Cloud, plan Conector: Estándar, 49 €/mes o 490 €/año, o Pro, 98 €/mes o 980 €/año, sin IVA. Tienes 14 días de prueba gratis. El precio incluye dos meses de ayuda para ponerlo en marcha y, mientras mantengas la suscripción, las actualizaciones y el soporte, como dicen las condiciones de contratación 2.2. Lo resume la página del conector de BambooHR.
¿En qué versiones de Odoo funciona?
En Odoo 17, 18, 19 y 20, en Odoo.sh o en tu propio servidor. No funciona en Odoo Online. La cuenta de BambooHR y sus tarifas van aparte.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
- Código del módulo: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
- documentation.bamboohr.com/docs/getting-started
- flexigotech.com/conector-bamboohr-odoo.html
- flexigotech.com/condiciones-contratacion.html
