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
- 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.
- Obre la pestanya Access Tokens i prem Generate new token.
- Tria el tipus Organization token.
- Marca els permisos de la taula de sota i decideix a quines dades sensibles podrà arribar el token.
- 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è | Crida | Permís |
|---|---|---|
Provar connexió | GET /organizations | organizations:read |
| Entitats legals | GET /legal-entities | organizations:read, accounting:read |
| Contractes i persones | GET /contracts, GET /people | contracts:read, people:read |
| Factures, comissions de Deel i els seus PDF | GET /invoices, GET /invoices/deel, GET /invoices/{id}/download | accounting:read |
| Pagaments i el seu desglossament | GET /payments, GET /payments/{payment_id}/breakdown | accounting:read |
| Cicles de nòmina i centres de cost | GET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centers | legal-entity:read |
| Informe brut-net de cada cicle | GET /reports/payroll/cycles/{cycle_id}/gross-to-net | payslips:read |
| Donar d'alta i treure el webhook | POST /webhooks, DELETE /webhooks/{id} | webhooks:write |
| Enviar a Deel els centres de cost | POST /legal-entities/{legal_entity_id}/cost-centers/synchronize | legal-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óaMètode d'Autoritzaciói tria l'Entorn; - enganxa el token a
Token d'Organització de Deeli 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.

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.

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 Deel | Causa, segons Deel | Què fa el connector |
|---|---|---|
| 401 | Token no vàlid o caducat, sense la capçalera Authorization o sense els permisos necessaris | Passa la connexió a Deel va rebutjar el token i demana desar-ne un de nou |
| 403 | Al token li falta el permís d'aquella crida | No dona el token per dolent: avisa amb el motiu que dona Deel |
| 429 | Mé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
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- 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
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_cost_center.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Codi del mòdul: 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
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Codi del mòdul: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
