Vai al contenuto principale
Deel

Deel API token per Odoo: crearlo, dargli i permessi e incollarlo

Deel ha tre tipi di token per la sua API e il connettore di Odoo ne usa uno: il token di organizzazione, che un amministratore di Deel crea nel Developer Center di Deel. Qui trovi i passaggi, il permesso che la documentazione di riferimento di Deel chiede per ogni chiamata del connettore, dove si incolla in Odoo e cosa succede al token quando salvi.

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

In breve

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

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

  1. 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.
  2. Apri la scheda Access Tokens e premi Generate new token.
  3. Scegli il tipo Organization token.
  4. Spunta i permessi della tabella qui sotto e decidi a quali dati sensibili potrà arrivare il token.
  5. 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 serveChiamataPermesso
Prova connessioneGET /organizationsorganizations:read
Entità legaliGET /legal-entitiesorganizations:read, accounting:read
Contratti e personeGET /contracts, GET /peoplecontracts:read, people:read
Fatture, commissioni di Deel e i loro PDFGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Pagamenti e il loro dettaglioGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Cicli di paga e centri di costoGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Report lordo-netto di ogni cicloGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Creare e togliere il webhookPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Mandare a Deel i centri di costoPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-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’Organizzazione in Metodo di Autorizzazione e sceglie l'Ambiente;
  • incolla il token in Token Organizzazione Deel e 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.

Connessione Deel in Odoo con il metodo token di organizzazione scelto, il consenso per FlexigoTech Cloud accettato, il campo del token vuoto e la data in cui è stata salvata la credenziale
La connessione con il token già salvato: il campo è vuoto e la data dice quando è stato inviato (organizzazione inventata, dati dimostrativi).

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.

Impostazioni di FlexigoTech Cloud in Odoo con il database connesso e la scheda del connettore Deel in prova, con il suo prezzo e il testo che dice che mantiene attiva la connessione con la piattaforma tramite FlexigoTech Cloud
Il connettore Deel nelle impostazioni di FlexigoTech Cloud, in prova (dati dimostrativi).

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 DeelCausa, secondo DeelCosa fa il connettore
401Token non valido o scaduto, senza l'intestazione Authorization o senza i permessi necessariPorta la connessione a Deel ha rifiutato il token e chiede di salvarne uno nuovo
403Al token manca il permesso di quella chiamataNon considera il token sbagliato: mostra il motivo che dà Deel
429Più di 5 richieste al secondo nell'organizzazioneAspetta 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

Deel webhooks con Odoo: firma, eventi, nuovi tentativi e cosa fa il connettoreCome Deel firma ogni webhook, quali eventi ha la sua lista, quando riprova o lo disattiva e cosa ne fa il connettore Deel per Odoo di FlexigoTech.Deel invoice in Odoo: dalla fattura di Deel alla fattura fornitoreCosa contiene una Deel invoice di collaboratori, EOR o commissioni Deel e come arriva in Odoo come fattura fornitore, con IVA, PDF e centri di costo.Deel integrations contabili: cosa fanno GL Sync e Bill Sync e come averle in OdooDeel collega i suoi dati contabili a NetSuite, Xero, QuickBooks, Sage, SAP e Dynamics. Odoo non è nella lista: cosa copre un connettore e cosa no.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti