> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unitedpetroleum.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Interpretar y usar el reporte

> Cómo leer alertas, ralentí, desvíos y distancias, y qué acciones tomar en operaciones

# Interpretar y usar el reporte de rendimiento

Esta página es la guía de **acción** para supervisión, combustible y flota. Parte de que ya sabe [generar](/combustible/reporte-rendimiento) el informe y conoce los [conceptos](/combustible/conceptos-rendimiento).

***

## Flujo recomendado de trabajo

```mermaid theme={null}
flowchart TD
  A["1. Diario: Ayer sin filtros"] --> B["2. Separar rojas / amarillas / idle over"]
  B --> C{"¿Dato dudoso?"}
  C -->|Sí| D["Corregir km o revisar carga"]
  C -->|No| E["Abrir viajes y ralentí"]
  E --> F["Acción: conductor / ruta / taller / PARAM"]
  D --> G["3. Período: semana o mes"]
  F --> G
  G --> H["4. Exportar y archivar config"]
```

1. **Cierre diario** con [reporte de rutas](/combustible/reporte-diario).
2. **Tendencia** con [reporte por período](/combustible/reporte-periodo).
3. **Archivo** con configuración guardada + Excel/PDF del período.

***

## Matriz de lectura rápida (diario)

| Señal | Lectura primaria | Primera verificación | Acción típica |
| - | - | - | - |
| Alerta **roja**, desvío muy negativo | Quemó mucho más de lo esperado | ¿Km GPS/vendor coherentes? ¿Galones tipados bien? | Si dato OK → revisar idle, ruta, exceso; si dato malo → editar km o corregir entrada |
| Alerta **roja**, desvío muy positivo | “Demasiado bueno” | Posible odo inflado, galones de menos, o PARAM bajo | Validar odómetros y ticket; no premie hasta confirmar |
| Alerta **amarilla** | Desvío moderado | Misma lógica que roja, prioridad media | Seguimiento; acumular patrón en la semana |
| Alerta **unknown** | Falta PARAM o distancia | Completar PARAM del vehículo; revisar GPS/vendor | No juzgue eficiencia hasta tener dato |
| **Ralentí** sobre el máximo | Motor mucho tiempo sin avanzar | Expandir viajes; ver parking vs idle | Colas, A/C en vacío, mal corte de viaje; coaching |
| **Máx / Exceso** | Velocidad sobre umbral del vehículo | Confirmar límite (`red_threshold`) | Coaching / política de velocidad |
| **Viajes = 0** | Sin telemática en la ventana | ¿Hubo movimiento real? ¿Importación de viajes al día? | Completar sync de viajes; no culpe idle |

***

## Cómo hablar del desvío sin confundir

* El desvío % es **relativo al PARAM del vehículo**, no a la flota entera.
* Un −12 % en una unidad con PARAM 8 km/gal no es lo mismo en galones que en una con PARAM 12: use también **desvío en galones** cuando exista.
* Umbrales default **6 % / 10 %** son puntos de partida; ajústelos por política interna y guarde la config.

<Warning>
  Un desvío grande con fuente `none` o badge inconsistente **no** es evidencia de robo ni de mal manejo hasta validar odómetros y cargas.
</Warning>

***

## Ralentí: separar parking de idle

En el hover / detalle de la línea diaria verá motor, conducción, idle y parking.

| Patrón | Significado probable |
| - | - |
| Idle alto + muchos viajes cortos en ciudad | Operación real (tráfico, entregas). |
| Idle alto + pocos km | Motor encendido parado mucho tiempo. |
| Parking ≈ ventana completa + viajes 0 | Apagado o sin telemetría; no interprete idle. |
| Idle over pero ECO aceptable | Priorice tiempo parado vs estilo de manejo. |

El máximo de ralentí del vehículo (`ralenti_max_percentage`) es la regla de negocio; si muchas unidades “over” a la vez, revise si la meta es realista para esa marca.

***

## GPS vs vendor: cuándo confiar

| Escenario | Preferencia práctica |
| - | - |
| GPS continuo y delta positivo | En **diario**, confíe en GPS. |
| GPS faltante pero ticket/bomba coherente | Use vendor; documente. |
| Vendor con reset visible (salto absurdo) | En **período**, el sistema ya marca reset; pase a GPS o manual. |
| Ambos pelean y la economía es outlier | Abra el detalle de cargas; corrija la entrada mala en [Entradas](/combustible/entradas). |

Recuerde: **diario prioriza GPS**; **período prioriza vendor usable**. Al explicar un número a gerencia, diga siempre la **fuente** (badge en UI).

***

## PARAM y bandas de marca

| Modo | Meta | Si está mal configurada |
| - | - | - |
| Diario | PARAM único (`fuel_efficiency_target`) | Alertas falsas o “unknown”. Actualice el vehículo. |
| Período | Banda min–máx | Outliers y colores engañosos. Ajuste marca o override del vehículo. |

Buenas prácticas de handoff:

1. Documente PARAM y bandas por modelo/marca en la onboarding de flota.
2. No cambie PARAM el mismo día que investiga una alerta sin dejar nota.
3. Tras cambiar metas, regenere el reporte (no asuma que un snapshot viejo aplica).

***

## Playbooks de acción

### A. Unidad en rojo por bajo rendimiento

1. Verificar galones y odómetros de la carga del día y la previa.
2. Si distancia inválida → editar km o corregir entrada; regenerar.
3. Si distancia OK → expandir viajes: idle over, exceso, ECO.
4. Hablar con operaciones: ruta atípica, tráfico, aire acondicionado, carga útil.
5. Si el patrón se repite 3+ días → escalar a mantenimiento (filtros, presión llantas, inyección).

### B. Sospecha de dato (economía imposible)

1. Mirar badge de fuente y deltas GPS vs vendor.
2. Revisar cadena de cargas (¿faltó una importación?).
3. Corregir en Entradas o forzar distancia manual con evidencia.
4. Guardar config con título claro (`Corrige odo ficha 123 — 2026-08-08`).

### C. Cierre semanal / mensual

1. Generar [período](/combustible/reporte-periodo) con carry-in ON.
2. Resolver filas `needs_review` / resets.
3. Exportar Excel + PDF.
4. Comparar rendimiento prom. vs mes anterior; no mezcle fuentes distintas sin decirlo.

### D. Entregar el producto a un nuevo usuario

1. Leer [Conceptos](/combustible/conceptos-rendimiento).
2. Generar **Ayer** y explicar una línea completa en voz alta (ruta, viajes, ralentí, PARAM).
3. Generar **Este mes**, togglear GPS en una unidad, exportar Excel.
4. Guardar y reabrir una configuración.
5. Mostrar dónde se editan PARAM / ralentí / bandas en [Vehículos](/flota/vehiculos) (y marcas asociadas).

***

## Qué no hace este reporte

* No reemplaza el [reporte de conducción](/reportes/conduccion) ni el de [velocidad](/reportes/velocidad).
* No es un inventario de tanque físico (usa cargas registradas).
* No asigna culpabilidad automática: es una **señal** que combina combustible + telemática + metas.

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Por qué una recarga del día no aparece como ruta?">
    No hay carga previa del mismo vehículo en la ventana de 45 días, los galones son ≤ 0, el vehículo quedó fuera de filtros, o la fecha no cae en el día SDT seleccionado.
  </Accordion>

  <Accordion title="¿Por qué el conductor de la tabla no coincide con el del viaje?">
    La columna principal usa el conductor de la **entrada de combustible**. Los conductores de viaje salen al expandir / en el hover de ralentí.
  </Accordion>

  <Accordion title="¿Puedo exportar el reporte diario a Excel?">
    La exportación Excel/PDF está en el **modo período**. Para el diario use capturas, configs guardadas o pase al rango de un día… si pone un solo día vuelve al modo rutas (sin ese export). Use un rango ≥ 2 días para exportar consolidado.
  </Accordion>

  <Accordion title="¿Cuántos reportes puedo guardar?">
    Como máximo **3** configuraciones por organización; al guardar una nueva se depuran las más antiguas.
  </Accordion>

  <Accordion title="¿El día sigue mi zona horaria local?">
    No. El día operativo es **America/Santo\_Domingo** (UTC−4).
  </Accordion>
</AccordionGroup>

***

## Enlaces de handoff

| Necesidad | Página |
| - | - |
| Glosario | [Conceptos de rendimiento](/combustible/conceptos-rendimiento) |
| Generar / panorama | [Reporte de rendimiento](/combustible/reporte-rendimiento) |
| Jornada | [Reporte diario](/combustible/reporte-diario) |
| Semana/mes | [Reporte por período](/combustible/reporte-periodo) |
| Cargas | [Entradas](/combustible/entradas) |
| Viajes | [Viajes](/flota/viajes) |
| App | [Abrir aplicación](https://app.unitedlogistics.com.do/paso-rapido/dashboard/combustible/reporte-rendimiento) |
| Soporte | [sfuentes@assetmg.tech](mailto:sfuentes@assetmg.tech) |
