Consultar NFCom

GET/v1/nfcom/{id}

Consulta o status atual de uma NFCom 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 uma NFCom: a emissão é assíncrona (retorna 202 Accepted antes de qualquer confirmação da SEFAZ), então é aqui que você descobre se o documento foi de fato autorizado ou rejeitado.

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 da NFCom, quando aplicável.

eventsarray

Histórico de eventos síncronos já registrados no documento.

cURL

curl https://app.nfe.tenzanlabs.com/v1/nfcom/62f0a1b2-... \
  -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('62', invoiceId);
console.log(resposta.status); // 'AUTORIZADA'

Python

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

Java

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

Exemplo de resposta

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