Vai al contenuto principale
BambooHR

BambooHR API: cosa ne fa il connettore per Odoo

Secondo la documentazione di BambooHR, la sua API è un protocollo REST che legge o modifica una risorsa con richieste HTTPS, e serve a gestire i dati dei dipendenti e a generare report in vari formati. Il connettore di FlexigoTech per Odoo la usa al posto tuo: accede con OAuth e senza chiave API, chiama un insieme preciso di rotte, rispetta i limiti di BambooHR e registra ogni chiamata in Odoo.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 19 novembre 2026

In breve

Modulo
BambooHR
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
4 min

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:

  1. In BambooHR › Configurazione › Connetti BambooHR scrivi il tuo sottodominio.
  2. Confermi che i tuoi dipendenti sanno che stai collegando i due sistemi.
  3. 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.

Chiamate alla API di BambooHR in Odoo
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.

Eventi webhook di BambooHR in Odoo
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

BambooHR assenze in Odoo, passo dopo passoCome richieste di ferie, saldi e festività aziendali di BambooHR arrivano in Odoo, chi le approva e con quali opzioni parte il connettore.BambooHR buste paga in Odoo: quello che nessuno ti diceBambooHR Payroll paga i dipendenti negli Stati Uniti e il connettore non porta le sue paghe. Cosa porta al Libro paga di Odoo: bonus, provvigioni, trattenute.BambooHR onboarding in Odoo: un'assunzione e una cessazione, passo dopo passoCosa succede in Odoo quando assumi o fai uscire un dipendente in BambooHR: ufficio, qualifica, piano di inserimento e uscita, con un caso concreto.Cos'è BambooHR, e dove si colloca accanto a OdooCos'è BambooHR con parole sue, i suoi termini con l'equivalente in Odoo e cosa fa il connettore di FlexigoTech con i dati dei tuoi dipendenti.
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