Salidas y frecuencias

Estos dos conceptos son la base de todo lo que se vende. Conviene tenerlos muy claros porque se parecen, pero no son lo mismo.

• Una salida es un viaje concreto: una ruta, una fecha, una hora y un bus específicos. Por ejemplo, "Lima → Trujillo, 20 de julio, 22:00, bus de placa ABC-123". Cada salida es la que aparece en la pantalla de venta y sobre la que el cajero vende asientos.
• Una frecuencia es una plantilla que genera salidas solas, de forma automática. Por ejemplo, "Lima → Trujillo, todos los días a las 22:00, del 1 de julio al 31 de diciembre". La creas una vez y el sistema va creando cada salida diaria por ti.

Regla de oro

La frecuencia no vende nada por sí misma: solo fabrica salidas. Las salidas fabricadas son idénticas a las que crearías a mano, con las mismas validaciones y el mismo precio congelado.

¿Cuándo uso cada una?

Situación	Usa
Un viaje que no se repite, o un extra para una fecha puntual (feriado, refuerzo).	Salida puntual
Un servicio fijo que se repite (diario, o ciertos días de la semana).	Frecuencia
Un mismo horario pero con bus/conductor distinto cada día.	Frecuencia (la plantilla puede dejar el bus/conductor por definir y se asigna al generar)

---

Programar una salida puntual

1. Entra a Salidas desde el menú.
2. Presiona Nueva salida.
3. Completa el formulario:
   • Ruta (obligatorio): el trayecto con sus tramos, por ejemplo Lima → Trujillo.
   • Bus (obligatorio): el vehículo, con su croquis de asientos. Debe estar operativo y con los asientos numerados.
   • Tipo de servicio (obligatorio): VIP, Económico, etc. Influye en el precio.
   • Conductor (obligatorio): el chofer asignado.
   • Copiloto y Terramoza (opcionales): el resto de la tripulación.
   • Fecha y hora de salida.
4. Guarda. La salida se crea en estado programada y recibe su código correlativo (ver más abajo).

No se programa en el pasado

No puedes crear una salida cuya fecha y hora ya pasaron. Revisa la fecha antes de guardar.

Qué ocurre al guardar (efectos)

Guardar una salida no es solo "anotarla". El sistema, en un solo paso y todo-o-nada, hace lo siguiente:

• Valida las dependencias: comprueba que la ruta, el bus, el tipo de servicio y el personal existan y sean de tu empresa. Si algo no es tuyo o no existe, no deja continuar.
• Revisa cruces de bus y de conductor (ver Guardianes).
• Revisa los documentos del bus y del conductor.
• Congela los precios: toma la tarifa vigente de cada tramo y categoría y la guarda pegada a la salida. A partir de ahí, aunque cambies la tarifa, esa salida conserva el precio con el que nació. Así el precio que ve el cajero es estable.
• Asigna el código correlativo y crea la salida en estado programada.

Precio congelado = precio estable

Si más adelante subes las tarifas, las salidas ya programadas no cambian de precio. Solo las salidas nuevas nacerán con la tarifa nueva. Si necesitas ajustar el precio de una salida ya creada, edítalo desde sus precios congelados (requiere el permiso de editar precios).

El código de la salida

Cada salida recibe un código único con el formato S<AÑO>-<correlativo>, por ejemplo S2026-000123. El año es el año de la fecha de viaje y el correlativo reinicia cada año. La numeración no deja huecos y es correlativa por empresa. Este código aparece en el manifiesto y sirve para identificar la salida sin ambigüedad.

---

Estados de una salida

Una salida recorre un ciclo de vida. Conocer el estado te dice qué se puede hacer con ella:

Estado	Qué significa	Qué se puede hacer
Programada	Recién creada; aún no habilitada para vender.	Editar, pasar a En venta o cancelar.
En venta	Habilitada; el cajero puede vender asientos.	Vender, editar, pasar a Embarcando o cancelar.
Embarcando	El bus está en el paradero recibiendo pasajeros.	Control de embarque, pasar a En ruta o cancelar.
En ruta	El bus ya partió.	Pasar a Finalizada. Ya no se edita ni se cancela.
Finalizada	El viaje terminó.	Solo consulta. Estado final.
Cancelada	La salida se anuló.	Solo consulta. Estado final.

Cómo avanza de estado

El sistema solo permite avanzar por el camino natural. Las transiciones válidas son:

programada  →  en_venta  →  embarcando  →  en_ruta  →  finalizada
     └─────────────┴──────────────┴──────── (cancelar) ─────────┘

• No puedes "saltar" pasos (por ejemplo, de programada directo a en ruta).
• No puedes retroceder (una salida en ruta no vuelve a en venta).
• Cancelar es una acción aparte: puede hacerse desde programada, en venta o embarcando, y además da de baja la salida. No se puede cancelar una salida que ya está en ruta o finalizada.

No existe un estado "cerrada" por corte de venta

El corte de venta (dejar de vender minutos antes de la salida) no cambia el estado: la salida sigue en venta, pero deja de ofrecerse en la pantalla de venta para ese tramo. Es un filtro automático, no un estado. Ver Corte de venta.

Finalización automática

Aunque el operador puede pasar una salida a finalizada a mano, hay una red de seguridad automática: un proceso del sistema marca como finalizada toda salida (no cancelada) cuya hora de salida más un margen ya pasó. El margen por defecto es de 6 horas y se ajusta en Ajustes avanzados → Operaciones. Esto evita que queden salidas viejas "colgadas" en venta.

---

Corte de venta por tramo

El corte de venta es el momento en que se deja de vender una salida. En TitanicBus el corte se calcula por tramo, no por el origen de la ruta. Esto es clave para rutas con paradas intermedias:

• Cada punto de embarque tiene su hora de paso (la hora de salida del origen más los minutos que tarda el bus en llegar a ese punto).
• Se deja de vender un tramo cuando faltan menos de X minutos para que el bus pase por su punto de embarque, no para que salga del origen.
• Así, los paraderos intermedios siguen vendiendo hasta casi la llegada del bus, aunque el origen ya haya partido.

Los minutos de corte se configuran en Ajustes avanzados → Operaciones (el valor corte de venta antes de la salida). Ver también, del lado del cajero, Vender un pasaje.

---

Cambiar el bus de una salida

Si el bus asignado falla o se cambia, puedes reasignar el vehículo conservando los pasajeros ya vendidos (esto es distinto del transbordo, que mueve pasajeros a otra salida). El sistema:

• Exige que el bus nuevo sea de tu empresa, operativo, con el croquis numerado y sin cruce con otra salida.
• Re-mapea cada pasaje por número de asiento: si el mismo número existe en el bus nuevo, el pasajero lo conserva; si no, deberás reubicarlo eligiéndole otro asiento.
• Si algún pasajero queda sin asiento equivalente y no lo reubicas, el cambio se bloquea (nadie puede quedarse sin sitio).

No se puede cambiar el bus de una salida que ya está en ruta, finalizada o cancelada.

---

Crear una frecuencia

1. Entra a Frecuencias.
2. Presiona Nueva frecuencia.
3. Completa:
   • Ruta y Tipo de servicio (obligatorios).
   • Bus y Conductor (opcionales en la plantilla, pero necesarios para que genere salidas; ver más abajo).
   • Hora de salida (formato HH:MM).
   • Días en que se repite, escritos con las letras LMXJVSD (ver la tabla de abajo).
   • Vigencia desde y, opcionalmente, vigencia hasta. Sin "hasta", la frecuencia no caduca.
   • Activo: si está apagada, la frecuencia existe pero no genera salidas.
4. Guarda.

Las letras de los días

Cada día de la semana tiene una letra. Combínalas sin espacios:

Letra	Día
L	Lunes
M	Martes
X	Miércoles
J	Jueves
V	Viernes
S	Sábado
D	Domingo

Ejemplos: LMXJV = de lunes a viernes · SD = sábados y domingos · LMXJVSD = todos los días.

Cómo genera salidas una frecuencia

El sistema recorre una ventana de los próximos días (por defecto 14 días) y, por cada fecha que cae en los días marcados y dentro de la vigencia, crea una salida usando exactamente el mismo proceso que "Nueva salida" (mismas validaciones, mismos precios congelados).

• La generación es idempotente: si una salida ya fue creada para esa frecuencia, fecha y hora, no se duplica. Puedes volver a correr la generación sin miedo.
• Una frecuencia incompleta (sin bus o sin conductor) se omite con un aviso: es solo una plantilla hasta que le asignes tripulación.
• Si una fecha concreta choca (cruce de bus/conductor, documento vencido, etc.), esa salida se omite con un aviso, pero no rompe la generación del resto.

Las frecuencias te ahorran trabajo repetitivo

Si tu servicio es fijo, usa frecuencias: no tendrás que crear cada salida a mano día por día. Con una sola plantilla mantienes semanas de programación.

La frecuencia no generó salidas — cómo diagnosticarlo

Revisa, en orden:

1. ¿Está activa? Una frecuencia apagada no genera nada.
2. ¿Tiene bus y conductor asignados? Sin ambos, es solo una plantilla y se omite.
3. ¿Los días son correctos? Verifica las letras (L M X J V S D). MX no es "marzo", es martes+miércoles.
4. ¿La fecha de hoy está dentro de la vigencia? Si vigencia desde es futura o vigencia hasta ya pasó, no hay fechas que generar.
5. ¿La ruta, el bus y el conductor siguen activos y válidos? Un bus dado de baja o con documento vencido hace que esa fecha se omita.
6. ¿Chocan con otra salida? Si el bus o el conductor ya tienen una salida a esa hora, la fecha se omite con aviso.

---

Validaciones y errores

Al programar o editar una salida

Mensaje	Por qué aparece	Qué hacer
No se puede programar una salida en el pasado.	La fecha y hora ya pasaron.	Elige una fecha y hora futuras.
El bus ya tiene una salida que se solapa en ese horario.	El mismo bus está en otra salida activa cuyo horario se cruza.	Cambia la hora, la fecha o el bus.
El conductor ya tiene una salida que se solapa en ese horario.	El mismo conductor está en otra salida activa que se cruza.	Cambia la hora, la fecha o el conductor.
El bus tiene un documento vencido (SOAT). · (CITV). · (REVISION TECNICA).	Un documento crítico del bus está vencido.	Renueva ese documento del bus antes de programar.
El conductor tiene la licencia vencida (…).	La licencia de conducir del conductor está vencida.	Renueva la licencia antes de programar.
La ruta no tiene tramos configurados. Define los tramos de la ruta antes de programar el viaje.	La ruta elegida no tiene tramos.	Configura los tramos de la ruta.
El bus no tiene asientos configurados. Edita el croquis del bus antes de programar.	El croquis del bus está vacío o tiene asientos sin número.	Edita y numera el croquis del bus.
No se puede editar una salida en_ruta. · finalizada. · cancelada.	El viaje ya arrancó o terminó.	No se edita; solo consulta.
Transición no válida: de '…' no se puede pasar a '…'.	Intentaste saltar o retroceder pasos del ciclo de vida.	Avanza estado por estado en el orden permitido.
No se puede cancelar: la salida tiene pasajes vendidos. Transbórdalos a otra salida o anula sus ventas primero.	Hay boletos vendidos en esa salida.	Transborda esos pasajeros o anula sus ventas, luego cancela.

Al cambiar el bus de una salida

Mensaje	Por qué aparece	Qué hacer
El bus nuevo debe ser distinto del actual.	Elegiste el mismo bus.	Elige otro bus.
El bus no está operativo.	El bus nuevo está fuera de servicio.	Elige un bus operativo.
Hay asientos sin equivalencia en el bus nuevo. Reubica esos pasajeros para completar el cambio.	El bus nuevo no tiene el mismo número de asiento para algunos pasajeros.	Asígnales manualmente otro asiento (reubicación).
No se puede cambiar el bus de una salida en_ruta / finalizada / cancelada.	El viaje ya arrancó o terminó.	No es posible cambiar el bus.

Al crear o editar una frecuencia

Mensaje	Por qué aparece	Qué hacer
Indica los días con letras de LMXJVSD (L=lun … D=dom).	El campo de días está vacío o tiene letras que no son días.	Usa solo L, M, X, J, V, S, D (ej. LMXJV).
Hora inválida (HH:MM).	El formato de la hora es incorrecto.	Escribe la hora como HH:MM (ej. 22:00).
Fecha de inicio de vigencia inválida.	La fecha "desde" está mal escrita.	Usa el formato AAAA-MM-DD.
Fin de vigencia inválido o anterior al inicio.	El "hasta" está mal escrito o es anterior al "desde".	El fin debe ser igual o posterior al inicio.
Ruta no válida. · Tipo de servicio no válido. · Referencia no válida.	La ruta, el tipo de servicio, el bus o el conductor elegidos no existen en tu empresa.	Elige valores válidos de tu catálogo.

---

Guardianes: por qué a veces no deja programar

TitanicBus corre tres verificaciones antes de crear una salida. No son estorbos: evitan que un viaje salga con problemas.

Cruce de bus o de conductor

Un mismo bus (o un mismo conductor) no puede estar en dos salidas a la vez. El sistema calcula la ventana de tiempo de cada salida (la hora más la duración de la ruta) y, si se cruza con otra salida activa del mismo bus o conductor, la rechaza. Cambia la hora, la fecha o el recurso.

Documentos vencidos

El bus no puede tener el SOAT, el CITV o la revisión técnica vencidos, y el conductor no puede tener la licencia vencida. Un documento ausente no bloquea, pero uno vencido sí. Renueva el documento en la ficha del bus o del personal antes de programar.

Límite del plan

Cada plan de suscripción tiene un tope de salidas por mes. Si lo superas, el sistema no deja crear más salidas hasta el siguiente período (o hasta que amplíes el plan).

Enlaces útiles

• Ajustes avanzados → Operaciones: corte de venta y margen de finalización.
• Vender un pasaje: cómo el cajero ve y vende estas salidas.
• Caja y tesorería: a dónde va el dinero de las ventas de una salida.
• Promociones y cupones: descuentos que se aplican al vender una salida.