Panel de Pedidos — Restaurantes

El panel de pedidos es donde ocurre la operación diaria de tu restaurante. Aquí ves cada pedido que entra, lo procesas y lo llevas hasta la entrega. A partir del refactor de sucursales, todo el panel respeta la sucursal activa seleccionada en el encabezado: los empleados solo ven los pedidos de la sucursal donde trabajan, y los dueños pueden alternar entre “Todas” y una sucursal específica con un solo clic.

---

Antes de empezar

Antes de usar el panel de pedidos, asegúrate de tener lo siguiente:

1. Acceso al sistema: Tu cuenta de negocio debe estar activa y verificada. Si aún no puedes entrar, contacta a soporte de Emelit Express.
2. Sucursales configuradas: Si tienes más de una sucursal (ejemplo: “Taquería Centro” y “Taquería Norte”), cada una debe estar registrada en Configuración > Sucursales. Cada empleado debe estar asignado a una sucursal fija.
3. Sucursal activa en el encabezado: En la parte superior del panel verás un selector de sucursal. El composable useManagerBranch gestiona este valor. Si eres dueño, puedes elegir “Todas” o una sucursal específica. Si eres empleado, el selector muestra tu sucursal y no puedes cambiarla.
4. Menú actualizado por sucursal: Los productos que vendes deben estar cargados en el sistema con sus precios correctos. Revisa en Configuración > Menú. Recuerda que cada sucursal puede tener sus propios overrides de precio y disponibilidad.
5. Personal capacitado: Todo empleado que maneje pedidos debe saber cómo aceptar, avanzar estados y entregar. El empleado siempre opera dentro de su sucursal asignada.
6. Dispositivo listo: Puedes usar el panel desde:
   • Una computadora de escritorio (recomendado para la cocina o caja).
   • Una tableta (ideal para meseros en el salón).
   • Un teléfono celular (para revisar pedidos desde cualquier lugar).
7. Sonido activado: El sistema reproduce un sonido cada vez que entra un pedido nuevo. Asegúrate de que las bocinas o audífonos estén funcionando para no perder pedidos.

---

Paso a paso detallado

Paso 1: Acceder al panel de pedidos y revisar la sucursal activa

1. Abre tu navegador de internet (Chrome, Edge, Firefox o Safari).
2. Escribe en la barra de direcciones la URL de tu panel de negocio (por ejemplo: mitaqueria.emelitexpress.com).
3. Ingresa tu correo electrónico y contraseña.
4. Haz clic en el botón “Iniciar sesión”.
5. Una vez dentro, mira la barra superior del encabezado. Ahí verás el selector de sucursal gestionado por useManagerBranch.
   • Si eres dueño: puedes elegir “Todas” o una sucursal específica (ejemplo: “Taquería Centro”).
   • Si eres empleado: el selector muestra tu sucursal asignada y está bloqueado. No puedes cambiar de sucursal porque tu cuenta está fija en esa ubicación.
6. En la barra lateral izquierda haz clic en Pedidos. La pantalla cambiará y verás el panel de pedidos.

Lo que ves en pantalla:

• El encabezado con la sucursal activa claramente identificada.
• Una barra superior con pestañas: Activos, Todos, Completados.
• Debajo, una barra de filtros con campos para tipo de servicio, estado y fechas.
• Un buscador para encontrar pedidos por número de orden, nombre o teléfono.
• Una tabla con todos los pedidos (en computadora) o tarjetas (en celular).

Paso 2: Entender el filtrado automático por sucursal

El backend filtra los pedidos según la sucursal activa mediante el encabezado X-Manager-Branch-Id que se envía en cada petición al API:

1. Empleado: El encabezado siempre envía el ID de su sucursal fija. El backend devuelve únicamente los pedidos de esa sucursal. No hay forma de ver pedidos de otras ubicaciones.
2. Dueño con “Todas” seleccionada: El encabezado envía all o se omite. El backend devuelve los pedidos de todas las sucursales del negocio.
3. Dueño con sucursal específica: El encabezado envía el ID de esa sucursal. El backend devuelve solo los pedidos de esa sucursal.

Este filtrado es automático y transparente. No necesitas aplicar ningún filtro manual para ver solo los pedidos de tu sucursal.

Paso 3: Entender las pestañas de estado

En la parte superior del panel verás tres pestañas:

1. Activos: Muestra SOLO los pedidos que necesitan tu atención AHORA, filtrados por la sucursal activa. Incluye pedidos en estado:

   • Pendiente (recién llegaron, no has hecho nada)
   • En preparación (ya los aceptaste y estás cocinando/armando)
   • En camino (el repartidor va rumbo al cliente)
   • Listo (está preparado y esperando al repartidor o al cliente)

2. Todos: Muestra el historial completo dentro del alcance de tu sucursal activa. Útil cuando necesitas buscar un pedido que ya fue entregado hace días.

3. Completados: Muestra únicamente los pedidos que ya fueron entregados satisfactoriamente. Ideal para hacer cortes de caja y conciliaciones por sucursal.

Paso 4: Usar los filtros adicionales

El filtro de sucursal ya está controlado por el selector del encabezado. Los filtros restantes te ayudan a afinar aún más:

1. En el campo Tipo de servicio, selecciona “Domicilio”.
2. En Rango de fechas, haz clic en la fecha de inicio y selecciona la fecha de hoy.
3. Haz clic en la fecha de fin y selecciona también la fecha de hoy.
4. El sistema filtra y muestra únicamente los domicilios de hoy dentro de la sucursal activa.

Puedes combinar filtros. Por ejemplo: Tipo “Domicilio” + Estado “Pendiente” para ver los domicilios nuevos que aún no has aceptado en tu sucursal activa.

Paso 5: Buscar un pedido específico

Cuando un cliente llama preguntando por su pedido, usa el buscador:

1. Ve al campo de búsqueda en la parte superior del panel.
2. Escribe cualquiera de estos datos:
   • Número de orden: por ejemplo “1042”.
   • Nombre del cliente: por ejemplo “Maria” o “Garcia”.
   • Teléfono del cliente: por ejemplo “5551234567”.
3. Mientras escribes, la tabla se filtra en tiempo real mostrando solo los pedidos que coinciden dentro de tu sucursal activa.
4. Cuando encuentres el pedido, haz clic en la fila para ver todos los detalles.

Paso 6: Ver el detalle de un pedido

1. Localiza el pedido que te interesa en la tabla o tarjetas.
2. Haz clic en cualquier parte de la fila del pedido.
3. Se abre un panel lateral (en computadora) o una pantalla completa (en celular) con toda la información:

Lo que ves en el detalle:

• Encabezado: Número de orden, sucursal de origen y estado actual con un círculo de color.
• Productos: Una lista con cada producto, cantidad solicitada, precio unitario y subtotal.
• Datos del cliente: Nombre completo, teléfono, dirección de entrega (si es domicilio), referencias.
• Método de pago: Efectivo, Tarjeta (Visa/Mastercard), o Transferencia.
• Origen de la venta: “App Emelit Express”, “Llamada telefónica”, “WhatsApp”, “Pedido en persona (POS)”.
• Línea de tiempo: Un historial con fecha y hora de cada cambio de estado.
• Total: El monto total del pedido, incluyendo costo de envío si aplica.
• Notas del cliente: Instrucciones especiales como “Sin cebolla por favor” o “Salsa aparte”.

Paso 7: Realizar acciones sobre un pedido

Dependiendo del estado del pedido, verás botones de acción en la parte inferior del detalle o en la columna “Acciones” de la tabla:

Botón	Color	Cuándo aparece	Qué hace
Aceptar	Verde	Estado: Pendiente	Confirmas que recibiste el pedido y empiezas a prepararlo. El cliente recibe una notificación.
Listo	Azul	Estado: En preparación	Marcas que el pedido está preparado y empacado.
Enviar	Naranja	Estado: Listo (solo domicilio)	Confirmas que el repartidor recogió el pedido y va en camino.
Entregar	Verde	Estado: En camino (domicilio) o Listo (pickup)	El cliente recibió su pedido.

Todas las acciones de cambio de estado se ejecutan dentro del contexto de la sucursal activa mediante el encabezado X-Manager-Branch-Id.

---

Ejemplo práctico

Escenario: Pedido a domicilio completo en sucursal específica

Contexto: Eres dueño de “Tacos El Güero” con dos sucursales: Centro y Norte. Son las 2:00 PM del viernes y tienes el selector en “Todas”.

Pedido nuevo #1185 en sucursal Centro:

• Cliente: Laura Martínez
• Teléfono: 55-2345-6789
• Dirección: Calle Independencia #45, Col. Centro, CP 06000. “Departamento 3, timbre B”
• Productos:
  • 3x Tacos de Suadero --- $22.00 c/u
  • 2x Tacos de Pastor --- $18.00 c/u
  • 1x Coca-Cola 600ml --- $25.00
  • 1x Orden de Cebollitas --- $30.00
• Total: $151.00 MXN
• Pago: Efectivo
• Sucursal de origen: Centro
• Nota: “Sin piña en los de pastor por favor”

Paso a paso:

1. 14:00 — Suena la alarma de nuevo pedido. Ves el pedido #1185 en la pestaña “Activos” etiquetado con la sucursal Centro.
2. 14:00 — Quieres enfocarte solo en Centro. Haces clic en el selector del encabezado y eliges “Taquería Centro”. El panel se actualiza automáticamente y ahora solo muestra pedidos de esa sucursal.
3. 14:01 — Haces clic en el pedido #1185. Lees los detalles: 3 de suadero, 2 de pastor, coca, cebollitas. Nota: “Sin piña en los de pastor”.
4. 14:01 — Verificas que tienes tortillas, suadero y pastor en la sucursal Centro. Todo en orden.
5. 14:02 — Haces clic en el botón verde “Aceptar”. El pedido cambia a estado “En preparación”. La petición envía X-Manager-Branch-Id con el ID de Centro.
6. 14:02 — Laura recibe una notificación: “Tacos El Güero (Centro) ha aceptado tu pedido #1185. Tiempo estimado: 25 minutos.”
7. 14:02 a 14:20 — Preparas los tacos, recordando NO poner piña en los de pastor.
8. 14:21 — Empacas todo: tacos en papel aluminio, coca y cebollitas aparte, servilletas y salsas.
9. 14:22 — Haces clic en el botón azul “Listo”. El pedido cambia a estado “Listo”.
10. 14:23 — El sistema asigna al repartidor Carlos Hernández.
11. 14:28 — Carlos llega a Tacos El Güero Centro. Le entregas la bolsa.
12. 14:28 — Haces clic en el botón naranja “Enviar”. El pedido cambia a “En camino”.
13. 14:36 — Carlos entrega a Laura. Laura paga en efectivo $151.00.
14. 14:36 — Carlos confirma la entrega. El pedido cambia a “Entregado”.
15. 14:36 — El pedido #1185 desaparece de “Activos” y se va a “Completados”.

---

Flujo de trabajo recomendado

Para el dueño o gerente multi-sucursal:

1. Al abrir el negocio (8:00 AM):

   • Inicia sesión en el panel.
   • Revisa el selector de sucursal. Si quieres una vista general, déjalo en “Todas”.
   • Revisa la pestaña Activos por si quedaron pedidos sin procesar del día anterior en cualquier sucursal.

2. Durante el día:

   • Cuando necesites enfocarte en una sucursal específica, usa el selector del encabezado para cambiar a esa sucursal. El panel se actualiza al instante.
   • Acepta cada pedido en menos de 2 minutos (la rapidez mejora tu calificación).

3. Horas pico (1:00 PM a 3:00 PM):

   • Asigna a una persona dedicada SOLO al panel de pedidos de cada sucursal.
   • Los empleados de cada sucursal verán automáticamente solo sus pedidos, sin necesidad de filtrar.

4. Al cerrar el negocio (10:00 PM):

   • Revisa que no haya pedidos en estado “Pendiente” o “En preparación” en ninguna sucursal.
   • Ve a la pestaña Completados y verifica el total de ventas del día. Puedes alternar entre sucursales para hacer cortes por ubicación.

Para el cocinero o empleado de una sucursal:

1. Cuando suene un nuevo pedido, voltea a ver la pantalla de inmediato. Solo verás pedidos de tu sucursal.
2. Antes de aceptar, verifica que tengas todos los ingredientes en tu sucursal.
3. Lee las notas del cliente ANTES de empezar a cocinar.
4. Prepara los pedidos en orden de llegada.
5. Antes de marcar “Listo”, revisa físicamente la bolsa: ¿está todo? ¿servilletas? ¿salsas? ¿cubiertos?

---

Errores comunes y soluciones

Error 1: “No veo los pedidos de mi otra sucursal”

Causa: El selector de sucursal del encabezado está en una sucursal específica.

Solución: Si eres dueño, haz clic en el selector del encabezado y elige “Todas” para ver los pedidos de todas tus sucursales. Si eres empleado, solo puedes ver los pedidos de tu sucursal asignada; esto es por diseño.

Error 2: “Acepté un pedido por error”

Solución: Si aún no has comenzado a prepararlo, puedes cancelarlo. Ve al detalle del pedido, selecciona Cancelar, elige el motivo “Error del negocio” y confirma. El cliente recibirá una notificación de cancelación.

Error 3: “No encuentro un pedido en la lista”

Causas posibles y soluciones:

• Estás en la pestaña equivocada: Cambia entre Activos, Todos y Completados.
• Sucursal equivocada en el selector: Revisa el selector del encabezado. Si eres dueño, cambia a “Todas” o a la sucursal correcta.
• Filtro de fechas limitado: Amplía el rango de fechas.
• El pedido ya fue cancelado: Ve a la pestaña Todos y filtra por estado “Cancelado”.

Error 4: “El botón Listo no aparece”

Causa: El pedido no está en estado “En preparación”. Puede estar en “Pendiente” (debes aceptarlo primero) o en “Listo” (ya lo marcaste).

Solución: Revisa el estado actual del pedido en la columna “Estado” y sigue la secuencia correcta: Pendiente > Aceptar > En preparación > Listo.

Error 5: “El sistema va muy lento o no carga”

Posibles soluciones:

1. Revisa tu conexión a internet.
2. Recarga la página (tecla F5 en computadora).
3. Cierra sesión y vuelve a iniciar.
4. Si el problema persiste más de 5 minutos, contacta a soporte.

Error 6: “Marqué Listo pero no se asigna repartidor”

Causa: Puede no haber repartidores disponibles en tu zona en ese momento.

Solución: El sistema sigue buscando automáticamente. Si después de 10 minutos no hay asignación, contacta a soporte.

---

Preguntas frecuentes

¿Puedo ver pedidos de todas mis sucursales al mismo tiempo?

Sí, si eres dueño. Simplemente deja el selector del encabezado en “Todas”. El backend devolverá los pedidos de todas las sucursales. Los empleados, al estar fijos en una sucursal, no tienen esta opción.

¿Puedo ver pedidos de días anteriores?

Sí. Usa la pestaña Todos y ajusta el filtro de Rango de fechas para seleccionar el período que quieres consultar. Los resultados estarán limitados a tu sucursal activa (o a todas si el selector está en “Todas”).

¿Qué hago si un cliente quiere agregar algo a su pedido después de que ya fue aceptado?

No es posible modificar un pedido ya aceptado. Tienes dos opciones:

1. El cliente puede hacer un nuevo pedido con el producto adicional.
2. Si el pedido aún está en “Pendiente”, cancela ese pedido y pide al cliente que haga uno nuevo con todos los productos.

¿Puedo tener dos personas usando el panel al mismo tiempo?

Sí, no hay límite de dispositivos conectados a la misma cuenta. El cocinero puede tener el panel en una tableta en la cocina de la sucursal Centro, y otro cocinero en la sucursal Norte en su propia tableta. Cada empleado ve automáticamente los pedidos de su sucursal.

¿El cliente puede cancelar un pedido por su cuenta?

Sí, pero solo si el pedido está en estado “Pendiente”. Una vez que tú lo aceptas, solo el negocio puede cancelarlo.

¿Qué pasa si el repartidor no encuentra la dirección?

El repartidor normalmente se contacta directamente con el cliente usando el teléfono que aparece en el pedido. Como negocio, tu responsabilidad termina al entregar el pedido al repartidor. Sin embargo, puedes ayudar proporcionando referencias adicionales al repartidor si conoces la zona.

¿Cómo sé si ya me pagaron?

En el detalle del pedido puedes ver el Método de pago:

• Efectivo: El cliente paga al recibir (contra entrega). El repartidor te entrega el efectivo después.
• Tarjeta: El pago ya está procesado por Emelit Express.
• Transferencia: Similar a tarjeta, el pago ya fue procesado.

¿Los pedidos se borran después de un tiempo?

No. Todos los pedidos se guardan permanentemente en el historial. Puedes consultar pedidos de meses atrás usando el filtro de fechas. Esto es útil para contabilidad y análisis de ventas por sucursal.

¿Puedo personalizar los estados de los pedidos?

No. Los estados (Pendiente, En preparación, Listo, En camino, Entregado, Cancelado) son fijos y parte del flujo estándar de Emelit Express. Esto garantiza consistencia para todos los negocios y clientes.

¿Los pedidos de diferentes sucursales se mezclan?

No. El filtrado por sucursal es automático. Cada empleado solo ve los pedidos de su sucursal. Los dueños pueden ver todo si seleccionan “Todas”, pero cada pedido está claramente etiquetado con su sucursal de origen.