Archivos

Descarga de archivos

Descarga XML, DANFE, DACCE o DACTE 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

Parámetros de ruta

kindstringobligatorio
Tipo de archivo: xml (XML autorizado o recibo de evento), danfe, dacce o dacte (CT-e).
refstringobligatorio
Identificador del archivo o la clave de acceso de 44 dígitos.

Parámetros de consulta

tokenstringobligatorio
Token del enlace emitido por la plataforma. No lo construya ni modifique manualmente.

Respuestas

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

Errores

Código	HTTP
10009035	401	Enlace inválido (ruta alterada, token reutilizado o firma no coincide).
10009036	401	Enlace expirado. Consulte el documento de nuevo para obtener un enlace nuevo.
10009037	503	Archivo aún no listo (servicio de renderizado ocupado). Reintente el mismo enlace tras `Retry-After`.
10013011	404	Archivo no encontrado.
10013016	429	Demasiadas descargas desde una misma IP. Reintente tras `Retry-After`.

Validez y renderizado

Validez: 7 días por defecto (la plataforma puede configurar de 1 a 365 días por integrador); el ajuste solo afecta a los enlaces emitidos después. Cada consulta emite enlaces nuevos.
DANFE bajo demanda: linkDanfe es utilizable en cuanto la NF-e queda autorizada; el PDF se renderiza en la primera descarga.
Los fallos son estados HTTP: 401 enlace inválido o expirado, 403 aplicación o integrador desactivado, 404 archivo no encontrado, 429 límite de tasa (con Retry-After), 503 archivo no listo; el cuerpo es el sobre de la plataforma (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.