Naar hoofdinhoud
BambooHR

BambooHR API: wat de Odoo-connector ermee doet

Volgens de documentatie van BambooHR is de API een REST-protocol dat met HTTPS-verzoeken een resource leest of wijzigt, en dient ze om werknemersgegevens te bewerken en rapporten in verschillende formaten te maken. De connector van FlexigoTech voor Odoo gebruikt haar voor u: hij logt in met OAuth zonder API-sleutel, roept een vaste reeks routes aan, houdt zich aan de limieten van BambooHR en legt elke aanroep vast in Odoo.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 19 november 2026

In het kort

Module
BambooHR
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
4 min

Wat de BambooHR API is

BambooHR noemt het een open API waarmee u eenvoudig andere applicaties in BambooHR integreert. Elk bedrijf heeft een eigen adres. Volgens de documentatie vervangt u {companyDomain} door de tekst die vóór .bamboohr.com staat in de BambooHR-URL van uw bedrijf.

De connector bouwt elke aanroep als https://{subdomein}.bamboohr.com plus de route. Hij gebruikt nooit een ander adres dat BambooHR teruggeeft, en hij controleert de server nadat de URL is opgebouwd, zodat geen enkele aanroep ergens anders heen gaat.

Geen API-sleutel: OAuth

Veel mensen zoeken hoe ze in BambooHR een API-sleutel aanmaken. Met deze connector hebt u die niet nodig. De documentatie van BambooHR vraagt app-makers om een OAuth-flow in hun applicatie te bouwen, en dat doet de app van FlexigoTech:

  1. In BambooHR › Configuratie › BambooHR verbinden vult u uw subdomein in.
  2. U bevestigt dat uw werknemers weten dat u de twee systemen koppelt.
  3. Een beheerder van BambooHR keurt de app goed op het scherm van BambooHR zelf.

FlexigoTech Cloud beheert de tokens die BambooHR aan onze app geeft en vernieuwt de toegang elk uur. Uw Odoo bewaart die toegang in velden die alleen beheerders kunnen lezen en roept BambooHR rechtstreeks aan. Uw werknemers, hun verlof en hun uren gaan niet via FlexigoTech Cloud. Antwoordt BambooHR met een 401, dan vernieuwt de connector de toegang één keer en herhaalt hij de aanroep één keer.

Welke API-routes hij aanroept

Gewijzigde werknemers
GET /api/v1/employees/changed met de parameter since: welke werknemers sinds de vorige ronde zijn gewijzigd.
Werknemersgegevens
POST /api/v2/datasets/employee/data, pagina voor pagina.
Verlof
/api/v1/time-off/requests, om aanvragen te lezen en, als u het aanzet, te schrijven.
Webhooks
POST /api/v1/webhooks, om de webhook van de connector te registreren.

Elke aanroep draagt Authorization: Bearer, Accept: application/json en een eigen X-Request-ID. Hij volgt geen omleidingen. Hij wacht 10 seconden op de verbinding en 60 op het antwoord, 120 bij downloads.

BambooHR API-aanroepen in Odoo
BambooHR › Monitoring › API-aanroepen: elke aanroep met methode, route, status en X-Request-ID. Eén ervan eindigde met een fout en staat in het rood.

De limieten: 429, Retry-After en fouten

De verbinding heeft de instelling Max. aanvragen per seconde, die op 5 begint. Dat tempo delen de vier soorten werk van de connector: de wachtrij, de synchronisatie, de dagelijkse en de wekelijkse taken.

Als BambooHR met een 429 antwoordt, doet de connector het volgende:

  • Met Retry-After wacht de hele verbinding zo lang als BambooHR aangeeft, tussen 1 en 3600 seconden, of 60 als er niets staat. Daarna draait ze 10 minuten op half tempo.
  • Komt de 429 zonder Retry-After bij het aanmaken van een werknemer (POST /api/v1/employees), dan is dat het werknemersmaximum van uw BambooHR-account, en wordt de aanroep niet herhaald.
  • Bij een 500, een 502, een 503 of een netwerkstoring wacht hij 1 minuut, 5 minuten, 30 minuten, 2 uur en 6 uur. De zesde poging telt als mislukt.

Elke aanroep laat een regel achter in API-aanroepen, met de methode, het routesjabloon, de status, de request-ID, de milliseconden en de Retry-After. Hij slaat nooit de inhoud van berichten, tokens of de querystring op.

Webhooks: ze melden alleen een wijziging

De connector registreert zijn eigen webhook in BambooHR. Leveringen komen ondertekend binnen, en de ontvanger antwoordt binnen een seconde zonder iets op de verbinding te schrijven. Een levering start alleen een leesactie: de API blijft de bron van waarheid, en de controle om de 15 minuten loopt door, ook als een webhook mislukt. Van elke levering bewaart hij het type, het tijdstip, de companyId, de employeeId en de gewijzigde velden, 8 dagen lang.

BambooHR-webhookgebeurtenissen in Odoo
BambooHR › Monitoring › Webhookgebeurtenissen: twee leveringen employee.updated, al verwerkt, met het werknemers-ID in BambooHR.

Dit zijn de geplande acties die met de API werken:

  • De wachtrij, elke minuut: webhookleveringen en wat Odoo naar BambooHR moet sturen.
  • De incrementele synchronisatie, elke 15 minuten.
  • De dagelijkse taken, om 02:00 uur lokale tijd van elk bedrijf.
  • De afstemming, één keer per week.

Verlof loopt via dezelfde API, en hoe het in Odoo komt, leest u in BambooHR verlof in Odoo.

Vragen over de BambooHR API en Odoo

Heb ik een API-sleutel van BambooHR nodig?

Nee. De verbinding gebruikt OAuth: u vult uw subdomein in Odoo in en een beheerder van BambooHR keurt de app van FlexigoTech goed.

Gaan mijn gegevens via FlexigoTech Cloud?

Nee. Uw Odoo roept de BambooHR API rechtstreeks aan. FlexigoTech Cloud autoriseert de verbinding, vernieuwt de toegang, bewaakt de synchronisatie en waarschuwt u als die mislukt.

Wat kost het?

De modulelicentie kost € 9 per Odoo-versie op Odoo Apps. Daarnaast is FlexigoTech Cloud nodig, plan Connector: Standard, € 49 per maand of € 490 per jaar, of Pro, € 98 per maand of € 980 per jaar, excl. btw. U kunt 14 dagen gratis proberen. De prijs omvat twee maanden hulp om het werkend te krijgen en, zolang u het abonnement houdt, updates en ondersteuning, zoals onze verkoopvoorwaarden in versie 2.2 zeggen. De pagina van de BambooHR-connector zet alles op een rij.

Op welke Odoo-versies werkt hij?

Odoo 17, 18, 19 en 20, op Odoo.sh of op uw eigen server. Op Odoo Online werkt hij niet. Uw BambooHR-account en de kosten ervan staan hier los van.

Lees verder

BambooHR verlof in Odoo, stap voor stapHoe verlofaanvragen, saldi en bedrijfsfeestdagen uit BambooHR in Odoo komen, wie ze goedkeurt en met welke opties de connector begint.BambooHR salarisadministratie in Odoo: wat niemand u verteltBambooHR Payroll betaalt werknemers in de VS en de connector haalt geen loonruns op. Wat hij wel naar Odoo brengt: bonus, commissie, inhoudingen.BambooHR onboarding in Odoo: één indiensttreding en één vertrek, stap voor stapWat er in Odoo gebeurt als u in BambooHR iemand aanneemt of laat vertrekken: afdeling, functietitel, onboardingplan en vertrek, met een uitgewerkt voorbeeld.Wat is BambooHR, en waar staat het naast OdooWat BambooHR is in zijn eigen woorden, zijn begrippen met hun tegenhanger in Odoo en wat de connector van FlexigoTech met uw werknemersgegevens doet.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen

  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
  • Broncode van de module: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
  • documentation.bamboohr.com/docs/getting-started
  • flexigotech.com/nl/bamboohr-koppeling-odoo.html