Skip to main content

Visão Geral

As consultas relacionadas à NFC-e (Nota Fiscal de Consumidor Eletrônica) permitem verificar a situação da nota fiscal junto à SEFAZ, acompanhar o processamento de uma emissão e monitorar a disponibilidade dos serviços do ambiente autorizado. Essas consultas garantem maior controle e confiabilidade nas operações de emissão e validação de documentos fiscais eletrônicos.

Existem três tipos principais de consultas disponíveis:

1. Consulta de NFC-e​

A Consulta de NFC-e permite obter informações completas sobre uma nota fiscal já emitida.
Essa rota é utilizada para confirmar se uma NFC-e foi autorizada pela SEFAZ e recuperar detalhes como número, série, chave de acesso, data de emissão e situação atual do documento (autorizada, cancelada, denegada, etc).

  • Uso comum: confirmar se uma NFC-e foi efetivamente registrada e validada pela SEFAZ.
  • Requisito principal: chave de acesso da NFC-e (chNFe).
  • Retorno esperado: dados completos da nota e status da autorização.

2. Consulta de Processamento​

A Consulta de Processamento é utilizada quando a transmissão de uma NFC-e foi realizada, mas a resposta da SEFAZ ainda não foi recebida.
Ela permite acompanhar o andamento do processamento de uma nota em contingência ou em caso de lentidão nos servidores da SEFAZ.

  • Uso comum: acompanhar o status de um envio pendente de retorno.
  • Requisito principal: número do recibo (nRec) retornado na tentativa de envio.
  • Retorno esperado: status atual do processamento (em processamento, autorizado, rejeitado, etc).

3. Consulta de Status de Serviço​

A Consulta de Status de Serviço verifica se o ambiente da SEFAZ (Autorização, Retorno, Inutilização, etc.) está operacional.
Essa rota é essencial para determinar se as operações de emissão podem ocorrer normalmente ou se é necessário acionar um modo de contingência.

  • Uso comum: monitorar a disponibilidade da SEFAZ antes de efetuar novas emissões.
  • Requisito principal: UF do emitente (cUF) e ambiente (tpAmb).
  • Retorno esperado: status do serviço (107 - Serviço em Operação, 108 - Serviço Paralisado Temporariamente, 109 - Serviço Paralisado sem Previsão, etc).

Essas consultas são fundamentais para o funcionamento seguro e confiável do processo de emissão de NFC-e, permitindo que o sistema identifique rapidamente falhas de comunicação, contingências ou inconsistências no retorno da SEFAZ.