Consultar NFe / NFCe

GET/v1/nfe/{id}

Consulta o status atual de um documento fiscal a partir do seu invoiceId (o UUID retornado em invoiceId na emissão). Não recebe corpo nem query string — o único parâmetro é o id na própria URL.

Use este endpoint para fazer polling depois de emitir, cancelar ou corrigir um documento: essas três operações são assíncronas (retornam 202 Accepted antes de qualquer confirmação da SEFAZ), então é aqui que você descobre se o documento foi de fato autorizado, cancelado ou rejeitado.

Consultando NFC-e

Se o documento for uma NFC-e, use GET /v1/nfc-e/{id} em vez de /v1/nfe/{id} — a resposta é idêntica. O mesmo endpoint de consulta existe em todos os namespaces (/v1/cte/{id}, /v1/mdfe/{id}, etc.).

Parâmetros

Path

idstringobrigatório

UUID do documento (invoiceId retornado na emissão).

Resposta

200 OK

idstring

UUID do documento.

accessKeystring

Chave de acesso de 44 dígitos do documento fiscal.

statusstring

Valores aceitos: PENDENTE | AUTORIZADA | REJEITADA | CANCELADA | ENCERRADA | ERRO_TECNICO

Status atual do processamento.

protocolNumberstring

Número de protocolo de autorização retornado pela SEFAZ. Presente quando status é AUTORIZADA (ou posterior).

rejectionReasonstring

Motivo da rejeição, quando status é REJEITADA.

updatedAtstring

Data/hora da última atualização do status (ISO 8601).

qrCodeUrlstring

URL do QR Code (NFC-e/NFCom, quando aplicável).

eventsarray

Histórico de eventos síncronos já registrados no documento (encerramento de MDF-e, CC-e, cancelamentos, etc).

cURL

curl https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-... \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI"

Node.js

const resposta = await client.getInvoice('55', invoiceId);
console.log(resposta.status); // 'AUTORIZADA'

Python

resposta = client.get_invoice("55", invoice_id)
print(resposta["status"])  # 'AUTORIZADA'

Java

GetInvoiceResponse resposta = client.getInvoice("55", invoiceId);
System.out.println(resposta.status); // "AUTORIZADA"

Exemplo de resposta

{
  "id": "35f0a1b2-...",
  "accessKey": "35260812345678000199550010000000011000000018",
  "status": "AUTORIZADA",
  "protocolNumber": "135260000123456",
  "updatedAt": "2026-08-19T15:04:32.000Z",
  "qrCodeUrl": "https://www.homologacao.nfce.fazenda.sp.gov.br/...",
  "events": []
}