Saltar al contenido principal
Deel

Deel API token para Odoo: crearlo, darle permisos y pegarlo

Deel tiene tres clases de token para su API y el conector de Odoo usa una: el token de organización, que crea un administrador de Deel en su Developer Center. Aquí está el paso a paso, el permiso que pide la referencia de Deel para cada llamada del conector, dónde se pega en Odoo y qué pasa con él al guardarlo.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 18 de noviembre de 2026

Lo esencial

Módulo
Deel
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
7 min

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

  1. 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.
  2. Abre la pestaña Access Tokens y pulsa Generate new token.
  3. Elige el tipo Organization token.
  4. Marca los permisos de la tabla de abajo y decide a qué datos sensibles podrá llegar el token.
  5. 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éLlamadaPermiso
Probar conexiónGET /organizationsorganizations:read
Entidades legalesGET /legal-entitiesorganizations:read, accounting:read
Contratos y personasGET /contracts, GET /peoplecontracts:read, people:read
Facturas, comisiones de Deel y sus PDFGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Pagos y su desgloseGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Ciclos de nómina y centros de costeGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Informe bruto-neto de cada cicloGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Dar de alta y quitar el webhookPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Mandar a Deel los centros de costePOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-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ón en Método de Autenticación y elige el Entorno;
  • pega el token en Token de Organización de Deel y 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.

Conexión de Deel en Odoo con el método token de organización marcado, el consentimiento para FlexigoTech Cloud aceptado, el campo del token vacío y la fecha en que se guardó la credencial
La conexión con el token ya guardado: el campo sale vacío y la fecha dice cuándo se mandó (organización inventada, datos de demostración).

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.

Ajustes de FlexigoTech Cloud en Odoo con la base conectada y la tarjeta del conector de Deel en prueba, con el texto de las llamadas que manda a Deel
El conector de Deel en los ajustes de FlexigoTech Cloud, en prueba; el texto de su tarjeta dice qué manda a Deel y que el token se guarda cifrado (datos de demostración).

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 DeelCausa, según DeelQué hace el conector
401Token no válido o caducado, sin la cabecera Authorization o sin los permisos necesariosPasa la conexión a Deel rechazó el token y pide guardar uno nuevo
403Al token le falta el permiso de esa llamadaNo da el token por malo: avisa con el motivo que da Deel
429Más de 5 peticiones por segundo en la organizaciónEspera 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

Deel webhooks con Odoo: firma, eventos, reintentos y qué hace el conectorCómo firma Deel cada webhook, qué eventos hay en su lista, cuándo reintenta o lo desactiva y qué hace con ellos el conector de Deel para Odoo.Deel invoice en Odoo: de la factura de Deel a la factura de proveedorQué trae una Deel invoice de contratista, EOR o comisión y cómo entra en Odoo como factura de proveedor, con su IVA, su PDF y sus centros de coste.Deel integrations contables: qué hacen GL Sync y Bill Sync y cómo tenerlo en OdooDeel conecta su contabilidad con NetSuite, Xero, QuickBooks, Sage, SAP y Dynamics. Odoo no está en la lista: esto es lo que cubre un conector y lo que no.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes