O relatório gross to net da Deel
Segundo o centro de ajuda da Deel, o Deel Global Payroll gera um relatório bruto-líquido em cada ciclo, com o mesmo formato em todos os países, e cada relatório é de um só ciclo. Abre-se em Analytics, entre os relatórios salariais, e exporta-se em CSV, XLSX ou PDF. A Deel avisa também que o G2N mostra resultados salariais e não regras contabilísticas, por isso não traz lançamentos a débito e a crédito, nem lógica para atribuir contas, nem validação. Sem uma integração, alguém da contabilidade prepara à mão o lançamento de cada ciclo a partir desse ficheiro.
A API da Deel dá o mesmo relatório por ciclo com GET /reports/payroll/cycles/{cycle_id}/gross-to-net. Para cada contrato devolve a moeda (currency), a taxa de câmbio entre a moeda salarial e a do pagamento (conversion_rate) e a lista de conceitos, cada um com o seu nome (label), o seu montante (value), a sua categoria e um destes grupos (category_group):
| Grupo da Deel | O que reúne |
|---|---|
ADDITIONS | O que se acrescenta ao salário bruto, como o salário base |
DEDUCTIONS | O que se desconta à pessoa, como a sua retenção e a sua contribuição |
BENEFITS | Benefícios |
CONTRIBUTIONS | Contribuições do empregador |
INFOS | Informação |
TOTALS | Totais, como o líquido a pagar |
O conector lê todas as páginas do relatório e guarda cada conceito como uma linha do ciclo no Odoo. A Deel devolve 20 contratos por página se não lhe for pedido outro tamanho; o conector pede 50, e isso não foi testado com um relatório real.
Quando um ciclo está pronto
O conector pede os ciclos de cada entidade legal com GET /legal-entities/{legal_entity_id}/payroll-events, mas só os das entidades que têm Diário de Folha de Pagamento. Cada entidade nova fica com o primeiro diário geral da sua empresa como diário salarial; se lho tirar, essa entidade deixa de dar lançamentos de salários. Cada leitura começa na data de Importar ciclos de folha de pagamento de, que por omissão é 90 dias antes do dia em que cria a ligação: o conector não guarda até onde leu, por isso cada passagem volta a pedir os ciclos desde essa data.
A Deel marca cada ciclo com has_g2n_report, e a sua documentação diz que só é verdadeiro quando o ciclo está publicado e o relatório não tem erros que o bloqueiem. No Odoo é a caixa Pronto para gross-to-net, e é ela que passa o ciclo de Aguardando Deel para Para validar. Daí o ciclo recebe o seu lançamento (Entrada criada), para em Mapear conceitos se faltarem contas a algum conceito, ou fica em Erro com um aviso. A sincronização corre a cada 30 minutos; se a ligação receber webhooks, o evento gp.payslips.available da Deel antecipa a parte salarial, e os dados voltam sempre a ser lidos pela API.
Cada conceito nas suas contas
O mapa está no separador Contas de Folha de Pagamento da ligação, e cada linha diz o que fazer com um conceito: Emitir, o valor por omissão, ou Ignorar. Uma linha que se lança tem uma Conta de débito e uma Conta de crédito, e o montante do conceito vai por inteiro para as duas, por isso cada lançamento bate certo por construção. Uma linha sem conceito vale para todo o seu grupo, e uma sem entidade legal, para todas as entidades da ligação. Se várias linhas encaixarem numa linha do relatório, ganha a mais concreta: a dessa entidade e desse conceito, depois a dessa entidade e do seu grupo, depois a de qualquer entidade com esse conceito e por fim a de qualquer entidade com esse grupo.
Quando chega um conceito sem linha pronta, o ciclo fica em Mapear conceitos: o conector cria a linha que falta e abre uma ocorrência que pede uma conta a débito e outra a crédito, ou que se ignore o conceito. O mesmo acontece com um grupo que o conector não conhece, que guarda como INFOS e que também precisa da sua linha, de modo que nenhum montante fica de fora sem que alguém o tenha visto. A caixa Centros de Custo de cada linha vem marcada, e com ela a linha a débito leva os centros de custo do contrato da Deel dessa pessoa.

Moeda, data e detalhe por pessoa
Cada conceito entra na moeda que o relatório dá ao seu contrato, ou na da empresa se o relatório não a indicar. Se essa moeda não estiver ativa no Odoo, o ciclo para com um aviso que pede para a ativar e tentar de novo. O montante na moeda da sua empresa sai das taxas de câmbio do Odoo na data do lançamento: o conversion_rate da Deel fica guardado na linha do ciclo, mas o lançamento não o usa.
O lançamento vai para o diário salarial da entidade legal, com a data de fim do ciclo e uma referência que leva o nome do ciclo. Dentro dele, os montantes do mesmo conceito que partilham contas, centros de custo e moeda somam-se, por isso sai um par de linhas por conceito e não por pessoa. O detalhe de cada pessoa fica nas linhas do ciclo, que só os administradores de contabilidade do Odoo veem. Mas se a entidade tiver uma só pessoa, ou se cada pessoa tiver o seu próprio centro de custo, o lançamento mostra o salário dessa pessoa a quem puder ver os lançamentos. Cada ciclo dá um só lançamento, mesmo que coincidam duas passagens, e o campo Registos de Folha de Pagamento decide se fica em Rascunho, para revisão, o valor por omissão, ou sai Emitido.
Um ciclo de exemplo, acertado à mão

O ciclo da captura é um ciclo REGULAR de uma empresa inventada, a Lumbre Analytics, S.L., de 30 de setembro a 30 de outubro de 2026, com um contrato do Global Payroll em euros. O seu mapa usa contas do PGC, o plano de contas desta S.L.: 640 para salários, 642 para a segurança social a cargo da empresa, 4751 para retenções, 476 para a segurança social e 465 para o líquido por pagar. Com estes dados de demonstração, o código do conector daria este lançamento, calculado à mão:
| Conceito | Grupo da Deel | Débito (conta) | Crédito (conta) |
|---|---|---|---|
Salario base | ADDITIONS | 3900 (640) | 3900 (465) |
IRPF | DEDUCTIONS | 702 (465) | 702 (4751) |
Seguridad Social trabajador | DEDUCTIONS | 253,5 (465) | 253,5 (476) |
Seguridad Social empresa | CONTRIBUTIONS | 1236,3 (642) | 1236,3 (476) |
Neto a pagar | TOTALS | Com Ignorar, não entra | |
| Soma | 6091,8 | 6091,8 |
Cada conceito é lançado duas vezes, uma a débito e outra a crédito, e por isso as duas colunas somam o mesmo. A conta 465 recebe 3900 a crédito e 702 e 253,5 a débito, e fica com 2944,5 a crédito, que é o Neto a pagar do relatório. Por isso, neste exemplo, a linha de TOTALS está em Ignorar: o líquido já sai das outras linhas. A 476 acumula 1489,8 de segurança social, a 4751 os 702 de retenções, e o custo do ciclo para a empresa fica em 640 e 642, com 5136,3 entre as duas.
O que não cobre
Os salários de PEO não têm tratamento próprio: o conector trata os contratos PEO como EOR, enquanto o GL Sync, a integração contabilística da Deel, leva o PEO ao razão geral. Além disso, nada disto 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, ainda não tinha ciclos salariais, por isso os ciclos foram testados com respostas construídas sobre a referência da sua API. 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.
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. Segundo a documentação da Deel, o relatório bruto-líquido pede
payslips:reade a lista de ciclos,legal-entity:read. Segundo o próprio módulo, o token fica guardado, cifrado, na FlexigoTech Cloud, nunca no Odoo. - O
Diário de Folha de Pagamentode cada entidade legal que use o Global Payroll. - As linhas de
Contas de Folha de Pagamento. Na primeira vez, cada conceito novo trava o seu ciclo até que lhe dê contas ou o ignore. - A data de
Importar ciclos de folha de pagamento de, se quiser trazer ciclos com mais de 90 dias.
As faturas que a Deel emite seguem outro caminho e entram como faturas de fornecedor, como conta Deel invoice no Odoo, e os seus pagamentos registam-se como explica o guia dos pagamentos à Deel. O que o GL Sync faz com outros programas de contabilidade comparamos nas integrações contabilísticas da Deel. 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/12602682257809-Customizing-And-Downloading-Gross-To-Ne
- help.letsdeel.com/hc/en-gb/articles/45125127111825-Accounting-Integrations-Pricing-and-Set
- developer.deel.com/api/reference/endpoints/reports/gets-g-2-n-report-data-for-a-given-payr
- Código do módulo: flexigo_deel_connector 20.0 (18442307): models/deel_payroll.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_maps.py
- developer.deel.com/api/reference/endpoints/list-cycles/list-payroll-cycles-v-2026-01-01
- 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/account_move.py
- Cálculo da FlexigoTech com os valores citados
- 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
