Skip to main content

Reporte diario de rutas (jornada)

Cuando en los filtros elige la misma fecha de inicio y fin, United Logistics abre el modo Reporte de rutas (jornada). Es la ficha operativa del día para entregar a supervisión de flota o combustible.
Antes de usar este manual, revise el glosario: qué es una ruta, un viaje y el ralentí.

Cuándo usarlo

  • Cierre diario de eficiencia por unidad.
  • Investigar una recarga anómala del día.
  • Cruzar combustible (galones / odómetro) con telemática (viajes, idle, velocidad).
  • Preparar evidencia antes de hablar con un conductor o taller.
Para tendencias semanales o mensuales use el reporte por período.

Cómo generar el reporte

1

Abrir Rendimiento combustible

En Paso Rápido vaya a Combustible → Rendimiento, o directamente a /paso-rapido/dashboard/combustible/reporte-rendimiento.
2

Elegir un solo día

Use el selector de fechas con inicio = fin (presets Hoy o Ayer). La zona del día es siempre America/Santo_Domingo, no la zona del navegador.
3

Filtrar (opcional)

  • Marca y Flota para reducir el universo.
  • Vehículos: vacío = todos los que tengan cargas ese día (según filtros).
  • Umbral amarillo % (default 6) y umbral rojo % (default 10) para las alertas de desvío vs PARAM.
4

Generar reporte

Pulse Generar reporte. La vista se desplaza a los resultados (#rendimiento-results).
5

Revisar, ajustar y guardar

Edite kilómetros si hace falta, expanda filas para ver viajes, guarde la configuración si la reutilizará.
Si cambia de un día único a un rango (o al revés), la app limpia los resultados anteriores: son dos motores distintos.

Qué hace el sistema por detrás

Orden conceptual del cálculo (API POST /api/fuel-route-day):
  1. Toma todas las cargas del día (ventana SDT) con vehículo asignado.
  2. Para cada vehículo arma la cadena de cargas desde día − 45 días hasta el fin del día, ordenada por fecha e id.
  3. Por cada carga del día, busca la carga anterior en esa cadena. Sin anterior → no hay línea.
  4. Omite galones ≤ 0.
  5. Calcula distancia GPS y vendor; elige GPS si el delta GPS > 0, si no vendor.
  6. Calcula rendimiento, desvío vs PARAM del vehículo y nivel de alerta con los umbrales del filtro.
  7. Asocia viajes en (carga_anterior, carga_actual] y agrega motor, idle, ECO, velocidad máxima.
  8. Devuelve las líneas + un resumen (KPIs).

KPIs del encabezado

Si ve el mensaje No hay rutas con recarga…, suele significar: no hubo cargas ese día, o ninguna tenía carga previa en 45 días, o los filtros dejaron fuera los vehículos.

Columnas de la tabla (cómo leerlas)


Fórmulas que debe poder explicar en una reunión

Rendimiento
Desvío %
Desvío en galones
Alerta
  • Sin desvío calculable → unknown
  • |desvío| > rojo → red
  • |desvío| > amarillo → yellow
  • si no → ok
% ralentí
Parking (aprox.)

Detalle al expandir una ruta

Cada viaje muestra, entre otros:
  • Mapa de inicio/fin (si hay coordenadas).
  • Distancia y duración del trip.
  • Motor / conducción / ralentí del viaje.
  • ECO y driving score.
  • Velocidad máxima y si hubo exceso vs límite del vehículo.
  • Conductor telemático.
Use esto para separar:
  1. Problema de dato (odo mal, GPS faltante, carga mal tipada).
  2. Problema de operación (mucho idle en cola, rutas cortas, exceso de velocidad).
  3. Problema de meta (PARAM desactualizado para ese modelo).

Editar kilómetros

Puede corregir km inicio, km fin o la distancia de la línea. Al guardar el ajuste:
  • La fuente pasa a manual.
  • Se recalculan rendimiento, desvío y alerta con los mismos umbrales del filtro actual.
  • El ajuste puede persistirse al Guardar la configuración del reporte (route_distance_edits).
Corrija odómetros solo con evidencia (foto de tablero, ticket, GPS confiable). Deje constancia en el título o notas de la configuración guardada.

Guardar y reabrir

  • Guardar: título opcional; conserva filtros, umbrales y ediciones de distancia del modo diario.
  • La organización conserva como máximo las 3 configuraciones más recientes (las anteriores se depuran).
  • Guardados: menú para recargar (regenera el reporte). También puede abrirse con ?configId= en la URL.

Casos límite frecuentes


Checklist de entrega diaria (handoff)

  1. Generar Ayer (o el día operativo cerrado) sin filtros, luego filtrar flotas críticas.
  2. Ordenar mentalmente: alertas rojas → amarillas → idle over → exceso de velocidad.
  3. Expandir cada roja: ¿dato malo o operación real?
  4. Ajustar km solo con evidencia; guardar configuración con título Jornada YYYY-MM-DD.
  5. Si necesita tendencia de la semana, pasar al reporte por período (export Excel/PDF).
  6. Para interpretación de negocio y acciones recomendadas, ver Interpretación y uso.