← Voltar para a página inicial

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

PerguntaO que checaOnde se faz
Está bem formado?Sintaxe: tags fechadas, aninhamento, encodingQualquer editor ou parser XML
Obedece ao schema?Campos obrigatórios, ordem, tipos e tamanhosValidaçã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.

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

Fontes

Aviso Importante

Este conteúdo é meramente informativo e não constitui assessoria contábil, tributária ou jurídica. A AITEKS SOLUÇÕES EM TECNOLOGIA LTDA não é um escritório de contabilidade, advocacia ou consultoria tributária. Para questões específicas sobre impostos, obrigações fiscais ou situações particulares, consulte sempre um contador ou advogado tributário habilitado. As informações aqui apresentadas podem estar desatualizadas ou não se aplicar ao seu caso concreto.

NFSe Downloader

A melhor extensão Chrome para download de NFSe em lote. Baixe XML do portal nfse.gov.br, organizados em ZIP por mês ou destinatário. Use em quantas máquinas quiser, sem licença atrelada ao computador.

Conhecer o NFSe Downloader

© 2026 NFSe Downloader por AITEKS SOLUÇÕES EM TECNOLOGIA LTDA. Todos os direitos reservados.