El token de Deel que necesita Odoo
Deel distingue tres tokens: el de organización, que representa a toda la organización; el personal, que representa a un usuario; y el de trabajador, que representa a un empleado de EOR. El conector trabaja con el de organización, que es lo que viene marcado en Método de Autenticación: Token de Organización. Según el centro de ayuda de Deel, un token personal caduca si quien lo creó se va de la empresa, y uno de organización no depende de nadie y no caduca, aunque no sirve para firmar contratos. Para crearlo hay que ser Org Admin o IT Developer Admin en Deel.
Paso a paso en el Developer Center de Deel
- Entra en el Developer Center. La guía de autenticación de Deel entra por More y luego Developer; su guía de webhooks, desde el icono del perfil, Settings y Developer Center; y su centro de ayuda, desde Apps & Integrations.
- Abre la pestaña Access Tokens y pulsa Generate new token.
- Elige el tipo Organization token.
- Marca los permisos de la tabla de abajo y decide a qué datos sensibles podrá llegar el token.
- Pulsa Generate y copia el token en ese momento: Deel avisa de que después no se puede volver a ver.
Deel da claves distintas para su sandbox y para producción, y pide no mezclarlas. En Odoo, el campo Entorno de la conexión ofrece Producción y Sandbox (pruebas), que es una organización de demostración de Deel (demo.deel.com) sin dinero real. El token tiene que ser del entorno que elijas.
Qué permisos marcar
Deel llama a sus permisos recurso:read y recurso:write, y su referencia da el que pide cada llamada. Estas son, entre otras, las llamadas que hace el conector y el permiso de cada una según la referencia de Deel del 18-11-2026:
| Para qué | Llamada | Permiso |
|---|---|---|
Probar conexión | GET /organizations | organizations:read |
| Entidades legales | GET /legal-entities | organizations:read, accounting:read |
| Contratos y personas | GET /contracts, GET /people | contracts:read, people:read |
| Facturas, comisiones de Deel y sus PDF | GET /invoices, GET /invoices/deel, GET /invoices/{id}/download | accounting:read |
| Pagos y su desglose | GET /payments, GET /payments/{payment_id}/breakdown | accounting:read |
| Ciclos de nómina y centros de coste | GET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centers | legal-entity:read |
| Informe bruto-neto de cada ciclo | GET /reports/payroll/cycles/{cycle_id}/gross-to-net | payslips:read |
| Dar de alta y quitar el webhook | POST /webhooks, DELETE /webhooks/{id} | webhooks:write |
| Mandar a Deel los centros de coste | POST /legal-entities/{legal_entity_id}/cost-centers/synchronize | legal-entity:write |
Las dos últimas filas escriben en Deel. El webhook solo se da de alta si un administrador pulsa Registrar webhook, y los centros de coste solo viajan a Deel si eliges que los lleve Odoo; lo que viene puesto es que vayan de Deel a Odoo. La ayuda del campo del token pide permisos de lectura. Con solo esos, según su referencia, Deel rechazará el alta del webhook y, si eliges que Odoo lleve los centros de coste, también su envío. La guía de autenticación de Deel da dos respuestas posibles para un token al que le falta un permiso: 403 o 401. Con un 403, la sincronización de cada 30 minutos sigue leyendo todo lo demás. Con un 401, el conector lo toma por un token rechazado y, si Odoo lleva los centros de coste, cada pasada se para en ellos sin llegar a contratos, facturas, pagos ni nóminas; en ese caso, el token necesita también legal-entity:write. Si Deel cambia el permiso de alguna llamada, manda su referencia.
Dónde se pega en Odoo
En la conexión de Deel, un administrador:
- marca
Acepto que FlexigoTech Cloud conserve la credencial de Deel, porque hasta entonces el campo del token no deja escribir y no se envía nada; - deja
Token de OrganizaciónenMétodo de Autenticacióny elige elEntorno; - pega el token en
Token de Organización de Deely guarda.
Al guardar, el conector manda el token a FlexigoTech Cloud, que tiene que estar en prueba o suscrito, y anota la fecha en Credencial guardada en. El campo vuelve a salir vacío, y es a propósito: es de solo escritura y Odoo no se queda el token. Solo un administrador puede guardarlo. Después, Probar conexión pide a Deel la organización y sus entidades legales y contesta con el nombre y cuántas hay.

Si cambias el Entorno o el Método de Autenticación de una conexión ya guardada, la credencial guardada deja de valer: la conexión vuelve a No conectado, hay que pegar el token otra vez y la entrada vieja se borra de FlexigoTech Cloud.
Adónde va el token
Según el propio módulo, FlexigoTech Cloud guarda el token cifrado, una entrada por conexión, y lo pone en cada llamada a Deel como cabecera Authorization: Bearer, que es como Deel pide usarlo. Las llamadas a Deel no salen directamente de tu Odoo; lo único que va en sentido contrario son los avisos de los webhooks, que Deel manda a tu Odoo y que están explicados en los webhooks de Deel con Odoo. Desconectar borra el token de FlexigoTech Cloud y, si el servicio está activo, el webhook de Deel, y no toca nada de lo ya sincronizado.

Deel recomienda guardar las credenciales en un almacén seguro y nunca en el código, cambiar los tokens cada trimestre o cuando alguien deja el equipo, y borrar los que no se usan. Con el conector, el cambio es crear el token nuevo en Deel, pegarlo en el mismo campo, guardar, y borrar el viejo en Deel.
Autorizar con Deel, hoy
La otra opción de Método de Autenticación, Autorizar con Deel, conecta sin copiar ningún token: un administrador de Deel aprueba la app de FlexigoTech. Mientras FlexigoTech Cloud no tenga esa app para el entorno elegido, el conector responde «Autorizar con Deel aún no está disponible para este entorno de Deel. Mientras tanto, use un token de organización: no se ha enviado nada a Deel.»
Los límites y los errores
Deel admite 5 peticiones por segundo por organización, sumando todos sus tokens, en una ventana móvil de 1 segundo, y su sandbox tiene los mismos límites. Al pasarse responde 429 y, según su documentación, no manda cabeceras que avisen antes. Si otro programa lee la misma organización, comparte con el conector esos 5. La sincronización deja al menos 0,25 segundos entre una llamada y la siguiente; ante un 429 espera (un segundo, salvo que la respuesta pida otra espera, y nunca más de 5), repite hasta 3 veces y, si sigue, lo deja para la pasada siguiente.
| Respuesta de Deel | Causa, según Deel | Qué hace el conector |
|---|---|---|
| 401 | Token no válido o caducado, sin la cabecera Authorization o sin los permisos necesarios | Pasa la conexión a Deel rechazó el token y pide guardar uno nuevo |
| 403 | Al token le falta el permiso de esa llamada | No da el token por malo: avisa con el motivo que da Deel |
| 429 | Más de 5 peticiones por segundo en la organización | Espera y repite |
Una nota del código del conector añade otro 403, el «Error 1010»: es el Cloudflare de Deel parando el User-Agent de Python-urllib, y por eso el conector manda siempre el suyo. Para ver por qué Deel rechazó una llamada, los Request logs del Developer Center guardan 15 días de peticiones hechas con los tokens de la organización, también las rechazadas, con el motivo.
Lo probado
El conector funciona en Odoo 17, 18, 19 y 20, en tu servidor o en Odoo.sh, y no en Odoo Online. Se probó de punta a punta contra una organización de demostración de Deel (demo.deel.com), a través de FlexigoTech Cloud: la conexión, las entidades legales, un contrato con su persona y su proveedor, los webhooks y una segunda pasada sin duplicados. Facturas, pagos y ciclos de nómina se probaron con respuestas hechas sobre la referencia de la API de Deel, porque esa organización aún no tenía. Lo que entra después como factura de proveedor está en la guía de Deel invoice, y la comparación con las integraciones de Deel, en Deel integrations. El conector está explicado entero en su página y publicado en Odoo Apps.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- 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
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_cost_center.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Código del módulo: 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
- Código del módulo: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Código del módulo: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Código del módulo: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
