Saltar al contenido
Facturador

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:

  • 403 si el reporte es de otro usuario y no eres administrador.
  • 404 si el reporte no existe o su archivo ya no está disponible.
  • 409 si aún se está generando (status: IN_PROCESS) o falló (status: ERROR / FAILED); la respuesta trae status.
  • 401 sin 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.