Che cos'è la API di BambooHR
BambooHR la definisce una API aperta che rende facile integrare altre applicazioni in BambooHR. Ogni azienda ha il proprio indirizzo. Secondo la documentazione, {companyDomain} va sostituito con il testo che compare prima di .bamboohr.com nell'URL di BambooHR della tua azienda.
Il connettore costruisce ogni chiamata come https://{sottodominio}.bamboohr.com più la rotta. Non usa mai un altro indirizzo restituito da BambooHR e controlla il server dopo aver costruito l'URL, così nessuna chiamata può finire altrove.
Niente chiave API: OAuth
Molti cercano come generare una chiave API in BambooHR. Con questo connettore non ti serve. La documentazione di BambooHR chiede a chi sviluppa app di implementare un flusso OAuth, ed è quello che fa l'app di FlexigoTech:
- In
BambooHR › Configurazione › Connetti BambooHRscrivi il tuo sottodominio. - Confermi che i tuoi dipendenti sanno che stai collegando i due sistemi.
- Un amministratore di BambooHR approva l'app nella schermata di BambooHR stesso.
FlexigoTech Cloud gestisce i token che BambooHR rilascia alla nostra app e rinnova l'accesso ogni ora. Il tuo Odoo conserva quell'accesso in campi che solo gli amministratori possono leggere e chiama BambooHR direttamente. I tuoi dipendenti, le loro ferie e le loro ore non passano da FlexigoTech Cloud. Se BambooHR risponde con un 401, il connettore rinnova l'accesso una volta e ripete la chiamata una volta.
Quali rotte della API chiama
- Dipendenti modificati
- GET /api/v1/employees/changed con il parametro since: quali dipendenti sono cambiati dall'ultimo passaggio.
- Dati dei dipendenti
- POST /api/v2/datasets/employee/data, pagina per pagina.
- Ferie
- /api/v1/time-off/requests, per leggere le richieste e, se lo attivi, per scriverle.
- Webhook
- POST /api/v1/webhooks, per registrare il webhook del connettore.
Ogni chiamata porta Authorization: Bearer, Accept: application/json e il proprio X-Request-ID. Non segue reindirizzamenti. Aspetta 10 secondi per connettersi e 60 per leggere, 120 per i download.

BambooHR › Monitoraggio › Chiamate API: ogni chiamata con metodo, rotta, stato e X-Request-ID. Una è finita con un errore e appare in rosso.I limiti: 429, Retry-After ed errori
La connessione ha l'impostazione Richieste massime al secondo, che parte da 5. Questo ritmo è condiviso dai quattro tipi di lavoro del connettore: la coda, la sincronizzazione, le attività giornaliere e quelle settimanali.
Quando BambooHR risponde con un 429, il connettore fa così:
- Con Retry-After, tutta la connessione aspetta il tempo indicato da BambooHR, tra 1 e 3600 secondi, oppure 60 se non indica nulla. Poi va a metà ritmo per 10 minuti.
- Se il 429 arriva senza Retry-After durante la creazione di un dipendente (POST /api/v1/employees), è il limite di dipendenti del tuo account BambooHR, e la chiamata non viene ripetuta.
- Con un 500, un 502, un 503 o un errore di rete, aspetta 1 minuto, 5 minuti, 30 minuti, 2 ore e 6 ore. Il sesto tentativo conta come fallito.
Ogni chiamata lascia una riga in Chiamate API, con il metodo, il modello della rotta, lo stato, l'identificativo della richiesta, i millisecondi e il Retry-After. Non salva mai il contenuto dei messaggi, i token né la query.
Webhook: segnalano solo un cambiamento
Il connettore registra il proprio webhook in BambooHR. Gli invii arrivano firmati e il ricevitore risponde in meno di un secondo senza scrivere nulla sulla connessione. Un invio avvia solo una lettura: la fonte di verità resta la API, e il controllo ogni 15 minuti continua anche se un webhook non arriva. Di ogni invio conserva il tipo, l'ora, il companyId, l'employeeId e i campi cambiati, per 8 giorni.

BambooHR › Monitoraggio › Eventi webhook: due invii employee.updated, già elaborati, con l'ID del dipendente in BambooHR.Queste sono le azioni pianificate che lavorano con la API:
- La coda, ogni minuto: gli invii dei webhook e ciò che Odoo deve mandare a BambooHR.
- La sincronizzazione incrementale, ogni 15 minuti.
- Le attività giornaliere, alle 02:00 ora locale di ogni azienda.
- La riconciliazione, una volta alla settimana.
Anche le ferie passano per questa API, e come arrivano in Odoo è spiegato in BambooHR assenze in Odoo.
Domande sulla API di BambooHR e Odoo
Mi serve una chiave API di BambooHR?
No. La connessione usa OAuth: scrivi il tuo sottodominio in Odoo e un amministratore di BambooHR approva l'app di FlexigoTech.
I miei dati passano da FlexigoTech Cloud?
No. Il tuo Odoo chiama direttamente la API di BambooHR. FlexigoTech Cloud autorizza la connessione, rinnova l'accesso, controlla la sincronizzazione e ti avvisa quando fallisce.
Quanto costa?
La licenza del modulo costa 9 € per versione di Odoo su Odoo Apps. Serve anche FlexigoTech Cloud, piano Connettore: Standard, 49 €/mese o 490 €/anno, oppure Pro, 98 €/mese o 980 €/anno, IVA esclusa. Hai 14 giorni di prova gratuita. Il prezzo include due mesi di aiuto per metterlo in funzione e, finché mantieni l'abbonamento, aggiornamenti e assistenza, come dicono le nostre condizioni di vendita, versione 2.2. La pagina del connettore BambooHR riassume tutto.
Con quali versioni di Odoo funziona?
Odoo 17, 18, 19 e 20, su Odoo.sh o sul tuo server. Non funziona su Odoo Online. Il tuo account BambooHR e i suoi costi sono a parte.
Continua a leggere
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
- Codice del modulo: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
- documentation.bamboohr.com/docs/getting-started
- flexigotech.com/it/connettore-bamboohr-odoo.html
