Saltar para o conteúdo principal
Deel

Deel API token para o Odoo: criá-lo, dar-lhe permissões e colá-lo

A Deel tem três tipos de token para a sua API e o conector do Odoo usa um: o token de organização, que um administrador da Deel cria no Developer Center da Deel. Aqui está o passo a passo, a permissão que a referência da Deel pede para cada chamada do conector, onde se cola no Odoo e o que acontece ao token quando guarda.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 18 de novembro de 2026

O essencial

Módulo
Deel
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
7 min

O token da Deel de que o Odoo precisa

A Deel distingue três tokens: o de organização, que representa toda a organização; o pessoal, que representa um utilizador; e o de trabalhador, que representa um trabalhador em EOR. O conector trabalha com o de organização, que vem marcado em Método de Autenticação: Token da Organização. Segundo o centro de ajuda da Deel, um token pessoal expira se quem o criou sair da empresa, e um de organização não depende de ninguém e não expira, embora não sirva para assinar contratos. Para o criar é preciso ser Org Admin ou IT Developer Admin na Deel.

Passo a passo no Developer Center da Deel

  1. Entre no Developer Center. O guia de autenticação da Deel chega lá por More e depois Developer; o guia de webhooks, pelo ícone do perfil, Settings e Developer Center; e o centro de ajuda, por Apps & Integrations.
  2. Abra o separador Access Tokens e carregue em Generate new token.
  3. Escolha o tipo Organization token.
  4. Marque as permissões da tabela abaixo e decida a que dados sensíveis o token poderá chegar.
  5. Carregue em Generate e copie o token nesse momento: a Deel avisa que depois não o volta a mostrar.

A Deel dá chaves diferentes para o seu sandbox e para produção, e pede que não se misturem. No Odoo, o campo Ambiente da ligação oferece Produção e Ambiente de Teste (sandbox), que é uma organização de demonstração da Deel (demo.deel.com) sem dinheiro real. O token tem de ser do ambiente que escolher.

Que permissões marcar

A Deel chama às suas permissões recurso:read e recurso:write, e a sua referência indica a que cada chamada pede. Estas são, entre outras, as chamadas que o conector faz e a permissão de cada uma segundo a referência da Deel de 18-11-2026:

Para quêChamadaPermissão
Testar conexãoGET /organizationsorganizations:read
Entidades legaisGET /legal-entitiesorganizations:read, accounting:read
Contratos e pessoasGET /contracts, GET /peoplecontracts:read, people:read
Faturas, comissões da Deel e os seus PDFGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Pagamentos e o seu detalheGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Ciclos salariais e centros de custoGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Relatório bruto-líquido de cada cicloGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Criar e remover o webhookPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Enviar à Deel os centros de custoPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-entity:write

As duas últimas linhas escrevem na Deel. O webhook só é criado se um administrador carregar em Registar webhook, e os centros de custo só vão para a Deel se escolher que é o Odoo a geri-los; por omissão, vão da Deel para o Odoo. A ajuda do campo do token pede permissões de leitura. Só com essas, segundo a sua referência, a Deel recusará a criação do webhook e, se escolher que o Odoo gere os centros de custo, também o seu envio. O guia de autenticação da Deel dá duas respostas possíveis para um token a que falta uma permissão: 403 ou 401. Com um 403, a sincronização a cada 30 minutos continua a ler todo o resto. Com um 401, o conector trata-o como um token recusado e, se o Odoo gerir os centros de custo, cada passagem para aí, antes dos contratos, das faturas, dos pagamentos e dos ciclos salariais; nesse caso, o token precisa também de legal-entity:write. Se a Deel mudar a permissão de alguma chamada, vale a sua referência.

Onde se cola no Odoo

Na ligação da Deel, um administrador:

  • marca Aceito que o FlexigoTech Cloud mantenha a credencial do Deel, porque até lá o campo do token não deixa escrever e nada é enviado;
  • deixa Token da Organização em Método de Autenticação e escolhe o Ambiente;
  • cola o token em Token de Organização Deel e guarda.

Ao guardar, o conector envia o token para a FlexigoTech Cloud, que tem de estar em teste ou subscrita, e regista a data em Credencial guardada em. O campo volta a aparecer vazio, e de propósito: é só de escrita e o Odoo não fica com o token. Só um administrador o pode guardar. Depois, Testar conexão pede à Deel a organização e as suas entidades legais e responde com o nome e quantas são.

Ligação da Deel no Odoo com o método token de organização escolhido, o consentimento para a FlexigoTech Cloud aceite, o campo do token vazio e a data em que a credencial foi guardada
A ligação com o token já guardado: o campo aparece vazio e a data diz quando foi enviado (organização inventada, dados de demonstração).

Se mudar o Ambiente ou o Método de Autenticação de uma ligação já guardada, a credencial guardada deixa de valer: a ligação volta a Não conectado, é preciso colar o token outra vez e a entrada antiga é apagada da FlexigoTech Cloud.

Para onde vai o token

Segundo o próprio módulo, a FlexigoTech Cloud guarda o token cifrado, uma entrada por ligação, e põe-no em cada chamada à Deel como cabeçalho Authorization: Bearer, que é como a Deel pede que se use. As chamadas à Deel não saem diretamente do seu Odoo; a única coisa que vai no sentido contrário são os avisos dos webhooks, que a Deel envia para o seu Odoo e que estão explicados em os webhooks da Deel com o Odoo. Desconectar apaga o token da FlexigoTech Cloud e, se o serviço estiver ativo, o webhook da Deel, e não toca em nada do que já foi sincronizado.

Definições da FlexigoTech Cloud no Odoo com a base de dados ligada e o cartão do conector da Deel em teste, com o seu preço e o texto que diz que mantém a ligação com a plataforma através da FlexigoTech Cloud
O conector da Deel nas definições da FlexigoTech Cloud, em teste (dados de demonstração).

A Deel recomenda guardar as credenciais num cofre seguro e nunca no código, trocar os tokens a cada trimestre ou quando alguém sai da equipa, e apagar os que não se usam. Com o conector, trocar é criar o token novo na Deel, colá-lo no mesmo campo, guardar e apagar o antigo na Deel.

Autorizar com o Deel, hoje

A outra opção de Método de Autenticação, Autorizar com o Deel, liga sem copiar nenhum token: um administrador da Deel aprova a app da FlexigoTech. Enquanto a FlexigoTech Cloud não tiver essa app para o ambiente escolhido, o conector responde «Autorizar com o Deel ainda não está disponível para este ambiente do Deel. Entretanto, use um token da organização: nada foi enviado ao Deel.»

Os limites e os erros

A Deel admite 5 pedidos por segundo por organização, somando todos os seus tokens, numa janela móvel de 1 segundo, e o seu sandbox tem os mesmos limites. Acima disso responde 429 e, segundo a sua documentação, não envia cabeçalhos que avisem antes. Se outro programa ler a mesma organização, partilha esses 5 com o conector. A sincronização deixa pelo menos 0,25 segundos entre uma chamada e a seguinte; perante um 429 espera (um segundo, salvo se a resposta pedir outra espera, e nunca mais de 5), repete até 3 vezes e, se continuar, deixa a chamada para a passagem seguinte.

Resposta da DeelCausa, segundo a DeelO que faz o conector
401Token inválido ou expirado, sem o cabeçalho Authorization ou sem as permissões necessáriasPassa a ligação para O Deel recusou o token e pede para guardar um novo
403Falta ao token a permissão dessa chamadaNão dá o token como mau: mostra o motivo que a Deel indica
429Mais de 5 pedidos por segundo na organizaçãoEspera e repete

Uma nota do código do conector acrescenta outro 403, o «Error 1010»: é o Cloudflare da Deel a bloquear o User-Agent do Python-urllib, e por isso o conector envia sempre o seu. Para ver porque a Deel recusou uma chamada, os Request logs do Developer Center guardam 15 dias de pedidos feitos com os tokens da organização, também os recusados, com o motivo.

O que foi testado

O conector funciona no Odoo 17, 18, 19 e 20, num servidor próprio ou no Odoo.sh, e não no Odoo Online. Foi testado de ponta a ponta contra uma organização de demonstração da Deel (demo.deel.com), através da FlexigoTech Cloud: a ligação, as entidades legais, um contrato com a sua pessoa e o seu fornecedor, os webhooks e uma segunda passagem sem duplicados. Faturas, pagamentos e ciclos salariais foram testados com respostas construídas sobre a referência da API da Deel, porque essa organização ainda não tinha. O que entra depois como fatura de fornecedor está no guia da Deel invoice, e a comparação com as integrações da Deel, em Deel integrations. O conector está explicado por inteiro na sua página e publicado na Odoo Apps.

Continue a ler

Deel webhooks com o Odoo: assinatura, eventos, novas tentativas e o que faz o conectorComo a Deel assina cada webhook, que eventos tem a sua lista, quando volta a tentar ou o desativa e o que faz com eles o conector da Deel para o Odoo.Deel invoice no Odoo: da fatura da Deel à fatura de fornecedorO que traz uma Deel invoice de prestadores, EOR ou comissões da Deel e como entra no Odoo como fatura de fornecedor, com IVA, PDF e centros de custo.Deel integrations contabilísticas: o que fazem o GL Sync e o Bill Sync e como tê-los no OdooA Deel liga os seus dados contabilísticos ao NetSuite, Xero, QuickBooks, Sage, SAP e Dynamics. O Odoo fica de fora: o que um conector cobre e o que não.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes