O que muda com a calculadora de tributos da Receita em código aberto?
A Receita Federal autorizou a publicação no GitHub do código-fonte de três ferramentas ligadas à Reforma Tributária: calculadoras para o regime regular e para o Simples Nacional, além de um gerador de DANFSe. A medida foi formalizada pela Portaria Cotec nº 342/2026, conforme comunicado oficial de 16 de novembro de 2026.
Para empresas, contabilidades e fornecedores de sistemas, o código pode servir como referência técnica para estudar regras, comparar resultados e planejar integrações de faturamento e gestão. Mas há uma distinção essencial: abrir o código não altera a legislação, não valida automaticamente os dados da empresa e não garante que qualquer resultado gerado esteja correto para uma operação concreta. O cálculo depende das regras vigentes, da versão utilizada e, sobretudo, da classificação e das informações inseridas.
O que foi disponibilizado — e o que ainda precisa ser confirmado?
A Receita informa que os repositórios incluem a calculadora para o regime regular, a calculadora do Simples Nacional e o gerador de DANFSe. O projeto do regime regular descreve uma API que calcula CBS, IBS e Imposto Seletivo, consulta tabelas utilizadas no cálculo e auxilia na geração e validação de grupos tributários de documentos fiscais eletrônicos.
A notícia oficial também esclarece que o código já podia ser baixado pela Plataforma CBS desde 2025; a mudança de novembro foi sua publicação em repositórios públicos de desenvolvimento, com licença MIT e identificação das versões iniciais. Isso facilita o acesso ao material e o acompanhamento das versões, mas não significa que a empresa deva substituir de imediato seu ERP ou seu sistema fiscal.
O próprio repositório do regime regular indica requisitos técnicos para execução local, como Java 21 ou superior e preparação de uma base de dados. Portanto, para muitos micro e pequenos negócios, o caminho prático será pedir ao fornecedor do sistema e à contabilidade que avaliem a ferramenta e informem se a integração cabe no contrato, no calendário e na estrutura da empresa.
Como uma empresa pode usar a ferramenta sem tratar a simulação como decisão final?
O uso mais prudente é começar em ambiente de teste, com operações representativas e dados fictícios ou anonimizados. Uma empresa que venda produtos e preste serviços, por exemplo, pode selecionar algumas operações comuns e verificar se os cadastros, documentos e resultados do sistema atual correspondem aos parâmetros aplicáveis da CBS e do IBS.
Uma sequência de trabalho possível é:
- Escolher operações reais recorrentes, sem expor dados pessoais ou comerciais desnecessários. Separe casos de venda, devolução, desconto e prestação de serviço que sejam relevantes para o negócio.
- Conferir os dados de entrada. Revise a descrição e classificação dos itens, NCM ou NBS quando aplicável, código de situação tributária, destino da operação e informações que alimentam o documento fiscal.
- Identificar a versão e a fonte das tabelas utilizadas. Guarde o número da versão ou o hash disponibilizado no repositório e registre quando o teste foi feito. Uma atualização posterior pode mudar o comportamento do software.
- Comparar e explicar divergências. Se a ferramenta oficial e o ERP retornarem valores ou códigos diferentes, peça ao fornecedor e à contabilidade a memória do cálculo. Diferenças podem decorrer de cadastro, regra configurada, versão ou hipótese distinta; não provam, sozinhas, que um dos sistemas esteja errado.
- Aprovar a integração antes de levá-la à produção. Registre os responsáveis por validar a classificação fiscal, o tratamento contábil e os testes técnicos. Só então defina cronograma e plano de retorno caso a atualização cause falhas.
Esse processo permite transformar o código aberto em uma referência de conferência e planejamento. A utilidade é maior quando a empresa conhece seus fluxos e consegue documentar por que escolheu determinado tratamento para cada operação.
Exemplo hipotético: divergência no cálculo de uma venda
Imagine uma pequena distribuidora que testa no ERP uma venda de mercadoria para outro estado. O sistema informa uma classificação tributária e um valor estimado de CBS e IBS. Ao repetir o caso na ferramenta da Receita, aparece um resultado diferente.
A diferença não deve ser corrigida apenas copiando um valor de uma tela para outra. A equipe precisa conferir se ambos os sistemas receberam os mesmos dados, se a classificação fiscal corresponde ao produto e à operação, se as tabelas e versões são equivalentes e se existe uma regra específica aplicável. Em seguida, a contabilidade e o fornecedor do ERP devem registrar a justificativa e validar o tratamento antes de alterar o sistema de produção.
O exemplo é hipotético: não indica alíquota ou conclusão para uma operação real. A tributação depende do enquadramento legal e dos fatos de cada negócio.
O código aberto substitui a legislação ou a revisão fiscal?
Não. A Lei Complementar nº 214/2025, com alterações posteriores, continua sendo a referência legal para CBS, IBS e Imposto Seletivo, junto às demais normas aplicáveis e aos regulamentos. O repositório é um componente de software que implementa regras e tabelas; não tem força para criar exceções, modificar a lei ou resolver controvérsias sobre a classificação de uma operação.
Também é necessário separar três tarefas: o software processa os dados recebidos; a área fiscal ou a contabilidade verifica se esses dados e o enquadramento estão corretos; e o jurídico examina dúvidas de interpretação ou exposição relevante. Uma saída tecnicamente consistente pode continuar inadequada se a premissa fiscal estiver errada.
O que fazer agora
Empresas que emitem documentos fiscais devem mapear quais sistemas serão afetados, conversar com o fornecedor do ERP e organizar testes com a contabilidade. Vale ainda manter registro das versões consultadas, casos testados, divergências e decisões adotadas. Para negócios sem equipe de tecnologia, essa preparação pode ser feita com o suporte do fornecedor e do contador, sem necessidade de instalar diretamente o código.
A publicação oficial oferece mais transparência e uma referência útil para a transição, mas não elimina a necessidade de adaptação individual. A equipe tributária da Maciel Sociedade de Advogados acompanha temas de implementação da reforma e pode auxiliar na análise jurídica de situações concretas, em coordenação com a contabilidade e os responsáveis pelos sistemas da empresa.
Fontes e referências
- Receita Federal: publicação do código-fonte da calculadora no GitHub, 16/11/2026
- Portaria Cotec nº 342/2026 — Diário Oficial da União, 13/11/2026
- Repositório oficial da Calculadora de Tributos — regime regular
- Repositório oficial da Calculadora de Tributos — Simples Nacional
- Lei Complementar nº 214/2025 — texto legal no Planalto