Salta al contingut principal
Deel

Deel API token per a Odoo: crear-lo, donar-li permisos i enganxar-lo

Deel té tres classes de token per a la seva API i el connector d'Odoo en fa servir una: el token d'organització, que crea un administrador de Deel al seu Developer Center. Aquí hi ha el pas a pas, el permís que demana la referència de Deel per a cada crida del connector, on s'enganxa a Odoo i què passa amb el token quan el deses.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 18 de novembre de 2026

L'essencial

Mòdul
Deel
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
7 min

El token de Deel que necessita Odoo

Deel distingeix tres tokens: el d'organització, que representa tota l'organització; el personal, que representa un usuari; i el de treballador, que representa un empleat d'EOR. El connector treballa amb el d'organització, que és el que ve marcat a Mètode d'Autorització: Token de l'Organització. Segons el centre d'ajuda de Deel, un token personal caduca si qui el va crear se'n va de l'empresa, i un d'organització no depèn de ningú i no caduca, tot i que no serveix per signar contractes. Per crear-lo cal ser Org Admin o IT Developer Admin a Deel.

Pas a pas al Developer Center de Deel

  1. Entra al Developer Center. La guia d'autenticació de Deel hi entra per More i després Developer; la seva guia de webhooks, per la icona del perfil, Settings i Developer Center; i el seu centre d'ajuda, per Apps & Integrations.
  2. Obre la pestanya Access Tokens i prem Generate new token.
  3. Tria el tipus Organization token.
  4. Marca els permisos de la taula de sota i decideix a quines dades sensibles podrà arribar el token.
  5. Prem Generate i copia el token en aquell moment: Deel avisa que després no es pot tornar a veure.

Deel dona claus diferents per al seu sandbox i per a producció, i demana no barrejar-les. A Odoo, el camp Entorn de la connexió ofereix Producció i Sandbox (proves), que és una organització de demostració de Deel (demo.deel.com) sense diners reals. El token ha de ser de l'entorn que triïs.

Quins permisos marcar

Deel anomena els seus permisos recurs:read i recurs:write, i la seva referència dona el que demana cada crida. Aquestes són, entre d'altres, les crides que fa el connector i el permís de cadascuna segons la referència de Deel del 18-11-2026:

Per a quèCridaPermís
Provar connexióGET /organizationsorganizations:read
Entitats legalsGET /legal-entitiesorganizations:read, accounting:read
Contractes i personesGET /contracts, GET /peoplecontracts:read, people:read
Factures, comissions de Deel i els seus PDFGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Pagaments i el seu desglossamentGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Cicles de nòmina i centres de costGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Informe brut-net de cada cicleGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Donar d'alta i treure el webhookPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Enviar a Deel els centres de costPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-entity:write

Les dues últimes files escriuen a Deel. El webhook només es dona d'alta si un administrador prem Registrar webhook, i els centres de cost només viatgen a Deel si tries que els porti Odoo; el que ve posat és que vagin de Deel a Odoo. L'ajuda del camp del token demana permisos de lectura. Només amb aquests, segons la seva referència, Deel rebutjarà l'alta del webhook i, si tries que Odoo porti els centres de cost, també el seu enviament. La guia d'autenticació de Deel dona dues respostes possibles per a un token al qual li falta un permís: 403 o 401. Amb un 403, la sincronització de cada 30 minuts continua llegint tota la resta. Amb un 401, el connector ho pren per un token rebutjat i, si Odoo porta els centres de cost, cada passada s'atura en aquest pas sense arribar a contractes, factures, pagaments ni nòmines; en aquest cas, el token necessita també legal-entity:write. Si Deel canvia el permís d'alguna crida, mana la seva referència.

On s'enganxa a Odoo

A la connexió de Deel, un administrador:

  • marca Accepto que FlexigoTech Cloud conservi la credencial de Deel, perquè fins aleshores el camp del token no deixa escriure i no s'envia res;
  • deixa Token de l'Organització a Mètode d'Autorització i tria l'Entorn;
  • enganxa el token a Token d'Organització de Deel i desa.

En desar, el connector envia el token a FlexigoTech Cloud, que ha d'estar en prova o subscrit, i anota la data a Credencial guardada el. El camp torna a sortir buit, i és a propòsit: és només d'escriptura i Odoo no es queda el token. Només un administrador el pot desar. Després, Provar connexió demana a Deel l'organització i les seves entitats legals i respon amb el nom i quantes n'hi ha.

Connexió de Deel a Odoo amb el mètode token d'organització marcat, el consentiment per a FlexigoTech Cloud acceptat, el camp del token buit i la data en què es va desar la credencial
La connexió amb el token ja desat: el camp surt buit i la data diu quan es va enviar (organització inventada, dades de demostració).

Si canvies l'Entorn o el Mètode d'Autorització d'una connexió ja desada, la credencial desada deixa de valer: la connexió torna a No connectat, cal enganxar el token una altra vegada i l'entrada vella s'esborra de FlexigoTech Cloud.

On va el token

Segons el mateix mòdul, FlexigoTech Cloud guarda el token xifrat, una entrada per connexió, i el posa a cada crida a Deel com a capçalera Authorization: Bearer, que és com Deel demana fer-lo servir. Les crides a Deel no surten directament del teu Odoo; l'única cosa que va en sentit contrari són els avisos dels webhooks, que Deel envia al teu Odoo i que s'expliquen a els webhooks de Deel amb Odoo. Desconnectar esborra el token de FlexigoTech Cloud i, si el servei està actiu, el webhook de Deel, i no toca res del que ja s'ha sincronitzat.

Configuració de FlexigoTech Cloud a Odoo amb la base connectada i la targeta del connector de Deel en prova, amb el seu preu i el text que diu que manté la connexió amb la plataforma a través de FlexigoTech Cloud
El connector de Deel a la configuració de FlexigoTech Cloud, en prova (dades de demostració).

Deel recomana guardar les credencials en un magatzem segur i mai al codi, canviar els tokens cada trimestre o quan algú deixa l'equip, i esborrar els que no es fan servir. Amb el connector, el canvi és crear el token nou a Deel, enganxar-lo al mateix camp, desar, i esborrar el vell a Deel.

Autoritzar amb Deel, avui

L'altra opció de Mètode d'Autorització, Autoritzar amb Deel, connecta sense copiar cap token: un administrador de Deel aprova l'app de FlexigoTech. Mentre FlexigoTech Cloud no tingui aquesta app per a l'entorn triat, el connector respon «Autoritzar amb Deel encara no està disponible per a aquest entorn de Deel. Mentrestant, feu servir un token d'organització: no s'ha enviat res a Deel.»

Els límits i els errors

Deel admet 5 peticions per segon per organització, sumant tots els seus tokens, en una finestra mòbil d'1 segon, i el seu sandbox té els mateixos límits. Quan se supera respon 429 i, segons la seva documentació, no envia capçaleres que avisin abans. Si un altre programa llegeix la mateixa organització, comparteix amb el connector aquestes 5. La sincronització deixa com a mínim 0,25 segons entre una crida i la següent; davant d'un 429 espera (un segon, llevat que la resposta en demani una altra, i mai més de 5), repeteix fins a 3 vegades i, si continua, ho deixa per a la passada següent.

Resposta de DeelCausa, segons DeelQuè fa el connector
401Token no vàlid o caducat, sense la capçalera Authorization o sense els permisos necessarisPassa la connexió a Deel va rebutjar el token i demana desar-ne un de nou
403Al token li falta el permís d'aquella cridaNo dona el token per dolent: avisa amb el motiu que dona Deel
429Més de 5 peticions per segon a l'organitzacióEspera i repeteix

Una nota del codi del connector afegeix un altre 403, l'«Error 1010»: és el Cloudflare de Deel aturant el User-Agent de Python-urllib, i per això el connector envia sempre el seu. Per veure per què Deel va rebutjar una crida, els Request logs del Developer Center guarden 15 dies de peticions fetes amb els tokens de l'organització, també les rebutjades, amb el motiu.

El que s'ha provat

El connector funciona a Odoo 17, 18, 19 i 20, al teu servidor o a Odoo.sh, i no a Odoo Online. Es va provar de punta a punta contra una organització de demostració de Deel (demo.deel.com), a través de FlexigoTech Cloud: la connexió, les entitats legals, un contracte amb la seva persona i el seu proveïdor, els webhooks i una segona passada sense duplicats. Factures, pagaments i cicles de nòmina es van provar amb respostes fetes sobre la referència de l'API de Deel, perquè aquella organització encara no en tenia. El que entra després com a factura de proveïdor és a la guia de Deel invoice, i la comparació amb les integracions de Deel, a Deel integrations. El connector està explicat sencer a la seva pàgina i publicat a Odoo Apps.

Continua llegint

Deel webhooks amb Odoo: signatura, esdeveniments, reintents i què fa el connectorCom signa Deel cada webhook, quins esdeveniments hi ha a la seva llista, quan reintenta o el desactiva i què en fa el connector de Deel per a Odoo.Deel invoice a Odoo: de la factura de Deel a la factura de proveïdorQuè porta una Deel invoice de contractista, EOR o comissió i com entra a Odoo com a factura de proveïdor, amb el seu IVA, el PDF i els centres de cost.Deel integrations comptables: què fan GL Sync i Bill Sync i com tenir-ho a OdooDeel connecta la seva comptabilitat amb NetSuite, Xero, QuickBooks, Sage, SAP i Dynamics. Odoo no hi és: això és el que cobreix un connector i el que no.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts