Zum Hauptinhalt springen
BambooHR

BambooHR API: was der Odoo-Connector damit macht

Laut der Dokumentation von BambooHR ist die API ein REST-Protokoll, das mit HTTPS-Anfragen eine Ressource liest oder ändert, und sie dient dazu, Mitarbeiterdaten zu bearbeiten und Berichte in mehreren Formaten zu erstellen. Der Connector von FlexigoTech für Odoo nutzt sie für Sie: Er meldet sich per OAuth ohne API-Schlüssel an, ruft eine feste Reihe von Routen auf, hält die Limits von BambooHR ein und protokolliert jeden Aufruf in Odoo.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 19. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
4 Min.

Was die BambooHR API ist

BambooHR nennt sie eine offene API, mit der sich andere Anwendungen leicht in BambooHR integrieren lassen. Jedes Unternehmen hat seine eigene Adresse. Laut der Dokumentation ersetzen Sie {companyDomain} durch den Text, der in der BambooHR-URL Ihres Unternehmens vor .bamboohr.com steht.

Der Connector baut jeden Aufruf als https://{Subdomain}.bamboohr.com plus Route. Er nutzt nie eine andere Adresse, die BambooHR zurückgibt, und er prüft den Server, nachdem er die URL gebaut hat, damit kein Aufruf woandershin geht.

Kein API-Schlüssel: OAuth

Viele suchen, wie man in BambooHR einen API-Schlüssel erzeugt. Mit diesem Connector brauchen Sie keinen. Die Dokumentation von BambooHR rät App-Anbietern, in ihrer Anwendung einen OAuth-Ablauf einzubauen, und genau das tut die App von FlexigoTech:

  1. Unter BambooHR › Konfiguration › BambooHR verbinden geben Sie Ihre Subdomain ein.
  2. Sie bestätigen, dass Ihre Mitarbeiter wissen, dass Sie die beiden Systeme verbinden.
  3. Ein Administrator von BambooHR genehmigt die App auf dem Bildschirm von BambooHR selbst.

FlexigoTech Cloud verwaltet die Tokens, die BambooHR unserer App ausstellt, und erneuert den Zugriff jede Stunde. Ihr Odoo speichert diesen Zugriff in Feldern, die nur Administratoren lesen können, und ruft BambooHR direkt auf. Ihre Mitarbeiter, ihre Abwesenheiten und ihre Stunden laufen nicht über FlexigoTech Cloud. Antwortet BambooHR mit einem 401, erneuert der Connector den Zugriff einmal und wiederholt den Aufruf einmal.

Welche API-Routen er aufruft

Geänderte Mitarbeiter
GET /api/v1/employees/changed mit dem Parameter since: welche Mitarbeiter sich seit dem letzten Durchlauf geändert haben.
Mitarbeiterdaten
POST /api/v2/datasets/employee/data, Seite für Seite.
Abwesenheiten
/api/v1/time-off/requests, um Anträge zu lesen und, wenn Sie es einschalten, zu schreiben.
Webhooks
POST /api/v1/webhooks, um den Webhook des Connectors zu registrieren.

Jeder Aufruf trägt Authorization: Bearer, Accept: application/json und seine eigene X-Request-ID. Er folgt keinen Weiterleitungen. Er wartet 10 Sekunden auf den Verbindungsaufbau und 60 auf die Antwort, 120 bei Downloads.

BambooHR-API-Aufrufe in Odoo
BambooHR › Überwachung › API-Aufrufe: jeder Aufruf mit Methode, Route, Status und X-Request-ID. Einer davon endete mit einem Fehler und ist rot markiert.

Die Limits: 429, Retry-After und Fehler

Die Verbindung hat die Einstellung Max. Anfragen pro Sekunde, die bei 5 beginnt. Dieses Tempo teilen sich die vier Arten von Arbeit des Connectors: die Warteschlange, die Synchronisierung, die täglichen und die wöchentlichen Aufgaben.

Antwortet BambooHR mit einem 429, tut der Connector Folgendes:

  • Mit Retry-After wartet die ganze Verbindung so lange, wie BambooHR angibt, zwischen 1 und 3600 Sekunden, oder 60, wenn nichts angegeben ist. Danach läuft sie 10 Minuten lang mit halbem Tempo.
  • Kommt der 429 ohne Retry-After beim Anlegen eines Mitarbeiters (POST /api/v1/employees), ist das die Mitarbeitergrenze Ihres BambooHR-Kontos, und der Aufruf wird nicht wiederholt.
  • Bei einem 500, 502, 503 oder einem Netzwerkfehler wartet er 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 6 Stunden. Der sechste Versuch gilt als gescheitert.

Jeder Aufruf hinterlässt eine Zeile in API-Aufrufe, mit Methode, Routenvorlage, Status, Request-ID, Millisekunden und Retry-After. Er speichert nie die Inhalte der Nachrichten, die Tokens oder die Query-Parameter.

Webhooks melden nur eine Änderung

Der Connector registriert in BambooHR seinen eigenen Webhook. Die Zustellungen kommen signiert an, und der Empfänger antwortet in weniger als einer Sekunde, ohne etwas an der Verbindung zu schreiben. Eine Zustellung startet nur einen Lesevorgang: Die API bleibt die Quelle der Wahrheit, und die Abfrage alle 15 Minuten läuft weiter, auch wenn ein Webhook ausfällt. Von jeder Zustellung behält er den Typ, die Uhrzeit, die companyId, die employeeId und die geänderten Felder, 8 Tage lang.

BambooHR-Webhook-Ereignisse in Odoo
BambooHR › Überwachung › Webhook-Ereignisse: zwei Zustellungen employee.updated, bereits verarbeitet, mit der Mitarbeiter-ID von BambooHR.

Diese geplanten Aktionen arbeiten mit der API:

  • Die Warteschlange, jede Minute: Webhook-Zustellungen und was Odoo an BambooHR senden muss.
  • Die inkrementelle Synchronisierung, alle 15 Minuten.
  • Die täglichen Aufgaben, um 02:00 Uhr Ortszeit jedes Unternehmens.
  • Der Abgleich, einmal pro Woche.

Abwesenheiten laufen über dieselbe API, und wie sie nach Odoo kommen, steht in BambooHR Abwesenheiten in Odoo.

Fragen zur BambooHR API und Odoo

Brauche ich einen API-Schlüssel von BambooHR?

Nein. Die Verbindung nutzt OAuth: Sie geben Ihre Subdomain in Odoo ein, und ein Administrator von BambooHR genehmigt die App von FlexigoTech.

Laufen meine Daten über FlexigoTech Cloud?

Nein. Ihr Odoo ruft die BambooHR API direkt auf. FlexigoTech Cloud autorisiert die Verbindung, erneuert den Zugriff, überwacht die Synchronisierung und meldet sich, wenn sie fehlschlägt.

Was kostet es?

Die Modullizenz kostet 9 € pro Odoo-Version auf Odoo Apps. Dazu braucht es FlexigoTech Cloud, Plan Konnektor: Standard für 49 €/Monat oder 490 €/Jahr, oder Pro für 98 €/Monat oder 980 €/Jahr, zzgl. MwSt. Sie können 14 Tage kostenlos testen. Im Preis enthalten sind zwei Monate Hilfe bei der Inbetriebnahme und, solange Ihr Abonnement läuft, Updates und Support, wie es unsere Vertragsbedingungen in Version 2.2 vorsehen. Die Seite des BambooHR-Connectors fasst alles zusammen.

Mit welchen Odoo-Versionen funktioniert er?

Odoo 17, 18, 19 und 20, auf Odoo.sh oder auf Ihrem eigenen Server. Auf Odoo Online funktioniert er nicht. Ihr BambooHR-Konto und seine Gebühren laufen separat.

Weiterlesen

BambooHR Abwesenheiten in Odoo, Schritt für SchrittWie Abwesenheitsanträge, Salden und Firmenfeiertage aus BambooHR nach Odoo kommen, wer sie genehmigt und mit welchen Optionen der Connector startet.BambooHR Lohnabrechnung in Odoo: was Ihnen niemand sagtBambooHR Payroll zahlt Mitarbeiter in den USA, der Connector holt keine Lohnläufe. Was er an die Odoo-Personalabrechnung gibt: Boni, Provisionen, Abzüge.BambooHR Onboarding in Odoo: eine Einstellung und ein Austritt, Schritt für SchrittWas in Odoo passiert, wenn Sie in BambooHR jemanden einstellen oder austreten lassen: Abteilung, Stelle, Einarbeitungsplan und Austritt, an einem Beispiel.Was ist BambooHR, und wo steht es neben OdooWas BambooHR mit eigenen Worten ist, seine Begriffe mit ihrer Entsprechung in Odoo und was der Connector von FlexigoTech mit Ihren Mitarbeiterdaten macht.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen

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