Saltar para o conteúdo principal
Deel

Deel gross to net: do relatório bruto-líquido de cada ciclo a um lançamento de salários no Odoo

O Deel Global Payroll gera em cada ciclo um relatório bruto-líquido (gross to net, G2N) com os conceitos de cada contrato repartidos por grupos como os acréscimos ao bruto, as deduções, as contribuições do empregador e os totais. O conector da Deel da FlexigoTech lê esse relatório pela API e monta com ele um lançamento por ciclo no Odoo, em que cada conceito vai para as contas que lhe atribuir. Eis como o faz, o que não cobre e um ciclo de exemplo calculado à mão.

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

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 DeelO que reúne
ADDITIONSO que se acrescenta ao salário bruto, como o salário base
DEDUCTIONSO que se desconta à pessoa, como a sua retenção e a sua contribuição
BENEFITSBenefícios
CONTRIBUTIONSContribuições do empregador
INFOSInformação
TOTALSTotais, 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.

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

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

Ciclo salarial da Deel no Odoo no estado Entrada criada, com a caixa Pronto para gross-to-net marcada e cinco conceitos com o seu grupo, o seu montante em EUR e a sua linha do mapa
Um ciclo do Global Payroll no Odoo com o seu lançamento em rascunho e os seus cinco conceitos (empresa e contrato inventados, dados de demonstraçã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:

ConceitoGrupo da DeelDébito (conta)Crédito (conta)
Salario baseADDITIONS3900 (640)3900 (465)
IRPFDEDUCTIONS702 (465)702 (4751)
Seguridad Social trabajadorDEDUCTIONS253,5 (465)253,5 (476)
Seguridad Social empresaCONTRIBUTIONS1236,3 (642)1236,3 (476)
Neto a pagarTOTALSCom Ignorar, não entra
Soma6091,86091,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:read e 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 Pagamento de 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

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.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 contractor payments no Odoo: do pagamento à Deel ao pagamento de cada fatura de fornecedorComo um pagamento à Deel que cobre várias faturas se torna no Odoo um pagamento por fatura de fornecedor, e que condições cada fatura tem de cumprir.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes