Formatador XML
Formate e indente documentos XML para melhor legibilidade.
XML Formatado
O que é Formatador XML?
O Formatador XML (também conhecido como Pretty Print XML) transforma XML compactado ou mal formatado em um documento indentado, organizado e legível para humanos. Adiciona espaços, quebras de linha e recuo hierárquico que representam visualmente a estrutura do documento XML, sem alterar nenhum dado ou conteúdo. Esta ferramenta é indispensável para desenvolvedores e analistas que trabalham com XML de notas fiscais eletrônicas, que frequentemente chegam em formato compactado dos web services da SEFAZ, tornando a análise manual praticamente impossível.
Como funciona
Cole ou faça upload do XML compactado ou mal formatado. A ferramenta parseia a estrutura do documento utilizando um parser XML válido, identifica a hierarquia de elementos pai e filho, e gera uma versão formatada com indentação consistente de 2 espaços por nível. Cada elemento de abertura e fechamento de tag é colocado em uma linha separada, com recuo proporcional à profundidade na hierarquia. Atributos são organizados de forma legível e valores de texto são preservados exatamente como no original. Suporta XML de NF-e, NFC-e, CT-e, MDF-e e qualquer outro formato XML válido, incluindo documentos com namespaces complexos.
Quando utilizar
Utilize quando receber XML de sistemas SEFAZ em formato compactado, que é o padrão de retorno dos web services. É essencial ao debugar integrações que enviam ou recebem XML, pois a visualização formatada facilita enormemente a identificação de campos e valores. Também é útil quando precisar analisar a estrutura de um documento XML de nota fiscal eletrônica para identificar campos específicos, como o código de erro retornado pela SEFAZ. Analistas de suporte técnico frequentemente precisam formatar XML para identificar rapidamente o problema em transmissões que falharam.
Exemplo prático
Um desenvolvedor recebe o retorno de uma consulta de protocolo da SEFAZ em XML compactado e precisa identificar o campo de erro para corrigir o problema de transmissão. Ele cola o XML no formatador e visualiza a estrutura completa com facilidade, localizando rapidamente o campo xMotivo que contém a descrição do erro. Outro cenário: um analista de suporte recebe um XML de NF-e de 5.000 linhas em formato compactado e precisa verificar se o campo de destaque de ICMS está correto. Com o formatador, ele expande o documento e navega pela estrutura para encontrar o campo específico em segundos.
Vantagens
Transforma XML compactado em documento indentado e legível em menos de um segundo. Suporta XML de NF-e, NFC-e, CT-e, MDF-e e qualquer outro formato XML válido. Preserva o conteúdo original sem alterar nenhum dado, atributo ou elemento. Indentação consistente de 2 espaços facilita a visualização da hierarquia. Processamento local no navegador sem envio de dados para servidores. Suporta XML com namespaces complexos, comuns em documentos fiscais. Facilita debug e análise de estruturas XML complexas com muitos níveis de aninhamento. Interface simples que permite copiar o resultado formatado com um clique.
Informações adicionais sobre XML fiscal
XML é o formato padrão para documentos fiscais eletrônicos no Brasil. Todos os web services da SEFAZ utilizam XML como formato de entrada e saída. A formatação correta é crítica: um único caractere fora do lugar pode causar rejeição na transmissão.
Os documentos seguem padrões técnicos definidos em Notas Técnicas do ENCAT. Cada tipo possui estrutura XML própria. A assinatura XMLDSig é obrigatória com certificado ICP-Brasil.