Mextic

Desglose del ESTATUS ADMINISTRATIVO de las unidades: cuantas estan activas e inactivas (baja). Retorna total, activos, inactivos (y otros[] si hay algun estatus no estandar). La clave suspendidos SOLO llega para superadmin; su AUSENCIA NO significa cero. Si no viene: no la menciones, no digas que es 0 y NO la infieras restando (total - activos - inactivos); el total ya excluye las suspendidas. Si preguntan explicitamente por unidades suspendidas y la clave no vino, responde que no dispones de ese dato, sin afirmar ni negar que existan. Usar SIEMPRE para preguntas como "cuantas unidades activas/inactivas/suspendidas tengo", "estatus de mi flota", "cuantas unidades dadas de baja". IMPORTANTE: el estatus administrativo (alta/baja/suspension de la unidad, campo status) es un eje DISTINTO de "reporta / no reporta" (eso es posicion_actual con minutos_sin_reportar). NO derivar el estatus desde posicion_actual ni inventar umbrales. Para superadmin SIN empresa_id devuelve {requiere_busqueda:true,total:N}: resolver la empresa via obtener_empresas y reintentar con empresa_id. Admin y usuario sin empresa_id reciben el desglose de toda su flota visible.

estatus_flota

Cargas, extracciones y despachos de combustible. Retorna por evento: tipo (carga/extraccion/despacho), litros, fecha_local, lat/lng, vehiculo. Usar para: hubo carga hoy, robos o fugas, ultima carga, historial de cargas, litros cargados en periodo. IMPORTANTE: una unidad carga cada 8-9 dias en promedio, asi que el periodo default (7d) puede venir vacio aunque si haya habido cargas. Si la respuesta llega vacia y el usuario NO acoto fechas, reintentar con periodo=30d antes de responder que no hubo eventos. En flotas grandes preferir acotar con buscar o dispositivo al ampliar el periodo: la respuesta trae los 200 eventos mas recientes.

eventos_combustible

Geocercas del usuario: lista TODAS las geocercas registradas (con y sin actividad) mas actividad por vehiculo. SIEMPRE llamar este tool para cualquier pregunta sobre geocercas. Retorna por vehiculo: geocercas con visitas, tiempo_total_min, tiempo_promedio_min, actualmente_dentro, primera_entrada, ultima_salida. Tambien retorna geocercas_sin_actividad para geocercas sin eventos. Con incluir_detalle=true retorna cada par entrada/salida.

consultar_geocercas

Alarmas y eventos de unidades. Retorna: vehiculo, evento, detalle, fecha_local, lat/lng. Tipos: velocidad, geocerca (entrada/salida), encendido, apagado, paradas, conduccion (aceleracion/frenado/vuelta brusca), sos, mantenimiento, temperatura. NO incluye combustible (usar eventos_combustible).

historial_eventos

Mantenimientos vehiculares. Retorna por unidad: periodo (total, pendientes, realizados, cancelados, costo_total, costo_promedio, por_tipo, por_clasificacion, por_proveedor), ultimo_realizado (fecha, odometro_km, tipo, clasificacion, proveedor, costo). Con incluir_proximo_servicio agrega odometro_actual_km y proximo_servicio (km_objetivo, km_restantes). Con incluir_historial agrega top 10 mantenimientos mas recientes. Tipo es ENUM nativo preventivo/correctivo. Clasificacion es subcategoria por empresa (Motor, Frenos, etc). Costos en moneda de la empresa. Usar para: mantenimientos pendientes, historial, costos, preventivos vs correctivos, proveedor mas usado, proximo servicio, km sin mantenimiento.

consultar_mantenimientos

Ultima posicion GPS de unidades. Retorna por cada unidad: lat/lng, velocidad_kmh, motor (encendido/apagado), minutos_sin_reportar, odometro, estacionado_min (minutos detenido en punto actual). Sin buscar retorna TODA la flota. Usar para: ubicacion, velocidad, unidades en movimiento/detenidas, unidades sin reportar, estado del motor, tiempo estacionado.

posicion_actual

Posicion GPS de una unidad en un momento especifico del pasado. Retorna: vehiculo, lat, lng, velocidad_kmh, motor, odometro_km, fecha_local. Busca el registro mas cercano a la fecha/hora indicada.

posicion_historica

Recorridos por unidad en un periodo. Retorna: km_total, encendido, movimiento, detenido (texto legible) y *_seg (segundos crudos para calculos), primer_movimiento, ultimo_movimiento. Sin buscar retorna toda la flota. Con detalle=diario retorna desglose por dia con km_encendido, km_apagado. Llamar 2 veces con periodos distintos para comparar.

consultar_recorridos

Rendimiento de combustible ACTUAL / en este momento (tendencia en vivo), leido de tiempo real. Usar SIEMPRE que pregunten por el rendimiento "actual", "ahora", "en este momento", "como va" o sin mencionar un periodo. Para rendimiento de un periodo o historico (hoy, ayer, ultimos dias, fechas) usar consultar_rendimientos. Retorna por unidad: tipo_unidad, metrica_principal (km_l o l_hr), estado_fsm (ESTABLE, CALENTANDO, SIN_DATOS, DEGRADADO, NO_CONFIABLE o null si la unidad no tiene maquina de estados), estado_fsm_detalle (explicacion lista para citar), causas, actualizado_hace_min y desactualizado (true si lleva mas de 15 min sin recalcular); y para km_l y l_hr: valor, unidad, estado (eficiente/normal/deficiente/critico, o null cuando la unidad no esta ESTABLE: no hay clasificacion confirmada), confiable (si es false el valor viene null y no debe estimarse), combustible_lts y distancia_km u horas_trabajo. Incluye ultimo_evento de combustible si existe. Solo unidades con sensor de combustible o CAN-BUS y clasificacion configurada; las demas se omiten. Sin buscar retorna toda la flota.

rendimiento_actual

Rendimiento de combustible por unidad. Solo unidades con sensor de combustible o CAN-BUS. Por defecto retorna el agregado del rango: rendimiento (km/l o lts/hr), consumo_lts, cargas_lts, extracciones_lts, km_total, odometro_km, encendido, movimiento, detenido, ralenti (texto legible) y *_seg (segundos crudos para calculos). Con detalle=diario retorna ademas la lista dias[] con los mismos campos por cada dia del rango. Sin buscar retorna toda la flota.

consultar_rendimientos