Saltar para o conteúdo principal
BambooHR

BambooHR API: o que o conector do Odoo faz com ela

Segundo a documentação do BambooHR, a sua API é um protocolo REST que lê ou altera um recurso através de pedidos HTTPS, e serve para trabalhar com os dados dos funcionários e gerar relatórios em vários formatos. O conector da FlexigoTech para o Odoo usa-a por si: entra com OAuth e sem chave de API, chama um conjunto definido de rotas, respeita os limites do BambooHR e regista cada chamada no Odoo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 19 de novembro de 2026

O essencial

Módulo
BambooHR
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
4 min

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:

  1. Em BambooHR › Configuração › Conectar o BambooHR, escreve o seu subdomínio.
  2. Confirma que os seus funcionários sabem que está a ligar os dois sistemas.
  3. 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.

Chamadas à API do BambooHR no Odoo
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.

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

BambooHR ausências no Odoo, passo a passoComo os pedidos de ausência, os saldos e os feriados da empresa do BambooHR chegam ao Odoo, quem os aprova e com que opções arranca o conector.BambooHR processamento salarial no Odoo: o que ninguém lhe dizO BambooHR Payroll paga funcionários nos EUA e o conector não traz os seus processamentos. O que leva para a Folha de Salários do Odoo: bónus e deduções.BambooHR onboarding no Odoo: uma admissão e uma saída, passo a passoO que acontece no Odoo quando admite ou desvincula um funcionário no BambooHR: departamento, cargo, plano de integração e saída, com um caso prático.O que é o BambooHR, e onde fica ao lado do OdooO que é o BambooHR nas suas próprias palavras, os seus termos com o equivalente no Odoo e o que o conector da FlexigoTech faz com os dados dos funcionários.
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