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 envia | Onde 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_fee | Se a fatura não tiver rubricas, uma linha com o montante e outra com a comissão da Deel |
vat_percentage | O imposto do Odoo associado a essa taxa em Taxas de IVA |
| Data de emissão e de vencimento | Data da fatura e, sem condições de pagamento, o vencimento |
| Número da fatura na Deel | Referência da fatura e do pagamento |
| Anexo 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.

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
| Estado | O que significa |
|---|---|
Para importar | Lida da Deel, ainda sem fatura de fornecedor |
Fatura criada | A fatura de fornecedor já existe no Odoo |
Para rever | O 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.

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 Deelvai 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 Pagamentosde 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
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- help.letsdeel.com/hc/en-gb/articles/20301708484753-How-to-Download-Invoices-and-Manage-Pay
- developer.deel.com/api/reference/endpoints/accounting/retrieve-invoices-v-2026-01-01
- 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): data/deel_cron.xml
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- 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_legal_entity.py
