Consultar NFSe Nacional

GET/v1/nfse/{id}

Consulta o status atual de uma NFS-e Nacional 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 NFS-e: a emissão é assíncrona (retorna 202 Accepted antes de qualquer confirmação do ambiente nacional), 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 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. 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, quando aplicável.

eventsarray

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

cURL

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

Python

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

Java

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

Exemplo de resposta

{
  "id": "e5f0a1b2-...",
  "accessKey": "35260812345678000199NFSE10000000011000000018",
  "status": "AUTORIZADA",
  "protocolNumber": "135260000123456",
  "updatedAt": "2026-08-19T15:04:32.000Z",
  "qrCodeUrl": null,
  "events": []
}