Gestion de Sucursales con Seed Contable

Si tu negocio tiene mas de una ubicacion fisica (por ejemplo, un restaurante en el centro, otro en el norte de la ciudad y un tercero en otra ciudad), Emelit Express te permite administrarlas todas desde un mismo panel de control. Despues del refactor de sucursales, cada sucursal se maneja como una ruta global (el selector de sucursal estaria oculto en secciones donde no aplica) y al crear una sucursal nueva el sistema genera automaticamente un seed contable con las cuentas contables por sucursal. La primera sucursal, llamada Matriz (is_main=1), se crea automaticamente al registrar el negocio y no se puede eliminar.

Esta guia te explica como crear, editar y gestionar sucursales, el seed contable automatico, el fallback de compatibilidad para ordenes antiguas, con ejemplos concretos y todos los detalles que necesitas.

---

Antes de empezar

Antes de crear sucursales en el sistema, ten lista la siguiente informacion:

1. Datos completos de cada sucursal:

   • Nombre: Como llamaras a esta sucursal en el sistema. Ejemplos: “Sucursal Centro”, “Sucursal Norte”, “La Terraza Satelite”, “Sucursal Guadalajara”.
   • Direccion completa: Calle, numero exterior, numero interior (si aplica), colonia, codigo postal, ciudad, estado. Ejemplo: “Av. Insurgentes Sur 1234, Col. Del Valle, C.P. 03100, CDMX”.
   • Telefono: Un numero de contacto real donde los clientes puedan llamar a esta sucursal.
   • Horario de atencion: Hora de apertura y hora de cierre para cada dia de la semana.
   • Coordenadas de ubicacion: Vas a usar un mapa interactivo para marcar la ubicacion exacta.

2. Entender la sucursal Matriz y el seed contable:

   • Al registrar tu negocio, el sistema crea automaticamente la sucursal Matriz con is_main=1. Esta sucursal NO se puede eliminar.
   • La Matriz puede absorber datos generales del negocio (direccion, telefono, etc.) en el momento de registro, para que no tengas que llenarlos dos veces.
   • Cada vez que creas una sucursal nueva, el sistema genera automaticamente un seed contable para esa sucursal, que incluye las cuentas contables basicas que el negocio ya tiene (egresos, ingresos, impuestos, etc.) pero ahora especificas para la nueva sucursal. Esto permite llevar la contabilidad por separado por sucursal sin que tengas que crear las cuentas manualmente.

3. Entender el fallback de compatibilidad para ordenes antiguas:

   • Las ordenes antiguas que tengan sucursal_id = NULL (porque se crearon antes del refactor de sucursales o porque por algun error quedaron sin sucursal) caen automaticamente en la sucursal Matriz. Esto es el “fallback de compatibilidad”.
   • Asi te aseguras de que ninguna orden se quede sin sucursal asignada en los reportes. Si existe una orden con sucursal_id = NULL, el sistema la trata como si fuera de la Matriz.

4. Acceso a Google Maps o conocimiento de la ubicacion: Vas a usar un mapa interactivo para marcar la ubicacion exacta de cada sucursal. Es util tener abierto Google Maps en otra pestana para verificar direcciones y coordenadas.

5. Permisos: Solo los usuarios con rol de Dueno pueden crear y gestionar sucursales. La seccion de Sucursales gestiona una ruta global (el selector de sucursal esta oculto en esta seccion porque no aplica: aqui administras las sucursales mismas, no trabajas DENTRO de una sucursal especifica).

---

Paso a paso detallado

Paso 1: Acceder a la seccion de sucursales

1. Ingresa al panel de administracion de Emelit Express con tu usuario y contrasena de dueno.
2. En la barra lateral izquierda, busca y haz clic en Sucursales.
3. Lo que ves en pantalla: Una cuadricula de tarjetas. Cada tarjeta representa una sucursal existente y muestra:
   • El nombre de la sucursal.
   • La direccion resumida.
   • Un mapa pequeno con la ubicacion.
   • Opcionalmente, una foto de la sucursal.
   • Etiquetas indicadores como “Matriz” en la primera sucursal (la que tiene is_main=1).
4. Selector de sucursal oculto: En esta seccion, el selector de sucursal del panel NO aparece. La razon es que Sucursales es una seccion administrativa GLOBAL: aqui gestionas las sucursales mismas, no trabajas dentro de una sucursal. El composable useManagerBranch queda en stand-by aqui.
5. Si solo tienes una sucursal, veras una sola tarjeta (la Matriz). Si ya tienes varias, veras todas.

Paso 2: Abrir el formulario para nueva sucursal

1. Busca y haz clic en el boton para agregar una nueva sucursal. Este boton puede ser:
   • Un boton + en la esquina superior derecha.
   • Un boton flotante con texto “Agregar Sucursal” o “Nueva Sucursal”.
   • Una tarjeta con un signo + al final de la cuadricula que dice “Agregar sucursal”.
2. Se abre un panel lateral (deslizable desde la derecha) o una ventana emergente (modal) con el formulario de creacion.

Paso 3: Ingresar el nombre de la sucursal

1. El primer campo es Nombre de la sucursal.
2. Escribe un nombre claro y descriptivo. Este nombre aparecera en:
   • El selector de sucursal en el POS, Empleados, Inventario y otras secciones.
   • Las busquedas de clientes.
   • Los reportes y analiticas.
   • Las facturas y tickets.
   • Las cuentas contables generadas por el seed contable (etiquetadas con el nombre de la sucursal).
3. Recomendaciones para nombrar sucursales:
   • Usa el formato “Sucursal [Zona]”: “Sucursal Centro”, “Sucursal Norte”, “Sucursal Periferico”.
   • O usa el nombre comercial + ubicacion: “La Parrilla - Satelite”, “La Parrilla - Polanco”.
   • Si estas en diferentes ciudades: “Sucursal CDMX”, “Sucursal Guadalajara”, “Sucursal Monterrey”.
   • No uses nombres demasiado largos que no quepan en los selectores.
   • Buen ejemplo: “Taqueria El Pastor - Centro”
   • Mal ejemplo: “Sucursal de la Taqueria El Pastor ubicada en el centro historico de la ciudad junto al teatro principal segunda planta” (demasiado largo).

Paso 4: Ingresar la direccion

1. Busca el campo Direccion.
2. Escribe la direccion completa de la calle. Ejemplo: “Av. Reforma 222, Colonia Juarez”.
3. Incluye referencias utiles para los repartidores y clientes.
4. Ejemplo completo: “Av. Universidad 3000, Edificio B Piso 2 Local 4, Col. Copilco Universidad, C.P. 04360, Coyoacan, CDMX”.

Paso 5: Seleccionar la ciudad con autocompletado

1. Busca el campo Ciudad.
2. Empieza a escribir el nombre de tu ciudad. El sistema tiene una funcion de autocompletado que sugiere ciudades mientras escribes.
3. Por ejemplo, escribe “Guad” y el sistema sugerira “Guadalajara, Jalisco”, “Guadalupe, Nuevo Leon”, etc.
4. Selecciona la opcion correcta de la lista desplegable.
5. Importante: Si tu ciudad no aparece en el autocompletado, intenta escribiendo el nombre del municipio o la ciudad principal mas cercana.

Paso 6: Ingresar el telefono de contacto

1. Busca el campo Telefono.
2. Ingresa un numero telefonico real de la sucursal donde los clientes puedan llamar.
3. Formato: 10 digitos (incluyendo clave lada). Ejemplo para CDMX: “5512345678”. Ejemplo para Guadalajara: “3312345678”.
4. Recomendaciones:
   • Usa un numero de la sucursal, no tu celular personal.
   • Si tienes varias lineas, pon la principal.
   • Asegurate de que alguien conteste ese numero durante el horario de atencion.

Paso 7: Configurar el horario de atencion

1. Busca el campo o seccion de Horario.
2. Dependiendo de como este disenado el formulario, puedes encontrar campos de hora de apertura y cierre para cada dia de la semana, un selector de rango de horas por dia, o una tabla con columnas para Lunes a Domingo.
3. Para cada dia de la semana, configura:
   • Hora de apertura: Cuando abren las puertas. Ejemplo: “09:00”.
   • Hora de cierre: Cuando cierran. Ejemplo: “22:00”.
4. Dias de descanso: Si la sucursal cierra algun dia, deja ese dia sin horario, o marca una casilla de “Cerrado” si existe.
5. Ejemplo de horario tipico de restaurante:
   • Lunes: Cerrado
   • Martes a Jueves: 13:00 - 22:00
   • Viernes y Sabado: 13:00 - 23:00
   • Domingo: 13:00 - 18:00
6. Importancia del horario: Los horarios que configures aqui afectan:
   • La disponibilidad de reservas (no se permiten reservas fuera del horario).
   • Los pedidos en linea (los clientes solo pueden ordenar dentro del horario).
   • La visibilidad en busquedas (los clientes ven si la sucursal esta abierta o cerrada).

Paso 8: Marcar la ubicacion en el mapa

1. Busca la seccion del Mapa dentro del formulario. Veras un mapa interactivo (generalmente Google Maps integrado).
2. El mapa mostrara inicialmente una ubicacion generica o la ubicacion de tu sucursal Matriz.
3. Buscar por direccion: En el mapa, suele haber una barra de busqueda. Escribe la direccion de la sucursal (por ejemplo, “Av. Revolucion 500, CDMX”) y presiona Enter. El mapa se centrara en esa ubicacion.
4. Arrastrar el marcador: Veras un marcador (pin) rojo o del color de tu marca. Haz clic sobre el marcador y sin soltar, arrastralo hasta la posicion exacta de la sucursal. Puedes hacer zoom con la rueda del mouse para mayor precision.
5. Usar geolocalizacion: Si estas fisicamente en la sucursal, haz clic en el boton de geolocalizacion (un circulo con una mira) y el mapa usara la ubicacion de tu computadora.
6. Suelta el marcador en el lugar exacto de la entrada de la sucursal. Verifica en el mapa que la calle, esquina y ubicacion sean correctas.

Paso 9: Guardar la sucursal (Y ENTENDER EL SEED CONTABLE)

1. Antes de guardar, revisa todos los campos:
   • Nombre: Correcto y sin errores de ortografia.
   • Direccion: Completa y con referencias.
   • Ciudad: Seleccionada correctamente del autocompletado.
   • Telefono: Numero correcto, a 10 digitos.
   • Horario: Todos los dias configurados correctamente.
   • Mapa: El marcador en la ubicacion exacta.
2. Haz clic en el boton Guardar (generalmente en la parte inferior del formulario).
3. Espera unos segundos. Aqui es donde el sistema hace dos cosas importantes atras de la pantalla:
   • Crea la sucursal con todos sus datos.
   • Genera el seed contable por sucursal: El sistema crea automaticamente las cuentas contables basicas para la nueva sucursal. Esto significa que si tu negocio ya tiene cuentas contables (egresos, ingresos, impuestos, etc.), el sistema las replica para la nueva sucursal, etiquetadas con el nombre de la nueva sucursal. No tienes que crearlas tu manualmente. Esto te permite llevar la contabilidad por sucursal de forma separada.
4. Si todo esta bien, veras un mensaje de exito: “Sucursal creada exitosamente. Cuentas contables generadas automaticamente.” o similar.
5. El panel lateral se cierra y la nueva sucursal aparece como una tarjeta en la cuadricula de sucursales.

Paso 10: Revisar la sucursal creada

1. En la cuadricula de sucursales, localiza la nueva tarjeta.
2. Verifica que el nombre, direccion y el mapa en miniatura sean correctos.
3. Si notas algun error, editala inmediatamente (ver siguiente seccion).

---

Paso a paso: Editar una sucursal existente

1. En la cuadricula de Sucursales, haz clic en la tarjeta de la sucursal que quieres modificar.
2. Se abre el mismo panel lateral con el formulario, pero ahora con los datos actuales de la sucursal ya cargados.
3. Modifica unicamente los campos que necesites cambiar. Por ejemplo:
   • Cambiaste el numero de telefono.
   • Extendiste el horario (ahora cierran a las 11 PM en lugar de las 10 PM).
   • La sucursal cambio de domicilio.
4. Si cambias la direccion, actualiza tambien el marcador en el mapa.
5. Haz clic en Guardar para aplicar los cambios.
6. Los cambios de nombre de sucursal NO recrean el seed contable. Las cuentas contables que se generaron al crear la sucursal conservan su estructura; solo se actualizan las etiquetas visibles.

---

Paso a paso: Eliminar una sucursal

1. Importante: Solo puedes eliminar sucursales secundarias. La sucursal Matriz (is_main=1) NO se puede eliminar.
2. En la cuadricula de Sucursales, busca la tarjeta de la sucursal que deseas eliminar.
3. En la esquina de la tarjeta, busca un icono de tres puntos (…) o un bote de basura.
4. Haz clic en ese icono y selecciona Eliminar.
5. Aparece una ventana de confirmacion: “Estas seguro de eliminar esta sucursal? Esta accion no se puede deshacer.”
6. Lee las consecuencias que el sistema te muestra:
   • La sucursal dejara de aparecer en busquedas y en el selector de sucursal.
   • Los pedidos existentes con sucursal_id igual a esa sucursal NO se eliminan: quedan en el historial asociados a esa sucursal. Si la sucursal se elimina, el sistema puede asignarlos a la Matriz segun el fallback de compatibilidad (segun la configuracion).
   • Las mesas, planos y configuraciones de esa sucursal SI se eliminan permanentemente.
   • Las cuentas contables generadas por el seed contable para esa sucursal pueden quedar como historicas (depende de la configuracion) o eliminarse junto con la sucursal.
7. Si estas completamente seguro, haz clic en Confirmar o Eliminar.
8. La sucursal desaparece de la cuadricula.

---

La sucursal Matriz y el fallback de compatibilidad

La sucursal Matriz tiene un rol especial en el sistema. Entiende bien estos puntos:

1. Creacion automatica: Al registrar tu negocio en Emelit Express, el sistema crea automaticamente la sucursal Matriz con is_main=1. No tienes que crearla tu. Esta Matriz puede absorber datos del negocio (direccion, telefono, horarios) en el momento del registro, para que no tengas que llenar todos los campos dos veces.

2. No se puede eliminar: La Matriz no se puede eliminar. Es la sucursal por default de tu negocio y el sistema la usa como referencia. Si tu negocio fisicamente ya no existe en esa ubicacion, puedes editar la Matriz para cambiar su nombre a “Sucursal (CERRADA)” o modificar su direccion, pero no eliminarla.

3. Fallback de compatibilidad para ordenes NULL: Si tienes ordenes antiguas con sucursal_id = NULL (creadas antes del refactor de sucursales o por algun error de sistema), el sistema las trata como si fueran de la Matriz. Esto es lo que llamamos el “fallback de compatibilidad”:

   • Cuando un reporte agrupa ventas por sucursal, una orden con sucursal_id = NULL se contara dentro de la Matriz.
   • Cuando el listado de ordenes muestra la sucursal de una orden con sucursal_id = NULL, aparecera “Matriz” (o el nombre que le hayas puesto a tu Matriz) en lugar de quedarse en blanco.
   • Esto te asegura de que ninguna orden se queda sin clasificar en los reportes.

4. La Matriz puede absorber datos del negocio: En el momento del registro inicial, el sistema usa los datos que pusiste del negocio (nombre, direccion, telefono, ciudad) para llenar los campos equivalentes de la sucursal Matriz. Asi te ahorra trabajo. Despues puedes editar la Matriz como cualquier otra sucursal.

5. No se puede cambiar la Matriz: Una vez creada, la Matriz sera siempre la Matriz. No puedes convertir una sucursal secundaria en Matriz, ni la Matriz en secundaria. Si necesitas hacerlo, contacta al soporte de Emelit Express.

---

Ejemplo practico

Imagina que tienes una cadena de taquerias llamado “Tacos El Campeon”. Empezaste con un local en el centro de Puebla y ahora estas abriendo una segunda sucursal en Cholula. A futuro planeas una tercera en la CDMX.

La sucursal Matriz (Centro de Puebla)

Cuando el Sr. Ortega, dueno de “Tacos El Campeon”, registro su negocio en Emelit Express, el sistema creo automaticamente la sucursal Matriz con is_main=1 y absorbe los datos del negocio (direccion, telefono, horarios). Asi que la Matriz aparecio automaticamente en la seccion de Sucursales con el nombre “Tacos El Campeon - Centro Puebla” (etiqueta “Matriz”).

Creando la sucursal Cholula (con seed contable)

Es lunes por la manana y la taqueria esta cerrada al publico (ustedes descansan los lunes). El Sr. Ortega aprovecha para crear la sucursal de Cholula en el sistema, que abrira el proximo viernes.

1. Abre el panel de Emelit Express e inicia sesion como dueno.

2. En la barra lateral, hace clic en Sucursales. Nota que el selector de sucursal del panel NO aparece en esta seccion (es una ruta global).

3. Ve la tarjeta de su sucursal actual: “Tacos El Campeon - Centro Puebla” (sucursal Matriz, con etiqueta “Matriz”).

4. Hace clic en el boton + Agregar Sucursal.

5. Se abre el panel lateral. Llena:

   Campo: Nombre de la sucursal

   • Escribe: “Tacos El Campeon - Cholula”

   Campo: Direccion

   • Escribe: “Calle 5 de Mayo #15, Local A, San Pedro Cholula, Puebla. A un costado de la Parroquia de San Pedro.”

   Campo: Ciudad

   • Empieza a escribir “Cholula”. El autocompletado sugiere “San Pedro Cholula, Puebla”. Lo selecciona.

   Campo: Telefono

   • Escribe: “2224567890” (el nuevo numero que contrataron para esta sucursal).

   Campo: Horario

   • Configura cada dia:
     • Lunes: 17:00 - 23:00
     • Martes a Jueves: 17:00 - 23:00
     • Viernes: 17:00 - 01:00
     • Sabado: 14:00 - 01:00
     • Domingo: 14:00 - 22:00

   Mapa:

   • En la barra de busqueda del mapa escribe: “Calle 5 de Mayo 15, San Pedro Cholula”
   • El mapa se centra en la ubicacion. Hace zoom hasta ver el local.
   • El marcador se posiciona automaticamente cerca. Lo arrastra exactamente a la entrada del local.
   • Verifica que las calles alrededor sean correctas.

6. Hace clic en Guardar.

7. Atras de la pantalla, el sistema:

   • Crea la sucursal “Tacos El Campeon - Cholula” con is_main=0 (secundaria).
   • Genera un seed contable con cuentas contables etiquetadas “Tacos El Campeon - Cholula” (egresos, ingresos, impuestos, etc.).

8. Aparece mensaje: “Sucursal creada exitosamente. Cuentas contables generadas automaticamente.”

9. En la cuadricula ahora ve dos tarjetas: “Tacos El Campeon - Centro Puebla” (Matriz) y “Tacos El Campeon - Cholula” (secundaria).

Configurando la nueva sucursal

Ahora que la sucursal esta creada, la configura antes de que abra al publico:

1. Menu: Va a Catalogo y verifica que los productos esten disponibles para ambas sucursales. Decides que en Cholula ofrecera los mismos tacos, pero con un precio ligeramente diferente (alli la renta es mas barata, puedes bajar precios un poco para atraer clientes). Ajusta precios por sucursal si el sistema lo permite.

2. Plano de mesas: Va a Mesas > Editor de Planos. Selecciona “Tacos El Campeon - Cholula” en el selector de sucursal. Disena el plano del local de Cholula: es mas pequeno que el de Puebla, solo tiene 8 mesas (el de Puebla tiene 15). Guarda.

3. QR de mesas: Descarga los QR de las 8 mesas de Cholula y los manda a imprimir.

4. Inventario por sucursal: Va a Inventario. Con el selector en “Sucursal Cholula”, crea las ubicaciones de Cholula (Refrigerador unico, Bodega, Mostrador, todas con branch_id = Cholula). Despues crea los items de Cholula con su propio stock de inicio.

5. Personal: Da de alta a los nuevos empleados de Cholula en Equipo > Empleados. Con el selector en “Sucursal Cholula”, crea los empleados; el sistema auto-asigna sucursal_id = Cholula a cada uno. Los empleados quedan fijos en esa sucursal.

6. Repartidores: Va a Equipo > Repartidores y asigna un repartidor a la sucursal Cholula con la operacion “Mover a sucursal”.

Fallback de compatibilidad en acccion

Tres meses despues, el Sr. Ortega genera un reporte de ventas de los ultimos 12 meses. En el reporte aparecen algunas ordenes antiguas con sucursal_id = NULL (eran ordenes que se hicieron antes del refactor de sucursales, cuando no existia el sistema de sucursales multiples). El sistema las contabiliza dentro de la sucursal Matriz “Tacos El Campeon - Centro Puebla” gracias al fallback de compatibilidad. Asi el reporte cuadra: ninguna orden se queda sin clasificar.

El reporte mostrara algo asi:

• Sucursal Centro Puebla (Matriz): $1,800,000 MXN (incluye las ordenes viejas con sucursal_id = NULL que cayeron en la Matriz).
• Sucursal Cholula: $650,000 MXN.
• Total consolidado: $2,450,000 MXN.

Usando las sucursales en el dia a dia

Ya con dos sucursales funcionando, el flujo de trabajo diario cambia:

En el POS (al cobrar) - el mesero de Cholula:

• Como es un empleado fijado a la sucursal Cholula, no ve el selector de sucursal. Su POS siempre opera en Cholula.
• El mesero de Puebla (tambien fijo a esa sucursal) solo opera en Puebla.

En las reservas:

• El encargado de Puebla ve solo las reservas de Puebla.
• El encargado de Cholula ve solo las reservas de Cholula.
• El dueno puede ver ambas cambiando el selector de sucursal.

En los pedidos:

• Los pedidos en linea llegan con la etiqueta de la sucursal a la que fueron dirigidos.
• Los repartidores saben a cual sucursal ir por la direccion que aparece en el pedido (el _branch_id que se asigno al repartidor filtra que pedidos ve).

En los reportes:

• Al final del mes, el dueno genera reportes de ventas con el selector en “Todas”.
• Puede ver el reporte consolidado (ambas sucursales juntas) o filtrar por sucursal individual.
• Las cuentas contables estan separadas por sucursal gracias al seed contable que se genero al crear Cholula.

---

Flujo de trabajo recomendado

Al abrir una nueva sucursal fisica

1. 2-3 semanas antes de la apertura: Crear la sucursal en el sistema con los datos basicos (nombre, direccion, telefono, horario). El seed contable se generara automaticamente en este paso.
2. 1-2 semanas antes: Configurar el menu y precios de la nueva sucursal.
3. 1 semana antes: Disenar el plano de mesas y generar los QR.
4. 1 semana antes: Crear las ubicaciones de inventario de la nueva sucursal (con branch_id de la nueva sucursal) y los items con su stock inicial.
5. 3-5 dias antes: Dar de alta al personal nuevo con el selector en la nueva sucursal (cada empleado se auto-asigna a esa sucursal).
6. 3-5 dias antes: Asignar repartidores a la nueva sucursal con “Mover a sucursal” en Equipo > Repartidores.
7. 1-2 dias antes: Hacer pruebas: registrar ventas de prueba, escanear QR, probar reservas.
8. Dia de apertura: Todo listo. Monitorear el sistema durante el primer dia para resolver cualquier problema.

Al cerrar una sucursal permanentemente

1. Avisar a los clientes con anticipacion (en persona, por redes sociales, WhatsApp).
2. Despues del ultimo dia de operacion, NO eliminar la sucursal inmediatamente. Dejala unos dias por si necesitas consultar pedidos recientes.
3. Una o dos semanas despues, cuando ya no necesites consultar nada, elimina la sucursal del sistema. Solo puedes eliminarla si NO es la Matriz. Si lo es, no podras eliminarla; ponle el nombre “(CERRADA)” y ajusta los horarios para que aparezca como cerrada.
4. Los pedidos historicos con sucursal_id de esa sucursal pueden reasignarse a la Matriz por el fallback de compatibilidad (segun la configuracion del sistema). Los pedidos historicos permanecen en los reportes aunque la sucursal sea eliminada.

Rutina de mantenimiento de sucursales

1. Cada mes: Revisar que los horarios sigan siendo correctos (por ejemplo, horario de verano vs invierno).
2. Cada cambio de telefono: Actualizarlo inmediatamente en el sistema. Un telefono desactualizado significa clientes que llaman y nadie contesta.
3. Cada cambio de domicilio: Editar la sucursal existente, NO crear una nueva. Actualizar direccion y marcador en el mapa.
4. Cada cierre temporal (vacaciones, remodelacion): Ajustar los horarios o marcar la sucursal como cerrada para que los clientes no puedan hacer pedidos ni reservas.

---

Errores comunes y soluciones

Error 1: “Cree una sucursal pero no aparece en el POS”

Causa: La sucursal se creo correctamente, pero el POS esta en otra sucursal, o la nueva sucursal aun no esta activa.

Solucion: En la parte superior del POS o de cualquier seccion, busca el selector de sucursal. Te deberia aparecer la sucursal nueva ahi. Si eres un empleado fijo de otra sucursal, no veras la nueva en tu selector (tendras que pedirla al dueno). Si eres el dueno, cambia a la sucursal nueva.

Error 2: “Los productos no aparecen en la sucursal nueva”

Causa: Los productos del catalogo no estan asignados a la nueva sucursal.

Solucion: Ve a Catalogo > Productos (con el selector en la nueva sucursal). Edita cada producto y verifica que este asignado a la nueva sucursal.

Error 3: “El mapa muestra una ubicacion incorrecta”

Causa: Al escribir la direccion, el mapa no la interpreto correctamente.

Solucion: Edita la sucursal. En la seccion del mapa, usa la barra de busqueda con la direccion exacta. Si la direccion no existe en Google Maps, busca un punto de referencia cercano. Arrastra manualmente el marcador a la ubicacion correcta, incluso si no coincide con la direccion escrita. Guarda.

Error 4: “No puedo eliminar la sucursal Matriz”

Causa: El sistema no permite eliminar la sucursal Matriz (is_main=1) por diseno.

Solucion: No puedes eliminarla. Si tu negocio cerro esa ubicacion y ya no existe, puedes:

• Cambiarle el nombre a algo como “Sucursal (CERRADA)”.
• Editar los horarios para que aparezca como cerrada permanentemente.
• Ignorarla y seguir usando las sucursales activas.
• Si realmente necesitas eliminarla, contacta al soporte tecnico de Emelit Express para ver opciones.

Error 5: “Las ordenes viejas aparecen en la sucursal Matriz en los reportes, pero esas ordenes son de antes de tener varias sucursales”

Causa: Es el comportamiento esperado. Las ordenes antiguas con sucursal_id = NULL caen en la Matriz por el fallback de compatibilidad.

Solucion: No es un error. Es el diseno del sistema para asegurarse de que ninguna orden se quede sin clasificar. Si quieres reasignar esas ordenes a otra sucursal, contacta al soporte tecnico. Si solo quieres hacer un reporte aparte de las ordenes anteriores al refactor, puedes filtrar por fecha en los reportes.

Error 6: “Cree una sucursal nueva y no veo las cuentas contables”

Causa: El seed contable se genero automaticamente al crear la sucursal, pero las cuentas contables para esta sucursal estan vacias inicialmente (no hay movimientos). Necesitas entrar a la seccion de contabilidad y trabajar en el contexto de la nueva sucursal.

Solucion: 1. Ve a la seccion de Contabilidad o Reportes contables. 2. Pon el selector de sucursal en la nueva sucursal. 3. Ahi veras las cuentas contables generadas para esa sucursal. 4. Si no las ves, contacta al soporte tecnico para verificar que el seed contable se genero correctamente.

Error 7: “Los clientes de una sucursal ven los precios de otra sucursal”

Causa: Los precios estan configurados globalmente (mismo precio para todas las sucursales) o el QR lleva a la sucursal equivocada.

Solucion:

1. Verifica que los QR de cada sucursal sean los correctos.
2. Si necesitas precios diferentes por sucursal, configuralos en Catalogo con el selector en cada sucursal.
3. Revisa que el menu digital de cada sucursal muestre los precios correctos.

Error 8: “Las reservas de una sucursal aparecen en otra”

Causa: El selector de sucursal en la seccion de Reservas esta en la sucursal equivocada, o la reserva fue creada manualmente sin verificar la sucursal.

Solucion: En Reservas, verifica el selector de sucursal en la parte superior. Cambia a la sucursal correcta. Las reservas se filtran automaticamente por sucursal.

Error 9: “Cree una sucursal nueva pero al volver a entrar a la seccion de Sucursales, el selector del panel no aparece”

Causa: Es el comportamiento esperado. La seccion de Sucursales es una ruta global y el selector de sucursal del panel (useManagerBranch) queda en stand-by aqui.

Solucion: No es un error. En la seccion de Sucursales no necesitas el selector porque aqui administras las sucursales mismas, no trabajas dentro de una sucursal especifica. Para trabajar dentro de una sucursal (POS, Inventario, Empleados), sal de la seccion de Sucursales y ve a otra seccion; ahi si veras el selector.

---

Preguntas frecuentes

Cuantas sucursales puedo crear?

Depende de tu plan de Emelit Express. Algunos planes permiten sucursales ilimitadas, otros tienen un limite. Revisa tu plan actual en la seccion de Facturacion o Configuracion de cuenta para ver cuantas sucursales tienes disponibles.

Puedo tener precios diferentes en cada sucursal?

Generalmente si, el sistema soporta precios por sucursal. Si no ves la opcion, es posible que tu plan no lo incluya. Pregunta al soporte o revisa las opciones en Catalogo > Productos > Editar con el selector en cada sucursal.

Puedo transferir productos o mesas de una sucursal a otra?

No directamente. Los productos, mesas y planos son independientes para cada sucursal. Si necesitas lo mismo en otra sucursal, tendras que configurarlo manualmente (crear el plano, agregar las mesas, etc.).

Las sucursales comparten el mismo inventario?

El manejo de inventario despues del refactor esta separado por sucursal mediante el branch_id de las ubicaciones. Cada sucursal tiene sus propias ubicaciones (bodegas, refrigeradores) con su propio branch_id, y los items se filtran por sucursal. Si tienes un almacen central comun, algunas ubicaciones pueden tener branch_id = null (compartidas), pero por lo general cada sucursal lleva su propio inventario.

Como saben los repartidores a cual sucursal ir?

Cada pedido en linea incluye la direccion de la sucursal que lo procesa. Ademas, despues del refactor, los repartidores se asignan a una sucursal especifica (mediante PATCH business-branch) o son flotantes. Un repartidor asignado a la sucursal A solo vera los pedidos de la sucursal A. Un repartidor flotante ve los pedidos de todas las sucursales. El sistema asigna automaticamente el pedido a la sucursal mas cercana al cliente (si tienes configurada la geolocalizacion) o el cliente elige manualmente la sucursal al hacer su pedido.

Puedo cambiar cual sucursal es la Matriz?

No. La sucursal Matriz se define al crear la cuenta y no se puede cambiar. Si necesitas modificarlo, contacta al soporte de Emelit Express.

Que pasa con las ordenes antiguas que no tienen sucursal_id?

Las ordenes con sucursal_id = NULL caen automaticamente en la Matriz por el fallback de compatibilidad. En los reportes, se contaran dentro de la Matriz. Esto asegura que ninguna orden se quede sin clasificar.

Cuando creo una sucursal nueva, que cuentas contables se generan?

El sistema genera automaticamente un seed contable para la nueva sucursal. Esto significa que replica las cuentas contables basicas que ya tienes en tu negocio (egresos, ingresos, impuestos, etc.) ahora etiquetadas con el nombre de la nueva sucursal. No tienes que crearlas tu manualmente. Esto te permite llevar la contabilidad por sucursal de forma separada y generar reportes contables por sucursal.

Que pasa con las cuentas contables si elimino una sucursal?

Depende de la configuracion del sistema. En algunos casos, las cuentas contables de la sucursal eliminada quedan como historicas (para conservar el historial de movimientos contables). En otros casos, se eliminan junto con la sucursal. Si tienes movimientos contables en esa sucursal, te recomendamos reels los datos antes de eliminarla. Consulta al soporte si tienes dudas.

Puedo ocultar temporalmente una sucursal sin eliminarla?

Puedes ajustar los horarios para que aparezca como cerrada todos los dias. Esto hara que los clientes no puedan hacer pedidos ni reservas en esa sucursal, pero seguira existiendo en el sistema y podras reactivarla cuando quieras simplemente volviendo a poner horarios normales.

La Matriz absorbe datos del negocio al registrarse?

Si. Al registrar tu negocio en Emelit Express, el sistema crea automaticamente la sucursal Matriz con is_main=1 y usa los datos del negocio (nombre, direccion, telefono, horarios) para llenar los campos equivalentes de la Matriz. Esto te ahorra trabajo en el registro inicial. Despues puedes editar la Matriz como cualquier otra sucursal.

---

Lista de verificacion rapida: Nueva sucursal

Usa esta lista cada vez que abras una sucursal nueva para no olvidar nada:

• Crear la sucursal en el sistema (nombre, direccion, telefono, ciudad, mapa, horario). El seed contable se generara automaticamente.
• Verificar el seed contable en la seccion de Contabilidad (con el selector en la nueva sucursal).
• Configurar el menu para la nueva sucursal (asignar productos y precios).
• Disenar el plano de piso en el editor de planos.
• Generar codigos QR para todas las mesas.
• Imprimir y colocar los QR en las mesas fisicas.
• Crear las ubicaciones de inventario de la nueva sucursal (seleccionando la nueva sucursal en el selector, ya que hasSelectedBranch es obligatorio).
• Crear los items de inventario de la nueva sucursal con su stock inicial.
• Dar de alta al personal y asignarles acceso a la sucursal correcta (con el selector en la nueva sucursal, los empleados se auto-asignan).
• Asignar repartidores a la nueva sucursal con “Mover a sucursal” en Equipo > Repartidores.
• Probar el POS con ventas de prueba en la nueva sucursal.
• Probar los QR escaneandolos con un telefono.
• Probar las reservas creando una reserva de prueba en la nueva sucursal.
• Capacitar al personal en el uso del sistema.
• Anunciar la apertura a clientes (redes sociales, WhatsApp, letreros).