XML duplicado não deve desaparecer: revalidação com histórico e comparação
Saiba por que um XML repetido pode ser uma oportunidade de reanalisar regras novas sem apagar o resultado anterior.
Quando um XML já importado aparece novamente, existem duas reações ruins: duplicar tudo silenciosamente ou rejeitar o arquivo sem explicar. Nenhuma delas ajuda o usuário a entender se deseja apenas reenviar ou se precisa revalidar o documento com regras atualizadas.
Como identificar duplicados
O Certa Fiscal usa hash SHA-256 e chave de acesso para o pré-check. A chave pode ser identificada antes do parse completo, reduzindo a superfície de processamento. Se o arquivo for novo, ele segue para a fila. Se já existir, o painel apresenta um comparativo em vez de descartar a intenção do usuário.
Revalidar é diferente de duplicar
Revalidar significa executar novamente as operações do documento usando a versão atual do motor e das tabelas. Uma nova análise é criada com origem de revalidação, enquanto os resultados anteriores permanecem no histórico. Assim é possível verificar se uma mudança de regra, cadastro ou interpretação alterou o diagnóstico.
Por que preservar o passado
Apagar a análise antiga destruiria uma evidência importante. O usuário precisa saber qual motor foi usado, quais regras rodaram e qual resultado existia naquele momento. Essa trilha permite comparar antes e depois, investigar regressões e explicar por que o mesmo documento recebeu leituras diferentes em datas distintas.
O pop-up de decisão
Em uma seleção com vários arquivos, o sistema separa novos, repetidos e rejeitados. Os repetidos aparecem com data da importação, versão do motor e resultado anterior. O usuário marca somente os que deseja revalidar. O resumo informa quantos foram enfileirados, quantos já existiam e quantos não puderam ser aceitos.
Idempotência em profundidade
Além do pré-check, a camada de serviço mantém proteção para evitar duplicidade quando a chamada vem de integração direta. Em produtos CSV, o upsert por SKU atualiza o cadastro em vez de criar cópias. Em APIs de análise, a Idempotency-Key permite repetir uma requisição sem gerar uma segunda operação.
Duplicidade bem tratada não é um erro escondido. É uma decisão explícita, auditável e útil para a evolução do motor fiscal.