Como instalar e executar a Calculadora off-line

Observação

Na documentação a pasta calculadora está dentro da pasta Downloads, porém é aconselhável movê-la para outro diretório caso o usuário tenha o hábito de limpar a pasta Downloads.

A Receita Federal disponibilizou uma Calculadora de Tributos voltada para a Reforma Tributária sobre o Consumo, que inclui a CBS, o IBS e o Imposto Seletivo. 

Tipos de calculadora

A ferramenta oficial da Receita Federal tem basicamente duas formas de uso:

Características da Calculadora

Alguns pontos importantes que ela oferece:

• Conteúdo normativo embarcado: as regras legais da CBS, IBS e Imposto Seletivo já estão incorporadas no motor de cálculo.

• Transparência e auditabilidade: memória de cálculo, base legal aplicada, detalhamento técnico. 

• Código aberto: a comunidade pode ver, testar, auditar e sugerir melhorias. 

• Integração via API para uso local/componente. 

Como instalar ou usar a versão off-line (local)

Aqui vão os passos gerais para instalar e configurar a Calculadora off-line ou componente local, com base nas informações disponíveis:

1 - Obter o instalador / baixar o componente
A Receita Federal disponibiliza no portal oficial a versão off-line para download. Verifique a página de serviço “Calculadora de Consumo / Calculadora Offline” do site de pilotagem (Piloto CBS). 

Ela pode ser obtida através deste site:

https://piloto-cbs.tributos.gov.br/servico/calculadora-consumo/calculadora/calculadora-offline

2 - Requisitos mínimos
Embora o documento oficial não detalhe todos os requisitos, tipicamente são necessários:

• Ambiente local que suporte execução de software (servidor ou máquina de desenvolvimento)

• Sistema operacional compatível (Windows, Linux, ou outro que suporte execução do componente)

• Dependências de software: runtime Java, Node.js ou outro, se o motor usar essas tecnologias (verificar documentação)

• Acesso para leitura/gravação de arquivos ou logs, conforme exigido

• Permissões de rede (se o componente local usa API interna)

3 - Instalação

• Fazer o download do pacote ou instalador.
  
  
  
  

• Extrair ou descompactar, se for um pacote zip/tar.gz.
  
  

• Acesse a pasta Calculadora, dentro dela abra a pasta calculadora.tar.

  Não há necessidade de descompactar, apenas copie a pasta calculadora para a pasta principal.

  
  

  
  
  
  

• Após o procedimento, haverá uma pasta calculadora dentro de outra pasta Calculadora, conforme a imagem abaixo.
  
  
  
  

• Abra a pasta CALCULADORA/CALCULADORA via CMD e execute o comando abaixo, ajustando-o conforme o diretório que contém as pastas de instalação:
  
  

  C:\Users\gustavo.s\Downloads\calculadora\calculadora>java -jar api-regime-geral.jar --spring.profiles.active=offline

  
  Utilizando o exemplo acima, o comando padrão é:
  
  

  java -jar api-regime-geral.jar --spring.profiles.active=offline

  
  Antes dele, deve ser informado o caminho exato da pasta Calculadora → calculadora.

  
  

• Após executar o comando, será exibida uma mensagem semelhante à imagem a seguir, indicando que o serviço foi iniciado.
  
  
  

  Observação: Na documentação a pasta calculadora está dentro da pasta Downloads, porém é aconselhável movê-la para outro diretório caso o usuário tenha o hábito de limpar a pasta Downloads.

  
  

• Caso nenhum erro ocorra durante o procedimento, ao acessar o link: http://localhost:8080/api/, o navegador deve carregar a seguinte página:
  
  
  

  
  

  4 - Configurar integraçãoA integração ao SGE usa a tecnologia de API REST fornecida pelo componente da calculadora. Depois de instalado, o endereço do servidor deve ser informado na rotina GEM213 - Painel do IVA.

5 - Atualizações e manutenção

A Receita Federal deve manter o conteúdo normativo atualizado. Pode haver novas versões do componente. É importante acompanhar no site oficial. 

Vantagens e cuidados

Vantagens:

• Permite fazer os cálculos localmente, sem depender da internet ou do servidor externo.

• Maior controle de sigilo e segurança dos dados internos da empresa.

• Integração direta com sistemas existentes (ERP), automatização de processos.

• Transparência: saber exatamente qual regra legal e base está sendo utilizada.

Cuidados:

• Precisão: usar sempre a versão mais atual do componente, pois a legislação pode mudar.

• Compatibilidade técnica: garantir que o ambiente local suporte dependências exigidas.

• Segurança: se local, garantir que o componente esteja protegido, e a API não seja exposta de forma vulnerável.

ATENÇÃO

A SOFTDATA instalou a calculadora off-line no seu ambiente de nuvem e neste momento irá disponibilizar o acesso sem custo aos clientes a este serviço. Para usar, no campo "Endereço Servidor", informe o IP abaixo:

186.250.185.102

Estando a calculadora em nosso ambiente de nuvem, faremos todas as atualizações necessárias para este primeiro período de testes.

A idéia principal é que o SGE mande os itens de pedidos ou itens da nota, por exemplo, e a rotina de calculadora devolva os valores de impostos já calculados, facilitando assim a forma de cálculo e padronizando quando mudar algo na legislação. Desta forma todo o "motor" do cálculo será feito por esta calculadora.

Também iremos liberar uma opção para que o SGE faça o cálculo e não dependa da calculadora off-line em caso de paradas extremas ou performance comprometedora.