Validador de XML NF-e

Como funciona

• O validador lê o elemento raiz do XML e escolhe o XSD: nfeProc (nota autorizada), NFe (nota sem protocolo) ou enviNFe (lote de envio). Veja o que cada raiz é.
• A validação usa o pacote PL_010_V1.30 da Sefaz, incluindo grupos de IBS/CBS da reforma tributária quando presentes no XML.
• O processamento ocorre no servidor só para esta requisição; o conteúdo do XML não é salvo nem enviado ao Google Analytics.

O que são NFe, nfeProc e enviNFe?

Os três nomes são elementos raiz do XML da NF-e modelo 55, no namespace da Sefaz, versão 4.00. O validador lê essa raiz e aplica o XSD correspondente.

• NFe — a nota em si (infNFe: emitente, destinatário, itens e totais), com a tag de assinatura. Sem protocolo de autorização. É o XML que o emissor monta antes de transmitir. Schema nfe_v4.00.xsd.
• nfeProc — a NF-e processada: a nota (NFe) mais o protocolo de autorização (protNFe) devolvido pela Sefaz. É o arquivo que se arquiva e se envia ao destinatário depois da autorização. Schema procNFe_v4.00.xsd.
• enviNFe — o pedido de autorização: idLote, indicador de processamento síncrono (indSinc) e uma ou mais notas NFe (até 50). Envelope que o webservice de autorização recebe; o protocolo não está nesse arquivo. Schema enviNFe_v4.00.xsd.

O que este validador verifica?

A conferência é estrutural: o XML precisa ser legível pelo parser e obedecer ao XSD oficial da NF-e modelo 55, versão 4.00, no pacote PL_010_V1.30.

• XML bem formado — tags fechadas, encoding e sintaxe que permitam o parse do documento.
• Estrutura do documento — raiz reconhecida: nfeProc, NFe ou enviNFe no namespace da NF-e.
• Schema NF-e 4.00 — leiaute modelo 55 conforme o XSD selecionado para a raiz do arquivo.
• Campos e tags incompatíveis com o XSD — obrigatórios ausentes, ordem incorreta, tipos inválidos, valores fora de enumerações permitidas e namespace divergente.

Validador XML NF-e e Reforma Tributária

Os schemas mais recentes da NF-e 4.00 incluem os grupos criados para a Reforma Tributária do Consumo, como informações de IBS e CBS.

Quando esses campos estiverem presentes no XML, o validador verifica se sua estrutura está de acordo com o XSD utilizado pela ferramenta. Isso permite identificar, por exemplo:

• grupos IBS/CBS em posição não permitida pelo schema;
• tags obrigatórias ausentes dentro do grupo;
• campos com tipo ou formato incompatível;
• elementos da Reforma Tributária enviados para um schema que não os reconhece.

Essa validação é estrutural. Ela não confirma se o CST, o cClassTrib, a base de cálculo, as alíquotas ou os valores de IBS/CBS estão fiscalmente corretos.

Para essas verificações adicionais, use a Auditoria de XML da NF-e e consulte o guia IBS e CBS na NF-e em 2026.

O que este validador não verifica?

Passar no XSD é um passo antes do envio, mas não substitui os serviços da Sefaz nem a análise fiscal da operação. Itens abaixo ficam fora do escopo desta ferramenta.

• Autorização da Sefaz — código de status (cStat), protocolo de autorização ou rejeição após o envio do lote.
• Situação fiscal da nota — consulta de situação, cancelamento, denegação ou eventos posteriores à emissão.
• Assinatura digital — validade do certificado, integridade da assinatura XML ou cadeia de confiança.
• Regras de negócio que o XSD não cobre — coerência CST × CFOP, totais da nota, duplicidade de chave, regras por UF ou validações do ambiente de autorização.
• Outros documentos — NFC-e (modelo 65), carta de correção, inutilização de numeração e demais eventos com schemas próprios.

Seu XML apresentou “Falha no Schema”?

Quando a Sefaz rejeita o envio por falha de schema, o XML não está conforme o XSD vigente — tags fora do leiaute, campos obrigatórios faltando ou tipos incorretos. Este validador reproduz a mesma conferência estrutural no pacote PL_010_V1.30 para você corrigir o arquivo antes de transmitir de novo.

Algumas falhas comuns:

• Rejeição 215: Falha no Schema XML (ou cStat 215) — retorno genérico da Sefaz quando o XSD falha; a mensagem não indica a tag. Cole o XML aqui para ver o erro com linha antes de retransmitir.
• Opening and ending tag mismatch ou Premature end of data in tag — XML malformado: tag não fechada, arquivo cortado ou encoding incompatível.
• Elemento raiz não reconhecido — o arquivo não começa com nfeProc, NFe ou enviNFe no namespace da NF-e.
• This element is not expected — tag fora de ordem, nome errado ou pacote XSD desatualizado. Na reforma tributária é comum ver Element '{http://www.portalfiscal.inf.br/nfe}IBSCBS': This element is not expected ou, em validadores .NET/ACBr, invalid child element 'IBSCBS' com List of possible elements expected: 'COFINSST, ICMSUFDest'. Confira o pacote PL_010_V1.30 e o guia IBS e CBS na NF-e em 2026.
• [facet 'pattern'] The value '…' is not accepted by the pattern — formato inválido (por exemplo o Id de infNFe fora do padrão NFe + 44 dígitos) ou … is not a valid value of the atomic type (decimal com vírgula, data fora do padrão).
• Missing child element(s). Expected is ( … ) — grupo ou campo obrigatório ausente no leiaute 4.00.

Perguntas frequentes

O que significa “Falha no Schema” na Sefaz?

É a rejeição porque o XML não obedece ao XSD da NF-e na versão exigida no ambiente de autorização. Não indica sozinho qual tag está errada — use o resultado deste validador (mensagem e linha do erro) e a seção Falha no Schema acima para orientar a correção no ERP ou no emissor.

O validador verifica IBS e CBS da Reforma Tributária?

O validador verifica a estrutura dos grupos de IBS/CBS quando eles estão presentes no XML e fazem parte do XSD utilizado. Ele identifica problemas de schema, como tags ausentes, ordem incorreta ou formatos incompatíveis. Não verifica se CST, cClassTrib, bases, alíquotas ou valores dos tributos estão fiscalmente corretos.

Erro “IBSCBS: This element is not expected”: o que significa?

Esse erro indica que o schema usado na validação não esperava o grupo IBSCBS naquela posição ou naquela versão do leiaute. Verifique se o XML e o pacote de schemas utilizados estão compatíveis com a versão vigente da NF-e.

Valida NFC-e (cupom fiscal)?

Não nesta versão. O pacote atual é de NF-e modelo 55. NFC-e exige outro conjunto de schemas.

XML válido aqui garante autorização na Sefaz?

Não. A Sefaz aplica validações adicionais (certificado, duplicidade, regras por UF, etc.). Este utilitário ajuda a corrigir erros de leiaute antes do envio.

Por que meu ERP diz que está certo e aqui falha?

Versões de schema, namespace ou raiz diferente (por exemplo enviar NFe quando o arquivo é um nfeProc) geram resultados distintos. Confira o pacote PL_010_V1.30 e a NT em vigor.

Meus dados ficam no Utiliso?

O XML é usado só para validar na hora e descartado. Evite colar notas com dados sensíveis em ambientes compartilhados; prefira arquivos de homologação quando possível.