Descargar reporte
GET /api/download-tray/{download_tray_id}/download
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Descarga el archivo de un reporte terminado.
Quién puede usarlo: cualquier usuario autenticado. Cada usuario ve solo sus reportes; un administrador ve los de todos (y puede filtrar por user_id). Pedir el reporte de otro usuario sin ser administrador responde 403.
Formato de respuesta: archivo (PDF, XML, ZIP, Excel o texto), no JSON. application/pdf, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet o application/zip (reporte dividido en lotes). Si hay error, responde JSON {success: false, message}.
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
download_tray_id |
integer | Sí | Id del reporte. |
Errores:
403si el reporte es de otro usuario y no eres administrador.404si el reporte no existe o su archivo ya no está disponible.409si aún se está generando (status: IN_PROCESS) o falló (status: ERROR/FAILED); la respuesta traestatus.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
download_tray_id |
ruta | sí | 1 |
Respuestas
200 — Excel
PK ... (contenido binario del libro Excel) ...
200 — PDF
%PDF-1.7
%âãÏÓ
... (contenido binario del PDF) ...
%%EOF
200 — ZIP (lotes)
PK ... (contenido binario del ZIP con los PDF de cada lote) ...
409 — Aún en proceso
{
"success": false,
"message": "El reporte aún se está generando. Vuelva a consultar en unos segundos.",
"status": "IN_PROCESS"
}
409 — Falló
{
"success": false,
"message": "El reporte no se pudo generar. Solicítelo nuevamente.",
"status": "ERROR"
}
403 — De otro usuario
{
"success": false,
"message": "No tienes permiso para acceder a este registro."
}
404 — Archivo no disponible
{
"success": false,
"message": "El archivo del reporte ya no está disponible."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.