Vehículos y sticker QR

Para qué sirve

En la isla solo se despacha a crédito a una placa registrada y activa del cliente. En la pestaña Vehículos de la ficha registras cada unidad de la flota con sus topes de consumo, el combustible que puede cargar y si debe dar el odómetro. Además generas un sticker QR para pegarlo en el vehículo: el playero lo escanea con la cámara y el sistema identifica al cliente y la placa sin errores de tipeo.

Dónde está

Menú:Configuración›Créditos y flotas/creditos

Ver ficha del cliente → pestaña Vehículos.

Quién puede

Acción	Permiso
Ver la lista de vehículos	Permisocreditos.ver
Nuevo vehículo, Editar, Generar QR, Ver QR	Permisocreditos.gestionar o Permisocreditos.gestionar_flota
Revocar QR	Permisocreditos.revocar_qr
Rendimiento km/gal	Permisocreditos.ver. La acción solo aparece si tu plan incluye el módulo Cobranzas; si no, queda oculta.

Conceptos

• Unidad de los límites: los límites del vehículo se expresan en Galones o en Soles. Con galones solo cuentan los ítems de combustible despachados por manguera; con soles cuenta el total de la venta.
• Límite por carga: tope de un solo despacho. Límite diario y Límite mensual: suma de las cargas a crédito de esa placa en el día o en el mes calendario (hora de Lima), más la carga actual. Vacío = Sin límite.
• Productos permitidos: si marcas productos, el vehículo solo puede cargar esos (por ejemplo solo Diésel B5). Si no marcas ninguno, puede cargar todos.
• Exige odómetro: el POS pide el kilometraje en cada carga. El odómetro nunca puede ser menor que el último registrado.
• QR: un código único por vehículo. Si lo regeneras o lo revocas, el anterior deja de funcionar de inmediato.

Paso a paso

Registrar un vehículo

1. Abre la pestaña Vehículos
   En la ficha del cliente, pulsa la pestaña Vehículos.
2. Pulsa «Nuevo vehículo»
   Se abre el modal Nuevo vehículo.
3. Escribe la placa
   Formato peruano ABC-123 o 1234-AB. Se guarda en mayúsculas.
4. Define los límites
   Elige la Unidad de los límites (Galones o Soles) y completa solo los límites que quieras controlar.
5. Marca opciones
   Activa Exige odómetro si quieres el kilometraje en cada carga y marca los Productos permitidos si la unidad solo puede cargar ciertos combustibles.
6. Pulsa «Guardar»
   Verás "Vehículo guardado." y la placa aparece en la tabla.

Editar un vehículo

Pulsa Editar en la fila. El modal se titula Vehículo ABC-123. Cambia lo necesario y pulsa Guardar.

Generar o regenerar el QR

1. Pulsa «Generar QR»
   En la fila del vehículo.
2. Revisa el sticker
   Verás "QR generado." (o "QR regenerado: el anterior dejó de funcionar." si ya tenía uno) y se abre el modal Sticker QR del vehículo con el código, la placa y el nombre del cliente.
3. Descárgalo
   Pulsa Descargar PNG (archivo qr-ABC-123.png), imprímelo y pégalo en el vehículo. Cerrar cierra el modal.

Para volver a ver el sticker de un vehículo que ya tiene QR, pulsa Ver QR.

Revocar el QR

Úsalo si el sticker se perdió, se dañó o el vehículo dejó de ser del cliente.

1. Pulsa «Revocar QR»
   Solo aparece si el vehículo tiene QR. Se abre Revocar QR · ABC-123.
2. Escribe el motivo
   Motivo (queda auditado), entre 10 y 200 caracteres.
3. Confirma
   Pulsa Revocar QR. Verás "QR revocado: deja de funcionar de inmediato.".

:::danger No se puede deshacer Un QR revocado o regenerado no vuelve a funcionar. Si el chofer lo presenta en la isla, el POS responderá "El QR no es válido o fue revocado. Pide otra identificación.". Genera uno nuevo y entrega el sticker nuevo. :::

Ver el rendimiento km/gal

1. Pulsa «Rendimiento km/gal»
   En la fila del vehículo. Se abre el modal Rendimiento km/gal con la placa.
2. Elige el rango (opcional)
   Completa Desde y Hasta; el cálculo se rehace al cambiar las fechas. Sin fechas usa todas las cargas.
3. Lee la tarjeta
   Rendimiento en km/gal, los km recorridos, los galones y el número de cargas.

Cómo se calcula: toma las ventas a crédito emitidas de esa placa con odómetro, ordenadas por fecha. Km = último odómetro − primero; galones = suma de las cargas posteriores a la primera; rendimiento = km ÷ galones (3 decimales). Con menos de 2 cargas válidas verás Datos insuficientes. Las cargas con odómetro menor al anterior se excluyen y se avisa: "N carga(s) excluida(s) por odómetro decreciente.".

Campos

Campo	¿Obligatorio?	Descripción
PlacaTexto	Sí	Máximo 8 caracteres, formato ABC-123 o 1234-AB. No puede repetirse dentro del mismo cliente.
DescripciónTexto	No	Por ejemplo "Volvo FH 2019 – volquete". Máximo 80 caracteres.
Capacidad del tanque (gal)Galones	No	Hasta 3 decimales. Si una carga la supera, se envía la alerta de consumo atípico.
Unidad de los límitesLista	Sí	Galones (por defecto) o Soles.
Límite por cargaNúmero	No	Vacío = sin límite. Hasta 3 decimales en galones y 2 en soles; mayor que cero.
Límite diarioNúmero	No	Igual que el anterior, sumando las cargas del día.
Límite mensualNúmero	No	Igual que el anterior, sumando las cargas del mes.
Exige odómetroInterruptor	No	Si está activo, el POS pide el odómetro en cada carga.
Productos permitidos (ninguno marcado = todos)Casillas	No	Productos activos de tu catálogo.

Columnas de la tabla

Columna	Qué muestra
Placa	Placa del vehículo.
Descripción	Texto libre.
Límite diario	En gal o S/, o Sin límite.
Límite mensual	En gal o S/, o Sin límite.
QR	Sí · fecha y hora de generación, o No.

Acciones por fila (según permisos): Rendimiento km/gal, Editar, Generar QR, Ver QR y Revocar QR (estas dos solo si tiene QR). Sin vehículos verás "Sin vehículos registrados.".

:::info Pendiente de confirmar Desde la pantalla no hay botón para eliminar ni para desactivar un vehículo. Si una unidad deja de cargar a crédito, revoca su QR y consulta al administrador del sistema. :::

Mensajes de error frecuentes y qué hacer

Mensaje	Por qué pasa	Qué hacer
"Placa inválida (ej. ABC-123)." / "Placa inválida (formato ABC-123 o 1234-AB)."	La placa no tiene formato peruano válido.	Corrígela.
"La placa ya está registrada para este cliente."	Esa placa ya existe en la flota del cliente.	Edita el vehículo existente.
"Número con hasta 3 decimales." / "Número con hasta 2 decimales."	Límite con demasiados decimales.	Ajusta el número.
"Debe ser mayor que cero (hasta 3 decimales)."	Pusiste 0 o un valor negativo en un límite o en la capacidad.	Déjalo vacío si no quieres límite.
"El vehículo no tiene un QR vigente."	Pediste ver el QR de un vehículo sin QR.	Pulsa Generar QR.
"Indica el motivo (10 a 200 caracteres)."	Motivo de revocación muy corto.	Explica el motivo.
"No se pudo calcular el rendimiento."	Falló la consulta.	Pulsa Reintentar.

Relación con otros módulos

• Choferes autorizados: cada chofer puede limitarse a ciertos vehículos.
• Venta a crédito en el POS: cómo se usan placa, QR, límites y odómetro.
• Cobranzas y anticipos: el estado de cuenta muestra el consumo por placa.

Ejemplo

Camión ABC-123 de Transportes Sol del Sur, unidad Galones: límite por carga 80.000, diario 150.000, mensual 2,500.000, solo Diésel B5, exige odómetro, tanque de 90.000 gal.

• Hoy ya cargó 100.000 gal. Si intenta cargar 60.000 gal más (total 160.000), el POS rechaza con "Se supera el límite diario del vehículo."; un supervisor puede autorizar la excepción.
• Si intenta cargar Gasohol 95, el POS responde "Este producto no está permitido para el vehículo.".
• Rendimiento del mes: odómetro del 01/10 = 120,500 km y del 30/10 = 123,800 km (3,300 km); galones de las cargas posteriores a la primera = 412.500 → 8.000 km/gal.