Pantalla de turnos y sus botones

Para qué sirve

Turnos de playa es el tablero del jefe de playa. Desde aquí se hace casi todo sin cambiar de pantalla: abrir, relevar, registrar cortes y despachos, cerrar, declarar, aprobar y consultar el historial de turnos.

Dónde está

Menú:Operación›Turnos/turnos

Quién puede

• Ver la pantalla: Permisoturnos.ver
• Cada botón aparece solo si tienes su permiso (ver la tabla de botones por estado).

Partes de la pantalla

1. Cabecera

Título Turnos de playa y el subtítulo "Apertura con lecturas y asignaciones, relevos, despachos no comerciales y cierre." A la derecha:

• Programar turnos del día (con Permisoturnos.abrir) → Programar turnos.
• Abrir turno (con Permisoturnos.abrir) → Abrir turno.

2. Turno actual

Una tarjeta por cada turno de tu estación activa que esté Abierto o En cierre (puede haber dos a la vez: el nuevo abierto y el anterior en cierre). Cada tarjeta muestra Turno actual, el código, el estado y "Abierto 06/10/2026 06:00 · Juan Pérez" (quién lo abrió), y estos botones:

Botón	Cuándo aparece	Qué hace
Botones de cierre	Según estado y permisos (ver Botones por estado)	Cerrar, lecturas finales, declaraciones, cerrar y aprobar.
Ver detalle	Siempre	Detalle del turno.
Relevo	Turno abierto y Permisoturnos.asignar	Relevo.
Asignar manguera libre	Turno abierto y Permisoturnos.asignar	Asignar manguera libre.
Despacho no comercial	Turno abierto o en cierre y Permisoturnos.registrar_no_comercial	Despachos no comerciales.

Si no hay ningún turno abierto ni en cierre verás "No hay un turno abierto en la estación."

3. Aviso de cortes pendientes

Si durante el turno abierto cambió el precio de un producto, debajo de las tarjetas aparece el recuadro Lecturas de corte pendientes por cambio de precio, con una línea por manguera afectada, por ejemplo: "Manguera 3 — Gasohol 90 · S/ 15.4900 → S/ 15.8900 · 06/10/2026 18:00" y el botón Registrar lecturas de corte (con Permisoturnos.registrar_lecturas). Sin ese permiso verás "Avise al jefe de playa para registrar las lecturas de corte." Ver Cortes por cambio de precio.

4. Filtros

Filtro	Qué hace
Estación	Solo aparece si tienes acceso a más de una estación. Por defecto, la estación activa.
Estado	Todos los estados, Programado, Abierto, En cierre, Cerrado o Aprobado.
Desde / Hasta	Rango de fecha operativa.

La tabla se actualiza sola al cambiar un filtro.

5. Tabla de turnos

Ordenada del más reciente al más antiguo (fecha operativa y número), 20 por página.

Columna	Qué muestra
Turno	Código, por ejemplo E01-20261006-T2.
Fecha operativa	Día en que empezó el turno.
Estado	Programado, Abierto, En cierre, Cerrado o Aprobado.
Apertura	Fecha y hora en que se abrió (en un programado, la hora prevista).
Abrió	Quién lo abrió (— si aún no se abre).

Si no hay resultados: "No hay turnos con esos filtros."

Botones por estado

Los mismos botones aparecen en la tarjeta del turno actual y en cada fila de la tabla. El botón principal (el que más conviene hacer ahora) sale en color sólido.

Estado del turno	Botón	Permiso	Qué hace
Abierto	Cerrar turno (principal)	Permisoturnos.cerrar	Pide confirmación, pasa el turno a En cierre (se detiene la venta) y abre de inmediato las lecturas finales de las mangueras.
En cierre	Lecturas finales	Permisoturnos.registrar_lecturas (no basta con Permisoturnos.cerrar)	Abre las lecturas finales solo de las mangueras que aún no la tienen. Si ya están todas: "Lecturas completas: todas las mangueras ya tienen su lectura final."
En cierre	Declaraciones	Permisoturnos.cerrar	Abre Declaraciones del turno: el dinero de cada vendedor, para declarar por él, confirmar su cuadre o confirmar todos.
En cierre	Cerrar y aprobar (principal)	Permisoturnos.cerrar y Permisoturnos.liquidar	Cierra el turno y, si se puede, aprueba el cierre en el mismo paso. Si no se puede aprobar, ofrece Solo cerrar y explica por qué.
En cierre	Cerrar turno (principal)	Permisoturnos.cerrar sin Permisoturnos.liquidar	Cierra el turno; "un supervisor aprobará el cierre después."
Cerrado	Aprobar cierre (principal)	Permisoturnos.liquidar	Pide confirmación y aprueba el cierre.
Cualquiera	Ver detalle	Permisoturnos.ver	Resumen del turno con pestañas.
Aprobado o Programado	Solo Ver detalle

Cuando hay varias acciones, la prioridad para elegir la principal es: Cerrar turno → Cerrar y aprobar → Aprobar cierre → Lecturas finales → Declaraciones.

:::info El menú «Más» en el celular En pantallas pequeñas, si una fila tiene más de dos acciones, solo el botón principal queda a la vista y el resto (por ejemplo Lecturas finales, Declaraciones y Ver detalle) se guarda en el botón Más. Tócalo para desplegarlas. En pantallas medianas o grandes se ven todas en línea. :::

:::tip Asistente de cierre Además de estos botones directos existe el asistente de cierre, una pantalla completa con los cuatro pasos del cierre. Se abre desde Ver detalle (botones Cerrar turno, Continuar el cierre o Ver cierre) o desde el botón Abrir asistente de cierre de la ventana de pendientes. Ver Cierre de turno. :::

Estados y reglas

• Las acciones de cierre se evalúan contra el estado real del turno: si otra persona lo cambió mientras tanto verás "El turno cambió de estado. Se actualizó la lista."
• Una acción a la vez por turno: un doble toque no ejecuta dos veces.
• Relevo, Asignar manguera libre y Despacho no comercial solo están en la tarjeta del turno actual, no en la tabla.
• La pantalla se refresca sola cuando abres un turno, registras lecturas, haces un relevo, registras un despacho o cambia un precio ("Cambió un precio: registra las lecturas de corte de las mangueras afectadas.").

Mensajes de error frecuentes y qué hacer

Mensaje	Por qué pasa	Qué hacer
"No se pudo cargar el turno actual." (con Reintentar)	Falla de conexión.	Pulsa Reintentar.
"El turno ya no admite esta operación."	Quisiste hacer un relevo, despacho o corte en un turno que ya no está abierto o en cierre.	Revisa el estado del turno.
"El turno cambió de estado. Se actualizó la lista."	Otra persona avanzó el cierre.	Mira el nuevo estado y continúa.

Relación con otros módulos

• Cierre de turno, Declaraciones y cuadre por vendedor, Aprobar cierre, Detalle del turno.

Ejemplo

Son las 14:10 del 06/10/2026. Como jefe de playa (con permiso de cerrar pero no de aprobar) ves:

• Tarjeta E01-20261006-T2 · Abierto con Cerrar turno, Ver detalle, Relevo, Asignar manguera libre y Despacho no comercial.
• Tarjeta E01-20261006-T1 · En cierre con Lecturas finales, Declaraciones, Cerrar turno (principal) y Ver detalle.
• En la tabla, E01-20261005-T3 en Cerrado: no ves Aprobar cierre porque no tienes Permisoturnos.liquidar; el administrador sí lo verá.