Onde o XML ainda aparece
Mesmo com o JSON dominando as APIs modernas, o XML continua no dia a dia das empresas:
- Nota fiscal eletrônica (NF-e, NFC-e, CT-e e NFS-e): o documento fiscal é um arquivo XML assinado digitalmente.
- Integrações SOAP: serviços de bancos, órgãos públicos e ERPs mais antigos.
- Arquivos de configuração: sistemas Java e .NET, servidores de aplicação.
- Sitemaps e feeds: o sitemap.xml que informa ao Google as páginas do site e os feeds RSS.
- Documentos do Office: arquivos .docx e .xlsx são, por dentro, pacotes de XML.
Os erros de sintaxe mais comuns
- Tag sem fechamento: toda tag aberta precisa ser fechada (
<nome>...</nome>) ou ser autofechada (<item />). - Tags cruzadas:
<a><b></a></b>é inválido. A última tag aberta precisa ser a primeira fechada. - Diferença de maiúsculas:
<Nome>e</nome>são tags diferentes. - Caractere & sem escape: em textos, use
&no lugar de &, e<no lugar de <. É um erro frequente em razão social e endereço, como "Silva & Filhos". - Mais de um elemento raiz: o documento precisa ter um único elemento que envolva todos os outros.
- Atributos sem aspas:
<item id=1>é inválido; o correto é<item id="1">. - Texto antes da declaração: nada pode vir antes de
<?xml ...?>, nem mesmo um espaço ou um caractere invisível (BOM) adicionado por alguns editores.
Cuidado com XML assinado
Documentos com assinatura digital, como o XML de uma nota fiscal autorizada, não podem ser alterados: qualquer mudança, inclusive de espaços e quebras de linha, invalida a assinatura. Use a versão formatada desta ferramenta só para ler e conferir o conteúdo. Para armazenar, enviar ao contador ou importar em outro sistema, use sempre o arquivo original.
Bem formado não é o mesmo que válido
Esta ferramenta confere se o XML está bem formado, ou seja, se respeita as regras de sintaxe. Um XML bem formado ainda pode ser rejeitado por um sistema se não seguir o schema (XSD) esperado, por exemplo um campo obrigatório ausente ou um valor em formato errado. Nesse caso, a mensagem de erro do sistema de destino costuma indicar qual campo não confere.
Perguntas frequentes
O XML que eu colo aqui é enviado para algum servidor?
Não. A formatação e a validação acontecem no seu navegador.
Posso usar esta ferramenta para ler o XML de uma nota fiscal?
Pode, para visualizar o conteúdo de forma organizada. Mas não use o arquivo formatado no lugar do original, porque a alteração invalida a assinatura digital da nota.
O XML está bem formado aqui, mas o sistema rejeita. Por quê?
Provavelmente ele não segue o schema (XSD) que o sistema espera: um campo obrigatório ausente, uma tag com nome diferente ou um valor em formato inválido. A ferramenta confere a sintaxe, não as regras de cada sistema.
O que é namespace no XML?
É um prefixo associado a um endereço (por exemplo xmlns="http://www.portalfiscal.inf.br/nfe") que identifica a qual padrão as tags pertencem. Evita conflito entre tags com o mesmo nome definidas por padrões diferentes.