Il token di Deel che serve a Odoo
Deel distingue tre token: quello di organizzazione, che rappresenta tutta l'organizzazione; quello personale, che rappresenta un utente; e quello del lavoratore, che rappresenta un dipendente in EOR. Il connettore lavora con quello di organizzazione, che è il valore predefinito di Metodo di Autorizzazione: Token dell’Organizzazione. Secondo il centro assistenza di Deel, un token personale scade se chi l'ha creato lascia l'azienda, mentre uno di organizzazione non dipende da nessuno e non scade, anche se non può firmare contratti. Per crearlo bisogna essere Org Admin o IT Developer Admin in Deel.
Passo per passo nel Developer Center di Deel
- Apri il Developer Center. La guida all'autenticazione di Deel ci arriva da More e poi Developer; la sua guida ai webhook, dall'icona del profilo, Settings e Developer Center; e il suo centro assistenza, da Apps & Integrations.
- Apri la scheda Access Tokens e premi Generate new token.
- Scegli il tipo Organization token.
- Spunta i permessi della tabella qui sotto e decidi a quali dati sensibili potrà arrivare il token.
- Premi Generate e copia subito il token: Deel avvisa che dopo non si può più rivedere.
Deel dà chiavi diverse per il suo sandbox e per la produzione, e chiede di non mescolarle. In Odoo il campo Ambiente della connessione offre Produzione e Sandbox (test), cioè un'organizzazione dimostrativa di Deel (demo.deel.com) senza denaro reale. Il token deve essere dell'ambiente che scegli.
Quali permessi spuntare
Deel chiama i suoi permessi risorsa:read e risorsa:write, e la sua documentazione di riferimento indica quello che chiede ogni chiamata. Queste sono, tra le altre, le chiamate del connettore e il permesso di ciascuna secondo la documentazione di Deel del 18-11-2026:
| A cosa serve | Chiamata | Permesso |
|---|---|---|
Prova connessione | GET /organizations | organizations:read |
| Entità legali | GET /legal-entities | organizations:read, accounting:read |
| Contratti e persone | GET /contracts, GET /people | contracts:read, people:read |
| Fatture, commissioni di Deel e i loro PDF | GET /invoices, GET /invoices/deel, GET /invoices/{id}/download | accounting:read |
| Pagamenti e il loro dettaglio | GET /payments, GET /payments/{payment_id}/breakdown | accounting:read |
| Cicli di paga e centri di costo | GET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centers | legal-entity:read |
| Report lordo-netto di ogni ciclo | GET /reports/payroll/cycles/{cycle_id}/gross-to-net | payslips:read |
| Creare e togliere il webhook | POST /webhooks, DELETE /webhooks/{id} | webhooks:write |
| Mandare a Deel i centri di costo | POST /legal-entities/{legal_entity_id}/cost-centers/synchronize | legal-entity:write |
Le ultime due righe scrivono in Deel. Il webhook viene creato solo se un amministratore preme Registra Webhook, e i centri di costo vanno a Deel solo se scegli che li gestisca Odoo; il valore predefinito è che vadano da Deel a Odoo. L'aiuto del campo del token chiede permessi di lettura. Con soli quelli, secondo la sua documentazione, Deel rifiuterà la creazione del webhook e, se scegli che Odoo gestisca i centri di costo, anche il loro invio. La guida all'autenticazione di Deel dà due risposte possibili per un token a cui manca un permesso: 403 o 401. Con un 403, la sincronizzazione ogni 30 minuti continua a leggere tutto il resto. Con un 401, il connettore lo tratta come un token rifiutato e, se Odoo gestisce i centri di costo, ogni passaggio si ferma lì, prima di contratti, fatture, pagamenti e paghe; in quel caso il token ha bisogno anche di legal-entity:write. Se Deel cambia il permesso di una chiamata, vale la sua documentazione.
Dove si incolla in Odoo
Nella connessione di Deel, un amministratore:
- spunta
Accetto che FlexigoTech Cloud conservi la credenziale Deel, perché fino ad allora il campo del token non si può compilare e non parte nulla; - lascia
Token dell’OrganizzazioneinMetodo di Autorizzazionee sceglie l'Ambiente; - incolla il token in
Token Organizzazione Deele salva.
Al salvataggio, il connettore manda il token a FlexigoTech Cloud, che deve essere in prova o in abbonamento, e annota la data in Credenziali salvate su. Il campo torna vuoto, ed è voluto: è di sola scrittura e Odoo non tiene il token. Solo un amministratore può salvarlo. Dopo, Prova connessione chiede a Deel l'organizzazione e le sue entità legali e risponde con il nome e quante sono.

Se cambi l'Ambiente o il Metodo di Autorizzazione di una connessione già salvata, la credenziale salvata non vale più: la connessione torna a Non connesso, bisogna incollare di nuovo il token e la vecchia voce viene cancellata da FlexigoTech Cloud.
Dove va il token
Secondo il modulo stesso, FlexigoTech Cloud conserva il token cifrato, una voce per connessione, e lo mette in ogni chiamata a Deel come intestazione Authorization: Bearer, che è come Deel chiede di usarlo. Le chiamate a Deel non partono direttamente dal tuo Odoo; l'unica cosa che va nel senso opposto sono gli avvisi dei webhook, che Deel manda al tuo Odoo e che sono spiegati in i webhook di Deel con Odoo. Disconnetti cancella il token da FlexigoTech Cloud e, se il servizio è attivo, il webhook da Deel, e non tocca nulla di quanto già sincronizzato.

Deel consiglia di tenere le credenziali in un archivio sicuro e mai nel codice, di cambiare i token ogni trimestre o quando qualcuno lascia il team, e di cancellare quelli che non servono. Con il connettore, cambiarlo significa creare il nuovo token in Deel, incollarlo nello stesso campo, salvare e cancellare il vecchio in Deel.
Autorizza con Deel, oggi
L'altra opzione di Metodo di Autorizzazione, Autorizza con Deel, collega senza copiare alcun token: un amministratore di Deel approva l'app di FlexigoTech. Finché FlexigoTech Cloud non ha quell'app per l'ambiente scelto, il connettore risponde «Autorizza con Deel non è ancora disponibile per questo ambiente Deel. Nel frattempo usa un token dell'organizzazione: non è stato inviato nulla a Deel.»
Limiti ed errori
Deel ammette 5 richieste al secondo per organizzazione, sommando tutti i suoi token, in una finestra mobile di 1 secondo, e il suo sandbox ha gli stessi limiti. Oltre risponde 429 e, secondo la sua documentazione, non manda intestazioni che avvisino prima. Se un altro programma legge la stessa organizzazione, divide quelle 5 con il connettore. La sincronizzazione lascia almeno 0,25 secondi tra una chiamata e la successiva; davanti a un 429 aspetta (un secondo, salvo che la risposta chieda un'altra attesa, e mai più di 5), riprova fino a 3 volte e, se continua, rimanda la chiamata al passaggio successivo.
| Risposta di Deel | Causa, secondo Deel | Cosa fa il connettore |
|---|---|---|
| 401 | Token non valido o scaduto, senza l'intestazione Authorization o senza i permessi necessari | Porta la connessione a Deel ha rifiutato il token e chiede di salvarne uno nuovo |
| 403 | Al token manca il permesso di quella chiamata | Non considera il token sbagliato: mostra il motivo che dà Deel |
| 429 | Più di 5 richieste al secondo nell'organizzazione | Aspetta e riprova |
Una nota nel codice del connettore aggiunge un altro 403, l'«Error 1010»: è il Cloudflare di Deel che blocca lo User-Agent di Python-urllib, e per questo il connettore manda sempre il suo. Per vedere perché Deel ha rifiutato una chiamata, i Request logs del Developer Center tengono 15 giorni di richieste fatte con i token dell'organizzazione, anche quelle rifiutate, con il motivo.
Cosa è stato provato
Il connettore funziona su Odoo 17, 18, 19 e 20, sul tuo server o su Odoo.sh, e non su Odoo Online. È stato provato da cima a fondo contro un'organizzazione dimostrativa di Deel (demo.deel.com), tramite FlexigoTech Cloud: la connessione, le entità legali, un contratto con la sua persona e il suo fornitore, i webhook e un secondo passaggio senza duplicati. Fatture, pagamenti e cicli di paga sono stati provati con risposte costruite sul riferimento dell'API di Deel, perché quell'organizzazione non ne aveva ancora. Quello che entra poi come fattura fornitore è nella guida a Deel invoice, e il confronto con le integrazioni di Deel, in Deel integrations. Il connettore è spiegato per intero nella sua pagina ed è pubblicato su Odoo Apps.
Continua a leggere
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- developer.deel.com/api/authentication
- help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API
- developer.deel.com/api/webhooks/no-code
- help.letsdeel.com/hc/en-gb/articles/10660690287761-How-To-Create-And-Manage-Webhooks-Notif
- developer.deel.com/api/sandbox
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_cost_center.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_payroll.py
- developer.deel.com/api/rate-limits
- developer.deel.com/api/endpoints/organizations/get-organizations
- developer.deel.com/api/endpoints/legal-entities/get-legal-entities
- developer.deel.com/api/endpoints/contracts/get-contracts
- developer.deel.com/api/hris-endpoints/people/get-people
- developer.deel.com/api/reference/endpoints/accounting/retrieve-deel-invoices-v-2026-01-01
- developer.deel.com/api/reference/endpoints/accounting/get-billing-invoice-download-link-v-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-payment-receipts-v-2027-01-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-a-payment-breakdown-v-2026-
- developer.deel.com/api/reference/endpoints/list-cycles/list-payroll-cycles-v-2026-01-01
- developer.deel.com/api/reference/endpoints/reports/gets-g-2-n-report-data-for-a-given-payr
- developer.deel.com/api/endpoints/cost-centers/get-legal-entity-cost-centers
- developer.deel.com/api/reference/endpoints/cost-centers/sync-cost-centers-for-legal-entity
- developer.deel.com/api/endpoints/webhooks/create-webhook
- developer.deel.com/api/endpoints/webhooks/delete-webhook
- developer.deel.com/api/reference/endpoints/accounting/retrieve-invoices-v-2026-01-01
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
