Gestión del Menú — Restaurantes

El menú digital es el corazón de tu restaurante en Emelit Express. Aquí administras todo lo que los clientes pueden ordenar: productos, precios, categorías, variantes y disponibilidad. Con el sistema de sucursales, tus productos son globales (se comparten entre todas tus sucursales), pero cada sucursal puede personalizarlos con overrides: cambiar el precio, ocultar un platillo, desactivarlo por agotamiento, renombrarlo, ajustar la descripción o usar una imagen distinta. Esta guía te enseñará, con ejemplos reales, cómo dominar cada función.

---

Antes de empezar

Antes de abrir el sistema, ten a la mano lo siguiente:

1. Lista completa de tus platillos con nombres exactos y precios actualizados.
2. Fotos de cada platillo en tu computadora o teléfono, en formato JPG o PNG.
3. Categorías definidas que usas en tu restaurante (ejemplo: Entradas, Sopas, Cortes, Bebidas, Postres).
4. Lista de tus sucursales con el detalle de qué productos se venden en cada una y a qué precio. Esta información es clave para configurar los overrides.
5. Haber iniciado sesión en Emelit Express con tu cuenta de dueño o administrador. Si eres empleado, el sistema ya te fijó en tu sucursal.
6. Saber usar el selector de sucursal que aparece en la barra superior del ManagerLayout. El dueño puede elegir “Todas las sucursales” o una específica; el empleado solo ve su sucursal.

---

Cómo funciona el menú con el sistema de sucursales

Para que todo lo demás tenga sentido, entiende primero estas tres reglas:

1. Los productos son globales. Un producto que creas con “Todas las sucursales” seleccionado se comparte con todas tus sucursales. No tienes que crear el mismo taco cinco veces si tienes cinco locales.
2. Cada sucursal puede tener overrides. Un override es una personalización que aplicas a un producto solo en una sucursal. Puedes cambiar: precio, visibilidad (si se muestra o no), disponibilidad (disponible / agotado), nombre, descripción e imagen.
3. El menú se filtra por la sucursal seleccionada. Si en la barra superior elegiste “Sucursal Centro”, el listado del menú te muestra los productos con los overrides de esa sucursal. Si eliges “Todas las sucursales”, ves el catálogo base sin overrides.

Internamente, cada vez que abres el editor o guardas un cambio, el sistema envía un encabezado X-Manager-Branch-Id con el ID de la sucursal activa. El backend usa ese dato para filtrar lo que ves y para saber a qué sucursal aplicar el override. Tú no haces nada manual: basta con que tengas seleccionada la sucursal correcta antes de editar.

---

Paso a paso detallado

1. Acceder al menú y elegir la sucursal

1. Inicia sesión en tu cuenta de Emelit Express desde tu computadora.
2. En la pantalla principal, busca la barra lateral izquierda. Es una columna gris oscuro con íconos.
3. Localiza el ícono con forma de libro o carta que dice “Menú”.
4. Antes de hacer clic, fíjate en la barra superior de la pantalla: verás un selector de sucursal como un menú desplegable. Si eres dueño, verás “Todas las sucursales” y luego cada una (ejemplo: “Sucursal Centro”, “Sucursal Norte”). Si eres empleado, solo verás el nombre de tu sucursal.
5. Haz clic en el selector y elige “Todas las sucursales” si quieres administrar el catálogo base, o una sucursal específica si quieres personalizarla.
6. Ahora haz clic en Menú. La pantalla cambiará y verás tu lista de productos filtrada por la sucursal seleccionada.

2. Entender la estructura de la página

La pantalla del menú está dividida en dos columnas:

Columna izquierda — Lista de productos:

• En la parte superior verás una barra de búsqueda con un ícono de lupa. Dice “Buscar producto…”.
• Debajo hay botones de filtro: “Todas las categorías”, “Disponibles”, “No disponibles”.
• Más abajo está la lista de categorías con los productos debajo de cada una.
• Cada producto muestra una miniatura de imagen (o un cuadro gris si no tiene), el nombre en negritas y el precio en color verde. Si estás en una sucursal específica, el nombre y precio que ves ya reflejan los overrides de esa sucursal.
• A la derecha de cada producto hay un interruptor verde (disponible) o gris (no disponible). Cambiar este interruptor estando en una sucursal específica crea un override de disponibilidad para esa sucursal.
• Las categorías tienen un ícono de tres rayitas a la izquierda que puedes arrastrar para reordenarlas.

Columna derecha — Panel editor:

• Cuando haces clic en un producto, aquí aparecen sus detalles.
• Tiene cuatro pestañas en la parte superior: Info, Precios, Sucursal, Personalizaciones.
• En la parte inferior están los botones “Guardar” (azul) y “Eliminar” (rojo).

3. Filtrar y buscar productos

1. Buscar por nombre: Haz clic dentro del campo donde dice “Buscar producto…”. Escribe “hamburguesa”. Conforme escribes, la lista se reduce mostrando solo coincidencias. La búsqueda respeta la sucursal seleccionada: si tienes “Sucursal Centro”, busca entre los productos visibles en esa sucursal.
2. Filtrar por categoría: Haz clic en el botón desplegable “Todas las categorías”. Se abre una lista con tus categorías. Selecciona “Bebidas”. Ahora solo verás los productos de esa categoría. Para volver a ver todo, selecciona “Todas las categorías”.
3. Filtrar por disponibilidad: Haz clic en “No disponibles” para ver solo los productos desactivados en la sucursal actual. Útil para revisar qué platillos tienes pausados en ese local específico.
4. Selector de sucursal: ya lo vimos, está en la barra superior. Cambiarlo recarga la lista con los productos y overrides de la sucursal elegida.

4. Ordenar categorías con arrastrar y soltar

1. Coloca el puntero del mouse sobre el nombre de una categoría (ejemplo: “Postres”).
2. Verás que el cursor cambia a una manita que agarra.
3. Mantén presionado el botón izquierdo del mouse.
4. Arrastra hacia arriba o hacia abajo. Una línea azul te mostrará dónde quedará la categoría al soltarla.
5. Suelta el botón del mouse. La categoría se reubica.
6. Así aparecerá en tu menú digital. Recomendación: pon primero las categorías más vendidas.

5. Crear un producto nuevo (catálogo base)

Recomendamos crear productos con “Todas las sucursales” seleccionado para que sean el catálogo base.

1. Haz clic en el botón “Agregar producto” (botón azul, usualmente arriba a la derecha de la lista).
2. Se abre el panel lateral derecho con un formulario vacío en la pestaña Info.
3. Campo Nombre: Haz clic y escribe el nombre exacto. Ejemplo: “Hamburguesa Clásica”.
4. Campo Descripción: Haz clic y escribe una descripción atractiva. Ejemplo: “Carne angus de 180g, queso americano, lechuga fresca, jitomate, cebolla y nuestra salsa secreta. Acompañada de papas a la francesa.”
5. Campo Precio base: Haz clic y escribe el precio en números, sin signo de pesos. Ejemplo: 120. Este es el precio que tendrán todas las sucursales salvo que apliques un override.
6. Campo Categoría: Haz clic en el menú desplegable. Marca una o varias casillas. Ejemplo: “Platos Fuertes” y “Especialidades”.
7. Subir imagen: Verás un recuadro punteado que dice “Arrastra una imagen o haz clic para seleccionar”.
   • Opción A (arrastrar): Abre la carpeta donde tienes la foto. Arrastra el archivo de imagen hasta el recuadro punteado. Suéltalo.
   • Opción B (seleccionar): Haz clic dentro del recuadro. Se abre una ventana para buscar archivos. Navega hasta tu foto, selecciónala y haz clic en “Abrir”.
   • La imagen aparecerá en miniatura dentro del recuadro. Si quieres cambiarla, haz clic en la X de la esquina de la miniatura y sube otra.
8. Revisa que el interruptor de “Disponible” esté en verde (activado).
9. Haz clic en el botón “Guardar” (azul, abajo del panel). Verás una notificación verde: “Producto guardado exitosamente”.
10. El nuevo producto aparece inmediatamente en la lista de la izquierda y queda disponible para todas las sucursales.

6. Editar un producto existente

1. En la columna izquierda, busca el producto que quieres modificar.
2. Haz clic sobre su nombre o su imagen. El panel derecho se carga con los datos actuales.
3. Pestaña Info: Cambia nombre, descripción, precio base, categoría o imagen. Los cambios aquí aplican al catálogo base y se reflejan en todas las sucursales que no tengan override.
4. Pestaña Precios: Revisa y modifica precios por sucursal (versión legacy; cuando apliques overrides usa la pestaña Sucursal).
5. Pestaña Sucursal: Aquí configuras los overrides de la sucursal actualmente seleccionada en la barra superior (ver punto 7).
6. Pestaña Personalizaciones: Administra variantes del producto (tamaños, sabores). Ver la guía de Variantes y Personalizaciones.
7. Al terminar tus cambios, haz clic en “Guardar”. Los cambios se reflejan al instante en tu menú digital.

7. Configurar overrides por sucursal (pestaña Sucursal)

La pestaña Sucursal aparece cuando tienes seleccionada una sucursal específica en la barra superior (no aparece con “Todas las sucursales”). Aquí personalizas cómo se ve y cuánto cuesta el producto solo en esa sucursal.

1. En la barra superior, selecciona la sucursal que quieres personalizar (ejemplo: “Sucursal Norte”).
2. Abre un producto en el panel derecho.
3. Haz clic en la pestaña “Sucursal”.
4. Verás estos campos, todos opcionales. Si los dejas vacíos, el producto usa el valor del catálogo base:
   • Nombre (override): un nombre distinto para esta sucursal. Ejemplo: en la Sucursal Norte lo llamas “Hamburguesa Norteña” en lugar de “Hamburguesa Clásica”.
   • Descripción (override): una descripción propia. Útil si el platillo lleva ingredientes distintos en ese local.
   • Imagen (override): una foto específica para esta sucursal. Carga la imagen del recuadro igual que en la pestaña Info.
   • Precio (override): el precio en pesos para esta sucursal. Ejemplo: si el catálogo base tiene $120, en Sucursal Norte puedes poner $135.
   • Disponible (override): interruptor verde/gris. Si lo pones en gris, el producto no se muestra en el menú de esa sucursal, aunque sigue existiendo en el catálogo base.
   • Visibilidad: si activas la opción de “Ocultar en esta sucursal”, el producto desaparece del menú del cliente solo para esa sucursal. Es distinto a “no disponible”: un producto oculto no se ve nada; un “no disponible” se ve pero marcado como agotado.
5. Llena solo los campos que quieras sobrescribir. Los demás quedan con el valor del catálogo base.
6. Haz clic en “Guardar”. Internamente el sistema hace un PUT /menu-items/:id/branch-settings con los datos del override para esa sucursal.

8. Eliminar un override (volver al catálogo base)

Si ya no quieres personalizar un producto en una sucursal y quieres que vuelva a usar el catálogo base:

1. En la barra superior, selecciona la sucursal (ejemplo: “Sucursal Norte”).
2. Abre el producto y ve a la pestaña Sucursal.
3. Borra los campos que quieras revertir (nombre, descripción, precio) o regresa el interruptor de visibilidad a su valor por defecto.
4. Si quieres borrar todos los overrides de esa sucursal de un golpe, usa el botón “Restablecer a valores base” o el ícono de basura en la pestaña Sucursal. Internamente se ejecuta un DELETE /menu-items/:id/branch-settings que elimina toda la personalización de esa sucursal para este producto.
5. Haz clic en “Guardar”. El producto ya queda igual al catálogo base en esa sucursal.

9. Eliminar un producto del catálogo

Eliminar un producto lo quita de todas las sucursales. Úsalo solo cuando ya no lo vayas a vender en ningún local.

1. Haz clic en el producto que quieres eliminar para abrirlo en el panel derecho.
2. Desplázate hasta abajo del panel.
3. Haz clic en el botón rojo “Eliminar”.
4. Aparece una ventana de confirmación: “¿Estás seguro de eliminar este producto? Esta acción no se puede deshacer.”
5. Si estás seguro, haz clic en “Confirmar”. Si te arrepientes, haz clic en “Cancelar”.
6. El producto desaparece de la lista de todas las sucursales.

Si solo quieres ocultarlo en una sucursal especifica, NO lo elimines: usa la pestaña Sucursal → Visibilidad (ocultar en esta sucursal) o pon el interruptor de Disponible en gris.

10. El dueño ve “Todas” o específica; el empleado siempre en su sucursal

Si eres dueño (o administrador), la barra superior te deja elegir “Todas las sucursales” para administrar el catálogo base, o cualquier sucursal específica para aplicar overrides. Si eres empleado, la barra superior te muestra solo el nombre de tu sucursal y no puedes cambiarla; todo lo que hagas (crear overrides, pausar productos, ajustar precios) queda registrado únicamente en tu sucursal, mediante el encabezado X-Manager-Branch-Id que el sistema envía automáticamente.

---

Ejemplo práctico

Imagina que eres dueño de la Taquería “El Güero” y tienes dos sucursales: Matriz Centro y Sucursal Plaza. Vas a configurar tu menú completo usando el sistema de sucursales.

Paso 1: Crear el catálogo base (Todas las sucursales)

1. En la barra superior seleccionas “Todas las sucursales”.
2. Creas las categorías: Entradas, Tacos, Tortas, Bebidas, Postres, Paquetes.
3. Agregas el “Taco al Pastor” con precio base $25, la “Torta de Bistec” con precio base $45, el “Agua de Jamaica 1L” con precio base $35, y el resto de tu catálogo. Todos quedan disponibles para ambas sucursales.

Paso 2: Aplicar overrides en Sucursal Plaza

1. En la barra superior cambias a “Sucursal Plaza”.
2. Abres “Taco al Pastor”, vas a la pestaña Sucursal y pones el precio en $28 (en Plaza todo cuesta $3 más por la renta del local). Guardas. Internamente se ejecuta PUT /menu-items/:id/branch-settings con el override de precio.
3. Abres “Taco de Chicharrón Prensado”, vas a la pestaña Sucursal y pones el interruptor de Disponible en gris (en Plaza no lo venden). Guardas. La pestaña Sucursal crea un override de disponibilidad para esa sucursal.
4. Abres “Torta de Bistec” y en la pestaña Sucursal le cambias el nombre a “Torta Norteña (especialidad Plaza)” porque ahí le agregan aguacate. Guardas. El override de nombre solo aplica en la Sucursal Plaza; en Centro sigue diciendo “Torta de Bistec”.

Paso 3: Revisar y ordenar

1. Cambias el selector de vuelta a “Todas las sucursales” para ordenar las categorías del catálogo base. Arrastras “Tacos” al primer lugar (es tu categoría estrella), “Entradas” segundo, “Bebidas” tercero y “Postres” al final.
2. Regresas a “Sucursal Centro” y verificas que todo se vea como debe: $25 el pastor, $45 la torta, chicharrón disponible.
3. Cambias a “Sucursal Plaza” y verificas: $28 el pastor, $35 la torta (si overrideaste el precio), torta llamada “Torta Norteña”, chicharrón no disponible.

Paso 4: Activar solo lo disponible

El “Taco de Chicharrón Prensado” en la Matriz Centro solo lo vendes en fines de semana. En la Sucursal Centro lo desactivas (interruptor gris en la pestaña Sucursal) entre semana y lo activas los viernes. En Plaza ya está permanentemente desactivado con el override del paso 2.

Paso 5: Borrar un override

Decides que ya quieres que la “Torta de Bistec” se llame igual en ambas sucursales. En la Sucursal Plaza, abres el producto, vas a la pestaña Sucursal, y usas el botón “Restablecer a valores base” (que internamente ejecuta DELETE /menu-items/:id/branch-settings). Guardas. El nombre vuelve a ser “Torta de Bistec” en ambas sucursales.

---

Flujo de trabajo recomendado

Te recomendamos seguir este orden cada vez que actualices tu menú:

1. Semanal (cada lunes):

   • En “Todas las sucursales”, revisa el catálogo base. Reactiva productos pausados globalmente.
   • Cambia a cada sucursal específica y revisa los overrides de disponibilidad: reactiva lo necesario y pausa lo que no tengas en ese local.
   • Confirma que los precios por override sean correctos en cada sucursal.
   • Actualiza productos que hayan cambiado de receta o presentación.

2. Quincenal (cada 15 días):

   • Revisa qué productos se venden poco (consulta la sección de Analíticas).
   • Considera usar el override de visibilidad para ocultar productos de baja rotación en sucursales específicas, sin borrarlos del catálogo base.
   • Actualiza fotos de platillos que hayan cambiado, ya sea en el catálogo base o solo en una sucursal (override de imagen).

3. Mensual:

   • Haz una revisión completa de todo el menú en “Todas las sucursales”.
   • Compara tus precios por sucursal con la competencia local de cada zona.
   • Planea productos nuevos o de temporada en el catálogo base.
   • Revisa que las descripciones sigan siendo atractivas y correctas.

4. En temporadas especiales (Navidad, Semana Santa, Día de las Madres):

   • Crea una categoría especial (ejemplo: “Menú Navideño”) en el catálogo base.
   • Agrega productos de temporada en “Todas las sucursales”.
   • En las sucursales que no participen, usa el override de visibilidad para ocultarlos.
   • Al terminar la temporada, desactiva o elimina esos productos.

---

Errores comunes y soluciones

Error	Causa	Solución
”Cambié de sucursal y no veo los productos”	Cada sucursal filtra el menú según sus overrides de visibilidad.	Asegúrate de tener la sucursal correcta seleccionada. Si no ves un producto en una sucursal, revisa su override de visibilidad en la pestaña Sucursal.
”El precio no se actualiza en la sucursal”	Cambiaste el precio base en la pestaña Info, pero la sucursal tiene un override de precio que lo sobreescribe.	Ve a la sucursal específica, abre el producto, pestaña Sucursal, y modifica el override de precio o usa “Restablecer a valores base”.
”No puedo guardar el producto”	Dejaste vacío el nombre, precio o categoría del catálogo base (campos obligatorios).	Revisa que todos los campos con asterisco (*) estén llenos en la pestaña Info.
”La imagen no se sube”	El archivo es muy pesado o no es JPG/PNG.	Reduce el tamaño de la imagen a menos de 5 MB. Usa formato JPG o PNG.
”El producto no aparece en el menú digital de una sucursal”	Está oculto en esa sucursal (override de visibilidad) o no disponible (override de disponibilidad).	En la sucursal específica abre el producto, pestaña Sucursal, y revisa visibilidad y disponibilidad.
”Puse mal el precio y ya lo guardé”	Error al teclear.	Vuelve a abrir el producto, corrige el precio (base o el override de la sucursal) y guarda de nuevo.
”Eliminé un producto por accidente”	Confirmaste la eliminación global sin querer.	Queda borrado de todas las sucursales. Tendrás que crearlo de nuevo desde cero en el catálogo base.
”Las categorías no se ordenan al arrastrar”	No estás soltando en el lugar correcto.	Arrastra la categoría hasta que veas la línea azul en la posición deseada, luego suelta.
”No veo la pestaña Sucursal”	Tienes seleccionada “Todas las sucursales” en la barra superior. La pestaña Sucursal solo aparece cuando eliges una sucursal específica.	Cambia el selector de la barra superior a la sucursal que quieres personalizar.
”Mi empleado cambió el precio en otra sucursal”	El empleado quedó libre para editarlo.	El empleado solo puede editar su propia sucursal; el override que cree no afecta a otras sucursales. Si quieres que un empleado no pueda crear overrides, revísa sus permisos con el dueño de la cuenta.

---

Preguntas frecuentes

P: ¿Puedo ponerle dos categorías al mismo producto? R: Sí. Al crear o editar un producto, en el campo de Categoría puedes marcar varias casillas. Por ejemplo, “Hamburguesa Clásica” puede estar en “Platos Fuertes” y en “Combos”.

P: ¿Qué pasa si cambio el precio base en “Todas las sucursales” y ya tengo overrides en una sucursal? R: El override de esa sucursal sigue vigente y sobreescribe al nuevo precio base. Si quieres que esa sucursal use el nuevo precio base, elimina el override con el botón “Restablecer a valores base” en la pestaña Sucursal.

P: ¿Qué pasa si cambio el precio de un producto que ya está en pedidos pendientes? R: Los pedidos que ya se hicieron mantienen el precio anterior. El nuevo precio aplica solo a pedidos nuevos a partir del momento en que guardas el cambio.

P: ¿Cuántas imágenes puedo subir por producto en restaurante? R: Una imagen por producto en el catálogo base. Si necesitas una imagen distinta en una sucursal, usa el override de imagen en la pestaña Sucursal. Si necesitas mostrar variantes (ejemplo: diferente tamaño), consulta la guía de Variantes y Personalizaciones.

P: ¿Puedo copiar un producto para crear uno parecido? R: No hay función de duplicar. Debes crear el nuevo producto desde cero, pero puedes tener abierta la ventana del producto original como referencia.

P: ¿Puedo cambiar el orden de los productos dentro de una misma categoría? R: Los productos se ordenan alfabéticamente de forma automática. No se puede personalizar el orden dentro de una categoría en esta versión.

P: ¿Los cambios en el menú se ven al instante en la app del cliente? R: Sí. En cuanto guardas un cambio (ya sea en el catálogo base o un override en una sucursal), el menú digital que ve el cliente se actualiza inmediatamente en esa sucursal.

P: ¿Puedo poner precios con centavos? R: Sí. El sistema acepta precios como $47.50. Solo escribe el número con punto decimal: 47.50.

P: ¿El empleado puede editar el catálogo base? R: No. El empleado solo puede crear y editar overrides en su propia sucursal. El catálogo base (lo que ve el dueño con “Todas las sucursales”) solo lo puede editar el dueño o el administrador.

P: ¿Cuál es la diferencia entre “no disponible” y oculto? R: “No disponible” significa que el producto sigue mostrándose en el menú del cliente, pero marcado como agotado. “Oculto” significa que el producto no aparece en el menú del cliente en esa sucursal; no existe para él.

P: ¿Qué endpoints usa la pestaña Sucursal? R: El override se guarda con PUT /menu-items/:id/branch-settings y se elimina (Restablecer a valores base) con DELETE /menu-items/:id/branch-settings. En ambas peticiones el sistema incluye automáticamente el encabezado X-Manager-Branch-Id con la sucursal activa.

---

¿Listo para crear tu primer producto? Ve a la sección Crear y Editar Productos para una guía aún más detallada sobre el formulario de creación.