TF Fiscal
Documentação

Arquivos

Download de arquivos

Baixa o XML original ou o PDF do documento a partir dos links devolvidos pelas consultas e callbacks.

GET/openapi/files/{kind}/{ref}
Não requer cabeçalhos de assinatura.

Os links de download nas respostas de consulta e nas cargas de callback têm o formato https://api.v2.tffiscal.com/openapi/files/{kind}/{ref}?token=…. Não há cabeçalhos de assinatura: o token viaja no link e um GET simples basta. O token é vinculado ao caminho, ao integrador e à aplicação; alterar o caminho ou reutilizá-lo em outro arquivo o invalida. Use o link exatamente como devolvido.

Parâmetros de caminho

kind*
stringTipo do arquivo
ref*
stringReferência do arquivo

* Campo obrigatório

Parâmetros de consulta

token*
stringToken do link

* Campo obrigatório

302
Redireciona para uma URL de armazenamento de objetos válida por 60 segundos. O cliente deve seguir redirecionamentos (curl -L). A resposta traz Cache-Control: no-store; não faça cache dos links.

Sem corpo de resposta

  • Validade: 7 dias por padrão; a plataforma pode configurar de 1 a 365 dias por integrador, e a configuração só afeta links emitidos depois. Toda consulta emite links novos.
  • PDF sob demanda: danfe, danfce, dacte, dace e danfse são renderizados no primeiro download, então o link já é utilizável no momento em que o documento é autorizado. Se a renderização ainda não terminou, a resposta é 503 com Retry-After.
  • Falhas são status HTTP: 403 quando a aplicação ou o integrador está desativado; o corpo é o envelope da plataforma com success=false.
  • Limite de taxa e cobrança: downloads contam no limite da aplicação e têm o próprio grupo FILES; não são cobrados.

AnteriorRegistrar webhookPróximoCódigos de erro