Como validar o XML da NFS-e: validador, XSD e erros comuns
Publicado em 17 de agosto de 2026
"Validar o XML" parece uma coisa só, mas são três perguntas diferentes — e quem mistura as três acaba procurando resposta no lugar errado.
As três validações
| Pergunta | O que checa | Onde se faz |
|---|---|---|
| Está bem formado? | Sintaxe: tags fechadas, aninhamento, encoding | Qualquer editor ou parser XML |
| Obedece ao schema? | Campos obrigatórios, ordem, tipos e tamanhos | Validação contra o XSD do layout vigente |
| É uma nota real? | Autenticidade e situação (ativa ou cancelada) | Consulta pública no nfse.gov.br |
Um arquivo pode passar nas duas primeiras e falhar na terceira — é o caso de um XML tecnicamente perfeito de uma nota que foi cancelada. E pode ser autêntico e ainda assim ser recusado na importação, se o sistema de destino valida contra uma versão antiga do layout.
1. Bem formado
É a checagem mais básica e a mais rápida: abra o arquivo em qualquer editor que entenda XML. Se ele reclama antes mesmo de você fazer qualquer coisa, o problema é sintaxe — normalmente encoding trocado (acentos virando caracteres estranhos) ou o arquivo truncado, salvo pela metade.
2. Válido contra o schema (XSD)
Aqui entra o contrato do documento. O XSD do layout vigente é publicado no Portal Nacional e define o que pode existir no arquivo. Se a validação falha, a mensagem aponta a tag culpada — e o significado de cada código está detalhado em falha de schema no XML da NFS-e.
Vale um alerta: valide sempre contra o XSD da versão correta. Boa parte dos falsos negativos vem de validar um XML novo contra um schema antigo — o arquivo está certo, o validador é que está desatualizado.
3. Autêntica de verdade
Esta é a que mais importa para quem recebe nota de terceiros, e a única que um arquivo sozinho nunca responde. Um PDF bonito não prova nada; um XML bem formado, também não.
A prova está na consulta pública do Portal Nacional, pela chave de acesso de 50 dígitos ou pelo QR Code impresso no DANFSe. Se a nota aparece no portal com os mesmos valores do documento que você recebeu, ela existe. Se não aparece, ou aparece com outro valor, você tem um problema real.
Para conferir a estrutura da chave antes mesmo de consultar, veja como consultar o XML da NFS-e no Portal Nacional.
NFSe Downloader — a melhor extensão para download de NFS-e em lote.
Sincronize XMLs autenticados via API oficial NFS-e Nacional (NT 008/2026). ZIP por mês ou destinatário. Sem licença atrelada ao computador.
O atalho que dispensa as três
Existe um caminho que torna a validação desnecessária na maior parte dos casos: não receber o XML de terceiros — buscá-lo na fonte.
O Ambiente de Dados Nacional (ADN) é a API oficial da Receita Federal que entrega as NFS-e diretamente ao destinatário, autenticadas pela origem. Uma nota que veio de lá já é, por construção, real, íntegra e no layout vigente — não há o que validar.
O NFSe Downloader é a extensão do Chrome que consome essa API com o seu certificado digital e devolve tudo em um ZIP: XML autenticado, PDF e uma planilha com uma linha por nota, incluindo a situação de cada uma (ativa ou cancelada). A conferência que exigiria abrir arquivo por arquivo passa a ser uma coluna na planilha.
Erros comuns e o que cada um significa
- Valida no portal mas falha ao importar — o sistema de destino usa layout antigo. Problema do fornecedor do software, não do arquivo.
- Acentos corrompidos — encoding. O arquivo foi salvo fora do UTF-8 declarado no cabeçalho.
- Chave não encontrada na consulta — chave digitada errada, nota de município que não aderiu ao padrão nacional, ou documento que nunca existiu.
- Nota existe mas está cancelada — o XML continua válido e íntegro; o que mudou foi a situação. É por isso que a situação precisa entrar na sua conferência, e não só o valor.
Artigos Relacionados
- Falha de schema no XML da NFS-e: o que significa e como resolver
- Como consultar e baixar o XML da NFS-e no Portal Nacional
- DANFSe v1.0: o que é o Documento Auxiliar da NFS-e
- Como cancelar e substituir NFS-e no Portal Nacional