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:
- Unter
BambooHR › Konfiguration › BambooHR verbindengeben Sie Ihre Subdomain ein. - Sie bestätigen, dass Ihre Mitarbeiter wissen, dass Sie die beiden Systeme verbinden.
- 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 › Ü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 › Ü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
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
