Cómo usar los turnos en TMD

Qué resuelve esta guía\n\nEsta guía te sirve para entender cómo funcionan los turnos en TMD, dónde revisar el historial y qué información puedes validar cuando abres o cierras caja.\n\nLa ruta de consulta es: /app/pos/turnos.\n\nOjo: esta pantalla sirve para ver el historial y el detalle de cada turno. La apertura y el cierre del turno se hacen desde el panel principal del POS, no desde la tabla de historial.\n\n## Antes de empezar\n\nAntes de trabajar con turnos, toma en cuenta esto:\n\n- necesitas tener activo el módulo de Punto de Venta\n- debes entrar con tu usuario a la operación del POS\n- si no hay turno abierto, el POS mostrará la pantalla Turno Cerrado\n- la página /app/pos/turnos muestra historial, estado, responsable y total vendido por turno\n- al cerrar un turno, TMD registra el arqueo de caja con efectivo esperado, efectivo real y diferencia\n\nSi todavía estás dejando listo tu POS, primero revisa Cómo administrar módulos en TMD y luego Cómo crear y administrar mesas en POS.\n\n## 1. Revisa el historial en /app/pos/turnos\n\nDentro del menú lateral del POS entra a Turnos.\n\nAhí verás una tabla con el historial de turnos registrados. Cada fila muestra:\n\n- Apertura\n- Cierre\n- Estado\n- Responsable\n- Total ventas\n- botón Ver para abrir el detalle\n\nSi tienes muchos registros, TMD muestra paginación para cambiar de página. Si todavía no existe historial, verás el mensaje No hay turnos registrados.\n\n## 2. Abre un turno desde el POS\n\nCuando no hay turno activo, el POS muestra la vista Turno Cerrado con el botón Abrir Turno Ahora.\n\nAl tocarlo, se abre el modal Apertura de Turno. Ahí debes capturar el efectivo inicial con el que empieza la caja.\n\n### Si abres con efectivo mayor a cero\n\nSolo capturas el monto y confirmas la apertura.\n\n### Si abres con efectivo en cero\n\nTMD pide una confirmación explícita. En ese caso debes:\n\n- dejar el monto en $0\n- marcar la casilla de confirmación\n- opcionalmente escribir un motivo\n\nEsto existe para que el sistema distinga una apertura normal de una apertura sin efectivo inicial hecha a propósito.\n\nCuando el turno abre correctamente, el POS cambia a estado Turno Activo.\n\n## 3. Cierra el turno y registra el arqueo\n\nPara cerrar un turno, usa el botón Cerrar Turno desde la barra superior del POS.\n\nAl hacerlo, TMD abre el modal Cerrar Turno con un resumen del turno actual. Ahí verás:\n\n- Efectivo esperado\n- Ventas en tarjeta\n- Ventas totales\n- número de órdenes completadas\n\nDespués debes capturar el efectivo contado en caja y, si hace falta, agregar notas.\n\nTMD calcula la diferencia entre lo esperado y lo real en ese momento. Así puedes detectar sobrantes o faltantes antes de cerrar.\n\nCuando confirmas, el turno se cierra y el sistema te lleva al detalle de ese turno para revisar el resultado final.\n\n## 4. Consulta el detalle de un turno\n\nDesde la tabla de historial, haz clic en Ver.\n\nEn el detalle del turno puedes revisar cuatro bloques:\n\n### Resumen del turno\n\nMuestra:\n\n- fecha y hora de apertura\n- fecha y hora de cierre\n- si el turno sigue abierto o ya está cerrado\n- quién lo abrió\n- quién lo cerró, si ya terminó\n\n### Resumen de ventas\n\nAquí ves:\n\n- total de órdenes\n- total vendido\n- ventas en efectivo\n- ventas en tarjeta\n\n### Arqueo de caja\n\nSi el turno ya está cerrado, aparece el bloque con:\n\n- efectivo inicial\n- efectivo esperado\n- efectivo real\n- diferencia\n\nSi el turno se abrió sin efectivo inicial, también verás el aviso correspondiente y, si se capturó, el motivo.\n\n### Órdenes del turno\n\nAl final puedes revisar las órdenes asociadas a ese turno con datos como:\n\n- número de orden\n- tipo de orden\n- mesa\n- total\n- hora\n\n## Errores comunes\n\n### No encuentro dónde abrir el turno\n\nLa pantalla /app/pos/turnos no abre turnos. Solo muestra historial. La apertura se hace desde el panel del POS cuando aparece la vista Turno Cerrado.\n\n### Dejé el efectivo inicial en cero y no me deja seguir\n\nEs normal. Debes confirmar explícitamente que el turno abre sin efectivo inicial.\n\n### Cerré el turno y quiero revisar qué pasó en caja\n\nEntra a Turnos, ubica el registro y haz clic en Ver para revisar el arqueo y las órdenes de ese turno.\n\n### No veo movimientos en el historial\n\nPuede pasar por dos razones:\n\n- todavía no has generado turnos en esa sucursal\n- estás esperando ver un turno que sigue abierto y aún no has revisado su detalle\n\n## Siguiente paso recomendado\n\nSi ya dejaste controlada la operación de caja, lo más natural es seguir con una guía que complete el flujo del POS:\n\n- para ordenar el salón, sigue con Cómo crear y administrar mesas en POS\n- para imprimir tickets, sigue con Cómo conectar una impresora de tickets\n- si cocina también participa en la operación, sigue con Cómo usar la pantalla de cocina (KDS) en TMD