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 tudo na 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 há mais de 14 anos.

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 contribuições previdenciárias patronais antes do eSocial).
• GFIP — guia de FGTS e informações à Previdência Social, que existia desde 1999.

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-1280, S-1295, S-1298, S-1299) do mês. Quando o S-1299 é aceito pelo ambiente nacional, os totalizadores S-5011 (CPRB), S-5012 (CP por estabelecimento) e S-5013 (FGTS) retornam para o empregador. Esses totalizadores alimentam diretamente a DCTFWeb com:

• Contribuição patronal (parte empresa).
• Contribuição segurada (descontos).
• RAT/SAT, GILRAT, terceiros (Sistema S).
• CPRB (desoneração) quando aplicável.

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, produção rural).
• 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 (em desenvolvimento ativo 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, mas alguns CPRBs e retenções 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.

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