Consultar nota fiscal
Consulta o status da NFS-e diretamente na prefeitura e reconcilia o resultado no Spedy.
Use esta consulta para reconciliar uma nota cujo status no Spedy pode estar desatualizado em relação à prefeitura:
- Nota marcada como Rejeitada no Spedy mas que consta autorizada na prefeitura.
- Nota cujo acompanhamento automático pós-envio esgotou as tentativas (a prefeitura demorou a processar) e ficou travada — a consulta destrava o processamento.
Para apenas acompanhar o status (polling): se você não usa webhooks e precisa verificar o status periodicamente,
use Obter NFS-e (GET /v1/service-invoices/{id}) — retorna o status atual da nota sem acionar a prefeitura.
Reserve este check-status para os casos de reconciliação/destrave acima.
Quando NÃO usar: não serve para “furar a fila” e forçar a emissão na hora. Enquanto a nota está enfileirada para emissão (ainda não enviada à prefeitura), o endpoint responde HTTP 400 — aguarde o processamento. Só há status a consultar depois que a nota foi enviada à autoridade.
Authorizations
Authorization By X-Api-Key inside request's header
Path Parameters
Response
OK
ID da NF
ID de integração
Valores possíveis:
- created: Criada — aguarda emissão explícita via issue ou gatilho automático (ex: afterPayment)
- enqueued: Enfileirada para processamento junto à SEFAZ ou Prefeitura
- received: Recebido
- authorized: Autorizado
- inContingent: Em contingência
- rejected: Rejeitado
- canceled: Cancelado
- denied: Denegado
- removed: Removido
- disabled: Inutilizado
created, enqueued, received, authorized, inContingent, rejected, canceled, denied, removed, disabled Valores possíveis:
- productInvoice: NF-e
- consumerInvoice: NFC-e
- serviceInvoice: NFS-e
productInvoice, consumerInvoice, serviceInvoice Valores possíveis:
- production: Produção
- development: Homologação
- simulation:
production, development, simulation Data de emissão
Data de competência
Dados de autorização da nota fiscal
Valor total da NF
Número