Punto de Venta (POS)

El Punto de Venta (POS por sus siglas en inglés: Point of Sale) es la herramienta central para registrar todas las ventas de tu negocio. A partir del refactor de sucursales, el POS opera dentro del scope de una sucursal específica: los productos que aparecen son los del menú de esa sucursal (con sus overrides), las cuentas de mesa están filtradas por sucursal, y al cambiar de sucursal el carrito se vacía automáticamente para evitar mezclar ventas entre ubicaciones.

Esta guía te explica absolutamente todo lo que necesitas saber, desde lo más básico hasta los casos especiales del POS multi-sucursal.

---

Antes de empezar

Antes de usar el POS por primera vez, asegúrate de tener listo lo siguiente:

1. Sucursal activa seleccionada: En el encabezado del panel verás un selector de sucursal gestionado por useManagerBranch. El POS respeta esta selección. Si eres dueño, elige la sucursal donde vas a operar antes de empezar a vender. Si eres empleado, tu sucursal ya está fija y no puedes cambiarla.
2. Productos cargados por sucursal: Los productos que aparecen en el catálogo del POS se cargan mediante getDigitalMenuItems(negocioId, branchId). Esto significa que verás los productos del menú de la sucursal activa, incluyendo sus overrides de precio y disponibilidad. Verifica en Catálogo que cada sucursal tenga sus productos configurados.
3. Categorías organizadas: Los productos deben estar agrupados en categorías (Entradas, Platos Fuertes, Bebidas, Postres). Esto hace que encontrar productos en el POS sea mucho más rápido.
4. Mesas configuradas por sucursal: Cada sucursal tiene su propio floor plan en Mesas > Editor de Planos. Las mesas que aparecen en el POS al agregar a cuenta de mesa son exclusivamente las de la sucursal activa.
5. Usuarios con permisos: Asegúrate de que la persona que va a usar el POS (cajero, mesero, encargado) tenga una cuenta de usuario con los permisos adecuados. Los empleados están fijos en su sucursal.
6. Conexión a internet estable: El POS funciona en línea, por lo que necesitas una conexión confiable. Si tu internet falla, no podrás registrar ventas hasta que se restablezca.
7. Impresora configurada (opcional): Si vas a imprimir tickets o comandas, conecta y configura tu impresora térmica antes de empezar a vender.

---

Paso a paso detallado

Paso 1: Abrir el Punto de Venta y verificar la sucursal activa

1. Ingresa al panel de administración de Emelit Express con tu usuario y contraseña.
2. Verifica la sucursal activa en el selector del encabezado. Si eres dueño, selecciona la sucursal donde vas a operar (ejemplo: “Café del Centro - Sucursal Roma”). Si eres empleado, tu sucursal ya está asignada y no puedes cambiarla.
3. En la barra lateral izquierda, busca la opción que dice Vender. Esta palabra suele tener un icono de carrito o de bolsa de compras.
4. Haz clic en Vender. La pantalla cambiará a una vista de pantalla completa.
5. Lo que ves en pantalla: A la izquierda o en el centro aparece una cuadrícula con los productos de la sucursal activa (cargados con getDigitalMenuItems(negocioId, branchId)). Cada producto se muestra como una tarjeta con su foto, nombre y precio — que puede tener un override distinto al de otras sucursales. A la derecha aparece el carrito de compras.

Paso 2: Seleccionar productos del catálogo de la sucursal

1. Observa la cuadrícula de productos. Si tienes muchos productos, usa los chips de categoría que aparecen en la parte superior del catálogo. Por ejemplo, verás chips como “Entradas”, “Platos”, “Bebidas”, “Postres”.
2. Haz clic en una categoría para filtrar. La cuadrícula ahora solo muestra los productos de esa categoría dentro de la sucursal activa.
3. Para ver todos los productos de nuevo, haz clic en el chip que dice “Todos” o “Todo”.
4. Buscar por nombre: Si sabes el nombre del producto pero no lo encuentras visualmente, usa la barra de búsqueda en la parte superior del catálogo. Escribe parte del nombre y presiona Enter. El sistema filtrará instantáneamente.
5. Para agregar un producto al carrito, simplemente haz clic en la tarjeta del producto.
6. Importante: Si un producto no está disponible en la sucursal activa (por ejemplo, la sucursal Norte no vende postres), no aparecerá en el catálogo. Esto es controlado por los overrides de cada sucursal.

Paso 3: Seleccionar variantes (si aplica)

1. Si el producto tiene variantes (por ejemplo, un café que viene en chico, mediano y grande), al hacer clic aparecerá una ventana emergente (modal) en el centro de la pantalla.
2. En la ventana verás las opciones disponibles. Por ejemplo, tres botones: “Chico - $35”, “Mediano - $45”, “Grande - $55”. Los precios pueden variar entre sucursales.
3. Haz clic en la variante que el cliente pidió.
4. El producto se agrega automáticamente al carrito con la variante seleccionada.
5. Si el producto NO tiene variantes, se agrega al carrito inmediatamente sin mostrar ninguna ventana.

Paso 4: Revisar y ajustar el carrito

1. Mira el panel derecho de la pantalla. Ahí se muestra el carrito de compras con todos los productos que has agregado.
2. Cada línea del carrito muestra:
   • El nombre del producto
   • La cantidad actual (por defecto 1)
   • El precio unitario
   • El subtotal (cantidad x precio)
3. Cambiar cantidad: Para aumentar la cantidad de un producto, haz clic en el botón ”+” al lado de la cantidad. Para disminuirla, haz clic en ”-”. Si reduces la cantidad a 0, el producto se elimina automáticamente del carrito.
4. Usar el teclado numérico: También puedes hacer clic directamente sobre el número de cantidad y escribir el número deseado con el teclado de tu computadora.
5. Eliminar un producto: Cada línea del carrito tiene un icono de bote de basura o una “X”. Haz clic ahí para eliminar ese producto del carrito.
6. Total acumulado: En la parte inferior del carrito, verás el total de la venta actualizado en tiempo real.

Paso 5: Entender el comportamiento del carrito al cambiar de sucursal

CAMBIO CLAVE del refactor de sucursales:

• Si eres dueño y cambias la sucursal activa en el selector del encabezado mientras tienes productos en el carrito, el carrito se vacía automáticamente.
• Esto evita que mezcles productos de diferentes sucursales en una misma venta, ya que los precios y la disponibilidad pueden variar entre ubicaciones.
• El sistema muestra una notificación: “Se cambió de sucursal. El carrito se ha vaciado para evitar mezclar ventas entre ubicaciones.”
• Si necesitas continuar una venta, asegúrate de tener la sucursal correcta seleccionada antes de agregar productos al carrito.
• Los empleados no experimentan este comportamiento porque no pueden cambiar de sucursal.

Paso 6: Cobrar la venta

1. Cuando el carrito tenga todos los productos que el cliente pidió, haz clic en el botón grande que dice Cobrar. Normalmente está en color verde o azul en la parte inferior del carrito.
2. Se abrirá una nueva ventana o pantalla donde debes elegir el modo de venta y completar datos adicionales.

Paso 7: Elegir el modo de venta

Aparecerán tres opciones o pestañas. Elige la que corresponda:

• Venta Directa: El cliente está frente a ti, paga y se va. Es la opción más rápida y simple.
• Agregar a Cuenta de Mesa: El cliente está sentado en una mesa del restaurante. El pedido se acumula en la cuenta de esa mesa para que pague todo al final. Las mesas disponibles son únicamente las de la sucursal activa.
• Manual (Teléfono / WhatsApp): El cliente hizo su pedido por teléfono o por mensaje de WhatsApp. Debes registrar sus datos para contacto y entrega.

Paso 8: Seleccionar tipo de servicio

Independientemente del modo de venta, debes elegir cómo recibirá el cliente su pedido:

• Pickup (Recoger en tienda): El cliente vendrá al local a recoger su pedido. El sistema le asignará un código para que lo presente al llegar. No necesitas ingresar dirección.
• Consumo local: El cliente come en el restaurante. Debes asociar el pedido a una mesa de la sucursal activa. Selecciona la mesa de la lista desplegable (solo aparecen mesas de la sucursal actual).
• Domicilio: El pedido se entrega en la dirección del cliente. Necesitas ingresar la dirección completa.

Paso 9: Completar datos del cliente

Para ventas de Domicilio y Manuales, debes llenar:

1. Nombre del cliente: Escribe el nombre completo o como se identifique el cliente. Ejemplo: “Maria Lopez”.
2. Teléfono: Escribe el número a 10 dígitos. Ejemplo: “5512345678”.
3. Dirección (solo Domicilio): Escribe calle, número, colonia, y referencias. Ejemplo: “Av. Reforma 222, Col. Juarez, frente al parque, edificio rojo, Depto 4”.
4. Notas adicionales (opcional): Cualquier instrucción especial. Ejemplo: “Sin cebolla”, “Tocar el timbre del portón negro”.

Paso 10: Confirmar la venta

1. Revisa que todos los datos sean correctos: productos, cantidades, total, datos del cliente.
2. Haz clic en el botón Confirmar o Finalizar Venta.
3. El sistema registrará la venta asociada a la sucursal activa y te mostrará una confirmación en pantalla.
4. Si tienes impresora configurada, se imprimirá automáticamente el ticket o la comanda.
5. El carrito se vacía automáticamente y el POS queda listo para la siguiente venta.

Paso 11: Consultar cuentas de mesa filtradas por sucursal

1. Ve a Pedidos > Cuentas de Mesa.
2. La lista que aparece muestra únicamente las cuentas de las mesas de la sucursal activa.
3. Si eres dueño y cambias de sucursal en el selector del encabezado, la lista se actualiza para mostrar las cuentas de la nueva sucursal seleccionada.
4. Esto evita confusiones entre sucursales: nunca verás cuentas de mesa de otra ubicación mezcladas con las de tu sucursal actual.

---

Ejemplo práctico

Imagina que tienes una cafetería llamada “Café del Centro” con dos sucursales: Roma y Condesa. Es viernes por la tarde.

Cliente 1: Venta directa en mostrador (Sucursal Roma)

Un señor llega al mostrador de la sucursal Roma y pide un “Café Americano Grande” y un “Croissant de Almendras”.

Qué haces en el POS paso a paso:

1. Verificas que el selector del encabezado diga “Café del Centro - Roma”. Si no es así, lo cambias.
2. Abres Vender desde la barra lateral.
3. Haces clic en el chip de categoría Bebidas Calientes.
4. Buscas “Café Americano” en la cuadrícula y haces clic.
5. Aparece la ventana de variantes: Chico ($35), Mediano ($45), Grande ($55). En la sucursal Roma el grande cuesta $55; en Condesa podría tener un override distinto. Haces clic en “Grande - $55”.
6. El producto aparece en el carrito: “Café Americano (Grande) x1 - $55.00”.
7. Ahora buscas el croissant en la categoría Panadería y Postres.
8. Haces clic en “Croissant de Almendras”. No tiene variantes, se agrega directo.
9. El carrito muestra:
   • Café Americano (Grande) x1 - $55.00
   • Croissant de Almendras x1 - $42.00
   • Total: $97.00
10. Haces clic en Cobrar > Venta Directa > Consumo local > Físico > Confirmar. Venta registrada en sucursal Roma.

Cliente 2: Mesa con cuenta acumulada (Sucursal Roma)

Una pareja se sienta en la Mesa 3 de la sucursal Roma. Piden dos “Capuccinos Medianos” y un “Pay de Queso”.

Qué haces en el POS paso a paso:

1. Asegúrate de que el selector siga en “Roma”.
2. Agregas los productos al carrito:
   • Capuccino (Mediano) x2 - $45 c/u = $90.00
   • Pay de Queso x1 - $55.00
   • Total parcial: $145.00
3. Haces clic en Cobrar > Agregar a Cuenta de Mesa.
4. Aparece una lista de mesas. Solo verás las mesas de la sucursal Roma (M1, M2, M3… según el floor plan de Roma). Seleccionas Mesa 3.
5. Tipo de servicio: Consumo local. Origen: Físico. Confirmas.
6. El pedido NO se cobra aún. Se acumula en la cuenta de la Mesa 3 de Roma.

Escenario clave: Cambio de sucursal vacía el carrito

Más tarde, te dicen que la sucursal Condesa necesita ayuda. Cambias el selector del encabezado de “Roma” a “Condesa”.

1. El carrito que tenías con productos de Roma se vacía automáticamente. Ves una notificación: “Se cambió de sucursal. El carrito se ha vaciado.”
2. La cuadrícula de productos se actualiza con los productos del menú de Condesa (cargados con getDigitalMenuItems(negocioId, branchId)). Algunos productos pueden tener precios distintos o no estar disponibles.
3. Las cuentas de mesa que ves ahora son las de Condesa, no las de Roma.
4. Empiezas a vender en Condesa con un carrito limpio.

---

Flujo de trabajo recomendado

Para negocios con una sola sucursal

1. Llega el cliente al mostrador y te dice su pedido.
2. Abres el POS y agregas los productos.
3. Confirmas el total verbalmente con el cliente.
4. El cliente paga (efectivo o tarjeta con tu terminal bancaria).
5. Haces clic en Cobrar > Venta Directa > Confirmar.
6. Entregas los productos al cliente.

Para restaurantes con servicio en mesa multi-sucursal

1. Saludar al cliente y preguntarle en qué mesa se sienta.
2. Verificar que la sucursal activa en el selector sea la correcta.
3. Tomar el pedido en una libreta o memorizarlo.
4. Ir al POS, agregar los productos y enviarlos a la cuenta de la mesa correspondiente (solo aparecen mesas de la sucursal activa).
5. El sistema acumula automáticamente.
6. Cuando el cliente pida la cuenta, ir a Pedidos > Cuentas de Mesa, localizar la mesa (de la sucursal activa), revisar el total y cobrar.

Para dueños que supervisan varias sucursales

1. Si necesitas vender en una sucursal específica, selecciona esa sucursal en el encabezado antes de agregar productos al carrito.
2. Recuerda que cambiar de sucursal vacía el carrito automáticamente.
3. Para revisar cuentas de mesa de otra sucursal, cambia el selector y ve a Pedidos > Cuentas de Mesa. La lista se actualiza al instante con las cuentas de la nueva sucursal.

---

Errores comunes y soluciones

Error 1: “Cambié de sucursal y se vació mi carrito”

Causa: Es el comportamiento esperado del POS multi-sucursal. Al cambiar la sucursal activa, el carrito se vacía para evitar mezclar productos de diferentes ubicaciones.

Solución: Asegúrate de tener la sucursal correcta seleccionada antes de empezar a agregar productos al carrito. Si necesitas terminar una venta, tendrás que volver a agregar los productos en la sucursal correcta.

Error 2: “Agregué un producto equivocado al carrito”

Solución: Busca el producto incorrecto en el carrito y haz clic en el icono de eliminar (bote de basura o X). Agrega el producto correcto. Si ya cobraste la venta, NO se puede modificar. En ese caso, contacta al administrador del sistema.

Error 3: “No encuentro un producto en el catálogo”

Causas probables:

• El producto no está disponible en la sucursal activa (override de disponibilidad).
• El producto no está creado en el catálogo.
• El producto está desactivado.
• Estás en un filtro de categoría que no incluye ese producto.

Solución: Primero, haz clic en “Todos” para quitar cualquier filtro. Luego usa la barra de búsqueda. Si aún no aparece, ve a Catálogo > Productos y verifica que el producto exista, esté activo y esté disponible en la sucursal activa.

Error 4: “No puedo seleccionar una mesa al agregar a cuenta”

Causa probable: La mesa no está creada en el floor plan de la sucursal activa, o estás viendo el floor plan de otra sucursal.

Solución: Ve a Mesas > Editor de Planos, asegúrate de tener la sucursal correcta seleccionada, cambia a modo Editar y agrega la mesa que necesitas. Guarda los cambios. Regresa al POS, cierra y vuelve a abrir la ventana de Cobrar para que se actualice la lista de mesas.

Error 5: “Las cuentas de mesa de mi otra sucursal no aparecen”

Causa: Las cuentas de mesa están filtradas por sucursal. Solo ves las cuentas de la sucursal activa en el selector del encabezado.

Solución: Cambia el selector de sucursal del encabezado a la sucursal cuyas cuentas quieres ver. La lista en Pedidos > Cuentas de Mesa se actualizará automáticamente.

Error 6: “El total no coincide con lo que calculé”

Causa probable: Agregaste un producto de más o las variantes tienen precios diferentes a los que pensaste. Recuerda que los precios pueden tener overrides distintos por sucursal.

Solución: Revisa línea por línea el carrito. Verifica cantidades y precios. Si hay un error, ajusta las cantidades o elimina y vuelve a agregar.

---

Preguntas frecuentes

¿Puedo ver los productos de todas mis sucursales a la vez en el POS?

No. El POS muestra únicamente los productos del menú de la sucursal activa, cargados con getDigitalMenuItems(negocioId, branchId). Si quieres ver los productos de otra sucursal, debes cambiar el selector del encabezado (y el carrito se vaciará automáticamente).

¿Puedo cobrar con tarjeta de crédito o débito desde el POS?

El POS de Emelit Express no procesa pagos con tarjeta directamente. El botón de Cobrar confirma la venta en el sistema, pero el cobro físico lo haces tú con tu terminal bancaria, efectivo o cualquier otro medio.

¿Qué pasa si cambio de sucursal con productos en el carrito?

El carrito se vacía automáticamente. El sistema te notifica que se cambió de sucursal y que el carrito se ha vaciado para evitar mezclar ventas entre ubicaciones. Esto es un comportamiento intencional del refactor de sucursales.

¿Puedo dejar una venta a medias y continuar después?

El carrito del POS es temporal. Si cierras la ventana o navegas a otra sección, el carrito se perderá. Además, si cambias de sucursal, el carrito se vacía. Por eso es importante completar la venta de una sola vez. Si necesitas pausar, no cierres la ventana del POS ni cambies de sucursal.

¿Las cuentas de mesa se comparten entre sucursales?

No. Cada sucursal tiene sus propias mesas y sus propias cuentas de mesa activas. Cuando cambias de sucursal, las cuentas que ves corresponden únicamente a esa sucursal. No hay forma de ver cuentas de otra sucursal sin cambiar el selector.

¿El POS funciona en una tablet o celular?

El panel de Emelit Express es responsivo. Sin embargo, para una mejor experiencia en mostrador, se recomienda usar una computadora de escritorio o laptop con pantalla de al menos 13 pulgadas.

¿Puedo tener dos sesiones del POS abiertas en sucursales diferentes al mismo tiempo?

Sí. Puedes tener una computadora con el POS abierto en la sucursal Roma y otra en la sucursal Condesa. Cada sesión opera dentro del scope de su propia sucursal. Cada sesión es independiente y los pedidos se sincronizan en tiempo real.

¿Qué hago si un cliente pide algo que no está en el menú de mi sucursal?

Puedes crear un producto “genérico” o “comodín” en tu catálogo, por ejemplo “Pedido Especial” con precio variable. Al venderlo, agregas en las notas qué es lo que realmente pidió el cliente. Luego, si ese producto se vuelve frecuente, agrégalo formalmente al catálogo de esa sucursal.

¿Puedo ver el historial de ventas del día por sucursal?

Sí, ve a Pedidos y filtra por la fecha de hoy. Ahi veras todas las ventas registradas, con sus montos, productos y origen, dentro del alcance de tu sucursal activa.

¿Los empleados pueden cambiar de sucursal en el POS?

No. Los empleados están fijos en su sucursal asignada y no pueden cambiar el selector del encabezado. Solo los dueños pueden alternar entre “Todas” y una sucursal específica.