TF Fiscal
Documentação

Verificação de NF-e

Obter DANFE

Devolve o DANFE de uma NF-e verificada pela sua conta, pela chave de acesso, como arquivo PDF.

GET/openapi/v3/consultas/danfe/{chave}
Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Devolve o DANFE (layout A4) de uma NF-e verificada pela sua conta, como arquivo PDF. Cada chamada gera o PDF a partir do veredito de verificação mais recente da nota naquele momento; a plataforma não armazena PDFs, a obtenção em si não consulta a SEFAZ e não é cobrada à parte.

Este endpoint tem um escopo próprio, que a plataforma habilita separadamente: ter a consulta por chave não dá acesso ao PDF, e vice-versa.

As falhas devolvem um status HTTP e um objeto simples {code, message} (códigos no fim da página); os erros vêm em JSON mesmo quando a requisição traz Accept: application/pdf. Falhas de autenticação (401 / 403 / 429) usam o envelope da plataforma, veja Erros de autenticação e autorização.

Parâmetros de caminho

chave*
stringChave de acesso

* Campo obrigatório

200
O DANFE em arquivo PDF (não é JSON). Cabeçalhos da resposta: Content-Type: application/pdf; Content-Disposition: inline; filename="{chave}.pdf"; Cache-Control: no-store; X-Tffiscal-Nfe-Status, a situação fiscal que este PDF reflete, Autorizada (versão normal) ou Cancelada (com marca d'água de cancelada), para distinguir as duas sem interpretar o PDF.

A autenticação é a mesma da consulta por chave: envie os cabeçalhos token, timestamp e sign; o corpo do GET é a string vazia e a chave faz parte do caminho assinado (regras completas em Autenticação). Com app_secret = sk_live_9f8e7d6c5b4a, a chave 35260764962869000108550990001366171195929648 e timestamp = 1784906308, a string assinada é:

text
sign_input = "sk_live_9f8e7d6c5b4a"
+ "/openapi/v3/consultas/danfe/35260764962869000108550990001366171195929648"
+ ""
+ "1784906308"
sign = md5Hex(sign_input)