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 envia | O que o conector faz no Odoo |
|---|---|
Pagamentos de GET /payments | Lê-os desde a passagem anterior menos 7 dias; na primeira vez, desde Importar faturas emitidas de |
Estado processing | O pagamento espera em Aguardando Deel e o conector não pede a sua discriminação |
Estado paid | O 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 linha | A fatura de fornecedor dessa fatura da Deel, que recebe o seu pagamento |
paid_at | Data do pagamento no Odoo |
deel_reference | Comunicação do pagamento; se faltar, a etiqueta do pagamento |
general_ledger_account | Fica 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 fornecedoremRascunho, para revisão, o valor por omissão, alguém tem de a lançar; comEmitir 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.

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.

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
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- help.letsdeel.com/hc/en-gb/articles/4407737772689-Making-Invoice-Payments-With-Deel
- 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-
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Código do módulo: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- help.letsdeel.com/hc/en-gb/articles/46057955155217-Accounting-Integrations-Overview
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
