Existe um validador oficial de XML da NFS-e?

A validação oficial de autenticidade é feita pela consulta pública do Portal Nacional (nfse.gov.br), pela chave de acesso ou pelo QR Code do DANFSe. Já a validação estrutural é feita contra o schema XSD do layout vigente, publicado no próprio portal, e pode ser executada por qualquer ferramenta que valide XML contra XSD.

Qual a diferença entre XML bem formado e XML válido?

Bem formado significa que a sintaxe XML está correta: tags abertas e fechadas, aninhamento certo, encoding declarado. Válido significa que, além disso, o conteúdo obedece às regras do schema XSD — campos obrigatórios, ordem, tipos e tamanhos. Um arquivo pode ser bem formado e mesmo assim inválido.

Preciso validar todos os XMLs que recebo?

XMLs baixados diretamente do Portal Nacional já vêm autenticados pela origem e não precisam de conferência de autenticidade. A validação é necessária quando o arquivo chega por outro caminho — e-mail do prestador, sistema de terceiros ou importação manual.

Como validar o XML da NFS-e: validador, XSD e erros comuns

Q: Como saber se uma NFS-e é autêntica?

Pela consulta pública no Portal Nacional usando a chave de acesso de 50 dígitos, ou lendo o QR Code impresso no DANFSe. Se a nota aparece no portal com os mesmos valores do documento recebido, ela é autêntica. Um PDF por si só não prova nada.

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.

Disponível na Chrome Web Store

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.

Instalar no Chrome

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.