Arquivos

Download de arquivos

Baixa XML, DANFE, DACCE ou DACTE 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

Parâmetros de caminho

kindstringobrigatório
Tipo do arquivo: xml (XML autorizado ou recibo de evento), danfe, dacce ou dacte (CT-e).
refstringobrigatório
Identificador do arquivo ou a chave de acesso de 44 dígitos.

Parâmetros de consulta

tokenstringobrigatório
Token do link, emitido pela plataforma. Não construa nem altere manualmente.

Respostas

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

Erros

Código	HTTP
10009035	401	Link inválido (caminho alterado, token reutilizado ou assinatura divergente).
10009036	401	Link expirado. Consulte o documento novamente para obter um link novo.
10009037	503	Arquivo ainda não pronto (serviço de renderização ocupado). Repita o mesmo link após `Retry-After`.
10013011	404	Arquivo não encontrado.
10013016	429	Downloads em excesso a partir de um mesmo IP. Repita após `Retry-After`.

Validade e renderização

Validade: 7 dias por padrão (a plataforma pode configurar de 1 a 365 dias por integrador); a configuração só afeta links emitidos depois. Toda consulta emite links novos.
DANFE sob demanda: linkDanfe fica utilizável assim que a NF-e é autorizada; o PDF é renderizado no primeiro download.
Falhas são status HTTP: 401 link inválido ou expirado, 403 aplicação ou integrador desativado, 404 arquivo não encontrado, 429 limite de taxa (com Retry-After), 503 arquivo não pronto; o corpo é o envelope da plataforma (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.