Importação segura de XML: o que acontece entre o upload e a análise fiscal
Conheça o pipeline que separa arquivos, detecta o tipo de documento, protege contra XML malicioso e preserva erros por item.
Importar XML não deveria significar jogar dezenas de arquivos em uma tela e esperar por um resultado genérico. Um processo confiável precisa manter cada documento rastreável, isolar falhas e deixar claro em qual etapa o trabalho está.
Um arquivo, uma trilha
No Certa Fiscal, cada arquivo enviado cria uma importação própria. A fila passa por validação, identificação do documento, processamento e conclusão. Se um dos arquivos falhar, os demais continuam independentes. O usuário acompanha estados como Aguardando, Validando, Processando, Concluída, Concluída com erros, Falhou ou Cancelada.
Segurança antes do parser
A extensão do arquivo não é suficiente. O sistema também verifica o tipo real, limita tamanho e quantidade e armazena o conteúdo em área privada com nome aleatório. XML com DOCTYPE é rejeitado para reduzir risco de XXE, e o parser é executado sem acesso à rede. Essa proteção é importante porque documentos fiscais podem vir de várias origens.
Detecção automática sem adivinhação
O pipeline reconhece NF-e, NFC-e e NFS-e Nacional pelo namespace e pela estrutura. Formatos conhecidos que ainda não estão homologados são recusados com mensagem explícita. Essa decisão evita o erro mais perigoso: interpretar um documento como se fosse outro e produzir uma análise falsa.
Do documento para cada item
Em NF-e e NFC-e, cada item vira uma operação fiscal separada. Campos como NCM, CEST, CFOP, CST ou CSOSN, valor e indicador de consumidor final alimentam o motor. O resultado mantém ligação com documento, item, regra e versão. Na NFS-e Nacional, são extraídos dados como código de serviço, NBS, município, base, alíquota e ISS.
Fila e observabilidade
Processamento assíncrono evita que o navegador fique preso a uma tarefa longa. O painel acompanha o progresso sem recarregar a página inteira e mostra erros por linha ou arquivo. Para integrações, eventos de conclusão ou falha podem ser enviados por webhook.
Importar bem não é apenas aceitar arquivos. É construir uma trilha segura entre o dado recebido e a decisão que será tomada depois.