Pular para o conteúdo
FazendaNota
Rejeição 217

NF-e não consta na base de dados da SEFAZ

Rejeição 217: NF-e não consta na base de dados da SEFAZ

Ambiente e autorizaçãoModelo 55RejeiçãoAtualizado em 15 de maio de 2026
Campos afetados:tpAmbchNFe

O que significa esta rejeição

Você tentou consultar uma NF-e, cancelar uma já emitida, transmitir uma Carta de Correção, ou executar um evento qualquer sobre uma chave de acesso, e a SEFAZ respondeu que aquela chave simplesmente não existe no ambiente solicitado. Não é um erro de assinatura nem de schema: a nota não está lá.

A pista mais comum é o ambiente. NF-e autorizada em tpAmb=2 (homologação) não aparece em tpAmb=1 (produção), e vice-versa. Eventos enviados ao ambiente errado tropeçam aqui.

Causas mais comuns

  • Consulta ou cancelamento feito no ambiente errado (homologação contra produção, ou o inverso).
  • Chave de acesso digitada manualmente com erro (faltou um dígito, trocou dois números).
  • Tentativa de cancelar uma nota cujo lote ainda está em processamento, antes da autorização.
  • Recibo de lote (nRec) processado, mas a SEFAZ devolveu rejeição no protocolo individual, e o operador tenta cancelar achando que foi autorizada.
  • Replicação atrasada entre SVRS/SVCAN e SEFAZ origem em janelas de contingência.

Regra de validação oficial

Os serviços de consulta de NF-e e de eventos validam que a chave de acesso informada existe no banco da SEFAZ autorizadora, no ambiente solicitado, antes de qualquer processamento. Se não existe, retorna 217 sem ler o restante do payload.

Exemplo XML, antes (errado)

<consSitNFe versao="4.00">
  <tpAmb>1</tpAmb>
  <xServ>CONSULTAR</xServ>
  <chNFe>31250612345678000199550010000158421000123456</chNFe>
</consSitNFe>

Exemplo XML, depois (correto)

<consSitNFe versao="4.00">
  <tpAmb>2</tpAmb>
  <xServ>CONSULTAR</xServ>
  <chNFe>31250612345678000199550010000158421000123456</chNFe>
</consSitNFe>

Passo a passo para corrigir

  1. Confirme em qual ambiente a nota foi originalmente autorizada (homologação ou produção).
  2. Recupere o XML autorizado e leia o <tpAmb> dentro do <ide>. Esse é o ambiente onde a consulta deve ser feita.
  3. Se acabou de enviar o lote, espere alguns segundos e consulte o recibo (consReciNFe) antes de tentar cancelar.
  4. Para chaves digitadas manualmente, valide os 44 dígitos e o dígito verificador (último dígito) antes de retransmitir.
  5. Reenvie a consulta ou o evento no ambiente correto.

Como o FazendaNota previne

O FazendaNota armazena o ambiente de cada nota e roteia automaticamente consultas e eventos para o webservice correto. O usuário não escolhe ambiente manualmente: o sistema usa o mesmo da autorização original.

Rejeições relacionadas

Referência oficial

Esta rejeição está descrita no Anexo I - Leiaute e Regra de Validação do Manual de Orientação do Contribuinte (MOC) v7.0 da NF-e, publicado pelo CONFAZ. Texto integral em https://www.confaz.fazenda.gov.br/legislacao/arquivo-manuais/moc7-visao-geral.pdf

Rejeições relacionadas