Guia: erros comuns em XML de NF-e

O que a chave de acesso significa, como os totais fecham e quais problemas o validador do NF-e Lab costuma apontar.

A chave de acesso

A chave tem 44 dígitos, e cada trecho tem um significado: UF do emitente (2), ano e mês de emissão no formato AAMM (4), CNPJ do emitente (14), modelo (2), série (3), número da nota (9), tipo de emissão (1), código numérico (8) e dígito verificador (1).

O dígito verificador é calculado por módulo 11 sobre os 43 primeiros dígitos. Os erros mais comuns:

Dígito verificador errado: alguém editou um campo à mão e não recalculou a chave.
Chave diferente do conteúdo: o Id do infNFe (que começa com NFe) não bate com a UF, a data, o CNPJ, a série ou o número do próprio XML.
Espaços ou pontos na chave: a chave deve ter só dígitos.

Totais que não fecham

O grupo total/ICMSTot precisa ser coerente com os itens. Verifique estes pontos:

vProd é a soma dos vProd dos itens (apenas os que compõem o total, indTot igual a 1).
vNF parte de vProd, subtrai o desconto (vDesc) e o ICMS desonerado (vICMSDeson) e soma ST, frete, seguro, outras despesas, II e IPI.
A soma dos pagamentos (vPag) deve conferir com o valor da nota.
Frete, desconto e outras despesas rateados entre os itens precisam somar o valor informado no total, sem sobras de centavos.

Cadastro e endereços

CNPJ e CPF: devem ter 11 ou 14 dígitos válidos, com os dígitos verificadores corretos.
Código do município: usa o código de 7 dígitos do IBGE, e os dois primeiros dígitos têm de corresponder à UF do endereço.
Inscrição estadual: cada UF tem seu algoritmo. O NF-e Lab valida apenas o formato.

Itens e impostos

NCM: 8 dígitos.
CFOP: 4 dígitos, compatível com a operação (dentro ou fora do estado).
Grupo de ICMS: o grupo precisa ser compatível com o regime do emitente. No Simples Nacional usam-se CSOSN (por exemplo 102); no Regime Normal usam-se CST (por exemplo 00).
PIS e COFINS: o CST escolhido define quais campos são obrigatórios.

Estrutura e assinatura

Namespace e versão: o elemento raiz deve usar o namespace da NF-e e a versão 4.00.
Ordem dos elementos: o XSD exige uma ordem específica; trocar elementos de lugar gera rejeição mesmo com valores corretos.
Assinatura: o XML do NF-e Lab não é assinado. Para uma nota real, a assinatura XMLDSig com certificado digital é obrigatória.

O validador do NF-e Lab faz uma análise estrutural e de consistência. Ele não substitui o XSD oficial nem a validação da SEFAZ.

Teste agora

Gere uma nota de exemplo no gerador ou cole um XML existente no validador para ver erros, avisos e verificações aprovadas.