Validador de NF-e (regras da SEFAZ)

Valide uma NF-e antes que o seu sistema a envie à SEFAZ, ou uma que um fornecedor mandou: o schema da NF-e 4.00 e depois 353 das regras de rejeição da SEFAZ, da chave de acesso aos totais e ao IBS e à CBS da reforma tributária, com cada ocorrência na sua linha e o seu código de rejeição. Nada é enviado.

A NF-e no Brasil em resumo

O Brasil adotou a nota fiscal eletrônica muito antes da maioria dos países. A NF-e (Nota Fiscal Eletrônica, modelo 55) é o documento da venda e da circulação de mercadorias; a primeira foi autorizada em 14 de setembro de 2006. As vendas ao consumidor no balcão usam a NFC-e (modelo 65), e os serviços a NFS-e. O emitente assina o XML com um certificado ICP-Brasil e o envia à SEFAZ do seu estado, que o valida e responde com um protocolo de autorização ou uma rejeição numerada antes de a mercadoria sair. Um resumo impresso com a chave de acesso de 44 dígitos, o DANFE, acompanha a mercadoria.

A reforma tributária da Emenda Constitucional 132/2023 e da Lei Complementar 214/2025 substitui PIS, COFINS, ICMS e ISS pela CBS (federal) e pelo IBS (estados e municípios). Em 2026 os dois são cobrados com alíquotas de teste, 0,9% de CBS e 0,1% de IBS, compensadas com PIS e COFINS; os contribuintes que cumprem as obrigações acessórias ficam dispensados do recolhimento, e as alíquotas não se aplicam às empresas do Simples Nacional (LC 214/2025, artigos 343, 346 e 348). A partir de 2027 a CBS toma o lugar de PIS e COFINS; ICMS e ISS diminuem a partir de 2029 e acabam em 2033. A NT 2025.002 acrescentou o grupo de IBS e CBS à NF-e, e desde 3 de agosto de 2026 as SEFAZ rejeitam a NF-e de uma empresa do regime normal (CRT 3) sem ele.

Como validar uma NF-e

  1. Abra o validador com o perfil de NF-e. Uma NF-e aberta ou colada escolhe o perfil sozinha: NF-e 4.00 para o documento sozinho, NF-e 4.00 com protocolo de autorização para um arquivo nfeProc.
  2. Cole o XML ou arraste o arquivo e clique em Validate.
  3. Cada ocorrência indica o seu código de rejeição da SEFAZ; clique nele para ver a regra e o que costuma causá-la.

O que é verificado

Primeiro os schemas do Pacote de Liberação 010f, depois as nossas regras, escritas a partir das regras de validação do Manual de Orientação do Contribuinte (Anexo I) e das Notas Técnicas que as alteraram, até a NT 2026.010. Cada regra traz o código com que a SEFAZ responde e a sua descrição em português: a chave de acesso corresponde aos campos que a compõem e ao seu dígito verificador (NFE-502), o valor de um item é a quantidade vezes o preço (NFE-629), o ICMS é a base vezes a alíquota (NFE-528), o vNF fecha com os totais (NFE-610), o IBS estadual e a CBS resultam da sua base e das alíquotas (NFE-1041, NFE-1069), e uma venda não presencial informa se houve intermediador (NFE-434). CNPJs, inclusive os novos alfanuméricos, CPFs e GTINs são verificados pelos dígitos verificadores, os CFOPs pela direção e pelo destino da operação, e os itens contra os totais. As regras da NT 2026.002 para o DANFE Simplificado Tipo 2 valem quando tpImp é 6.

As regras que começam em uma data valem pela data de emissão, com as datas de homologação para documentos de teste. A SEFAZ também verifica o que um arquivo sozinho não mostra: o cadastro do emitente e do destinatário, as suas tabelas (CFOP, NCM, cClassTrib, municípios), os dígitos verificadores da inscrição estadual, a duplicidade e a assinatura. Isso não é verificado aqui, e as regras que o manual deixa a critério de cada UF são avisos.

Perfis para verificar

As regras mais violadas

Cada uma tem uma página com o que verifica, o seu teste e, em muitos casos, como corrigir.

  • NFE-502: Rejeição: Erro na Chave de Acesso - Campo Id não corresponde à concatenação dos campos correspondentes (Id …, campos NFe……).
  • NFE-629: Rejeição: Valor do Produto difere do produto Valor Unitário de Comercialização e Quantidade Comercial [nItem: …] (vProd …, qCom × vUnCom …).
  • NFE-528: Rejeição: Valor do ICMS difere do produto BC e Alíquota [nItem: …] (vICMS …, vBC × pICMS …).
  • NFE-610: Rejeição: Total da NF difere do somatório dos Valores compõe o valor Total da NF (vNF …, calculado …).
  • NFE-1041: Rejeição: Valor do IBS da UF difere do calculado [nItem: …] (vIBSUF …, calculado …).
  • NFE-1069: Rejeição: Valor da CBS difere do calculado [nItem: …] (vCBS …, calculado …).
  • NFE-434: Rejeição: NF-e sem indicativo do intermediador (indPres …).

Perguntas

A nota é enviada para um servidor?

Não. A verificação do schema e as regras rodam no seu navegador. Só a API e os monitores de URL validam nos nossos servidores.

Um resultado válido significa que a SEFAZ vai autorizar a NF-e?

Significa que a NF-e passa pelo schema e pelas regras da SEFAZ que precisam só do arquivo. A SEFAZ também consulta o seu cadastro e as suas tabelas e verifica o certificado e a assinatura, então ainda pode rejeitar o documento por algo que o arquivo sozinho não mostra.

Qual arquivo eu valido, a NF-e ou o nfeProc?

Qualquer um. O XML que o comprador recebe e que a maioria dos sistemas exporta é o nfeProc: a NF-e assinada com o protocolo de autorização da SEFAZ. Os dois são lidos, e as regras rodam sobre a NF-e que está dentro.

São as regras da própria SEFAZ?

São a nossa implementação das regras de validação que o manual e as Notas Técnicas publicam para todas as SEFAZ; as SEFAZ não publicam o seu código. Testamos as regras em NF-e autorizadas de produção, nas quais não encontram nada.

Posso validar notas pelo código?

Sim: com a API e o cliente de linha de comando com --schema nfe-4.00-proc, ou --schema auto para uma pasta com arquivos de vários tipos.

Fontes oficiais

Outros países