Salta al contingut principal
BambooHR

BambooHR API: què en fa el connector d'Odoo

Segons la documentació de BambooHR, la seva API és un protocol REST que llegeix o canvia un recurs amb peticions HTTPS, i serveix per treballar amb les dades dels empleats i treure informes en diversos formats. El connector de FlexigoTech per a Odoo la fa servir per tu: hi entra amb OAuth i sense clau d'API, crida unes rutes concretes, respecta els límits de BambooHR i anota cada crida a Odoo.

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

L'essencial

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

Què és l'API de BambooHR

BambooHR la presenta com una API oberta que facilita integrar altres aplicacions a BambooHR. Cada empresa té la seva pròpia adreça. Segons la documentació, {companyDomain} se substitueix pel text que surt davant de .bamboohr.com a l'URL de BambooHR de la teva empresa.

El connector munta cada crida com https://{subdomini}.bamboohr.com més la ruta. Mai no fa servir una altra adreça que li torni BambooHR, i comprova el servidor després de muntar l'URL, perquè cap crida no surti cap a un altre lloc.

Sense clau d'API: OAuth

Molta gent busca com generar una clau d'API a BambooHR. Amb aquest connector no la necessites. La documentació de BambooHR demana als creadors d'aplicacions que implementin un flux OAuth, i és el que fa l'aplicació de FlexigoTech:

  1. A BambooHR › Configuració › Connecta BambooHR hi escrius el teu subdomini.
  2. Confirmes que els teus empleats saben que connectes els dos sistemes.
  3. Un administrador de BambooHR aprova l'aplicació a la pantalla del mateix BambooHR.

FlexigoTech Cloud gestiona els tokens que BambooHR emet per a la nostra aplicació i renova l'accés cada hora. El teu Odoo desa aquest accés en camps que només poden llegir els administradors i crida BambooHR directament. Els teus empleats, les seves absències i les seves hores no passen per FlexigoTech Cloud. Si BambooHR respon amb un 401, el connector renova l'accés una vegada i repeteix la crida una vegada.

Quines rutes de l'API crida

Empleats canviats
GET /api/v1/employees/changed amb el paràmetre since: quins empleats han canviat des de l'última passada.
Dades dels empleats
POST /api/v2/datasets/employee/data, pàgina a pàgina.
Absències
/api/v1/time-off/requests, per llegir les sol·licituds i, si ho actives, per escriure-les.
Webhooks
POST /api/v1/webhooks, per registrar el webhook del connector.

Cada crida porta Authorization: Bearer, Accept: application/json i el seu propi X-Request-ID. No segueix redireccions. Espera 10 segons per connectar-se i 60 per llegir, 120 per a les descàrregues.

Crides a l'API de BambooHR a Odoo
BambooHR › Supervisió › Crides a l'API: cada crida amb el mètode, la ruta, l'estat i l'X-Request-ID. Una va acabar amb error i surt en vermell.

Els límits: 429, Retry-After i errors

La connexió té l'opció Màx. de sol·licituds per segon, que comença en 5. Aquest ritme el comparteixen els quatre tipus de feina del connector: la cua, la sincronització, les tasques diàries i les setmanals.

Quan BambooHR respon amb un 429, el connector fa això:

  • Amb Retry-After, tota la connexió espera el temps que digui BambooHR, entre 1 i 3600 segons, o 60 si no diu res. Després va a mig ritme durant 10 minuts.
  • Si el 429 arriba sense Retry-After en crear un empleat (POST /api/v1/employees), és el límit d'empleats del teu compte de BambooHR, i la crida no es repeteix.
  • Amb un 500, un 502, un 503 o una fallada de xarxa, espera 1 minut, 5 minuts, 30 minuts, 2 hores i 6 hores. El sisè intent compta com a fallat.

Cada crida deixa una fila a Crides a l'API, amb el mètode, la plantilla de la ruta, l'estat, l'identificador de la petició, els mil·lisegons i el Retry-After. Mai no desa el contingut dels missatges, els tokens ni la consulta.

Webhooks: només avisen d'un canvi

El connector registra el seu propi webhook a BambooHR. Els enviaments arriben signats, i el receptor respon en menys d'un segon sense escriure res a la connexió. Un enviament només engega una lectura: l'API continua sent la font de veritat, i la consulta cada 15 minuts continua encara que falli un webhook. De cada enviament en guarda el tipus, l'hora, el companyId, l'employeeId i els camps canviats, durant 8 dies.

Esdeveniments de webhook de BambooHR a Odoo
BambooHR › Supervisió › Esdeveniments de webhook: dos enviaments employee.updated, ja processats, amb l'identificador de l'empleat a BambooHR.

Aquestes són les accions planificades que treballen amb l'API:

  • La cua, cada minut: els enviaments dels webhooks i el que Odoo ha d'enviar a BambooHR.
  • La sincronització incremental, cada 15 minuts.
  • Les tasques diàries, a les 02:00, hora local de cada empresa.
  • La conciliació, un cop per setmana.

Les absències passen per aquesta mateixa API, i com arriben a Odoo s'explica a BambooHR absències a Odoo.

Preguntes sobre l'API de BambooHR i Odoo

Necessito una clau d'API de BambooHR?

No. La connexió fa servir OAuth: escrius el teu subdomini a Odoo i un administrador de BambooHR aprova l'aplicació de FlexigoTech.

Les meves dades passen per FlexigoTech Cloud?

No. El teu Odoo crida l'API de BambooHR directament. FlexigoTech Cloud autoritza la connexió, renova l'accés, vigila la sincronització i t'avisa quan falla.

Quant costa?

La llicència del mòdul costa 9 € per versió d'Odoo a Odoo Apps. També necessita FlexigoTech Cloud, pla Connector: Standard, 49 €/mes o 490 €/any, o Pro, 98 €/mes o 980 €/any, sense IVA. Tens 14 dies de prova gratuïta. El preu inclou dos mesos d'ajuda per posar-lo en marxa i, mentre mantinguis la subscripció, les actualitzacions i el suport, com diuen les nostres condicions de contractació, versió 2.2. La pàgina del connector BambooHR ho resumeix tot.

En quines versions d'Odoo funciona?

Odoo 17, 18, 19 i 20, a Odoo.sh o al teu propi servidor. No funciona a Odoo Online. El teu compte de BambooHR i les seves tarifes van a part.

Continua llegint

BambooHR absències a Odoo, pas a pasCom arriben a Odoo les sol·licituds d'absència, els saldos i els festius de l'empresa de BambooHR, qui els aprova i amb quines opcions comença el connector.BambooHR nòmina a Odoo: el que ningú no t'explicaBambooHR Payroll paga empleats als Estats Units i el connector no en porta les nòmines calculades. Què porta a Nòmina d'Odoo: bonus, comissions i deduccions.BambooHR onboarding a Odoo: una alta i una baixa, pas a pasQuè passa a Odoo quan dones d'alta o de baixa un empleat a BambooHR: departament, lloc, pla d'incorporació i sortida, amb un cas pràctic.Què és BambooHR, i on queda al costat d'OdooQuè és BambooHR en les seves pròpies paraules, els seus termes amb l'equivalent a Odoo i què fa el connector de FlexigoTech amb les dades dels teus empleats.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
  • Codi del mòdul: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
  • documentation.bamboohr.com/docs/getting-started
  • flexigotech.com/ca/connector-bamboohr-odoo.html