Crear reporte programado
Crea un nuevo reporte programado. El tipo de reporte determina la validación aplicada:
- trips_history: permite reportConfig con fuelNormRate y fuelPrice opcionales
- stops_history: sin configuración adicional
- speed_excess: requiere reportConfig.speedLimit obligatorio, minDuration opcional
Reglas de frecuencia:
- daily: solo executionTime. No enviar weekDays ni monthDays.
- weekly: requiere weekDays (0=domingo a 6=sábado). No enviar monthDays.
- monthly: requiere monthDays (1-31). No enviar weekDays.
controlDays: array de días en inglés (monday, tuesday, etc.) que indica qué días incluir en los datos del reporte.
Authorizations
Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.
Body
Nombre del reporte
Tipo de reporte (inmutable post-creación)
trips_history, stops_history, speed_excess ObjectIds de assets
1daily: solo hora. weekly: requiere weekDays, no permite monthDays. monthly: requiere monthDays, no permite weekDays.
daily, weekly, monthly Hora de ejecución en formato HH:mm
^([01]\d|2[0-3]):[0-5]\d$"08:30"
x >= 1hours, days Días cuyos datos se incluyen en el reporte
1monday, tuesday, wednesday, thursday, friday, saturday, sunday Formatos de archivo a generar (pdf o xlsx).
1pdf, xlsx 1Configuración específica según tipo de reporte
Requerido si frequency es weekly (0=domingo, 6=sábado). No enviar con daily ni monthly.
0 <= x <= 6Requerido si frequency es monthly. No enviar con daily ni weekly.
1 <= x <= 31Response
Reporte programado creado exitosamente
ID del reporte programado
Nombre del reporte
trips_history, stops_history, speed_excess daily: solo hora. weekly: requiere weekDays. monthly: requiere monthDays.
daily, weekly, monthly Solo aplica si frequency es weekly (0=domingo, 6=sábado)
0 <= x <= 6Solo aplica si frequency es monthly
1 <= x <= 31^([01]\d|2[0-3]):[0-5]\d$"08:30"
hours, days Días de la semana cuyos datos se incluyen en el reporte
monday, tuesday, wednesday, thursday, friday, saturday, sunday Formatos de archivo. Si se envían múltiples, se genera un ZIP.
pdf, xlsx