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
tpAmbchNFeO 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
- Confirme em qual ambiente a nota foi originalmente autorizada (homologação ou produção).
- Recupere o XML autorizado e leia o
<tpAmb>dentro do<ide>. Esse é o ambiente onde a consulta deve ser feita. - Se acabou de enviar o lote, espere alguns segundos e consulte o recibo (
consReciNFe) antes de tentar cancelar. - Para chaves digitadas manualmente, valide os 44 dígitos e o dígito verificador (último dígito) antes de retransmitir.
- 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
- Rejeição 203, Emissor não habilitado para emissão da NF-e
- Rejeição 204, Duplicidade de NF-e
- Rejeição 252, Ambiente informado diverge do Ambiente de recebimento
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