El modulo de flota permite gestionar la flota vehicular de la empresa: registro de vehiculos, control de combustible, mantenimiento preventivo y correctivo, gestion de viajes y control de documentos legales.
Cada vehiculo se registra con sus datos principales:
Campo Descripcion Placa Placa/matricula del vehiculo Marca Marca del fabricante Modelo Modelo del vehiculo Ano Ano de fabricacion Color Color del vehiculo VIN Numero de identificacion vehicular Tipo Sedan, camioneta, camion, moto, etc. Combustible Gasolina, diesel, electrico, hibrido Odometro Kilometraje actual Estado Activo, en mantenimiento, fuera de servicio Conductor asignado Conductor habitual
Endpoint Metodo Descripcion /v1/flota/vehiculosGET Listar vehiculos con filtros /v1/flota/vehiculosPOST Registrar nuevo vehiculo /v1/flota/vehiculos/:idGET Detalle con historial completo
El detalle del vehiculo incluye:
Datos basicos del vehiculo
Ultimas cargas de combustible
Mantenimientos recientes
Viajes recientes
Documentos vigentes
Indicadores: consumo promedio, costo total, km recorridos
Cada carga de combustible se registra con los siguientes datos:
Campo Descripcion Vehiculo Vehiculo que recibio la carga Fecha Fecha y hora de la carga Litros Cantidad de combustible cargado Costo Monto total de la carga Odometro Lectura del odometro al momento de la carga Estacion Estacion de servicio (opcional) Tipo combustible Gasolina, diesel, etc. Conductor Quien realizo la carga
El sistema calcula automaticamente el rendimiento (km/litro) comparando la lectura del odometro entre cargas consecutivas:
Rendimiento = (Odometro actual - Odometro anterior) / Litros cargados
Endpoint Metodo Descripcion /v1/flota/combustibleGET Listar cargas con filtros por vehiculo, fecha, conductor /v1/flota/combustiblePOST Registrar carga de combustible
Cada carga genera un asiento contable (best-effort):
Debito : Gasto de CombustibleCredito : Caja/Banco
Se configuran los tipos de mantenimiento con sus intervalos:
Tipo Ejemplo Intervalo Preventivo Cambio de aceite Cada 5,000 km Preventivo Rotacion de neumaticos Cada 10,000 km Preventivo Revision general Cada 20,000 km Correctivo Reparacion de frenos Segun necesidad Correctivo Reparacion de motor Segun necesidad
Campo Descripcion Vehiculo Vehiculo a mantener Tipo Tipo de mantenimiento Descripcion Descripcion del trabajo realizado Proveedor Taller o proveedor del servicio Costo estimado Costo presupuestado Costo real Costo final (al completar) Fecha programada Fecha planificada Odometro Kilometraje al momento del servicio Estado Programado, en progreso, completado, cancelado
SCHEDULED --> IN_PROGRESS --> COMPLETED
Estado Descripcion SCHEDULEDProgramado, pendiente de ejecucion IN_PROGRESSEn ejecucion COMPLETEDCompletado exitosamente CANCELLEDCancelado
El sistema genera alertas automaticas cuando un vehiculo supera el intervalo de kilometros configurado para un tipo de mantenimiento:
Alerta: "Vehiculo ABC-123 requiere Cambio de aceite
(ultimo: hace 5,200 km, intervalo: 5,000 km)"
Endpoint Metodo Descripcion /v1/flota/tipos-mantenimientoGET Listar tipos /v1/flota/tipos-mantenimientoPOST Crear tipo /v1/flota/mantenimientosGET Listar mantenimientos /v1/flota/mantenimientos/:idGET Detalle de mantenimiento /v1/flota/mantenimientosPOST Crear mantenimiento /v1/flota/mantenimientos/:id/completarPOST Completar mantenimiento /v1/flota/mantenimientos/:id/cancelarPOST Cancelar mantenimiento
Al completar un mantenimiento:
Preventivo : Debito Gasto de Mantenimiento / Credito Caja o BancoCorrectivo : Debito Gasto de Reparaciones / Credito Caja o Banco
Campo Descripcion Vehiculo Vehiculo asignado al viaje Conductor Conductor asignado Origen Punto de partida Destino Punto de llegada Fecha inicio Fecha y hora de salida Fecha fin Fecha y hora de llegada (al completar) Odometro inicio Lectura al salir Odometro fin Lectura al llegar (al completar) Proposito Motivo del viaje Carga Descripcion de la carga transportada Estado Planificado, en ruta, completado
PLANNED --> IN_TRANSIT --> COMPLETED
Endpoint Metodo Descripcion /v1/flota/viajesGET Listar viajes con filtros /v1/flota/viajesPOST Crear viaje /v1/flota/viajes/:id/completarPOST Completar viaje
Al completar un viaje se registra la distancia recorrida y se actualiza el odometro del vehiculo.
Tipo Descripcion Ejemplo Seguro Poliza de seguro Seguro contra todo riesgo Revision tecnica Inspeccion vehicular ITV/Revision anual Licencia Permisos y licencias Permiso de circulacion Certificado Certificaciones Certificado de emisiones Otro Documentos varios Contrato de leasing
Campo Descripcion Vehiculo Vehiculo al que pertenece Tipo Tipo de documento Numero Numero o referencia Fecha emision Fecha de emision Fecha vencimiento Fecha de vencimiento Proveedor Aseguradora, entidad emisora Costo Costo del documento Notas Observaciones
El sistema genera alertas cuando un documento esta proximo a vencer (configurable, por defecto 30 dias antes):
Alerta: "Seguro del vehiculo ABC-123 vence el 2026-04-15
Endpoint Metodo Descripcion /v1/flota/vehiculos/:id/documentosGET Listar documentos del vehiculo /v1/flota/vehiculos/:id/documentosPOST Agregar documento
El endpoint /v1/flota/dashboard retorna KPIs consolidados:
KPI Descripcion Total vehiculos Cantidad de vehiculos registrados Vehiculos activos En operacion actualmente En mantenimiento En taller o servicio Consumo promedio km/litro promedio de la flota Costo mensual combustible Gasto del mes en combustible Costo mensual mantenimiento Gasto del mes en mantenimiento Mantenimientos pendientes Programados y vencidos Documentos por vencer Documentos con vencimiento proximo Viajes activos Viajes en ruta actualmente
SP Descripcion usp_Fleet_Vehicle_ListListar vehiculos usp_Fleet_Vehicle_GetDetalle de vehiculo con historial usp_Fleet_Vehicle_CreateCrear vehiculo usp_Fleet_Fuel_ListListar cargas de combustible usp_Fleet_Fuel_CreateRegistrar carga usp_Fleet_MaintenanceType_ListListar tipos de mantenimiento usp_Fleet_MaintenanceType_CreateCrear tipo usp_Fleet_Maintenance_ListListar mantenimientos usp_Fleet_Maintenance_GetDetalle de mantenimiento usp_Fleet_Maintenance_CreateCrear mantenimiento usp_Fleet_Maintenance_CompleteCompletar mantenimiento usp_Fleet_Maintenance_CancelCancelar mantenimiento usp_Fleet_Trip_ListListar viajes usp_Fleet_Trip_CreateCrear viaje usp_Fleet_Trip_CompleteCompletar viaje usp_Fleet_VehicleDocument_ListListar documentos usp_Fleet_VehicleDocument_CreateAgregar documento usp_Fleet_DashboardKPIs del dashboard
