8. Módulo Restaurante (restaurant)

El módulo Restaurante agrega al sistema el servicio de mesas y comidas rápidas: mesas con una cuenta abierta por visita, comandas que llegan a una pantalla de cocina por estación, turnos para llamar al cliente que pidió para llevar y, opcionalmente, recetas que calculan el costo y la ganancia de cada plato a partir de los insumos comprados.

Requiere el módulo activo para la empresa (capítulo 5). Grupo de menú: Restaurante (Mesas, Cocina, Turnos, Recetas, Configuración).

La regla que ordena todo el módulo: la cuenta de una mesa es una orden normal del sistema (capítulo 2, órdenes/precuenta). El módulo la abre, le agrega productos a precio de lista y la imprime como precuenta; el cobro se hace en la pantalla de ventas de siempre, cargando esa orden. Por eso los meseros no necesitan caja abierta ni permisos de venta.

8.1 Permisos del módulo

Permiso	Habilita
rest-manage-config	Restaurante → Configuración: ajustes, áreas y mesas, estaciones de cocina y su ruteo.
rest-serve	Mesas: abrir mesas y pedidos para llevar, enviar a cocina, precuenta, cambiar cliente, mover de mesa.
rest-adjust-tab	Sobre lo anterior: ajustar la cuenta (cantidades/quitar), anular una cuenta y anular comandas; ver las visitas con factura anulada.
rest-kitchen	Cocina y Turnos: ver la cola, despachar, reimprimir, «Comanda desde factura».
rest-manage-recipes	Recetas: crear y editar recetas (ve cantidades, no costos).
rest-view-costs	Ver costo por porción, precio base y margen en recetas, y los reportes de márgenes y consumo.
rest-view-reports	Reportes operativos del módulo (tiempos de cocina, resumen de servicio).

Cobrar usa el permiso normal de ventas (create-invoices) y una caja abierta.

8.2 Configuración

Ruta: Restaurante → Configuración (permiso rest-manage-config). La pantalla muestra arriba un aviso con lo que falta para poder abrir mesas.

Ajustes

Ajuste	Qué hace
Tipo de orden	El tipo de orden de venta con el que nace cada cuenta (por ejemplo prefijo MES sobre el documento POS). Sin él no se puede abrir una mesa.
Habilitar «Para llevar»	Muestra el botón Para llevar en el salón.
«Enviar a cocina» marcado por defecto	Estado inicial de la casilla en cada venta nueva de mostrador (ver 8.5).
Imprimir el turno en la impresora del cajero	Al enviar una venta de mostrador a cocina, imprime un tiquete pequeño con el turno.
Segundos de refresco de cocina	Cada cuánto se actualizan las pantallas de cocina y turnos (2 a 60; por defecto 5).
Minutos en el llamador	Cuánto permanece un turno despachado en la pantalla de turnos (1 a 120; por defecto 15).
Consumir inventario por recetas	Al facturar un plato con receta, descuenta sus insumos del inventario (ver 8.8). Apagado por defecto.

Además el módulo necesita la Sucursal POS predeterminada de Configuración → Empresa: es el "consumidor final" con el que se abre toda cuenta.

Áreas y mesas

Ruta: Restaurante → Configuración → Áreas y mesas. Las áreas (Salón, Terraza…) son opcionales y solo agrupan. Cada mesa tiene código corto (M1), nombre, área, puestos y orden. El estado libre/ocupada no se edita: lo decide el sistema según haya una cuenta abierta. No se puede desactivar una mesa con cuenta abierta.

Estaciones de cocina y ruteo

Ruta: Restaurante → Configuración → Estaciones de cocina. Normalmente basta una estación Cocina; una Bar cuesta lo mismo. Cada estación puede tener una impresora (la comanda sale sola al enviarla). En la pestaña Ruteo de categorías se marca qué categorías de producto prepara cada estación (por ejemplo COMIDAS → Cocina). Reglas:

• Una categoría pertenece a una sola estación; si ya está tomada, el sistema dice cuál la tiene.
• Un producto cuya categoría no está ruteada (las bebidas, típicamente) entra a la cuenta pero nunca genera comanda: se sirve de barra.

8.3 Atender mesas

Ruta: Restaurante → Mesas (permiso rest-serve). Pensada para teléfono o tableta: botones grandes y actualización automática cada pocos segundos.

El salón

Cada área muestra sus mesas como tarjetas: libre (neutra) u ocupada (resaltada) con el turno T-047, las personas, el tiempo transcurrido, el total acumulado y cuántas comandas siguen pendientes en cocina. A la derecha, los pedidos para llevar abiertos y —para supervisores— las visitas de hoy cuya factura fue anulada.

• Tocar una mesa libre abre el diálogo Abrir mesa (personas, opcional) y pasa a la pantalla de la cuenta.
• Tocar una mesa ocupada entra directo a su cuenta.
• Si otro mesero abrió la mesa un segundo antes, el sistema lo detecta, actualiza el salón y entra a esa misma cuenta.

La pantalla de la cuenta

Arriba: mesa, turno, personas, hora de apertura y quién abrió; a la derecha el estado (Abierta / Facturada / Anulada) y, si ya se cobró, el enlace a la factura.

Enviar a cocina (la caja de arriba a la izquierda) es el pedido que se arma ahora, no la cuenta: busque productos (código o nombre + Enter, o F4 para saltar al buscador), ajuste cantidades con − / +, escriba la nota por ítem ("sin cebolla") y una nota general si aplica, y presione Enviar (F10). El sistema:

1. agrega los ítems a la cuenta al precio de lista de la sucursal (nunca se digita un precio);
2. corta una comanda por estación con los ítems ruteados, e imprime si la estación tiene impresora (si falla la impresión, la comanda igual queda en la pantalla de cocina y se avisa);
3. confirma con un mensaje: "Comanda enviada: Cocina #2" o "Agregado a la cuenta (sin comanda)" cuando solo había bebidas.

Los envíos se suman: cada Enviar es una comanda nueva (#1, #2, #3…). Lo ya enviado no se vuelve a mandar.

Cuenta: lo que el cliente debe hasta ahora, con subtotal, IVA y total. Un supervisor (rest-adjust-tab) puede Ajustar cantidades o quitar líneas; si un producto reducido tiene comanda pendiente, el sistema advierte porque la cocina no se entera sola: anule la comanda desde la lista si corresponde.

Comandas: las de esta cuenta con estado (Pendiente / Despachada / Anulada), horas y líneas. Reimprimir está disponible para cualquier mesero; Anular comanda (con motivo) solo para rest-adjust-tab.

Acciones:

Botón	Qué hace
Precuenta	Muestra el tiquete *** PRECUENTA - NO ES FACTURA *** de la cuenta y permite Imprimir en la impresora del usuario. Se puede repetir.
Cobrar	Abre la pantalla de ventas con la orden ya cargada (?orden=MES12). Requiere caja abierta y permiso de ventas (lo valida la pantalla de ventas).
Cliente	Pone la cuenta a nombre de un tercero (la precuenta sale con su nombre y sus precios de lista). El cajero puede cambiarlo igual al cobrar.
Mover	Traslada la cuenta a otra mesa libre. Un pedido para llevar movido a una mesa pasa a ser una mesa.
Anular mesa / pedido	(rest-adjust-tab) Cancela la cuenta y saca de cocina sus comandas pendientes. No toca caja ni inventario.

8.4 Cobrar

El cobro es la venta normal del capítulo 2: Cobrar lleva a Nueva venta con las líneas de la cuenta y el consumidor final cargados. El cajero puede cambiar el cliente si el comensal quiere factura a su nombre, registra el pago y guarda. Al facturar:

• la cuenta queda Facturada, la mesa vuelve a libre y la pantalla de la cuenta enlaza la factura;
• las comandas pendientes siguen en cocina (un pedido para llevar paga primero y espera después);
• si el cajero agregó algo en la caja que la cocina no vio (un postre), puede marcar Enviar a cocina en la venta: solo se envía la diferencia.

Si más tarde la factura se anula por completo, la visita aparece en el salón bajo Facturas anuladas hoy para que un supervisor decida qué hacer; la mesa no se reabre sola.

8.5 Para llevar y ventas de mostrador

Hay dos formas de atender sin mesa:

1. Desde el salón — «Para llevar» (si está habilitado): abre una cuenta sin mesa con un turno y, opcionalmente, el nombre para llamar. Funciona igual que una mesa (enviar, precuenta, cobrar) y aparece en la columna derecha del salón.
2. Desde la pantalla de ventas — casilla «Enviar a cocina»: con el módulo activo, la venta de mostrador muestra bajo las observaciones la casilla Enviar a cocina con la pista "N ítems irán a cocina" y un campo opcional Nombre para llamar. Al guardar la venta, la vista de éxito muestra en grande "Turno T-047" con las comandas creadas. La casilla arranca según el ajuste por defecto y el cajero decide venta por venta; si nada de la venta va a cocina, queda deshabilitada ("Nada para cocina").
   • Si el envío falla (red, cocina caída) la vista de éxito lo dice y ofrece Reintentar; también puede enviarse luego desde Cocina → Comanda desde factura con el número de la factura.
   • Cada factura se envía una sola vez: un segundo intento responde "ya fue enviada a cocina (turno …)".

8.6 Cocina

Ruta: Restaurante → Cocina (permiso rest-kitchen). Pantalla de letra grande para tableta o monitor; se refresca sola cada pocos segundos, también en segundo plano. Selector de estación (Todas, Cocina, Bar…) que la pantalla recuerda en ese dispositivo.

Cada comanda es una tarjeta en orden de llegada: MESA M5 · T-047 · Comanda #2 (o PARA LLEVAR · Juan · T-048 · …), la estación, el cronómetro desde el envío (cambia de color a los 10 y 20 minutos), las líneas 2 × Carne asada con su nota en cursiva, la nota general y el borde resaltado en las recién llegadas.

• Despachado: cierra toda la comanda, registra la hora y la saca de la lista.
• Casilla por línea: despacha solo esa línea; al despachar la última, la comanda se cierra sola.
• Reimprimir: vuelve a enviarla a la impresora de la estación.
• Historial de hoy: lo despachado y anulado, con minutos hasta el despacho.
• Comanda desde factura: red de seguridad para una venta de mostrador que no llegó a cocina (número de factura → turno).

Si se pierde la conexión, la pantalla conserva lo último que vio y muestra un aviso pequeño; nunca una ventana que tape las comandas. La cocina no anula comandas: eso lo hace un supervisor desde la cuenta de la mesa.

8.7 Turnos (llamador)

Ruta: Restaurante → Turnos (permiso rest-kitchen). Pantalla para el cliente: muestra en grande los turnos para llevar cuyas comandas ya fueron despachadas (el más reciente primero, hasta 8), con el nombre debajo, durante los minutos configurados; al lado, la columna Preparando con los turnos aún en cocina. Botón de pantalla completa. Las mesas no se llaman: se sirven.

8.8 Recetas y costos

Ruta: Restaurante → Recetas (permiso rest-manage-recipes; costos y márgenes solo con rest-view-costs). Una receta dice de qué insumos está hecho un plato: por ejemplo Carne asada = 0,250 Kg de carne + 0,200 Kg de papa. Los insumos son productos normales que se compran (capítulo 2, compras), y de esas compras sale su costo promedio.

• Listado: producto, porciones y —con permiso— costo por porción, precio base (sin IVA), margen y margen %. La insignia Sin costo completo marca recetas con algún insumo sin compras registradas. Filtros: búsqueda, estado, categoría, solo incompletas. Nueva receta elige el plato (los que ya tienen receta se editan desde la lista).
• Editor: porciones que rinde la lista, notas y las líneas: ingrediente (búsqueda), cantidad en la unidad del ingrediente (200 g de un producto en Kg se escriben 0.2; el botón g → Kg divide entre 1000), merma % y —con permiso— costo unitario y de línea. A la derecha, Costo y margen se recalcula mientras escribe: costo/porción, precio de venta (IVA incl. y base), margen y margen %; al guardar, los valores del servidor reemplazan el cálculo. Un plato puede ser ingrediente de otro (salsas, bases); el sistema impide ciclos.
• Consumir inventario por recetas (ajuste, apagado por defecto): con él encendido, cada plato no inventariable facturado descuenta sus insumos del inventario (kardex Consumo por receta) con el costo del momento; anular la factura por completo lo devuelve (Reversión de receta). Actívelo solo cuando las recetas estén completas. Un plato inventariable se descuenta a sí mismo y su receta sirve solo para costear.

8.9 Reportes de restaurante

En Reportes → Restaurante (solo con el módulo activo):

Reporte	Permiso	Qué muestra
Tiempos de cocina	rest-view-reports	Comandas por estación y día: enviadas, despachadas, anuladas, minutos promedio/p90/máximo, hora pico. Filtro por estación.
Resumen de servicio	rest-view-reports	Visitas por día (mesas vs para llevar), comensales, duración, ticket promedio, ventas, mesas más usadas.
Márgenes por receta (teórico)	rest-view-costs	Costo de hoy de cada plato frente al precio de la lista predeterminada; peor margen primero; marca INCOMPLETO.
Consumo por recetas (real)	rest-view-costs	Insumos descontados por los platos facturados en el período, con costo real y margen; excluye anuladas.

Todos en PDF o Excel, como los del núcleo (capítulo 4.1).

8.10 Mensajes frecuentes

Mensaje	Causa y acción
Falta configurar: el tipo de orden… / la sucursal POS predeterminada	Complete Restaurante → Configuración y Configuración → Empresa.
La mesa ya fue abierta por otro usuario	Otro mesero la abrió antes; el sistema entra a esa cuenta.
Hay comandas pendientes con: …	Redujo un producto que la cocina aún prepara; anule la comanda si aplica.
La categoría «X» ya está asignada a la estación «Y»	Una categoría solo puede ir a una estación; quítela de la otra primero.
Esta factura ya fue enviada a cocina (turno …)	La venta ya tiene comandas; busque el turno en Cocina.
Nada para cocina	Ningún producto de la venta tiene categoría ruteada a una estación.
Las recetas forman un ciclo	Un ingrediente termina usando la receta que lo contiene; corrija la lista.
Sin costo completo	Algún insumo no tiene compras: registre la compra o cambie el insumo.