DCTFWeb no Odoo: como o eSocial + Reinf alimentam automaticamente

A DCTFWeb é, na prática, a primeira obrigação acessória federal que a empresa não digita. Ela é montada pela própria Receita Federal a partir de eventos do eSocial e da EFD-Reinf. Quando o contribuinte abre o portal e-CAC, a declaração já está lá, pronta para conferência, retificação e transmissão. Esse modelo muda bastante a rotina fiscal, mas só funciona se as fontes a montante estiverem fechando corretamente.

Este post explica o que é a DCTFWeb, como o eSocial S-1299 e a Reinf alimentam o sistema, e o que isso significa para empresas operando no Odoo com a stack OCA Brasil, mantida pela comunidade open-source com a KMEE entre as mantenedoras principais desde 2012.

O que é a DCTFWeb

A Declaração de Débitos e Créditos Tributários Federais Web (DCTFWeb) substituiu duas obrigações antigas:

• DCTF: declaração de tributos federais (IRPJ, CSLL, PIS, COFINS, IRRF, IOF e CPRB).
• GFIP: guia de FGTS e informações à Previdência Social, que existia desde 1999 (na parte do FGTS, deu lugar ao FGTS Digital).

A migração foi escalonada por grupos do eSocial. Hoje, a DCTFWeb é obrigatória para a totalidade das pessoas jurídicas, com as contribuições previdenciárias e retenções tributárias federais sendo apuradas a partir do eSocial e da Reinf.

A entrega gera uma DARF numerada por código de receita, com vencimento no dia 20 do mês subsequente.

O fluxo de alimentação automática

A DCTFWeb não recebe arquivo. Ela é construída pela Receita Federal a partir de duas fontes:

eSocial, evento S-1299 (fechamento da folha)

O fechamento mensal do eSocial (evento S-1299) consolida todos os eventos de remuneração (S-1200, S-1202, S-1207, S-1210) e periódicos (S-1260, S-1270, S-1280) do mês. Quando o S-1299 é aceito pelo ambiente nacional, os totalizadores S-5011 (contribuições sociais consolidadas), S-5012 (IRRF consolidado) e S-5013 (FGTS consolidado) retornam para o empregador. Os dois primeiros alimentam diretamente a DCTFWeb (o FGTS vai para o FGTS Digital) com:

• Contribuição patronal (parte empresa).
• Contribuição segurada (descontos).
• RAT/SAT, GILRAT, terceiros (Sistema S).
• Na desoneração, a contribuição patronal substituída total ou parcialmente, conforme o S-1280 (a CPRB em si vem do R-2060 da EFD-Reinf).

EFD-Reinf, eventos R-2010, R-2030, R-2040 e R-2099

A Reinf complementa o eSocial com retenções de pessoa jurídica para pessoa jurídica:

• R-2010: retenção de 11% INSS sobre cessão de mão de obra e serviços.
• R-2030/R-2040: retenções específicas (associações desportivas).
• R-2099: fechamento mensal da Reinf, análogo ao S-1299.

Quando o R-2099 é aceito, os totalizadores Reinf chegam à DCTFWeb e somam aos totais previdenciários do eSocial.

Como o Odoo participa

O Odoo, com a stack OCA Brasil, gera os XMLs e gerencia a transmissão dos eventos a montante:

• Folha de pagamento: l10n_br_hr_payroll (folha CLT brasileira) calcula os eventos S-1200 e seus complementos. Veja eSocial S-1200 no Odoo para detalhes do mapeamento de itens de remuneração.
• eSocial: l10n_br_hr_payroll_esocial (módulos OCA: https://github.com/OCA/l10n-brazil/tree/16.0/l10n_br_hr_payroll_esocial) gera os XMLs S-1200/S-1210/S-1299 e gerencia o ciclo de assinatura, envio e consulta.
• Reinf: l10n_br_reinf, mantido na OCA, cobre R-2010, R-2030, R-2040 e R-2099. A KMEE é uma das mantenedoras dessa frente.

A DCTFWeb em si não é gerada pelo Odoo: ela é montada na Receita. Mas o Odoo é responsável por garantir que as fontes (S-1299 e R-2099) cheguem corretas, no prazo e fechadas.

O que muda na rotina fiscal

Antes da DCTFWeb, o contador (ou o módulo fiscal do ERP) somava manualmente as folhas, gerava DCTF/GFIP, conferia os tributos, montava a guia. Hoje, esse trabalho é deslocado para antes: o fechamento de folha e Reinf precisa estar correto, porque é dele que a DCTFWeb nasce.

Em termos práticos:

• Erro em S-1200 vira erro em S-1299, que vira erro em S-5011/5012, que vira erro em DCTFWeb.
• Reinf não fechada trava o fechamento mensal completo: não dá para entregar DCTFWeb sem R-2099.
• Retificação tardia é comum: o S-1299 já foi aceito, a DCTFWeb foi transmitida, e descobre-se um item de remuneração errado. Toda a cadeia precisa ser refeita (S-1200 retificado -> S-1299 retificado -> DCTFWeb retificadora).

Cadastros críticos no Odoo

Para a cadeia funcionar:

• CNAE preponderante correto na empresa (define alíquota RAT/GILRAT e Sistema S).
• Lotação tributária dos empregados (o eSocial exige amarração entre hr.employee e lotacao).
• Códigos de receita federais nas rubricas e nos pagamentos a PJ: sem eles, a DCTFWeb não soma.
• Calendário fiscal: o vencimento do DARF de DCTFWeb é dia 20 (a CPRB vence na mesma data), mas algumas retenções de IRRF têm prazos próprios.

Conclusão

A DCTFWeb não é uma obrigação independente: é o resultado de eSocial + Reinf bem operados. Para empresas no Odoo, isso significa investir tempo onde o trabalho realmente acontece: na qualidade do cadastro de remuneração, na correta amarração entre fornecedores PJ e códigos de receita, e na disciplina do fechamento mensal.

O vocabulário fiscal por trás disso está no Glossário Fiscal Brasileiro e em Localização Fiscal Brasileira no Odoo. Para o roadmap das mudanças que vêm aí, leia Reforma Tributária Odoo 2026.