TF Fiscal
Documentation

Files

File download

Downloads the original XML or the document PDF through the links returned by queries and callbacks.

GET/openapi/files/{kind}/{ref}
No signature headers required.

Download links in query responses and callback payloads look like https://api.v2.tffiscal.com/openapi/files/{kind}/{ref}?token=…. No signature headers: the token travels with the link and a plain GET is enough. The token is bound to the path, the integrator and the application; changing the path or reusing it on another file invalidates it. Use the link exactly as returned.

Path parameters

kind*
stringFile kind
ref*
stringFile reference

* Required field

Query parameters

token*
stringLink token

* Required field

302
Redirects to an object-storage URL valid for 60 seconds. Clients must follow redirects (curl -L). The response carries Cache-Control: no-store; do not cache links.

No response body

  • Validity: 7 days by default; the platform can configure 1 to 365 days per integrator, and the setting only affects links issued afterwards. Every query issues new links.
  • PDF on demand: danfe, danfce, dacte, dace and danfse are rendered on the first download, so the link is usable as soon as the document is authorized. If rendering has not finished yet, the response is 503 with Retry-After.
  • Failures are HTTP statuses: 403 when the application or the integrator is disabled; the body is the platform envelope with success=false.
  • Rate limiting and billing: downloads count against the application throttle and have their own FILES group; they are not billed.

PreviousRegister webhookNextError codes