TF Fiscal
Documentación

Archivos

Descarga de archivos

Descarga el XML original o el PDF del documento a partir de los enlaces devueltos por consultas y callbacks.

GET/openapi/files/{kind}/{ref}
No requiere cabeceras de firma.

Los enlaces de descarga en las respuestas de consulta y en las cargas de callback tienen el formato https://api.v2.tffiscal.com/openapi/files/{kind}/{ref}?token=…. Sin cabeceras de firma: el token viaja en el enlace y basta un GET simple. El token está vinculado a la ruta, al integrador y a la aplicación; cambiar la ruta o reutilizarlo en otro archivo lo invalida. Use el enlace exactamente como se devolvió.

Parámetros de ruta

kind*
stringTipo de archivo
ref*
stringReferencia del archivo

* Campo obligatorio

Parámetros de consulta

token*
stringToken del enlace

* Campo obligatorio

302
Redirige a una URL de almacenamiento de objetos válida durante 60 segundos. El cliente debe seguir redirecciones (curl -L). La respuesta lleva Cache-Control: no-store; no almacene los enlaces en caché.

Sin cuerpo de respuesta

  • Validez: 7 días por defecto; la plataforma puede configurar de 1 a 365 días por integrador, y el ajuste solo afecta a los enlaces emitidos después. Cada consulta emite enlaces nuevos.
  • PDF bajo demanda: danfe, danfce, dacte, dace y danfse se renderizan en la primera descarga, así que el enlace ya es utilizable en cuanto el documento queda autorizado. Si el renderizado aún no terminó, la respuesta es 503 con Retry-After.
  • Los fallos son estados HTTP: 403 cuando la aplicación o el integrador está desactivado; el cuerpo es el sobre de la plataforma con success=false.
  • Límite de tasa y facturación: las descargas cuentan en el límite de la aplicación y tienen su propio grupo FILES; no se facturan.

AnteriorRegistrar webhookSiguienteCódigos de error