Skip to main content

Reporte de rendimiento por período

Cuando el rango de fechas tiene más de un día, la pantalla pasa al modo Reporte de Rendimiento: consolidado por vehículo para la semana, quincena o mes. Complementa al reporte diario de rutas. El diario es tanque-a-tanque + telemática del día; el período responde “¿cuántos km por galón compramos en este intervalo?”.

Cómo generar el reporte

1

Abrir la pantalla

/paso-rapido/dashboard/combustible/reporte-rendimiento
2

Elegir un rango

Fecha inicio ≠ fecha fin. Presets útiles: Últimos 7 días, Este mes, Mes pasado.
3

Incluir última carga previa

Por defecto activado. Trae la última carga anterior al inicio (hasta 45 días) para no cortar el primer tanque a mitad.
4

Filtrar marca, flota y vehículos

Vacío en vehículos = todas las unidades con cargas en el rango (según marca/flota).
5

Generar reporte

Pulse Generar reporte y revise KPIs, gráficos y tabla.

Qué calcula el motor

API POST /api/fuel-performance, lógica en el cálculo de rendimiento del producto:
  1. Carga todas las entradas del período por vehículo.
  2. Resuelve flota, marca y overlays del vehículo (bandas min/máx, ralentí).
  3. Distancia GPS del período: primer y último odómetro de eventos GPS en el rango (no solo el GPS de las cargas).
  4. Distancia vendor: primer → último odometer_reading de las cargas del período (ajustado si hay carry-in).
  5. Detecta irregularidades (una sola carga, GPS faltante, reset de odómetro, outliers de distancia o economía).
  6. Sugiere fuente de distancia:
    • Si el vendor está dañado (reset / unusable) → GPS si sirve; si no, vendor; si no, ninguna.
    • Si el vendor es usable → prioriza vendor.
    • Si no → GPS si sirve.
  7. Economía = distancia efectiva / galones totales del período.

KPIs

Los gráficos ayudan a ver dispersión entre unidades; la tabla es la fuente de verdad para ajustes.

Tabla por vehículo

Al expandir una fila verá el detalle de cargas (deltas vendor/GPS por entrada).

Buckets de revisión (UI)

La interfaz clasifica filas para priorizar trabajo, por ejemplo:
  • ok — datos coherentes.
  • gps_out_of_range / needs_review — poca distancia GPS, pocas cargas, pocos galones, o economía fuera de banda (con holguras blandas/duras).
Umbrales internos de referencia (producto): distancia GPS mínima ~1 km para auto, mínimo 2 cargas y 5 galones para sugerencias automáticas; holgura blanda sobre el máximo de banda (+8 km/G) y dura (+100 km/G) para marcar anomalías extremas.

Editor de distancia

Use el editor cuando:
  • El odómetro vendor se reinició o saltó.
  • El GPS del período está incompleto pero tiene un tramo confiable.
  • Hay evidencia externa (bitácora) que justifica un km manual.
Al confirmar, la fuente efectiva puede quedar en manual o gps según lo elegido. Eso alimenta el km/G mostrado y las exportaciones.

Exportar Excel y PDF

Disponible solo en modo período (no en el diario de rutas).

Excel (hojas típicas)

PDF

Plantilla de informe de rendimiento para archivo / envío formal.
Genere, corrija distancias dudosas, guarde la configuración y luego exporte. Así el Excel refleja los mismos ajustes que la pantalla.

Guardar configuración

Igual que el diario: máximo 3 configs por organización. En modo período guarda:
  • Filtros y flag de carga previa.
  • Ediciones por vehículo (vehicle_edits).
  • Opcionalmente un snapshot de estadísticas para reabrir rápido.
Deep link: ?configId=CONFIG_ID.

Irregularidades que debe reconocer

La distancia máxima de referencia escala con los días del período a partir de un techo mensual de 15 000 km.

Diferencias clave vs el reporte diario

Siguiente: cómo interpretar y actuar.