Como instalar e executar a Calculadora off-line

Modificado em Seg, 15 Set na (o) 2:29 PM

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:

Tipo	Para quem é	Como funciona
Simulador online	Contribuintes, contadores, consultores — quem quiser testar ou simular sem instalar nada	É uma interface web, onde você insere dados da operação de consumo ou do seu negócio e ela calcula os tributos conforme as regras da Reforma. Não requer instalação.
Componente / Calculadora off-line (local)	Empresas de software, empresas que usam ERP, contadores ou setores fiscais que preferem operar localmente ou integrar ao sistema interno	Você baixa uma versão que roda no seu ambiente local, podendo ser integrada via API REST ao ERP ou sistema contábil. Garante autonomia, sigilo, execução sem depender da internet.

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 offline 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.
Instalar qualquer dependência exigida (bibliotecas, runtimes).
Configurar variables de ambiente se for necessário (por exemplo variáveis de caminho ou de acesso).
Registrar ou executar o serviço localmente (pode ser via linha de comando ou serviço de sistema).

Aqui existe a instrução de instalação:

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

4 - Configurar integração

A 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.

No SGE, ainda estamos fazendo testes de performance da API e por este motivo ainda não liberamos a versão definitiva com a geração das TAG.

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.