Fale conosco
WhatsApp

Manual da Calculadora de Impostos – Reforma Tributária

A Calculadora de Impostos tem como objetivo permitir que o usuário compare o cálculo realizado pelo sistema interno, baseado nas Regras Tributárias configuradas, com o cálculo retornado pela API oficial do Projeto Piloto da Reforma Tributária.

Essa ferramenta auxilia na conferência, ajuste e validação das parametrizações internas, garantindo que o sistema esteja alinhado com o comportamento da calculadora governamental.


1. Finalidade da Calculadora

A calculadora serve para:

  • Validar se a Regra Tributária configurada está correta;

  • Comparar CST, Classificação Tributária (cClassTrib) e alíquotas;

  • Verificar se o resultado do cálculo interno corresponde ao cálculo da API oficial;

  • Auxiliar na parametrização inicial da Reforma Tributária dentro do sistema.

Para acessar a Calculadora, acesse o menu: Cadastros > Gerenciar Cadastros > Calculadora Impostos.


2. Campos utilizados no cálculo

Para realizar os cálculos, devem ser informados:

  • Emitente/Filial
    Utilizado para localizar regras específicas por empresa.

  • Operação
    Define qual regra tributária será pesquisada.

  • Data da Operação
    Filtra regras de acordo com a vigência.

  • Município do Destinatário
    Pode influenciar UF/Município no IBS/CBS.

  • Produto
    Traz Grupo Tributário, NCM, Classificação, etc.

  • Quantidade e Valor do Item

Essas informações compõem o cenário para localizar a regra adequada e gerar a simulação.


3. Botão Calcular Sistema

Ao acionar Calcular Sistema, o sistema executa:

3.1 Busca da Regra Tributária

O sistema aplica o mesmo algoritmo utilizado nas emissões:

  • Emitente compatível

  • Operação

  • Grupo tributário do produto

  • UF/Cidade do destino

  • Vigência

  • NCM (exata ou genérica)

  • Sequência (prioridade manual)

A regra localizada traz:

  • CST

  • cClassTrib

  • Alíquotas de IBS UF e Município

  • Alíquotas de CBS

  • Bases de cálculo e valores

Esses valores são exibidos no bloco “Calculado Sistema”.

3.2 Pré-preenchimento para cálculo online

Após localizar a regra, o sistema:

  • Preenche automaticamente CST e cClassTrib nos campos da seção Calculado Online.

  • Prepara o cenário para envio à API.

Assim, o usuário evita divergências por preenchimento manual incorreto.


4. Botão Calcular Online

O botão Calcular Online realiza uma chamada à API oficial:

Essa API é parte do Projeto Piloto da Reforma Tributária, e simula a tributação de consumo em ambiente oficial de testes.

4.1 O sistema envia os seguintes dados:
  • CST selecionado

  • cClassTrib

  • Valor da operação

  • Quantidade

  • UF e Município do destinatário

  • Dados gerais da operação

4.2 O retorno da API contém:
  • Alíquota IBS

  • Alíquota CBS

  • Percentuais UF/Município

  • Bases de cálculo

  • Valores dos tributos

  • Detalhes complementares

Esses valores são exibidos na seção “Calculado Online”.


5. Comparação dos Cálculos

Na interface, as seções Calculado Sistema e Calculado Online são exibidas juntas para facilitar a comparação:

  • CST

  • cClassTrib

  • Base de cálculo

  • % IBS UF / Município

  • % CBS

  • IS - Imposto Seletivo (a partir de 2027)
  • Entre outros, como dados de Diferimento, Devolução de Tributos, Redução de Alíquota, Crédito Presumido, Tributação Regular, Compra Governamental, Monofásicos, Transferência Crédito, etc

Em caso de divergências:

  • O usuário pode revisar a Regra Tributária configurada;

  • Verificar se o CST e cClassTrib foram corretamente definidos;

  • Ajustar alíquotas ou vigências;

  • Validar se o produto pertence ao grupo tributário correto.


6. Visualização do JSON Recebido

O botão “Visualizar JSON” permite inspecionar a estrutura completa retornada pela api.

Esse recurso facilita auditoria e suporte técnico.


7. Boas práticas de uso

  • Sempre confirmar se o produto possui Grupo Tributário adequado.

  • Certificar que a operação tem classificações tributárias válidas.

  • Validar se a regra possui vigência compatível.

  • Utilizar a ferramenta durante a fase de implantação da Reforma Tributária.

  • Registrar divergências para ajuste de parametrização.


8. Conclusão

A Calculadora de Impostos é essencial para garantir que o sistema esteja alinhado com os cálculos oficiais da Reforma Tributária, oferecendo:

  • Transparência

  • Padronização

  • Segurança tributária

  • Aderência à legislação

Isso reforça a confiabilidade do sistema e reduz riscos em emissões reais.