Saltar para o conteúdo principal
Deel

Deel invoice no Odoo: da fatura da Deel à fatura de fornecedor

Cada fatura que a Deel emite à empresa, seja de um prestador, de um trabalhador em EOR ou das próprias comissões da Deel, pode entrar no Odoo como fatura de fornecedor uma única vez, com o PDF, o IVA e os centros de custo do contrato. Eis o que faz com ela o conector da Deel da FlexigoTech e o que convém preparar antes.

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

A Deel invoice vista pela empresa que paga

Quem pesquisa «deel invoice» encontra sobretudo como um prestador cria a fatura na Deel. Este guia trata do outro lado: a empresa que recebe essas faturas e tem de as levar para a contabilidade. Na Deel, a empresa gere pagamentos e faturas no separador Billing, dentro de Finance, e daí descarrega-as uma a uma ou num zip com até 50 documentos. Sem conector, alguém volta a introduzir cada PDF no Odoo.

A API da Deel diz mais do que o PDF. A lista de faturas devolve por omissão apenas as pagas e as reembolsadas, por isso o conector pede-a com status=all e recebe também as pendentes. As faturas das comissões da Deel chegam por outra chamada, GET /invoices/deel, e o conector também as importa.

O conector foi testado de ponta a ponta, através da FlexigoTech Cloud, contra uma organização de demonstração da Deel (demo.deel.com): a ligação, as entidades legais, um contrato com a sua pessoa e o seu fornecedor, os webhooks e uma segunda passagem sem duplicados. Essa organização ainda não tinha faturas, pagamentos nem ciclos salariais, por isso essa parte foi testada com respostas construídas sobre a referência da API da Deel. Falta confirmar, com uma organização real, que a lista de faturas da Deel inclui também as dos trabalhadores em EOR.

O que a Deel enviaOnde fica no Odoo
As rubricas da fatura (line_items)Uma linha da fatura de fornecedor por rubrica, com a respetiva descrição
amount e deel_feeSe a fatura não tiver rubricas, uma linha com o montante e outra com a comissão da Deel
vat_percentageO imposto do Odoo associado a essa taxa em Taxas de IVA
Data de emissão e de vencimentoData da fatura e, sem condições de pagamento, o vencimento
Número da fatura na DeelReferência da fatura e do pagamento
PDFAnexo da fatura de fornecedor, até 20 MB

Como se transforma em fatura de fornecedor

Cada fatura da Deel fica guardada no Odoo com o identificador da Deel, e o conector nunca deixa a mesma fatura gerar duas faturas de fornecedor, mesmo que duas passagens coincidam ou duas ligações leiam a mesma organização da Deel. A entidade legal da Deel decide a empresa do Odoo, o diário de compras e o fornecedor, e um prestador com fornecedor próprio no Odoo vai para esse fornecedor. Com um total negativo, nasce uma nota de crédito de fornecedor.

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 criada a partir de uma fatura da Deel (empresa e prestador inventados, dados de demonstração).

As linhas saem das rubricas que a fatura tem na Deel e levam a distribuição analítica do contrato, pelo que os centros de custo chegam já preenchidos. Só a linha da comissão de uma fatura sem rubricas fica sem ela. A importação para com um aviso, sem criar a fatura, entre outros casos quando uma taxa de IVA da Deel não tem imposto do Odoo associado na ligação, quando a moeda não está ativa no Odoo ou quando a entidade legal da Deel não tem diário de compras.

Antes de a dar como pronta, o conector compara o total da fatura no Odoo com o da Deel. Se diferirem em mais de 0,01, coloca-a em Para rever com uma mensagem que indica os dois totais e pede para verificar os impostos antes de validar. O campo Faturas de fornecedor da ligação decide o resto: com Rascunho, para revisão, o valor por omissão, ficam todas em rascunho; com Emitir quando tudo corresponder, são lançadas automaticamente quando o total bate certo.

Os estados de uma fatura da Deel no Odoo

EstadoO que significa
Para importarLida da Deel, ainda sem fatura de fornecedor
Fatura criadaA fatura de fornecedor já existe no Odoo
Para reverO total não bate certo ou a Deel alterou-a depois, e decide uma pessoa

As faturas de total zero não geram fatura de fornecedor, nem as de prestadores ou de trabalhadores em EOR que a Deel marca como anuladas, falhadas ou impagáveis. Se faltar algo para a criar, como um imposto ou uma moeda, a fatura fica em erro com um aviso que diz o que falta.

Ficha de uma fatura da Deel no Odoo com o tipo, o contrato, a entidade legal, os montantes, o IVA e a ligação à fatura de fornecedor
A fatura da Deel dentro do Odoo, no estado Fatura criada e ligada à fatura de fornecedor em rascunho.

Se a Deel alterar ou anular a fatura depois

Se a Deel alterar o total de uma fatura, ou anular uma de um prestador ou de um trabalhador em EOR, quando já existe a fatura de fornecedor no Odoo, o conector não mexe nessa fatura de fornecedor, porque pode já estar lançada ou paga: passa a fatura da Deel para Para rever e abre um aviso com a alteração, para que alguém anule a fatura ou emita uma nota de crédito. Para dar por isso, a sincronização corre a cada 30 minutos e volta a ler o que foi emitido nos 7 dias anteriores à última passagem. As faturas mais antigas que já têm fatura de fornecedor e ainda não estão pagas são revistas uma a uma, até 100 por passagem.

Antes de o ativar

  • Odoo 17, 18, 19 ou 20 num servidor próprio ou no Odoo.sh. O módulo não funciona no Odoo Online.
  • Um token de organização da Deel com permissões de leitura, criado por um administrador da Deel no Developer Center. Cola-se na ligação e fica guardado, cifrado, na FlexigoTech Cloud, nunca no Odoo. A opção Autorizar com o Deel vai funcionar quando a Deel aprovar a app da FlexigoTech; até lá, o conector pede para usar o token.
  • Um imposto do Odoo para cada taxa de IVA das faturas, em Taxas de IVA.
  • O Diário de Pagamentos de cada entidade legal da Deel, que vem vazio. Sem ele, o conector não regista no Odoo os pagamentos à Deel; com ele, regista-os nas faturas de fornecedor já lançadas.
  • A data a partir da qual importar. Se não for alterada, entram as faturas emitidas nos 60 dias anteriores à criação da ligação.

Quando uma organização da Deel paga a partir de várias entidades, cada entidade legal vai para a sua empresa do Odoo, com os seus diários e o seu fornecedor. Se também usar Global Payroll, os salários entram como um lançamento por ciclo, e comparamos isso com o que a Deel oferece 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 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