Saltar para o conteúdo principal
Deel

Deel contractor payments no Odoo: do pagamento à Deel ao pagamento de cada fatura de fornecedor

Uma empresa que paga aos seus prestadores através da Deel faz uma só transferência para a Deel que cobre várias faturas. O conector da Deel da FlexigoTech lê esse pagamento, reparte-o com a discriminação que a API da Deel fornece e regista no Odoo um pagamento por cada fatura de fornecedor, no diário de pagamentos da entidade legal e com a data em que a Deel foi paga. Eis as condições para que o faça, o que acontece se uma fatura chegar atrasada e o que não faz.

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
6 min

O que é um pagamento na Deel

Este guia olha para o pagamento a prestadores do lado da empresa que paga. No separador Pay de Finance, a Deel seleciona por omissão todas as faturas pendentes para as pagar de uma vez, e a empresa pode retirar as que ainda não quer pagar, exceto as que, segundo a Deel, podem ser obrigatórias em alguns casos, como as vencidas. Se pagar por transferência bancária, tem de incluir a referência Deel do pagamento. Enquanto o dinheiro não chega, o pagamento aparece em processamento, e quando a Deel confirma que o recebeu passa a Paid. Assim, um pagamento à Deel salda de uma vez as faturas de vários prestadores.

A API da Deel separa as duas coisas. GET /payments lista os pagamentos à Deel com o seu estado, que é paid ou processing, os totais, a moeda e o meio de pagamento, mas já não traz as faturas que cobre. Para isso existe GET /payments/{payment_id}/breakdown, que, segundo a Deel, dá cada fatura e a comissão da Deel como linhas separadas. Cada linha leva, entre outros campos, o identificador da fatura (invoice_id), o contrato e o seu tipo, o nome da pessoa, o montante com a sua moeda, o montante na moeda do pagamento e a conta do razão geral configurada na Deel (general_ledger_account).

Como o conector o reparte

O que a Deel enviaO que o conector faz no Odoo
Pagamentos de GET /paymentsLê-os desde a passagem anterior menos 7 dias; na primeira vez, desde Importar faturas emitidas de
Estado processingO pagamento espera em Aguardando Deel e o conector não pede a sua discriminação
Estado paidO pagamento passa a Para registar e o conector lê a sua discriminação, se a Deel o der como pago nos 7 dias seguintes à sua criação
invoice_id de cada linhaA fatura de fornecedor dessa fatura da Deel, que recebe o seu pagamento
paid_atData do pagamento no Odoo
deel_referenceComunicação do pagamento; se faltar, a etiqueta do pagamento
general_ledger_accountFica guardada em Conta do Grande Livro Deel, mas não decide para onde vai o pagamento

Cada fatura é paga com o assistente de registo de pagamentos do Odoo, no Diário de Pagamentos da sua entidade legal, por isso um pagamento à Deel que cobre várias faturas dá no Odoo um pagamento por fatura. O valor de cada pagamento é o que falta pagar da sua fatura de fornecedor, não o da linha da discriminação: se alguém alterou a fatura no Odoo, paga-se o que diz a fatura. Se uma fatura já aparecer como paga no Odoo, o conector não cria outro pagamento, e uma linha já paga não volta a ser paga nas passagens seguintes. Quando nenhuma fatura tem de esperar, o pagamento da Deel fica em Registado.

As condições, todas

Para que uma fatura receba o seu pagamento, têm de se cumprir ao mesmo tempo todas estas condições:

  • A ligação tem marcada a caixa Pagamentos para Deel, que vem marcada.
  • A Deel dá o pagamento como pago (paid) nos 7 dias seguintes à sua criação.
  • A fatura da Deel já tem a sua fatura de fornecedor no Odoo.
  • Essa fatura de fornecedor está lançada. Com Faturas de fornecedor em Rascunho, para revisão, o valor por omissão, alguém tem de a lançar; com Emitir quando tudo corresponder, é lançada automaticamente quando tudo corresponde.
  • A sua entidade legal tem Diário de Pagamentos, um diário de banco ou de caixa. Esse campo vem vazio em cada entidade nova, e sem ele as faturas ficam por pagar no Odoo.

Se faltar a uma fatura alguma das três últimas condições, o pagamento fica em Algumas faturas não estão prontas, com um aviso que o explica, e as faturas que as cumprem são pagas na mesma. A sincronização volta a olhar para ele a cada 30 minutos, e assim que a fatura é lançada e a entidade tem diário, o seu pagamento é registado. Se a ligação receber webhooks, os eventos payment.statement.initiated e payment.statement.mark-paid da Deel antecipam a parte dos pagamentos, e os dados voltam a ser lidos pela API.

Fatura de fornecedor em rascunho no Odoo, criada a partir de uma fatura da Deel, com o fornecedor, a referência da fatura da Deel e duas linhas com IVA
Fatura de fornecedor em rascunho de um prestador, criada a partir de uma fatura da Deel (empresa e prestador inventados, dados de demonstração).

Se o pagamento chegar antes da sua fatura

A discriminação pode nomear uma fatura da Deel que o Odoo ainda não tem: uma emitida antes da data a partir da qual importa, ou a de um trabalhador COR, que o conector não pede quando lista faturas. Nesse caso lê-a da Deel pelo seu identificador, com GET /invoices/{id}, e cria logo a sua fatura de fornecedor, com as mesmas regras das outras. Se essa fatura ficar em rascunho, que é o valor por omissão, o pagamento espera em Algumas faturas não estão prontas até alguém a lançar, e é registado na passagem seguinte.

Prestadores com fornecedor próprio

Na Deel o dinheiro vai para a Deel, mas no Odoo cada fatura está em nome de um fornecedor, e a entidade legal da Deel decide a empresa, o diário de compras e esse fornecedor. Um prestador é o seu próprio fornecedor: o conector procura-o pelo seu e-mail, mas só entre os contactos do Odoo que já são fornecedores e não têm utilizador; se não o encontrar, cria um novo. Enquanto a Deel não tiver essa pessoa, por exemplo porque não aceitou o convite, as suas faturas vão para o fornecedor da Deel. As de EOR e COR vão sempre para a Deel, para o Fornecedor Deel da entidade legal ou, se estiver vazio, para o da ligação. Como o pagamento é registado na fatura, salda a dívida com o mesmo fornecedor que a fatura tem.

Lista de contratos da Deel no Odoo com dois prestadores que têm o seu fornecedor, uma trabalhadora em EOR e um trabalhador do Global Payroll com o seu registo de funcionário
Os contratos da Deel no Odoo: os dois prestadores aparecem com o seu fornecedor (pessoas inventadas, dados de demonstração).

O que não faz

O conector não usa a conta do razão geral que vem na discriminação: guarda-a em Conta do Grande Livro Deel, e o pagamento vai para o diário de pagamentos da entidade. Também não lê as notas de crédito, que a API da Deel dá noutra chamada (GET /billing/invoices), nem volta a ler um pagamento que continue em processamento mais de 7 dias depois de ser criado, porque a Deel, segundo a referência da sua API, filtra a lista de pagamentos pela data de criação. Se a Deel o der como pago mais tarde, o pagamento fica em Aguardando Deel sem nenhum aviso e as suas faturas continuam por pagar no Odoo. Os webhooks lançam essa mesma leitura, por isso também não o recuperam, e hoje não há nenhum botão que o faça. Além disso, nenhum pagamento foi testado contra a API real da Deel. A organização de demonstração da Deel contra a qual o conector foi testado, através da FlexigoTech Cloud, não tinha pagamentos, por isso esta parte foi testada com respostas construídas sobre a referência da API da Deel, e ninguém viu ainda como chega numa discriminação real a linha da comissão da Deel. Contra essa organização foram testados a ligação, as entidades legais, um contrato com a sua pessoa e o seu fornecedor, os webhooks e uma segunda passagem sem duplicados.

O conector funciona no Odoo 17, 18, 19 e 20 num servidor próprio ou no Odoo.sh, não no Odoo Online. Como entra cada fatura está em Deel invoice no Odoo, os salários do Global Payroll em Deel gross to net e a comparação com o Bill Sync, a sincronização de faturas da Deel, nas suas integrações contabilísticas. O conector está explicado por inteiro na sua página e publicado na Odoo Apps.

Continue a ler

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 gross to net: do relatório bruto-líquido de cada ciclo a um lançamento de salários no OdooComo o relatório gross to net (G2N) de cada ciclo do Deel Global Payroll se converte num lançamento do Odoo que bate certo, conceito a conceito, com um exemplo.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