DANFE Etiqueta

GET/v1/nfe/{id}/danfe-etiqueta

Gera uma etiqueta de envio em base64 (PDF) a partir de um documento fiscal autorizado, no formato 100x150mm, contendo o código de barras da chave de acesso — pensada para impressão em impressoras de etiqueta usadas em logística e expedição.

Só se aplica a documentos com mod 55 (NF-e) ou 65 (NFC-e) que já estejam AUTORIZADA.

Gerando etiqueta de NFC-e

Se o documento for uma NFC-e, use GET /v1/nfc-e/{id}/danfe-etiqueta em vez de /v1/nfe/{id}/danfe-etiqueta — o restante do contrato é idêntico.

Não é o DANFE completo

Esta etiqueta usa um layout próprio, pensado para envio/logística — ela não é o DANFE completo regulado pela SEFAZ (que segue o layout do Manual de Orientação do Contribuinte). Para o DANFE completo, use os canais habituais de impressão do documento fiscal.

Parâmetros

Path

idstringobrigatório

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

Resposta

200 OK

statusstring

Status atual do documento fiscal.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

chave_nfestring

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

numerostring | number

Número do documento fiscal.

seriestring | number

Série do documento fiscal.

danfe_etiqueta_base64string

Etiqueta 100x150mm em base64 (PDF), pronta para impressão.

cURL

curl https://app.nfe.tenzanlabs.com/v1/nfe/35f0a1b2-.../danfe-etiqueta \
  -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.getShippingLabel('55', invoiceId);
console.log(resposta.danfe_etiqueta_base64.slice(0, 20)); // 'JVBERi0xLjQKJdPr6eEK...'

Python

resposta = client.get_shipping_label("55", invoice_id)
print(resposta["danfe_etiqueta_base64"][:20])  # 'JVBERi0xLjQKJdPr6eEK...'

Java

ShippingLabelResponse resposta = client.getShippingLabel("55", invoiceId);
System.out.println(resposta.danfe_etiqueta_base64.substring(0, 20));

Exemplo de resposta

{
  "status": "AUTORIZADA",
  "status_sefaz": "100",
  "mensagem_sefaz": "Autorizado o uso da NF-e",
  "chave_nfe": "35260812345678000199550010000000011000000018",
  "numero": 11,
  "serie": 1,
  "danfe_etiqueta_base64": "JVBERi0xLjQKJdPr6eEK..."
}