Saltar al contenido principal
BambooHR

BambooHR API: lo que hace con ella el conector de Odoo

La documentación de BambooHR presenta su API como un protocolo REST sobre HTTPS para leer o cambiar datos, y dice que sirve para trabajar con los datos de los empleados y sacar informes en varios formatos. El conector de FlexigoTech para Odoo la usa por ti: entra con OAuth y sin clave de API, llama a unas rutas concretas, respeta los límites de BambooHR y apunta cada llamada en Odoo.

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

Lo esencial

Módulo
BambooHR
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
4 min

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:

  1. En BambooHR › Configuración › Conectar BambooHR escribes tu subdominio.
  2. Confirmas que tus empleados saben que vas a conectar los dos sistemas.
  3. 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.

Llamadas a la API de BambooHR en Odoo
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.

Eventos de webhook de BambooHR en Odoo
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

Las ausencias de BambooHR en Odoo, paso a pasoCómo llegan a Odoo las solicitudes de ausencia, los saldos y los festivos de BambooHR, quién las aprueba y qué opciones trae el conector de serie.BambooHR y nómina en Odoo: lo que no te cuentanBambooHR Payroll paga a empleados en EE. UU. y el conector no trae sus nóminas. Lo que sí lleva a la nómina de Odoo: bonus, comisiones y deducciones.Onboarding de BambooHR en Odoo: un alta y una baja, paso a pasoQué pasa en Odoo cuando das de alta o de baja a un empleado en BambooHR: departamento, puesto, plan de incorporación y salida, con un caso.Qué es BambooHR y qué papel tiene junto a OdooQué es BambooHR según su propia web, sus términos con su equivalente en Odoo y qué hace el conector de FlexigoTech con los datos de tus empleados.
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