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:
- A
BambooHR › Configuració › Connecta BambooHRhi escrius el teu subdomini. - Confirmes que els teus empleats saben que connectes els dos sistemes.
- 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.

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.

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
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
