Aller au contenu principal
Deel

Deel API token pour Odoo : le créer, lui donner ses droits et le coller

Deel propose trois sortes de token pour son API et le connecteur Odoo en utilise une : le token d'organisation, qu'un administrateur Deel crée dans le Developer Center de Deel. Voici les étapes, la permission que la référence de Deel demande pour chaque appel du connecteur, l'endroit où le coller dans Odoo et ce qu'il devient à l'enregistrement.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 18 novembre 2026

L'essentiel

Module
Deel
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
7 min

Le token Deel dont Odoo a besoin

Deel distingue trois tokens : celui d'organisation, qui représente toute l'organisation ; le token personnel, qui représente un utilisateur ; et celui de travailleur, qui représente un salarié en EOR. Le connecteur travaille avec le token d'organisation, coché par défaut dans Méthode d'Authentification : Token d'Organisation. Selon le centre d'aide de Deel, un token personnel expire si la personne qui l'a créé quitte l'entreprise, alors qu'un token d'organisation n'est lié à personne et n'expire pas, même s'il ne peut pas signer de contrats. Pour le créer, il faut être Org Admin ou IT Developer Admin dans Deel.

Étape par étape dans le Developer Center de Deel

  1. Ouvrez le Developer Center. Le guide d'authentification de Deel y entre par More puis Developer ; son guide des webhooks, par l'icône du profil, Settings et Developer Center ; et son centre d'aide, par Apps & Integrations.
  2. Ouvrez l'onglet Access Tokens et cliquez sur Generate new token.
  3. Choisissez le type Organization token.
  4. Cochez les permissions du tableau ci-dessous et décidez à quelles données sensibles le token aura accès.
  5. Cliquez sur Generate et copiez le token tout de suite : Deel prévient qu'on ne peut plus le revoir ensuite.

Deel fournit des clés distinctes pour son sandbox et pour la production, et demande de ne pas les mélanger. Dans Odoo, le champ Environnement de la connexion propose Production et Sandbox (tests), une organisation de démonstration Deel (demo.deel.com) sans argent réel. Le token doit appartenir à l'environnement que vous choisissez.

Quelles permissions cocher

Deel nomme ses permissions ressource:read et ressource:write, et sa référence indique celle que demande chaque appel. Voici, entre autres, les appels du connecteur et la permission de chacun selon la référence de Deel du 18-11-2026 :

Pour quoiAppelPermission
Tester la connexionGET /organizationsorganizations:read
Entités légalesGET /legal-entitiesorganizations:read, accounting:read
Contrats et personnesGET /contracts, GET /peoplecontracts:read, people:read
Factures, frais Deel et leurs PDFGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Paiements et leur détailGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Cycles de paie et centres de coûtGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Rapport brut-net de chaque cycleGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Créer et supprimer le webhookPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Envoyer les centres de coût à DeelPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-entity:write

Les deux dernières lignes écrivent dans Deel. Le webhook n'est créé que si un administrateur clique sur Enregistrer le webhook, et les centres de coût ne partent vers Deel que si vous choisissez qu'Odoo les pilote ; par défaut, ils vont de Deel vers Odoo. L'aide du champ du token demande des permissions de lecture. Avec celles-là seulement, selon sa référence, Deel refusera la création du webhook et, si Odoo pilote les centres de coût, leur envoi aussi. Le guide d'authentification de Deel donne deux réponses possibles pour un token auquel il manque une permission : 403 ou 401. Avec un 403, la synchronisation toutes les 30 minutes continue de lire tout le reste. Avec un 401, le connecteur le traite comme un token refusé et, si Odoo pilote les centres de coût, chaque passage s'arrête là, avant les contrats, les factures, les paiements et la paie ; dans ce cas, le token a aussi besoin de legal-entity:write. Si Deel change la permission d'un appel, c'est sa référence qui fait foi.

Où le coller dans Odoo

Dans la connexion Deel, un administrateur :

  • coche J'accepte que FlexigoTech Cloud conserve l'identifiant Deel, car jusque-là le champ du token reste verrouillé et rien n'est envoyé ;
  • laisse Token d'Organisation dans Méthode d'Authentification et choisit l'Environnement ;
  • colle le token dans Jeton d'organisation Deel et enregistre.

À l'enregistrement, le connecteur envoie le token à FlexigoTech Cloud, qui doit être en essai ou souscrit, et note la date dans Identifiant enregistré le. Le champ redevient vide, et c'est voulu : il est en écriture seule et Odoo ne garde pas le token. Seul un administrateur peut l'enregistrer. Ensuite, Tester la connexion demande à Deel l'organisation et ses entités légales et répond avec le nom et leur nombre.

Connexion Deel dans Odoo avec la méthode token d'organisation choisie, le consentement pour FlexigoTech Cloud accepté, le champ du token vide et la date d'enregistrement de l'identifiant
La connexion avec le token déjà enregistré : le champ est vide et la date indique quand il a été envoyé (organisation inventée, données de démonstration).

Si vous changez l'Environnement ou la Méthode d'Authentification d'une connexion enregistrée, l'identifiant enregistré ne vaut plus : la connexion repasse à Non connecté, il faut coller le token à nouveau et l'ancienne entrée est effacée de FlexigoTech Cloud.

Où va le token

Selon le module lui-même, FlexigoTech Cloud conserve le token chiffré, une entrée par connexion, et le place dans chaque appel à Deel comme en-tête Authorization: Bearer, comme Deel demande de l'utiliser. Les appels à Deel ne partent pas directement de votre Odoo ; seuls les avis des webhooks vont dans l'autre sens, de Deel vers votre Odoo, et ils sont expliqués dans les webhooks Deel avec Odoo. Déconnecter efface le token de FlexigoTech Cloud et, si le service est actif, le webhook chez Deel, sans toucher à ce qui est déjà synchronisé.

Paramètres de FlexigoTech Cloud dans Odoo avec la base connectée et la carte du connecteur Deel en essai, avec son prix et le texte qui dit qu'il maintient la connexion avec la plateforme via FlexigoTech Cloud
Le connecteur Deel dans les paramètres de FlexigoTech Cloud, en essai (données de démonstration).

Deel recommande de garder les identifiants dans un coffre sécurisé et jamais dans le code, de changer les tokens chaque trimestre ou quand quelqu'un quitte l'équipe, et de supprimer ceux qui ne servent plus. Avec le connecteur, changer de token revient à créer le nouveau dans Deel, le coller dans le même champ, enregistrer, puis supprimer l'ancien dans Deel.

Autoriser avec Deel, aujourd'hui

L'autre option de Méthode d'Authentification, Autoriser avec Deel, connecte sans copier de token : un administrateur Deel approuve l'application de FlexigoTech. Tant que FlexigoTech Cloud n'a pas cette application pour l'environnement choisi, le connecteur répond « Autoriser avec Deel n'est pas encore disponible pour cet environnement Deel. En attendant, utilisez un token d'organisation : rien n'a été envoyé à Deel. »

Les limites et les erreurs

Deel admet 5 requêtes par seconde et par organisation, tous ses tokens confondus, sur une fenêtre glissante de 1 seconde, et son sandbox a les mêmes limites. Au-delà, il répond 429 et, selon sa documentation, n'envoie pas d'en-têtes qui préviennent avant. Si un autre programme lit la même organisation, il partage ces 5 avec le connecteur. La synchronisation laisse au moins 0,25 seconde entre deux appels ; face à un 429, elle attend (une seconde, sauf si la réponse demande une autre attente, et jamais plus de 5), réessaie jusqu'à 3 fois et, si cela échoue encore, reporte l'appel au passage suivant.

Réponse de DeelCause, selon DeelCe que fait le connecteur
401Token invalide ou expiré, en-tête Authorization absent ou permissions manquantesPasse la connexion à Deel a refusé le token et demande d'en enregistrer un nouveau
403Le token n'a pas la permission de cet appelNe considère pas le token comme mauvais : il affiche le motif donné par Deel
429Plus de 5 requêtes par seconde dans l'organisationAttend et réessaie

Une note du code du connecteur ajoute un autre 403, l'« Error 1010 » : c'est le Cloudflare de Deel qui bloque le User-Agent de Python-urllib, d'où le connecteur envoie toujours le sien. Pour savoir pourquoi Deel a refusé un appel, les Request logs du Developer Center gardent 15 jours de requêtes faites avec les tokens de l'organisation, refusées comprises, avec le motif.

Ce qui a été testé

Le connecteur fonctionne sur Odoo 17, 18, 19 et 20, sur votre serveur ou sur Odoo.sh, et pas sur Odoo Online. Il a été testé de bout en bout contre une organisation de démonstration Deel (demo.deel.com), via FlexigoTech Cloud : la connexion, les entités légales, un contrat avec sa personne et son fournisseur, les webhooks et un second passage sans doublons. Factures, paiements et cycles de paie ont été testés avec des réponses construites d'après la référence de l'API Deel, car cette organisation n'en avait pas encore. Ce qui arrive ensuite en facture fournisseur se trouve dans le guide Deel invoice, et la comparaison avec les intégrations de Deel, dans Deel integrations. Le connecteur est expliqué en entier sur sa page et publié sur Odoo Apps.

À lire aussi

Deel webhooks avec Odoo : signature, événements, nouvelles tentatives et rôle du connecteurComment Deel signe chaque webhook, quels événements compte sa liste, quand il réessaie ou le désactive, et ce qu'en fait le connecteur Deel pour Odoo.Deel invoice dans Odoo : de la facture Deel à la facture fournisseurCe que contient une Deel invoice de prestataire, d'EOR ou de frais Deel, et comment elle arrive dans Odoo en facture fournisseur, avec sa TVA et son PDF.Deel integrations comptables : ce que font GL Sync et Bill Sync et comment l'obtenir dans OdooDeel relie ses données comptables à NetSuite, Xero, QuickBooks, Sage, SAP et Dynamics. Odoo n'y est pas : ce que couvre un connecteur, et ce qui manque.
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources