Calculadora de Tributos da Receita ganha código aberto no GitHub

· 6 min de leitura

A Calculadora de Tributos da Receita Federal ganhou código aberto. A Portaria Cotec nº 342, de 12 de novembro de 2026, autorizou a publicação de três repositórios oficiais no GitHub, sob licença MIT. Além disso, a medida saiu no Diário Oficial da União em 13 de novembro, e a Receita divulgou o alcance da iniciativa em 16 de novembro.

Além disso, é a primeira vez que a Receita Federal publica um projeto de software próprio em ambiente público de desenvolvimento colaborativo. Com isso, empresas de tecnologia, desenvolvedores e contribuintes passam a consultar a mesma lógica de cálculo usada pelo Fisco para CBS, IBS e Imposto Seletivo.

Tela de computador com código-fonte aberto, referência usada na Calculadora de Tributos da Receita Federal publicada no GitHub
Foto: Sai Kiran Anagani / Wikimedia Commons (CC0)

Já para escritórios contábeis, o ganho está na conferência. Em vez de comparar apenas resultados, a equipe pode checar a regra aplicada e identificar divergências antes de fechar a apuração. Além disso, a transparência ajuda a reduzir a dependência de interpretações isoladas de fornecedores de sistema.

O que a Calculadora de Tributos em código aberto inclui

A portaria autoriza a conversão de privados para públicos e a publicação de três repositórios na organização “ReceitaFederal” do GitHub. O primeiro é a Calculadora de Tributos – Regime Regular. Trata-se de uma API REST que calcula CBS, IBS e Imposto Seletivo no contexto da reforma tributária do consumo e da Lei Complementar nº 214/2025.

Além disso, esse repositório consulta as tabelas oficiais usadas no cálculo. Além disso, gera e valida os grupos de tributação dos documentos fiscais eletrônicos. Já o segundo projeto é a Calculadora de Tributos – Simples Nacional, uma API REST que calcula CBS e IBS nas operações submetidas ao regime simplificado.

DANFSe Service e os três repositórios da Calculadora de Tributos

Por fim, o terceiro repositório é o DANFSe Service. Ele é um serviço HTTP em linguagem Go que gera o Documento Auxiliar da NFS-e em PDF a partir do XML da nota de serviço. Portanto, o pacote cobre cálculo, validação e representação do documento fiscal.

Além disso, a publicação usa a licença MIT, uma das mais difundidas no mundo do software livre. Ela permite usar, copiar, modificar e distribuir o código, inclusive em produto comercial. Ainda assim, a licença não transfere responsabilidade técnica nem cria garantia de suporte por parte da Receita.

Como a Receita protege a autenticidade do código

A portaria registra os hashes das versões iniciais tornadas públicas. Com isso, qualquer pessoa pode conferir se o arquivo baixado corresponde ao código oficial. Além disso, o GitHub permite acompanhar versões e alterações ao longo do tempo.

Por isso, esse controle importa: o cálculo tributário precisa de rastreabilidade. Um integrador que baixa o projeto pode comparar o hash com o publicado no Diário Oficial. Dessa forma, evita versões alteradas e reduz o risco de usar uma regra desatualizada.

Limites definidos pela portaria

A norma é clara sobre o alcance. A publicação não implica garantia de suporte técnico ao público externo. Também não cria compromisso de manutenção evolutiva ou corretiva, nem validação automática de usos não previstos pela administração.

Além disso, o texto afirma que o código não tem efeito vinculante ou normativo. Ou seja, a referência é técnica, não uma consulta tributária. Por isso, a interpretação da legislação continua exigindo análise profissional e, quando necessário, consulta formal à Receita.

Por que o código aberto muda a rotina contábil

O primeiro efeito é de diagnóstico. Quando o valor apurado pelo sistema da empresa difere do cálculo oficial, a equipe pode testar a mesma operação na calculadora e comparar etapa por etapa. Assim, identifica se o erro está na base, na alíquota, no crédito ou no documento fiscal.

Já o segundo efeito é de integração. Empresas de tecnologia podem usar a API como referência para adaptar ERPs, emissores de nota e plataformas de gestão. Com isso, o mercado ganha um parâmetro comum para testar a conformidade antes da entrada em vigor da CBS, prevista para janeiro de 2027.

Por fim, o terceiro efeito é de auditoria. O contador pode documentar a conferência e guardar o resultado do teste. Essa evidência ajuda em uma revisão interna e mostra que a apuração seguiu a lógica oficial.

O que a calculadora não resolve

O código não substitui a obrigação acessória nem corrige cadastros. Ele também não decide o enquadramento da empresa, o direito ao crédito ou o tratamento de um caso concreto. Para isso, continuam valendo a legislação, a jurisprudência e a análise do profissional.

Além disso, outro cuidado é com as bibliotecas de terceiros. Cada repositório traz licenças próprias, e o integrador precisa conferi-las. Além disso, o uso comercial exige atenção à versão adotada e ao histórico de mudanças.

Impacto para contadores e empresas

Já para o escritório contábil, a calculadora vira uma ferramenta de conferência. Ela ajuda a validar cenários de IBS e CBS, a testar operações específicas e a explicar ao cliente por que determinado valor aparece na nota. Além disso, reduz o tempo gasto em discussões sem base técnica.

Para a empresa, o ganho é de previsibilidade. A área fiscal pode simular operações e ajustar contratos antes de a cobrança começar. Já a área de tecnologia consegue planejar a integração com uma referência objetiva.

Nesse cenário, a integração entre apuração e sistema fica mais importante. As APIs de apuração da CBS já exigem preparação técnica, e o Ato Técnico 10/2026 alterou campos de NF-e e CT-e. Um sistema contábil para escritórios organiza esses dados e evita que a conferência dependa de planilhas paralelas.

Como começar a usar a Calculadora de Tributos

Em primeiro lugar, a equipe acessa a organização oficial da Receita no GitHub e escolhe o repositório adequado ao regime da empresa. Em seguida, o time técnico confere os hashes registrados na portaria. Depois, monta um ambiente de teste separado da produção.

Na sequência, vale reproduzir operações conhecidas. A equipe compara o resultado da calculadora com a apuração atual e registra as diferenças. Por fim, documenta as conclusões e atualiza os procedimentos internos.

Por isso, esse roteiro evita dois erros comuns. O primeiro é tratar o código como verdade absoluta. O segundo é ignorar a versão usada. Afinal, a portaria prevê evolução do projeto, e a regra pode mudar com a regulamentação.

Em resumo

  • A Calculadora de Tributos está publicada no GitHub pela Receita Federal;
  • São três repositórios: Regime Regular, Simples Nacional e DANFSe Service;
  • A licença é MIT, com hashes das versões iniciais registrados na portaria;
  • O código calcula CBS, IBS e Imposto Seletivo e valida grupos de documentos fiscais;
  • A Receita não oferece suporte, manutenção ou efeito vinculante ao código;
  • A calculadora serve para conferência e integração, não substitui a análise tributária;
  • O uso exige ambiente de teste, conferência de versão e documentação das conclusões.

As informações estão na Portaria Cotec nº 342/2026, na Agência Gov e no repositório oficial da Receita Federal.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Open chat
Olá! Em que posso ajudar?
Olá, podem me ajudar com mais informações?