Consultar MDFe

GET/v1/mdfe/{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 um MDF-e: 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. Já os eventos de MDF-e — encerramento, inclusão de condutor e inclusão de DF-e — são síncronos e retornam o resultado da SEFAZ diretamente na resposta, sem necessidade de consulta adicional.

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) — não se aplica a MDF-e.

eventsarray

Histórico de eventos síncronos já registrados no documento (encerramento, inclusão de condutor, inclusão de DF-e, etc).

cURL

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

Python

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

Java

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

Exemplo de resposta

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