Combustible

La pantalla de Combustible registra cada carga de combustible de la flota: cuándo se cargó, cuántos litros, a qué costo y en qué estación de servicio, para calcular el rendimiento y el gasto mensual por vehículo.

Para qué sirve

Controla el consumo real de combustible de cada vehículo, detecta anomalías de rendimiento (consumo inusualmente alto) y calcula el costo operativo de la flota para el análisis de costos mensual.

Vista principal

Cómo acceder

Navegar a Flota → Combustible en el menú lateral.

Datos de una carga

Campo	Descripción
Vehículo	Vehículo que recibió la carga
Placa	Identificación del vehículo
Fecha	Fecha y hora de la carga
Litros	Cantidad de combustible cargado
Costo	Monto total de la carga
Odómetro	Lectura del odómetro al momento de la carga
Estación	Estación de servicio (opcional)
Tipo	Gasolina, diésel, eléctrico
Conductor	Quién realizó la carga

Cálculo de rendimiento

El sistema calcula automáticamente el rendimiento (km/litro) comparando las lecturas del odómetro entre cargas consecutivas del mismo vehículo.

Integración contable

Cada carga genera un asiento contable (best-effort):

• Débito: Gasto de Combustible
• Crédito: Caja / Banco

Nota sobre el estado actual

Hallazgo QA (2026-04-26):

• Las columnas “Fecha”, “Placa Vehículo” y “Litros” aparecen vacías o con valor 0.00 en todas las filas. El SP usp_Fleet_Fuel_List no estaría retornando estos campos o el mapping del frontend no coincide (P1).
• El tipo de combustible se muestra en inglés (GASOLINE, DIESEL) — pendiente localización (P2).
• La columna “Estación” se renderiza sin tilde (“Estacion”) — error tipográfico en la definición de columna (P3).
• cache.zentto.net/v1/grid-layouts/module-flota:combustible:list devuelve 500 (P1).

Flujo del usuario

Vista no tecnica del proceso. Pensada para conductores, responsables de flota y personal de administracion.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo tecnico

Vista tecnica para desarrolladores: sequence diagram con endpoints, stored procedures, calculo de rendimiento y asiento contable.

Componente	Tipo	Ubicacion
GET /v1/flota/combustible	Route Express	web/api/src/routes/flota/fuel.ts
POST /v1/flota/combustible	Route Express	web/api/src/routes/flota/fuel.ts
usp_Fleet_Fuel_List	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
usp_Fleet_Fuel_Create	Stored procedure (SQL Server + funcion PG)	web/api/sqlweb*/includes/sp/
flt.FuelLog	Tabla operativa	web/api/migrations/postgres/
flt.Vehicle	Tabla operativa (UPDATE odometro)	web/api/migrations/postgres/
acc.JournalEntry	Tabla contable (side-effect best-effort)	web/api/migrations/postgres/
FuelListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-flota/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.