Como consultar quem alterou um cadastro fiscal
A tela Fiscal > Auditoria fiscal mostra o histórico de mudanças de todos os cadastros do módulo Fiscal — quem alterou, quando e exatamente o quê. É a resposta para perguntas como "quando essa alíquota mudou?" ou "quem cadastrou este regime tributário?". Esta tela é operada pela equipe interna da Tecnovia.
O que é auditado
A trilha cobre os cadastros do módulo Fiscal: Alíquotas, Regime do emitente, Regras, Filtros de regra, Classificação IBS/CBS, Textos legais e Tratamentos. Algumas dessas tabelas ainda não têm uma tela própria de cadastro — se aparecerem na trilha mesmo assim, é porque foram alteradas por outro meio (por exemplo, uma migração de dados).
Consultando a trilha
Nenhum filtro é obrigatório — a grade já carrega ao abrir a tela, mostrando os últimos 30 dias por padrão. Os filtros disponíveis são:
- Tabela — qual cadastro você quer auditar.
- Período — de/até; nasce preenchido com os últimos 30 dias, mas pode ser ampliado ou limpo.
- Nº do registro — o identificador interno de um cadastro específico, quando você já sabe qual.
Cada evento aparece como uma linha resumida, no formato "{data/hora} · {usuário} · {tabela} #{registro} · {operação} · {resumo}" — por exemplo "01/09/2026 11:30 · MARIA.SILVA · Alíquotas #1 · Alterou · Alíquota 0,9 → 1,2". Quando mais de um campo muda na mesma alteração, o resumo mostra o primeiro e acrescenta "(+N campos)". Criações e exclusões mostram "registro criado"/"registro excluído" em vez de um de-para.
Vendo o que mudou em detalhe
Clique numa linha para expandir. A tabela Antes / Depois mostra só os campos que efetivamente mudaram naquela alteração — nada de um dump genérico do registro inteiro. Se precisar do dado técnico bruto (por exemplo, para comparar com um chamado de suporte), use o disclosure "Ver dados brutos", que traz o JSON completo de antes e depois.
Vendo o histórico direto no cadastro
Nas telas de edição de Alíquotas e Regime do emitente existe um painel "Histórico deste registro", que carrega ao ser aberto (não faz request sozinho) e mostra os 20 eventos mais recentes daquele cadastro específico — sem precisar sair da tela ou montar filtros. Para ver a trilha completa (sem o limite de 20), use o link "Ver toda a trilha" no fim do painel: ele leva à página de auditoria já filtrada pela tabela e pelo registro certos, com o período de datas removido (mostra tudo, não só os últimos 30 dias).
Se você não vê o painel "Histórico deste registro", é porque o seu usuário tem acesso ao cadastro (pode ver e editar) mas não tem o direito específico de auditoria (FIS_AUDITORIA) — são direitos independentes. Isso não é um erro: a tela simplesmente não mostra o painel, e nenhuma tentativa de acesso é feita.
Paginando um período grande
A trilha pagina em 25, 50, 100 ou 200 linhas por página. Se um período tiver muitas alterações, prefira estreitar o filtro por tabela ou por um intervalo de datas menor em vez de navegar por muitas páginas.
Erros comuns
- "Nenhuma alteração registrada entre {data} e {data}" — o filtro de período está ativo e não há eventos nele; amplie o período ou remova o filtro de data.
- "Nenhuma alteração registrada para este filtro" — aparece quando o filtro de período foi removido (por exemplo, ao chegar pelo link "Ver toda a trilha") e mesmo assim não há eventos para a combinação de tabela/registro escolhida.
- O serviço de manutenção fiscal está indisponível — as telas fiscais falam com um serviço próprio, separado do restante do sistema; se ele estiver fora do ar, a tela avisa e oferece "Tentar novamente".
Veja também
- Como cadastrar alíquotas fiscais com vigência
- Como definir o regime tributário de uma unidade emitente
- Módulo Fiscal: alíquotas, simulador e regras — visão geral do menu Fiscal e quem tem acesso.