Guia Técnico Completo

Rejeições NFe: Códigos de Erro NFe

Tabela completa com códigos de rejeição da NFe, suas causas e como resolver. Essencial para quem precisa baixar XML de nota fiscal ou integrar sistemas fiscais.

40+ Códigos documentados
3 Tipos de consulta NFe
90d Prazo de download XML

Como Baixar o XML de uma Nota Fiscal Eletrônica

Antes de entender os erros, é importante conhecer o processo correto de download de XML de NFe. O acesso ao XML por chave e certificado permite que atores da nota fiscal, como emitente, destinatário, transportador e terceiros autorizados, localizem documentos fiscais eletrônicos de seu interesse.

Requisitos para baixar XML de NFe

🔐
Certificado Digital válido

A1 (arquivo .pfx) ou A3 (token/smartcard). O CNPJ-base do certificado deve coincidir com o CNPJ da empresa consultada.

🔑
Chave de acesso (44 dígitos)

Para consulta pontual por consChNFe. Deve ser uma chave válida com dígito verificador correto.

📋
CNPJ ou CPF do interessado

Necessário para consultas por NSU (distNSU e consNSU). O documento deve ser o mesmo do certificado digital.

⏱️
Prazo de 90 dias

Os XMLs podem ficar disponíveis por prazo limitado após a autorização. Após esse período, o download pode não ser mais possível (código 632).

Os 3 tipos de consulta de XML NFe

distNSU Distribuição por NSU

Baixa todos os documentos disponíveis a partir de um NSU informado. Ideal para sincronização contínua. Respeite o intervalo de 1 hora quando receber código 137.

consNSU Consulta NSU específico

Consulta um único NSU identificado como faltante na base. Usado para fechar lacunas na sequência de documentos recebidos.

consChNFe Consulta por chave

Busca uma NFe específica pela chave de acesso de 44 dígitos. Retorna apenas a NF-e, sem eventos. O interessado deve ser destinatário, transportador ou terceiro.

Prefere uma solução mais simples?

O iLoveXML simplifica esse processo: instale o Agente, informe sua chave de acesso e seu certificado digital e baixe o XML sem configurar serviços técnicos nem lidar manualmente com NSU.

Baixar XML agora →

Tabela Completa de Rejeições NFe

Códigos de erro de NFe com explicação e como resolver

Respostas de Processamento (Sucesso)

CódigoDescriçãoO que fazer
138
Documento(s) localizado(s)

Consulta realizada com sucesso. Os documentos foram retornados.

Processar os XMLs retornados e atualizar o ultNSU para a próxima consulta.
137
Nenhum documento localizado

Não há documentos novos para o CNPJ/CPF informado a partir do NSU consultado.

Aguardar no mínimo 1 hora antes de nova consulta. Consultas repetidas geram rejeição 656.
108
Serviço paralisado momentaneamente

O serviço de consulta está temporariamente indisponível.

Aguardar alguns minutos e tentar novamente. Implemente retry com backoff exponencial.
109
Serviço paralisado sem previsão

Indisponibilidade prolongada do serviço de consulta.

Consultar o Portal Nacional da NFe para informações sobre manutenção programada.

Rejeições de Certificado Digital

CódigoDescriçãoComo resolver
280
Certificado Transmissor inválido

O certificado não é versão 3, não define Autenticação Cliente, ou está ausente.

Utilize um certificado ICP-Brasil válido emitido por AC credenciada. Certificados autoassinados não são aceitos.
281
Certificado fora da validade

A data de início ou fim de validade do certificado digital não é válida.

Renovar o certificado digital junto à Autoridade Certificadora (AC) antes do vencimento.
283
Erro na cadeia de certificação

A AC emissora não está cadastrada, foi revogada, ou o certificado não está assinado pela AC.

Verificar se a AC emissora é credenciada pelo ICP-Brasil. Reinstalar a cadeia de certificação completa.
284
Certificado revogado

O certificado foi revogado pela Autoridade Certificadora emissora.

Emitir um novo certificado digital junto à AC. Certificados revogados não podem ser reativados.
285
Certificado não é ICP-Brasil

O certificado raiz difere da cadeia ICP-Brasil exigida para esse tipo de autenticação.

Usar apenas certificados emitidos por ACs credenciadas pelo ICP-Brasil.
286
Erro no acesso à LCR

A Lista de Certificados Revogados (CRL) está indisponível, inválida ou sem endereço definido.

Verificar conectividade de rede e firewall. O servidor deve ter acesso externo à URL da LCR da AC.
473
Certificado sem CNPJ ou CPF

A extensão OtherName com OID de CNPJ (2.16.76.1.3.3) ou CPF (2.16.76.1.3.1) não está presente no certificado.

Utilizar certificado de PJ (com CNPJ) ou PF (com CPF) emitido conforme padrão ICP-Brasil.
472
CPF do certificado difere do CPF consultado

O CPF no certificado digital é diferente do CPF informado na requisição XML.

Usar o mesmo CPF tanto no certificado quanto na tag CPF da requisição.
593
CNPJ-Base do certificado difere do CNPJ consultado

Os 8 primeiros dígitos do CNPJ no certificado são diferentes do CNPJ informado na requisição.

O certificado deve pertencer à empresa raiz (mesmos 8 dígitos iniciais). Uma filial pode ser consultada com o certificado da matriz.

Rejeições de Dados e Formato

CódigoDescriçãoComo resolver
214
Tamanho da mensagem excedido

O XML da requisição ultrapassou o limite de 10 KB estabelecido pelo sistema nacional.

Simplificar a mensagem de requisição. Normalmente indica erro de implementação no XML enviado.
215
Falha no Schema XML

O XML da requisição não está em conformidade com o Schema distDFeInt_v9.99.xsd.

Validar o XML contra o Schema XSD disponibilizado no pacote PL_NFeDistDFe_102 antes de enviar.
402
Codificação diferente de UTF-8

O XML foi enviado com codificação diferente de UTF-8 (ex.: ISO-8859-1, Latin-1).

Garantir que o XML seja gerado e enviado com encoding UTF-8. Verificar a declaração .
404
Prefixo de namespace não permitido

O XML utiliza prefixos em namespaces onde não é permitido.

Remover prefixos de namespace desnecessários. Seguir estritamente o Schema XSD.
238
Versão do XML superior à vigente

A versão informada no atributo versao é maior que a versão atual suportada.

Atualizar o sistema para a versão correta do Schema. Consultar a NT 2014.002 vigente.
239
Versão do XML não suportada

A versão do Schema informada não é mais suportada pelo sistema nacional.

Migrar para a versão atual do Schema conforme a nota técnica mais recente.
252
Ambiente divergente

O tpAmb (tipo de ambiente) informado na requisição difere do ambiente do serviço técnico acessado (Produção=1 / Homologação=2).

Verificar se está usando a URL correta: produção para tpAmb=1 e homologação para tpAmb=2.
489
CNPJ inválido

O CNPJ informado na tag CNPJ da requisição possui dígito verificador inválido ou é composto por zeros.

Verificar o CNPJ informado e recalcular os dígitos verificadores conforme algoritmo oficial do documento.
490
CPF inválido

O CPF informado na tag CPF da requisição possui dígito verificador inválido ou é composto por zeros.

Verificar o CPF informado e recalcular os dígitos verificadores conforme algoritmo oficial do documento.

Rejeições de Chave de Acesso (consChNFe)

CódigoDescriçãoComo resolver
236
Dígito verificador inválido

O último dígito da chave de acesso de 44 dígitos não confere com o cálculo do módulo 11.

Verificar se a chave foi copiada corretamente. A chave possui 44 dígitos numéricos sem espaços ou pontuação.
614
Código UF inválido

Os 2 primeiros dígitos da chave de acesso não correspondem a um código de UF válido.

Verificar se a chave está completa e correta. Confirmar com o emitente.
615
Ano inválido na chave

O ano informado na chave é anterior a 2006 ou maior que o ano corrente.

Confirmar a chave de acesso com o emitente da nota fiscal.
616
Mês inválido na chave

O mês informado na chave é 0 ou maior que 12.

Verificar se a chave de acesso está íntegra. Solicitar ao emitente o arquivo XML original.
617
CNPJ do emitente inválido na chave

O CNPJ embutido na chave de acesso é zerado ou tem dígito verificador inválido.

Confirmar a chave com o emitente. Pode indicar chave digitada incorretamente.
618
Modelo diferente de 55

A chave de acesso não pertence a uma NF-e (modelo 55). CT-e e outros documentos não são consultados por este método.

O consChNFe aceita apenas NF-e (modelo 55). Para CT-e, utilize o serviço técnico específico de CT-e.
619
Número da NF-e igual a zero

O campo de número da nota fiscal na chave de acesso está zerado.

Verificar a integridade da chave de acesso.
217
NF-e inexistente para a chave informada

Não existe nenhuma NF-e autorizada para a chave de acesso fornecida.

Confirmar a chave com o emitente. Verificar se a NF-e foi realmente autorizada ou se há erro de digitação.
632
Fora do prazo de download

A NF-e existe, mas foi autorizada há mais de 90 dias e pode não estar mais disponível para download.

Solicitar o XML diretamente ao emitente da nota. Após 90 dias, o download pode não estar mais disponível.
640
CNPJ/CPF sem permissão para consultar esta NF-e

O interessado não é emitente, destinatário, transportador ou terceiro autorizado (autXML) desta NF-e.

Verificar se o CNPJ/CPF correto está sendo informado. Apenas os atores da NF-e têm acesso ao documento.
641
NF-e indisponível para o emitente

O consChNFe não está disponível para o emitente da própria nota. Emitentes devem usar outros recursos.

O emitente deve manter seus próprios arquivos XML gerados no momento da emissão.
653
NF-e cancelada — arquivo indisponível

A nota fiscal foi cancelada e o XML da NF-e original não está mais disponível para download.

O evento de cancelamento ainda pode ser acessado. Verificar junto ao emitente.
654
NF-e denegada — arquivo indisponível

A nota fiscal foi denegada e o XML não está disponível para download.

Consultar o emitente. NF-e denegada indica irregularidade fiscal e não pode ser utilizada.

Rejeições de NSU (distNSU / consNSU)

CódigoDescriçãoComo resolver
589
NSU superior ao maior NSU disponível

O NSU informado na consulta é maior que o maior NSU disponível para o CNPJ/CPF.

Usar apenas NSUs retornados pelo próprio serviço (ultNSU). Nunca informar NSUs arbitrários.
656
Consumo Indevido — Bloqueio por 1 hora

O CNPJ pode ser bloqueado por uso indevido do serviço de consulta. Causas: consultar após receber código 137 sem esperar 1 hora, ou não usar a sequência correta de NSUs (ultNSU).

Aguardar 1 hora para desbloqueio automático. Implementar: (1) espera de 1h após código 137; (2) sempre usar o ultNSU retornado nas chamadas subsequentes.

Baixar XML de NFe sem Dor de Cabeça

Enquanto sistemas corporativos lidam com NSU, distNSU e erros de certificado, o iLoveXML simplifica tudo isso em 3 passos.

1
Instale o Agente iLoveXML

Um pequeno programa local que gerencia a comunicação segura com seu certificado digital. Compatível com Windows. Não requer configuração de servidor.

2
Selecione seu certificado digital

Suporte a certificados A1 (.pfx) e A3 (token/smartcard). A senha e a chave privada nunca saem do seu computador.

3
Informe a chave e baixe

Cole a chave de acesso de 44 dígitos e clique em baixar. O XML é processado com segurança e salvo no seu computador.

Grátis, sem cadastro, sem complicação

Usado por contadores e empresas de todo o Brasil para baixar XMLs de notas fiscais diariamente.

Acessar iLoveXML →

Dúvidas frequentes sobre download de XML NFe

Preciso de certificado digital para baixar XML?

Sim. O download de XML por chave de acesso exige certificado digital válido (A1 ou A3), pois a solicitação precisa ser assinada digitalmente. Porém, para converter XML já baixado em PDF DANFE, nenhum certificado é necessário — use nossa ferramenta de conversão gratuita.

Por quanto tempo posso baixar o XML de uma NFe?

Os documentos podem ficar disponíveis por até 90 dias após a autorização da nota. Após esse prazo, o código de rejeição 632 pode ser retornado e o download pode não estar mais disponível. Por isso, é fundamental baixar e arquivar os XMLs regularmente.

O que é NSU e como funciona?

NSU (Número Sequencial Único) é um contador usado para cada CNPJ ou CPF interessado. Cada documento fiscal (NF-e, evento de cancelamento, carta de correção, etc.) recebe um NSU incremental. Para baixar documentos novos, o sistema deve consultar a partir do último NSU recebido (ultNSU). O iLoveXML gerencia esse controle automaticamente.

Posso baixar XML de notas emitidas contra minha empresa?

Sim. Como destinatário, você tem acesso à NF-e após realizar a manifestação do destinatário (Ciência da Operação, Confirmação de Operação ou Operação não Realizada). Antes da manifestação, apenas o resumo da NF-e fica disponível. O evento de Cancelamento fica disponível mesmo sem manifestação prévia.

O emitente pode baixar o próprio XML pelo sistema emissor?

Em muitos casos, o emitente deve manter seus próprios arquivos XML gerados no momento da emissão ou acessar os canais apropriados do seu sistema emissor.

O que fazer se receber rejeição 656?

A rejeição 656 (Consumo Indevido) ocorre quando há consultas excessivas. O CNPJ pode ficar bloqueado por 1 hora automaticamente. Para evitar: aguarde 1 hora após receber código 137 antes de consultar novamente e sempre use o ultNSU retornado nas consultas subsequentes.