Control de embarque

Es la pantalla donde registras quién subió realmente al bus. A medida que los pasajeros abordan los vas marcando —escaneando el QR de su boleto o a mano— y al final sabes con exactitud quién viajó, quién sigue pendiente y quién no se presentó. El conteo se actualiza en vivo y todo queda reflejado en el manifiesto.

Está pensada para usarse desde el celular en el andén: botones grandes, contador visible a distancia y un solo toque para cada acción.

¿En qué se diferencia del manifiesto?

El manifiesto es la lista oficial (a quién esperas). El control de embarque es la acción: marcar a cada uno cuando sube. Uno se lee, el otro se opera.

¿Cuándo se usa?

En el andén, en el momento de abordar, justo antes de que salga el bus. Lo ideal es marcar a cada pasajero cuando sube, no todos al final: así el conteo es fiable y no se te escapa nadie.

Necesitas el permiso de embarque

Para escanear o marcar necesitas el permiso ventas.embarcar. Sin él, la pantalla se abre pero las acciones quedan inertes. Pídeselo a tu administrador (usuarios y roles).

Paso 1 — Elegir la salida (filtro por fecha y placa)

Arriba de la pantalla hay un filtro con dos campos, y debajo la lista de salidas que cumplen. Se elige la salida con un toque (ya no es un buscador desplegable).

Campo	Para qué sirve	Detalle
Fecha	Elige el día de la salida.	Arranca en hoy. Al cambiarla, la lista de salidas se recarga al instante.
Placa	Filtra por la unidad.	Escribe la placa (o parte). Filtra mientras tecleas; deja vacío para ver todas las de esa fecha.

La búsqueda por placa es tolerante: no distingue mayúsculas ni guiones ni espacios, así que "ABC-123", "abc123" o "ABC 123" encuentran la misma unidad.

Debajo aparece la lista de salidas elegibles. Cada tarjeta muestra:

• La ruta (arriba, en negrita).
• La hora · placa (debajo).

Toca la salida que vas a embarcar: queda resaltada y se carga su lista de chequeo. Si el filtro no encuentra nada, verás "No hay salidas para esos filtros.".

Al abrir la pantalla ya ves las de hoy

Como la fecha arranca en hoy y la placa vacía, apenas entras se listan todas las salidas de hoy. Escribe la placa solo si necesitas acotar a un bus concreto.

Paso 2 — La lista de chequeo y el contador

Al elegir una salida se muestra el panel de embarque. Lo primero es el contador, en grande:

embarcados / total

Por ejemplo, 12 / 40 significa que de 40 pasajeros vendidos, 12 ya subieron. Se actualiza solo con cada marca. El total son los pasajes vendidos de esa salida (las reservas sin pagar y los anulados no cuentan).

Debajo del contador tienes el conmutador de vista y las acciones.

Vista Lista

Es la vista por defecto. Muestra una tarjeta por pasajero, con:

Elemento	Qué es
Asiento	Número de asiento (a la izquierda).
Nombre	Nombres y apellidos del pasajero.
Código	Código del boleto/venta.
Estado (badge)	Embarcado (con la hora en que subió) o Pendiente.
Botón "Marcar"	Aparece solo si el pasajero está pendiente; al tocarlo, lo marca como embarcado.

Si la salida no tiene pasajeros, verás "Esta salida no tiene pasajeros.".

Vista Croquis

Toca Croquis en el conmutador para ver el mapa del bus. Cada asiento vendido se pinta según su estado de embarque y es clicable para marcarlo; los asientos no vendidos salen como Libre e inertes (no se pueden tocar). Cada asiento muestra su número y el nombre del pasajero.

Los estados de embarque y sus colores en el croquis son:

Color	Estado	Significado
Gris claro	Libre	Asiento sin vender: no se marca.
Amarillo	Pendiente	Vendido, aún no ha subido.
Verde	Subió	Embarcado: el pasajero abordó.
Rojo	No subió	No se presentó (no show).

El selector "Al tocar un asiento"

Encima del croquis hay un selector que decide qué hace un toque sobre un asiento:

Opción	Al tocar el asiento…
Subió (por defecto)	Lo marca como embarcado.
No subió	Lo marca como no_show (no se presentó).
Pendiente	Lo devuelve a pendiente (deshace la marca).

Además funciona como toggle: si tocas un asiento que ya está en el estado del botón activo, un segundo toque lo regresa a pendiente. Por ejemplo, con "Subió" activo, tocar un asiento ya embarcado lo desmarca. Así corriges un error con el mismo botón, sin cambiar de opción.

Lista o croquis, tú eliges

La lista es cómoda para ir bajando pasajero por pasajero; el croquis es útil para ver de un golpe cuántos asientos siguen pendientes y para marcar por ubicación. Ambas vistas comparten el mismo contador y se mantienen sincronizadas.

Paso 3 — Marcar el embarque

Tienes dos formas de marcar. Puedes combinarlas libremente.

Escanear el QR (recomendado)

El botón Escanear QR aparece solo si tu dispositivo tiene cámara y lector de QR. Al tocarlo se abre la cámara; apunta al QR del boleto (el que sale impreso en el comprobante) y el sistema lo procesa automáticamente. Puedes escanear un boleto tras otro sin cerrar la cámara. Al terminar, pulsa Cerrar para volver a la lista.

Qué ocurre según el caso:

• Boleto válido y pendiente → se marca embarcado y verás "Embarcado: <código>.". Si la venta tenía varios pasajes en esa salida, se marcan todos los que faltaban de una vez.
• Ya estaba embarcado → "Ese boleto ya estaba embarcado (<código>).". No pasa nada malo: sigue con el siguiente.
• Nada que marcar → "Nada que embarcar para ese boleto." (todos sus pasajes ya estaban embarcados).

Marcar a mano (fallback)

El marcado manual siempre está disponible, tengas cámara o no:

• En la vista Lista, toca Marcar en la tarjeta del pasajero pendiente → verás "Pasajero embarcado.".
• En la vista Croquis, toca el asiento con el selector en la acción deseada (Subió / No subió / Pendiente).

El sistema valida, tú solo lees el código

Al escanear, el celular solo lee el código; es el servidor el que decide si ese boleto embarca (que sea de esta salida, que no esté anulado). Por eso, aunque escanees un boleto ajeno o anulado, no se marca nada indebido: el sistema lo rechaza con un aviso.

¿Qué ocurre después de marcar?

• El contador embarcados / total sube (o baja, si desmarcas).
• La tarjeta del pasajero cambia su badge a Embarcado con la hora de embarque; en el croquis el asiento cambia de color.
• El manifiesto reflejará el nuevo estado la próxima vez que lo generes: quién quedó Embarcado y quién Pendiente.
• Marcar No subió es solo un registro: no libera el asiento ni toca la caja. Sirve para dejar constancia de que la persona no se presentó.

Casos límite y preguntas frecuentes

Un pasajero con boleto no aparece en la lista

Confirma que estás en la salida correcta (fecha, hora y placa). Si es la correcta, puede que su pasaje sea una reserva sin pagar (no embarca hasta confirmarse) o que la venta fuera anulada. En el control solo aparecen los pasajes vendidos.

Escaneé dos veces el mismo boleto

No hay problema: la segunda vez el sistema avisa "Ese boleto ya estaba embarcado (…)." y no lo cuenta de nuevo. El embarque es idempotente.

No hay cámara en mi dispositivo

El botón Escanear QR no aparece si no hay cámara disponible. Usa el marcado manual: toca Marcar en la lista o el asiento en el croquis. El resultado es idéntico.

El boleto es de otra salida

El sistema lo rechaza con "El boleto no corresponde a esta salida.". Verifica que elegiste la salida correcta arriba; si el pasajero se equivocó de bus, deriva el caso al cajero.

Una reserva sin pagar no embarca

Correcto: una reserva no es una venta. El asiento reservado no habilita el embarque hasta que se confirma y cobra la reserva. Una vez cobrada, aparece en la lista.

Marqué a alguien por error → cómo lo desmarco

En la vista Croquis, con el selector en el mismo estado que marcaste, toca de nuevo el asiento: el toggle lo devuelve a pendiente. O elige la opción Pendiente y toca el asiento. Así corriges sin salir del andén.

Validaciones y errores

Estos son los mensajes que puede mostrar el sistema al escanear o marcar (el texto viene del servidor; no cambia):

Mensaje	Por qué aparece	Qué hacer
Escanea un boleto válido.	El código llegó vacío o no se leyó nada legible.	Vuelve a escanear apuntando bien al QR.
El boleto no corresponde a esta salida.	El boleto es de otra salida.	Verifica que estás en la salida correcta; deriva al cajero si el pasajero se equivocó de bus.
El boleto está anulado.	La venta fue anulada.	No embarca. Revisa la venta con el cajero.
Boleto no encontrado.	El código no corresponde a ninguna venta de tu empresa.	Recarga la lista y verifica el código/la salida.
Boleto no encontrado o salida ajena.	El código no pertenece a esta salida (aviso del control tras un rechazo).	Recarga la lista y confirma la salida.
Pasaje no encontrado en esta salida.	Intentaste marcar a mano un pasaje que no está (vendido) en esta salida.	Recarga la lista; el pasaje pudo cambiar de estado.
Estado de embarque inválido.	Se intentó aplicar un estado que no existe.	No debería ocurrir en uso normal; recarga la página.
El boleto está anulado o no es de esta salida.	Aviso general del control cuando el servidor rechaza el boleto.	Verifica salida y estado de la venta con el cajero.

Además, si algo falla al cargar, puedes ver: "No se pudieron cargar las salidas.", "No se pudo cargar la lista de embarque.", "No se pudo cargar el croquis." o "La cámara no está disponible; usa el marcado manual." — en todos los casos, reintenta o recurre al marcado manual.

Correcciones en el andén

Si marcaste a alguien por error, puedes desmarcarlo (toggle a pendiente) mientras sigues en el andén. Si un pasajero con boleto no aparece, confirma que su venta es de esta salida y que no fue anulada.

Enlaces relacionados

• Manifiesto y croquis — la lista oficial que este control va marcando.
• Comprobantes — dónde se imprime el QR que escaneas.
• Reservar — por qué una reserva sin pagar no embarca.
• Anular — por qué un boleto anulado no embarca.