O que é a API do BambooHR
O BambooHR chama-lhe uma API aberta que facilita a integração de outras aplicações no BambooHR. Cada empresa tem o seu próprio endereço. Segundo a documentação, {companyDomain} substitui-se pelo texto que aparece antes de .bamboohr.com no URL do BambooHR da sua empresa.
O conector monta cada chamada como https://{subdomínio}.bamboohr.com mais a rota. Nunca usa outro endereço devolvido pelo BambooHR e verifica o servidor depois de montar o URL, para que nenhuma chamada saia para outro sítio.
Sem chave de API: OAuth
Muita gente procura como gerar uma chave de API no BambooHR. Com este conector não precisa dela. A documentação do BambooHR pede a quem faz aplicações que implemente um fluxo OAuth, e é isso que faz a aplicação da FlexigoTech:
- Em
BambooHR › Configuração › Conectar o BambooHR, escreve o seu subdomínio. - Confirma que os seus funcionários sabem que está a ligar os dois sistemas.
- Um administrador do BambooHR aprova a aplicação no próprio ecrã do BambooHR.
A FlexigoTech Cloud gere os tokens que o BambooHR emite para a nossa aplicação e renova o acesso a cada hora. O seu Odoo guarda esse acesso em campos que só os administradores podem ler e chama o BambooHR diretamente. Os seus funcionários, as ausências e as horas deles não passam pela FlexigoTech Cloud. Se o BambooHR responder com um 401, o conector renova o acesso uma vez e repete a chamada uma vez.
Que rotas da API chama
- Funcionários alterados
- GET /api/v1/employees/changed com o parâmetro since: que funcionários mudaram desde a última passagem.
- Dados dos funcionários
- POST /api/v2/datasets/employee/data, página a página.
- Ausências
- /api/v1/time-off/requests, para ler os pedidos e, se o ativar, para os escrever.
- Webhooks
- POST /api/v1/webhooks, para registar o webhook do conector.
Cada chamada leva Authorization: Bearer, Accept: application/json e o seu próprio X-Request-ID. Não segue redirecionamentos. Espera 10 segundos para ligar e 60 para ler, 120 nas transferências.

BambooHR › Monitorização › Chamadas à API: cada chamada com o método, a rota, o estado e o X-Request-ID. Uma delas terminou com erro e aparece a vermelho.Os limites: 429, Retry-After e erros
A ligação tem a definição Máx. de pedidos por segundo, que começa em 5. Esse ritmo é partilhado pelos quatro tipos de trabalho do conector: a fila, a sincronização, as tarefas diárias e as semanais.
Quando o BambooHR responde com um 429, o conector faz isto:
- Com Retry-After, toda a ligação espera o tempo que o BambooHR indicar, entre 1 e 3600 segundos, ou 60 se não indicar nada. Depois funciona a meio ritmo durante 10 minutos.
- Se o 429 chegar sem Retry-After ao criar um funcionário (POST /api/v1/employees), é o limite de funcionários da sua conta do BambooHR, e a chamada não se repete.
- Com um 500, um 502, um 503 ou uma falha de rede, espera 1 minuto, 5 minutos, 30 minutos, 2 horas e 6 horas. A sexta tentativa conta como falhada.
Cada chamada deixa uma linha em Chamadas à API, com o método, o modelo da rota, o estado, o identificador do pedido, os milissegundos e o Retry-After. Nunca guarda o conteúdo das mensagens, os tokens nem a query.
Webhooks: só avisam de uma alteração
O conector regista o seu próprio webhook no BambooHR. Os envios chegam assinados e o recetor responde em menos de um segundo, sem escrever nada na ligação. Um envio só arranca uma leitura: a API continua a ser a fonte de verdade, e a consulta a cada 15 minutos continua mesmo que um webhook falhe. De cada envio guarda o tipo, a hora, o companyId, o employeeId e os campos alterados, durante 8 dias.

BambooHR › Monitorização › Eventos de webhook: dois envios employee.updated, já processados, com o ID do funcionário no BambooHR.Estas são as ações agendadas que trabalham com a API:
- A fila, a cada minuto: os envios dos webhooks e o que o Odoo tem de enviar ao BambooHR.
- A sincronização incremental, a cada 15 minutos.
- As tarefas diárias, às 02:00, hora local de cada empresa.
- A reconciliação, uma vez por semana.
As ausências passam por esta mesma API, e a forma como chegam ao Odoo está em BambooHR ausências no Odoo.
Perguntas sobre a API do BambooHR e o Odoo
Preciso de uma chave de API do BambooHR?
Não. A ligação usa OAuth: escreve o seu subdomínio no Odoo e um administrador do BambooHR aprova a aplicação da FlexigoTech.
Os meus dados passam pela FlexigoTech Cloud?
Não. O seu Odoo chama a API do BambooHR diretamente. A FlexigoTech Cloud autoriza a ligação, renova o acesso, vigia a sincronização e avisa quando falha.
Quanto custa?
A licença do módulo custa 9 € por versão do Odoo na Odoo Apps. Também precisa da FlexigoTech Cloud, plano Conector: Standard, 49 €/mês ou 490 €/ano, ou Pro, 98 €/mês ou 980 €/ano, sem IVA. Tem 14 dias de teste gratuito. O preço inclui dois meses de ajuda para o pôr a funcionar e, enquanto mantiver a subscrição, as atualizações e o suporte, como dizem as nossas condições de venda, versão 2.2. A página do conector BambooHR resume tudo.
Em que versões do Odoo funciona?
Odoo 17, 18, 19 e 20, no Odoo.sh ou no seu próprio servidor. Não funciona no Odoo Online. A sua conta do BambooHR e as respetivas tarifas são à parte.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
- Código do módulo: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
- documentation.bamboohr.com/docs/getting-started
- flexigotech.com/pt/conector-bamboohr-odoo.html
