Rejeição 217: NF-e não encontrada. Confira a consulta antes de reenviar

Se um Web Service retornou a rejeição 217, confira a chave, o ambiente e o serviço consultado antes de transmitir a nota novamente. A mensagem informa que o documento não foi localizado naquela consulta. Ela, sozinha, não prova que a operação ficou sem nota autorizada.

Se o código apareceu na consulta da NFC-e (modelo 65)

Na consulta pública da NFC-e, o código 217 indica dia de emissão inválido no QR Code, não cStat de nota inexistente. Nas versões 2 e 3, o dia é o quarto parâmetro somente no modo offline, com dois dígitos correspondentes à emissão original. Confira versão, modo, chave e ambiente antes de corrigir o gerador. Não acrescente esse parâmetro ao QR online, altere o XML autorizado ou reemita a nota por esse aviso. Manual DANFE NFC-e v6.0, seções 4.3, 4.4 e 5.3.

Se o código apareceu na consulta da NF-e 55 Tipo 2

Na consulta pública da NF-e modelo 55 com DANFE Simplificado Tipo 2, o código 217 também indica dia de emissão inválido no QR Code. No QR off-line, confira o dia em dois dígitos contra a emissão original e regenere o QR Code. Não reemita a nota por esse aviso. NT 2026.003, seções 4.3 e 5.3.

O que significa a mensagem

Na consulta de situação (NfeConsultaProtocolo), o retorno é “Rejeição: NF-e não consta na base de dados da SEFAZ”. A J03 pesquisa CNPJ/CPF do emitente, modelo, série e número; se não localizar a nota, verifica também a base EPEC. A 217 ocorre quando nenhum deles é encontrado. O serviço atende NF-e e NFC-e. MOC, seção 5.4

Na distribuição por chave (consChNFe), a H142 retorna “Rejeição: NF-e inexistente para a chave de acesso informada”. Esse ramo é do modelo 55 no Ambiente Nacional; não autoriza notas nem distribui NFC-e. NT 2014.002 v1.40, página 11

Identifique a resposta original: a tela de emissão ou cancelamento pode mostrar uma consulta auxiliar. Ela não identifica, sozinha, o serviço responsável.

Por que isso acontece

Investigue principalmente estas situações:

• A nota foi enviada em produção, mas a consulta ocorreu em homologação, ou o contrário

• A chave consultada não corresponde ao XML efetivamente transmitido

• A autorização ainda não foi concluída ou houve rejeição anterior que precisa ser tratada

• A resposta original se perdeu, e o sistema está consultando um documento diferente do que foi recebido pela SEFAZ

• O documento está no autorizador, mas ainda não chegou à base usada na distribuição

Verifique falhas de comunicação nos registros, sem presumir indisponibilidade da SEFAZ ou sincronização imediata entre consulta nacional e autorizador.

O que conferir antes de corrigir

1. Guarde o XML enviado, a resposta completa, o horário, o endereço do serviço e eventual protocolo ou recibo anterior.

2. Compare a chave consultada com a do XML original, sem reconstruí-la a partir de dados alterados depois do envio.

3. Confira modelo, emitente, série, número, UF e ambiente. Produção e homologação têm bases distintas.

4. Consulte a situação no canal oficial correspondente ao modelo e ao autorizador. Para NFC-e, use a consulta indicada pela SEFAZ da UF.

5. Examine o primeiro retorno da autorização. Uma mensagem de consulta posterior pode estar escondendo a rejeição que realmente impediu o primeiro envio.

Esses passos ajudam a distinguir ausência de autorização, erro de consulta e falha de sincronização. A orientação de consultar antes de retransmitir também aparece no atendimento da IOB para NFC-e. IOB, diagnóstico da 217 no PDV

Como resolver em cada cenário

A consulta foi feita no ambiente ou no autorizador errado

Corrija a configuração da consulta para o ambiente e o serviço que atendem aquele documento. Faça uma nova consulta com a chave original e compare o resultado com o registro interno.

Não altere o ambiente do XML já emitido para fazê-lo coincidir com uma consulta incorreta. Se uma emissão de teste tiver sido usada por engano em uma operação real, a regularização precisa ser analisada separadamente.

O documento aparece autorizado no canal oficial

Recupere a resposta de autorização e vincule-a ao XML original preservado, com ajuda do suporte quando necessário. Confira se destinatário, produtos, valores e operação são os mesmos. Depois, sincronize o estado do emissor.

Não gere outra nota por falta de retorno; esclareça o documento existente. Consultar a situação não garante acesso ao XML completo para download.

O primeiro envio foi rejeitado ou não chegou a ser concluído

Trate a causa comprovada no retorno de autorização. Se os registros mostrarem que o documento não foi autorizado, o suporte pode retomar o fluxo apropriado de envio, preservando o histórico e o controle fiscal da operação.

Se houver apenas uma resposta ausente ou contraditória, mantenha o caso em verificação. Não use “não encontrado” em uma única consulta como autorização automática para trocar número, série ou chave.

A nota está autorizada, mas a distribuição por chave retorna 217

Confira se a chamada é consChNFe no NFeDistribuicaoDFe e se a chave é de modelo 55. Compare com a consulta do autorizador e com o XML fornecido pelo emitente. A distribuição depende da recepção pelo Ambiente Nacional; a documentação não exige sincronização em tempo real. NT 2014.002 v1.40, seções 3.5 a 3.7

O suporte deve acompanhar essa diferença respeitando as regras de uso do serviço. Não faça consultas contínuas nem tente nova emissão para obter um arquivo que já existe. Se a resposta mudar para um problema de prazo, permissão ou manifestação, trate o novo código: esses controles não são sinônimos de 217.

A mensagem surgiu durante um cancelamento ou outro evento

Peça ao suporte para separar o retorno do evento do retorno da consulta auxiliar. Confirme primeiro a nota e sua situação. Não conclua que houve cancelamento, nem repita o evento, apenas porque a tela mostrou 217.

Exemplo hipotético

Uma distribuidora autoriza a NF-e 1.426, série 2, para uma entrega. Após importar os pedidos em outro sistema, a venda fica associada à chave de um rascunho de número 1.427, que nunca foi transmitido. A consulta desse rascunho retorna 217.

A equipe compara a venda com os arquivos preservados e encontra o XML e o protocolo da nota 1.426. A consulta da chave correta confirma a autorização. O suporte corrige a associação do pedido, sem transmitir o rascunho nem criar uma segunda nota para a entrega.

Como confirmar que foi resolvido

Confira chave, ambiente, autorizador e conciliação da situação comprovada. Preserve XML e retornos; se buscava distribuição, confirme o recebimento do arquivo.

Acione o suporte diante de respostas divergentes, XML ausente ou transmissão incerta. Envolva a contabilidade diante de duplicidade ou circulação sem situação fiscal esclarecida.

Referências

Revisão: 09/10/2026. Orientação de diagnóstico; disponibilidade, sincronização e procedimentos de atendimento precisam ser conferidos no autorizador do caso. Não representa teste de funcionamento em todas as UFs.

• MOC 7.0, Visão Geral, seção 5.4 e regra J03: https://www.confaz.fazenda.gov.br/legislacao/arquivo-manuais/moc7-visao-geral.pdf

• NT 2014.002 v1.40, distribuição por chave, regra H142: https://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=uWO2d%2FgTuWg%3D

• Oobj, consulta no ambiente correto e verificação da autorização: https://oobj.com.br/bc/rejeicao-217-como-resolver/

• TecnoSpeed, diagnóstico por consulta e sincronização: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360014552413-NFe-Como-resolver-a-Rejei%C3%A7%C3%A3o-217-NF-e-n%C3%A3o-consta-na-base-de-dados-da-SEFAZ

• IOB, consulta antes de retransmitir NFC-e: https://aprendo.iob.com.br/ajudaonline/artigo.aspx?artigo=6355