Calculadora de tributos da Receita: como testar a CBS do seu ERP
A Receita pôs a calculadora de tributos no GitHub. Veja o que foi publicado e um roteiro de cinco dias para testar a CBS do seu ERP antes de janeiro.

A calculadora de tributos da Receita Federal agora tem código-fonte público no GitHub, e isso muda a forma de testar o sistema de faturamento antes da CBS entrar em vigor em janeiro de 2027. Desde 16 de novembro de 2026, qualquer empresa, escritório contábil ou fornecedor de software pode baixar a mesma lógica de cálculo que o Fisco usa como referência e comparar com o que o próprio ERP está calculando nota a nota.
A autorização veio pela Portaria Cotec nº 342, de 12 de novembro de 2026, publicada no Diário Oficial da União em 13 de novembro. Neste texto você vai ver o que foi publicado, o que a ferramenta resolve e o que não resolve, e um roteiro de conferência que cabe em uma semana de trabalho do fiscal.
O que a Receita colocou no GitHub
Segundo a nota oficial da Receita Federal, foram publicados três repositórios, todos sob licença MIT, que permite usar, copiar e modificar o código, inclusive em produto comercial:
Repositório | Para que serve |
|---|---|
calculadora-rtc-regime-regular | Cálculo da CBS e do IBS para empresas fora do Simples Nacional |
calculadora-rtc-simples-nacional | Cálculo para optantes do Simples Nacional |
calculadora-rtc-gerador-danfse | Geração do DANFSe, o documento auxiliar da NFS-e |
Três detalhes da publicação importam para quem vai usar o código no dia a dia:
A portaria registra o hash das versões iniciais de cada repositório. Com ele, a equipe de TI confirma que o código baixado é o mesmo que a Receita publicou, sem alteração no caminho.
O projeto é da Receita com o Serpro. O código já estava disponível para baixar na Plataforma CBS desde 2025; a novidade é o canal público, com histórico de versões.
A própria Receita diz que a calculadora não substitui os sistemas que as empresas já usam. Ela é um componente oficial que o software de faturamento pode incorporar ou usar como gabarito.
Na prática, a Receita entregou uma régua. Se o seu sistema calcula a CBS de um jeito e a calculadora oficial calcula de outro, uma das duas contas está errada, e a chance de ser a sua é grande.
Por que isso pesa no seu caixa a partir de janeiro
A CBS começa em 1º de janeiro de 2027 com a alíquota cheia, e o PIS e a Cofins saem de cena no mesmo dia, conforme o cronograma da Lei Complementar 214/2025. O IBS segue em fase de teste. A alíquota de referência da CBS para 2027 ainda depende de resolução do Senado: o TCU recomendou 11,3% em 10 de novembro, e o prazo para a definição é 15 de dezembro de 2026. Falamos disso em detalhe no texto sobre a alíquota da CBS em 2027.
Erro de cálculo na nota fiscal tem dois custos. Se o sistema calcula a menos, a empresa paga a diferença depois, com o cliente já faturado. Se calcula a mais, o preço fica acima do concorrente e o cliente que toma crédito reclama do valor. Em 18 de novembro, a Receita avisou que vai identificar empresas do regime regular com dificuldade para informar a CBS nos documentos fiscais e repassar a lista ao Conselho Federal de Contabilidade, que vai comunicar os contadores responsáveis, segundo o comunicado do CFC. Quem testar antes chega a janeiro sem entrar nessa lista.
Exemplo: uma distribuidora conferindo o próprio ERP
Considere, como exemplo, uma distribuidora de peças do Lucro Presumido que emite cerca de 2.000 notas por mês. O fornecedor do ERP garante que a versão de dezembro já calcula a CBS. O contador pede uma prova.
O analista fiscal separa 40 notas de teste que cobrem os casos da empresa: venda dentro do estado, venda para outro estado, venda para cliente do Simples, devolução e bonificação. Roda as 40 no ambiente de homologação do ERP e na calculadora oficial, com os mesmos dados de entrada.
Suponha que a alíquota de referência confirmada pelo Senado seja os 11,3% recomendados pelo TCU. Numa venda de R$ 1.000,00, a CBS esperada é de R$ 113,00. Se o ERP ainda estiver configurado com a alíquota de teste de 2026 (0,9% de CBS, pela LC 214/2025), a nota sai com R$ 9,00. A diferença por nota é de R$ 104,00. Em 2.000 notas desse valor, o furo chega a R$ 208.000,00 em um mês.
A conferência nem sempre acha um erro desse tamanho. O caso mais comum é a divergência pequena e repetida: base de cálculo que inclui ou exclui um valor de frete por engano, código de classificação tributária trocado em uma família de produtos, desconto incondicional tratado como condicional. Cada um desses erros some no volume e aparece meses depois, na apuração.
Roteiro de conferência em cinco dias
O roteiro abaixo serve para empresa com fiscal interno e para escritório que atende vários clientes. Ajuste os prazos ao seu volume.
Dia 1. A TI baixa o repositório que corresponde ao regime da empresa e confere o hash publicado na portaria. Sem hash conferido, o teste não vale.
Dia 2. O fiscal monta a massa de teste: de 30 a 50 notas reais de outubro e novembro, escolhidas para cobrir todos os CFOPs, todos os tipos de cliente e as operações com tratamento diferente na reforma (redução de alíquota, isenção, devolução).
Dia 3. As notas passam pelas duas contas. O resultado vai para uma planilha com quatro colunas por nota: base de cálculo, alíquota, valor da CBS e código de classificação tributária, lado a lado.
Dia 4. Cada divergência vira um chamado para o fornecedor do ERP, com o número da nota, o valor esperado e o valor obtido. Divergência de base de cálculo vai também para o contador, porque às vezes o erro está no cadastro e não no sistema.
Dia 5. Depois da correção, a mesma massa de teste roda de novo. Só se encerra quando as duas contas batem em todas as notas.
Guarde a planilha e os chamados. Esse material mostra que a empresa testou o cálculo antes de janeiro e ajuda a sustentar a boa-fé num eventual questionamento, assunto que tratamos no texto sobre o Programa de Conformidade 2027.
O que a calculadora não faz
Ela calcula. Não decide enquadramento. Se o cadastro do produto estiver com a classificação errada, a calculadora devolve um valor coerente com o dado errado. Por isso, o passo 2 do roteiro pede notas reais e uma revisão do cadastro pelo contador, item por item, nas famílias de produtos com regra diferente.
A calculadora também não emite nota e não apura saldo. A apuração da CBS segue pelas ferramentas da Receita, como a apuração assistida, que explicamos no texto sobre como conferir o saldo da CBS.
E ela vai mudar. Normas novas, como a resolução do Senado sobre a alíquota, geram versões novas do código. Quem incorporar a calculadora ao sistema precisa de alguém responsável por acompanhar as atualizações do repositório e repetir a conferência a cada versão.
Quem deve cuidar disso na empresa
Na empresa média, o trabalho fica entre três pessoas: o analista fiscal monta a massa de teste e lê o resultado, a TI cuida do código e do hash, o contador revisa o enquadramento e assina a conclusão. Em empresa pequena, o escritório contábil costuma assumir a parte fiscal e pedir ao fornecedor do ERP o relatório de cálculo de cada nota.
Se a sua equipe não tem quem leia código, não é preciso contratar programador para isso. Várias empresas de software fiscal já usam a calculadora, e a pergunta certa ao fornecedor é direta: qual versão do repositório oficial o sistema usa e quando foi a última conferência.
Perguntas frequentes
A calculadora de tributos da Receita é obrigatória?
Não. A Receita publicou o código como referência e componente opcional. A empresa pode continuar com o sistema atual, desde que o cálculo da CBS e do IBS na nota esteja correto. A calculadora serve como gabarito para provar isso, e o uso dela não dispensa a revisão do cadastro fiscal pelo contador.
Preciso saber programar para usar a calculadora?
Para rodar o código baixado do GitHub, sim, ou alguém da TI. Para a conferência, não: o fiscal define as notas de teste e compara os resultados numa planilha. Empresas sem TI própria podem pedir ao fornecedor do ERP que rode a massa de teste e entregue o relatório nota a nota.
Posso usar a calculadora em um software que vendo para clientes?
A licença MIT permite uso comercial, cópia e modificação. Quem fizer isso deve manter o aviso de licença e acompanhar as versões publicadas pela Receita, porque cada mudança de norma pode alterar o cálculo. Confira o hash de cada versão contra o que a Receita registrar oficialmente.
O que fazer se o ERP e a calculadora derem valores diferentes?
Registre a nota, o valor esperado e o valor obtido, e abra chamado com o fornecedor do sistema. Leve também ao contador, porque a diferença pode estar no cadastro do produto e não no software. Só encerre o teste quando todas as notas da massa de teste baterem nas duas contas.
Próximo passo
Marque a semana de conferência ainda em novembro, antes da resolução do Senado sobre a alíquota, e repita o teste na semana seguinte à publicação. Se a sua empresa precisa de um contador com experiência na transição da CBS para revisar cadastro e resultado, a Connectabil conecta você a profissionais e escritórios especializados.
Regras válidas em 20 de novembro de 2026.
Leia também
Contabilidade: Apuração assistida da CBS: como conferir o saldo antes de 2027
Recrutamento: Como contratar analista de sistemas fiscais para a CBS e o IBS
Carreira: NF-e com IBS e CBS: o que o contador fiscal precisa dominar agora
Fontes
Receita Federal: código-fonte da Calculadora de Tributos no GitHub (16/11/2026)
Agência Gov: Receita abre código-fonte para cálculo de tributos de consumo (16/11/2026)
CFC: Receita e entidades anunciam apoio direto a contadores (18/11/2026)
Este conteúdo é informativo e não substitui a orientação de um contador ou advogado.


