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-rendimiento2
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
APIPOST /api/fuel-performance, lógica en el cálculo de rendimiento del producto:
- Carga todas las entradas del período por vehículo.
- Resuelve flota, marca y overlays del vehículo (bandas min/máx, ralentí).
- Distancia GPS del período: primer y último odómetro de eventos GPS en el rango (no solo el GPS de las cargas).
- Distancia vendor: primer → último
odometer_readingde las cargas del período (ajustado si hay carry-in). - Detecta irregularidades (una sola carga, GPS faltante, reset de odómetro, outliers de distancia o economía).
- 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.
- 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).
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.
Exportar Excel y PDF
Disponible solo en modo período (no en el diario de rutas).Excel (hojas típicas)
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.
?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.
