Como simular o efeito de uma alíquota ou regra fiscal antes de cadastrar
O Simulador (menu Configurações > Fiscal > Simulador) mostra o resultado do cálculo fiscal — ICMS, ST, CBS, IBS e o texto legal aplicável — para um documento real ou para um cenário criado manualmente, sem gravar nada. É a forma de conferir o efeito de uma alíquota ou de uma regra antes de confiar nela, e também de comparar o mesmo documento em duas datas diferentes.
Documento real × Cenário manual
A tela tem duas abas:
- Documento real — informe a chave do CT-e (44 dígitos) já existente. O sistema usa os dados reais desse documento.
- Cenário manual — monte uma situação hipotética preenchendo os campos relevantes (tipo de operação, UFs, regime do emitente e do cliente, subcontratação etc.). Use esta aba quando quiser testar um documento que ainda não existe.
No cenário manual, o campo "Cliente" é obrigatório. O motor de cálculo precisa identificar o tomador do serviço para resolver corretamente o ICMS e as demais regras — sem um cliente informado, a simulação não é enviada.
Documento real e mudança de REGRA: ao simular um documento real em duas datas, o Simulador recalcula a alíquota vigente em cada data, mas mantém a regra fiscal (o tratamento) que já foi decidida quando o documento foi originalmente processado — trocar a data não faz o motor escolher outra regra. Isso é suficiente para conferir o efeito de uma alíquota nova (é o uso mais comum), mas não mostra o efeito de uma regra criada ou alterada depois da emissão do documento. Para testar o efeito de uma regra nova, use o Cenário manual.
Sobre os campos de código no cenário manual
Os campos Tipo de DT, Modal, Operação, Modalidade de pagamento e Tipo de mercadoria são listas de seleção — escolha o valor pelo nome, sem precisar saber ou digitar nenhum código. O mesmo vale para as três UFs (Emitente, Origem, Destino): também são selecionadas numa lista, não digitadas.
Data de referência — inclusive no futuro
O campo Data de referência aceita qualquer data, inclusive futura. É assim que se testa, hoje, o que vai acontecer quando uma vigência futura entrar em vigor — por exemplo, simular como ficaria um documento emitido em 02/01/2027, com a alíquota de CBS que só passará a valer naquele dia.
Lendo a trilha
Abaixo do resultado, a trilha lista, na ordem em que o motor realmente avaliou, cada regra testada para aquele documento. Cada item mostra se a regra casou ou não casou — e "não casou" não é um erro: é o funcionamento normal do mecanismo, que aplica sempre a primeira regra que casa e ignora as seguintes. A trilha existe justamente para você conferir, passo a passo, por que o resultado saiu do jeito que saiu — clique num item para ver as condições avaliadas.
Comparando antes × depois
Informe duas datas (Data A e Data B) sobre o mesmo documento ou cenário para ver, lado a lado, o que muda entre elas. Toda diferença é destacada por cor e por texto (marcador "▲ alterado"), então a comparação funciona mesmo para quem não distingue bem cores. É o uso mais direto para provar que uma alíquota cadastrada com data futura realmente muda o resultado a partir daquela data — sem esperar a data chegar e sem qualquer atualização do sistema.
Quando o texto legal não aparece
Para alguns tratamentos, o texto que sai no CT-e depende dos valores do próprio documento (não é um texto fixo). No cenário manual, sem esses valores reais, a tela avisa "este texto depende de valores do documento" em vez de mostrar um texto fabricado — simule a partir de um documento real para ver o texto final.
Dica: na tela de Alíquotas, a ação "Simular com esta vigência" de cada linha já abre o Simulador com o tributo e uma data dentro daquele período — é o caminho mais rápido para conferir uma alíquota recém-cadastrada.