Como simular o efeito de uma alíquota ou regra fiscal antes de cadastrar
O Simulador (menu 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 ou o número de uma NF-e/CT-e 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
Alguns campos do cenário manual (Tipo de DT, Modal, Operação, Modalidade de pagamento, Tipo de mercadoria) pedem hoje um código numérico, sem busca ou lista suspensa — é a mesma numeração usada nos cadastros correspondentes do sistema (por exemplo, o código de Tipo de DT é o mesmo do cadastro de Tipos de DT). Se não souber o código de cabeça, consulte o cadastro correspondente ou peça apoio à equipe técnica; uma tela de busca mais amigável está prevista para uma fatia futura.
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.