Gestion de Inventario por Sucursal

El sistema de inventario de Emelit Express te permite llevar un control completo de todos los productos, ingredientes, materias primas e insumos que entran y salen de tu negocio. Despues del refactor de sucursales, cada ubicacion (bodega, refrigerador, cocina, estante) PERTENECE a una sucursal mediante el campo branch_id, y los items se filtran por la sucursal activa del selector. Con un buen manejo de inventario puedes evitar que te falten ingredientes en plena hora pico, saber exactamente cuanto dinero tienes invertido en mercancia por sucursal, y detectar perdidas o robos a tiempo.

Este sistema funciona para TODO tipo de negocio: restaurantes, taquerias, panaderias, tiendas de abarrotes, boutiques de ropa, ferreterias y cualquier comercio que maneje productos fisicos. Si tienes varias sucursales, cada una tendra su propia estructura de ubicaciones y su propio stock.

Antes de empezar

Antes de meter tus productos al sistema, necesitas preparar el terreno. Es como cuando abres un local nuevo: primero pones los estantes y luego la mercancia. Aqui primero configuras las categorias, unidades y ubicaciones por sucursal, y luego creas los items.

Lista de verificacion previa:

Haz un inventario fisico de lo que tienes POR SUCURSAL. Toma papel y lapiz. Recorre cada bodega, cocina, almacen o mostrador DE CADA SUCURSAL y ANOTA todo lo que tienes. Lo que se anote en la sucursal A no debe mezclarse con la sucursal B.
- Nombre del producto/ingrediente.
- Cantidad que tienes ahorita (en kilos, litros, piezas, lo que aplique).
- Cuanto te costo (aproximadamente, si no tienes el dato exacto).
- Donde esta guardado (bodega, cocina, refrigerador, mostrador) DENTRO de esa sucursal.
Identifica las categorias que necesitas. Agrupa mentalmente tus productos. Ejemplos de categorias para una taqueria:
- Carnes (pastor, bistec, suadero, chorizo, tripa)
- Lacteos (queso Oaxaca, crema, mantequilla)
- Verduras (cilantro, cebolla, limon, aguacate, nopales)
- Tortilleria (tortillas de maiz, tortillas de harina, tostadas)
- Salsas y condimentos (salsa roja, salsa verde, sal, pimienta, comino)
- Bebidas (refrescos, aguas frescas, cerveza)
- Empaques (bolsas de plastico, contenedores de unicel, bolsas de papel)
- Limpieza (jabon, cloro, desinfectante, papel de bano)
Identifica las ubicaciones POR SUCURSAL. Cada ubicacion pertenece a una sucursal. Decide como llamaras a cada lugar donde guardas cosas. Ejemplos para una sucursal:
- Bodega general (de esa sucursal)
- Refrigerador 1 - Carnes
- Refrigerador 2 - Lacteos y verduras
- Congelador
- Cocina (estantes)
- Mostrador (vitrina) En otra sucursal, los nombres pueden ser similares pero el branch_id cambiara. Algunas ubicaciones pueden tener branch_id = null si son compartidas entre sucursales (por ejemplo, una bodega central comun).
Define las unidades de medida que usaras. Las mas comunes:
- Kilogramo (kg)
- Gramo (g)
- Litro (L)
- Mililitro (ml)
- Pieza (pz)
- Caja (caja)
- Paquete (paq)
- Bolsa (bolsa)
Ten seleccionada la sucursal correcta en el selector superior antes de crear ubicaciones o items. La sucursal activa (useManagerBranch) determina a que sucursal se asociaran las nuevas ubicaciones y los nuevos items.

Conceptos clave del inventario por sucursal:

Item: Es cada producto, ingrediente, insumo o material que registras en el sistema. Puede ser un producto que vendes, un ingrediente que usas para cocinar, o un material de empaque que consumes. El listado de items (listItems) acepta un parametro branch_id para mostrarte unicamente los items de esa sucursal.
Ubicacion (location): Es cada lugar fisico donde guardas productos: una bodega, un refrigerador, una cocina, un estante. Despues del refactor, cada ubicacion PERTENECE a una sucursal mediante el campo branch_id. Algunas ubicaciones pueden ser null (compartidas entre sucursales).
branch_id: Es el identificador de la sucursal a la que pertenece una ubicacion o un item. Filtra el inventario por una sucursal especifica.
Stock: La cantidad que tienes disponible de un item en este momento.
Stock minimo: La cantidad minima que debes tener por sucursal. Cuando el stock baja de este numero, el sistema te envia una alerta.
Punto de reorden: La cantidad a la que debes comprar mas.
SKU: Un codigo unico que tu le asignas a cada producto (opcional pero muy recomendable). Ejemplo: TAC-PAS-001 para Tacos al Pastor.
Tipo de item: Clasifica QUE ES el item. Los tipos disponibles son: Producto, Ingrediente, Materia Prima, Empaque, Insumo, Servicio y Compuesto.
hasSelectedBranch: Condicion que valida si hay una sucursal seleccionada en el selector. Para crear una ubicacion nueva, el sistema exige que hasSelectedBranch sea verdadero; es decir, NO puedes crear ubicaciones cuando el selector esta en “Todas”.

Paso a paso detallado

Como entrar al inventario y entender el panel principal

Abre tu navegador, ve a la URL de tu panel de negocio e inicia sesion.
En la barra lateral izquierda, busca la opcion “Inventario” (puede tener un icono de caja o de almacen).
Verifica el selector de sucursal superior. Si eres dueno y tienes varias sucursales, ahi podras elegir “Todas” o una sucursal especifica. Las ubicaciones, items, movimientos y compras que veas y crees se asociaran a esa sucursal mediante el header X-Manager-Branch-Id.
Haz clic en “Inventario”. La pantalla principal cambiara.
Lo primero que veras en la parte superior son las tarjetas de resumen (KPIs). Estas tarjetas te dan un vistazo rapido del estado de tu inventario:
- Total de items: Cuantos productos diferentes tienes registrados EN LA SUCURSAL ACTIVA (o en todas, si tienes el selector en “Todas”).
- Items con stock bajo: Cuantos productos estan por debajo de su nivel minimo en esa sucursal y necesitan reabastecimiento URGENTE.
- Valor estimado del inventario: Cuanto dinero tienes invertido en mercancia EN ESA SUCURSAL, calculado con los costos de compra que has registrado.
- Movimientos recientes: Las ultimas entradas y salidas registradas en esa sucursal.
Debajo de las tarjetas, veras una fila de pestanas:
- Items: Donde creas y administras tus productos e ingredientes.
- Movimientos: Donde ves el historial de entradas y salidas de esa sucursal.
- Compras: Donde registras lo que compras a proveedores para esa sucursal.
- Recetas: Donde defines las composiciones de productos elaborados.
- Mermas: Donde registras desperdicios y perdidas.
- Configuracion: Donde creas categorias, ubicaciones, unidades de medida y proveedores.

Paso 1: Configurar los catalogos base (HAZ ESTO PRIMERO)

Antes de crear tu primer producto, configura los catalogos. Es la base de todo.

Ir a la pestana Configuracion

Haz clic en la pestana “Configuracion”.
Veras cuatro secciones: Categorias, Ubicaciones, Unidades de Medida y Proveedores.

Crear Categorias

En la seccion Categorias, haz clic en el boton “Agregar categoria”.
Escribe el nombre. Ejemplo: Carnes.
Guarda.
Repite para cada categoria que necesites.

Nota: Las categorias suelen compartirse entre todas las sucursales. No te preocupes por crear categorias duplicadas para cada sucursal.

Crear Ubicaciones (POR SUCURSAL — esto es lo que cambio)

Las ubicaciones si tienen branch_id. Cada ubicacion pertenece a una sucursal.

Antes de crear una ubicacion, selecciona la sucursal correcta en el selector superior. El sistema exige hasSelectedBranch = true para dejarte crear una ubicacion. Si tienes el selector en “Todas”, el boton “Agregar ubicacion” estara deshabilitado o el sistema te pedira que elijas una sucursal primero.
En la seccion Ubicaciones, haz clic en “Agregar ubicacion”.
Escribe el nombre. Ejemplo: Refrigerador 1 - Carnes.
El sistema automaticamente asigna el branch_id de la sucursal activa (useManagerBranch) a esta nueva ubicacion. NO tienes que seleccionar la sucursal manualmente en el formulario porque ya viene deducida del selector.
Guarda.
Crea todas las ubicaciones que necesites PARA ESA SUCURSAL. Se especifico con los nombres para que despues sepas exactamente donde esta cada cosa.
Para crear ubicaciones de otra sucursal, cambia el selector superior a la otra sucursal y repite el proceso. La nueva ubicacion quedara con el branch_id de esa otra sucursal.
Ubicaciones compartidas (branch_id null): Algunas ubicaciones pueden ser null, lo que significa que son compartidas entre sucursales. Estas ubicaciones especiales generalmente las crea el soporte tecnico o vienen por defecto en algunas configuraciones. Como regla general, SIEMPRE que crees una ubicacion nueva tendra el branch_id de la sucursal activa. No te preocupes por el caso null a menos que tengas un almacen central compartido.

Crear Unidades de Medida

En la seccion Unidades, haz clic en “Agregar unidad”.
Escribe el nombre. Ejemplo: Kilogramo y su abreviatura kg.
Guarda.
Crea al menos: Kilogramo (kg), Gramo (g), Litro (L), Mililitro (ml), Pieza (pz), Caja (caja), Paquete (paq), Bolsa (bolsa).

Las unidades de medida se comparten entre todas las sucursales.

Crear Proveedores (opcional en este paso, obligatorio para compras)

En la seccion Proveedores, haz clic en “Agregar proveedor”.
Llena: Nombre del proveedor, nombre del contacto, telefono, correo (si aplica).
Guarda.
Repite para cada proveedor.

Los proveedores suelen compartirse entre todas las sucursales.

Paso 2: Crear tu primer item (producto o ingrediente)

Ahora que ya tienes las categorias, ubicaciones y unidades configuradas PARA LA SUCURSAL ACTIVA, puedes crear items.

IMPORTANTE: El listado de items (listItems) se filtra por el branch_id de la sucursal activa. Cuando creas un item nuevo con el selector en una sucursal especifica, el sistema lo asocia a esa sucursal.

Ejemplo: Crear “Carne de Pastor” como ingrediente

Paso 1: Verificar la sucursal activa

En el selector superior, asegurate de estar en la sucursal correcta. Ejemplo: Sucursal Centro Veracruz.
Si estas en “Todas”, el sistema te pedira elegir una sucursal al guardar el item.

Paso 2: Ir a la pestana Items

Haz clic en la pestana “Items”.
La tabla mostrara unicamente los items de esa sucursal (branch_id).
Haz clic en el boton “Agregar item” (esquina superior derecha).

Paso 3: Llenar el formulario

Nombre: Escribe el nombre. Ejemplo: Carne de pastor marinada. Se descriptivo.
Tipo: Despliega el menu y selecciona Ingrediente.
- Guia rapida de tipos:
  - Producto: Algo que vendes directamente al cliente y que NO se transforma. Ejemplo: un refresco de lata, una bolsa de papas.
  - Ingrediente: Algo que se consume para preparar otro producto.
  - Materia prima: Material base sin procesar.
  - Empaque: Bolsas, cajas, envolturas, contenedores.
  - Insumo: Articulos de uso general. Ejemplo: productos de limpieza.
  - Servicio: Un servicio que contratas y no es un producto fisico.
  - Compuesto: Un producto que se FABRICA a partir de otros items del inventario.
SKU (codigo): (Opcional pero recomendado) Ejemplo: CAR-PAS-001.
Categoria: Despliega y selecciona Carnes.
Unidad de medida: Selecciona Kilogramo (kg).

Paso 4: Configurar el stock inicial y alertas

Stock inicial: Escribe la cantidad que tienes AHORA MISMO de este producto EN ESA SUCURSAL. Ejemplo: 15 (15 kg de carne de pastor).
Stock minimo: Ejemplo: 3. El sistema te alertara cuando baje a 3 kg EN ESA SUCURSAL.
Punto de reorden: Ejemplo: 5.
Ubicacion: Selecciona donde esta guardado EN ESA SUCURSAL. Ejemplo: Refrigerador 1 - Carnes. Solo apareceran ubicaciones que pertenezcan a la misma sucursal (assertLocationBranch valida que la ubicacion elegida tenga el mismo branch_id que la sucursal activa).

Paso 5: Guardar

Haz clic en “Guardar”.
Veras un mensaje de confirmacion.
El nuevo item aparecera en la tabla de items de esa sucursal.

Paso 6: Repetir para cada producto de cada sucursal

Para crear el mismo producto en OTRA sucursal, cambia el selector superior a la otra sucursal y repite el proceso. Cada sucursal tendra su propio stock del mismo item.
Ejemplos adicionales por sucursal:
- Tortillas de maiz taqueras — Tipo: Ingrediente, Categoria: Tortilleria, Unidad: Pieza (pz), Stock inicial: 500, Stock minimo: 100.
- Queso Oaxaca rallado — Tipo: Ingrediente, Categoria: Lacteos, Unidad: Kilogramo (kg), Stock inicial: 8, Stock minimo: 2.
- Cilantro fresco — Tipo: Ingrediente, Categoria: Verduras, Unidad: Kilogramo (kg), Stock inicial: 2, Stock minimo: 0.5.
- Refresco Coca-Cola 600ml — Tipo: Producto, Categoria: Bebidas, Unidad: Pieza (pz), Stock inicial: 48, Stock minimo: 12.
- Contenedor de unicel #8 — Tipo: Empaque, Categoria: Empaques, Unidad: Pieza (pz), Stock inicial: 200, Stock minimo: 50.
- Bolsa de plastico camiseta — Tipo: Empaque, Categoria: Empaques, Unidad: Pieza (pz), Stock inicial: 500, Stock minimo: 100.

Paso 3: Entender y usar los filtros

Una vez que tengas varios items registrados, los filtros te ayudan a encontrar rapidamente lo que buscas.

Filtrar por sucursal (filtro principal)

Encima de la tabla de items, el filtro principal es el selector de sucursal. Si lo cambias a otra sucursal, la tabla se actualizara automaticamente (listItems con branch_id) y veras los items de esa otra sucursal.
En “Todas”, veras una vista consolidada (o agrupada por sucursal, segun la version del sistema).

Filtrar por categoria

Busca un menu desplegable etiquetado “Categoria” o “Todas las categorias”.
Haz clic y selecciona una categoria. Ejemplo: Carnes.
La tabla mostrara solo los items de esa categoria DENTRO de la sucursal activa.

Filtrar por ubicacion

Busca un menu desplegable “Ubicacion” o “Todas las ubicaciones”.
Las ubicaciones que te aparecen en este filtro SON UNICAMENTE LAS DE LA SUCURSAL ACTIVA. Si estas en “Sucursal Centro Veracruz”, solo veras las ubicaciones con branch_id = Centro Veracruz.
Si una ubicacion tiene branch_id = null (compartida), tambien te aparecera porque es comun a todas las sucursales.
Selecciona una ubicacion especifica para ver solo los items guardados en ese lugar.

Filtrar por estado de stock

Busca un menu o botones: “Todos”, “Stock bajo”, “Sin stock”, “Con stock”.
Selecciona Stock bajo para ver solo los productos que necesitan reabastecimiento urgente EN ESA SUCURSAL.

Buscar por nombre

Usa el campo de busqueda con la lupa.
Escribe parte del nombre del producto. Ejemplo: pastor. La tabla se filtrara automaticamente dentro de la sucursal activa.

Paso 4: Editar un item existente

Busca el item en la tabla (usa los filtros si es necesario).
En la columna de “Acciones”, busca el icono de editar (lapiz).
Haz clic en el lapiz. Se abrira el formulario de edicion con los datos actuales.
Si quieres cambiar la ubicacion del item, el sistema validara con assertLocationBranch que la nueva ubicacion tenga el mismo branch_id que la sucursal activa. No puedes asignar a un item una ubicacion que pertenezca a otra sucursal.
Modifica lo que necesites.
Haz clic en “Guardar”.

Paso 5: Alertas de stock bajo

El sistema te avisa cuando un producto esta por debajo de su stock minimo EN LA SUCURSAL ACTIVA:

En el panel principal de inventario: La tarjeta de “Items con stock bajo” muestra el numero de productos en alerta EN ESA SUCURSAL (o en todas si tienes el selector en “Todas”). Haz clic en esa tarjeta para ver cuales son.
En la tabla de items: Los items con stock bajo aparecen resaltados con un color diferente (naranja o rojo) o con un icono de advertencia.

Que hacer cuando ves una alerta:

Revisa que item es y en que sucursal esta.
Verifica si realmente te queda poco en esa sucursal.
Si es real, contacta a tu proveedor y haz un pedido PARA ESA SUCURSAL.
Cuando recibas el producto, registra la compra en la pestana Compras (con la sucursal activa correcta).

Ejemplo practico

Negocio: Taqueria “Los Primos”, con dos sucursales.

Duena: Sra. Josefina Lopez. Sucursales: Ecatepec (Estado de Mexico) — Matriz — y Sucursal Tultitlan (secundaria). Situacion: La Sra. Josefina tiene dos sucursales y quiere llevar el inventario por separado. Es lunes a las 8 AM, antes de abrir, en la sucursal Ecatepec.

Configuracion inicial (3 horas de trabajo):

8:00 AM — Elegir la sucursal activa

En el selector superior, la Sra. Josefina selecciona “Sucursal Ecatepec” (la Matriz).
Todo lo que cree ahora se asociara a esa sucursal automáticamente mediante el header X-Manager-Branch-Id.

8:00 AM — 8:30 AM: Catalogo de configuracion (Ecatepec)

La Sra. Josefina va a Inventario > Configuracion.
Crea 8 categorias: Carnes, Lacteos, Verduras, Tortilleria, Salsas, Bebidas, Empaques, Limpieza. (Las categorias son globales.)
Crea 4 ubicaciones para Ecatepec (con el selector en “Sucursal Ecatepec”):
- Refrigerador 1 (branch_id = Ecatepec)
- Refrigerador 2 (branch_id = Ecatepec)
- Congelador (branch_id = Ecatepec)
- Bodega (estantes) (branch_id = Ecatepec)
Crea 6 unidades: kg, g, L, ml, pz, paq. (Las unidades son globales.)
Crea 3 proveedores. (Los proveedores son globales y los usara para ambas sucursales.)

8:30 AM — 10:00 AM: Crear items en Ecatepec

La Sra. Josefina toma su libreta donde tiene anotado el inventario del sabado por la noche de la sucursal Ecatepec.
Va creando cada item en el sistema con los datos de su libreta.

Item	Tipo	Stock real	Stock minimo	Ubicacion (Ecatepec)
Carne de pastor adobada	Ingrediente	22 kg	5 kg	Refrigerador 1
Bistec de res	Ingrediente	15 kg	4 kg	Refrigerador 1
Suadero	Ingrediente	10 kg	3 kg	Refrigerador 1
Chorizo	Ingrediente	8 kg	2 kg	Refrigerador 1
Queso Oaxaca	Ingrediente	12 kg	3 kg	Refrigerador 2
Crema acida	Ingrediente	6 L	2 L	Refrigerador 2
Tortilla de maiz taquera	Ingrediente	800 pz	200 pz	Bodega (estantes)
Cilantro	Ingrediente	2 kg	0.5 kg	Refrigerador 2
Coca-Cola 600ml	Producto	48 pz	12 pz	Mostrador (Ecatepec)
Contenedor unicel #8	Empaque	300 pz	80 pz	Bodega (estantes)

10:00 AM — Cambiar a la sucursal Tultitlan

La Sra. Josefina cambia el selector superior a “Sucursal Tultitlan”.
Ahora todo lo que cree se asociara a Tultitlan.

10:00 AM — 10:30 AM: Crear ubicaciones para Tultitlan

Va a Inventario > Configuracion > Ubicaciones.
Como el selector esta en Tultitlan, el sistema le permite crear ubicaciones (hasSelectedBranch = true).
Crea 3 ubicaciones para Tultitlan:
- Refrigerador unico (branch_id = Tultitlan)
- Bodega (branch_id = Tultitlan)
- Mostrador (branch_id = Tultitlan)

10:30 AM — 11:00 AM: Crear items en Tultitlan

La Sra. Josefina toma la libreta de Tultitlan y crea los items de esa sucursal.

Item	Tipo	Stock real	Stock minimo	Ubicacion (Tultitlan)
Carne de pastor adobada	Ingrediente	10 kg	3 kg	Refrigerador unico
Bistec de res	Ingrediente	7 kg	2 kg	Refrigerador unico
Queso Oaxaca	Ingrediente	5 kg	2 kg	Refrigerador unico
Tortilla de maiz taquera	Ingrediente	400 pz	100 pz	Bodega
Coca-Cola 600ml	Producto	24 pz	6 pz	Mostrador
Contenedor unicel #8	Empaque	150 pz	50 pz	Bodega

Resultado: En 3 horas, la Sra. Josefina tiene dos inventarios separados. Cuando pone el selector en “Sucursal Ecatepec”, ve su stock; cuando lo cambia a “Sucursal Tultitlan”, ve el otro. Si la sucursal Tultitlan se queda sin Coca-Cola, la alerta aparecera solo cuando este en el selector de Tultitlan, no en el de Ecatepec. Asi la Sra. Josefina sabe exactamente en que sucursal necesita reabastecer.

Flujo de trabajo recomendado

Rutina diaria (5 minutos)

AL ABRIR CADA SUCURSAL:
  └─ Entra al sistema y pon el selector en la sucursal que vas a abrir.
  └─ Revisa el panel de inventario.
  └─ Mira la tarjeta de "Items con stock bajo".
  └─ Si hay alertas, anota que hace falta y planea la compra PARA ESA SUCURSAL.

AL CERRAR CADA SUCURSAL:
  └─ Pon el selector en la sucursal que vas a cerrar.
  └─ Si usaste ingredientes de mas o hubo desperdicio, registra las
     mermas (ve a la pestana Mermas).

Rutina semanal (20-30 minutos por sucursal)

CADA LUNES (O EL DIA MAS TRANQUILO DE LA SEMANA), POR SUCURSAL:
  └─ Pon el selector en la sucursal a revisar.
  └─ Haz un conteo fisico RAPIDO de los items mas caros o importantes
     de esa sucursal.
  └─ Compara lo que dice el sistema vs lo que hay en realidad en esa
     sucursal.
  └─ Si hay diferencias, haz ajustes manuales (pestana Movimientos).
  └─ Revisa el historial de movimientos de la semana de esa sucursal.
  └─ Repite el proceso para cada sucursal.

Rutina mensual (1-2 horas por sucursal)

PRIMER DIA HABIL DE CADA MES, POR SUCURSAL:
  └─ Pon el selector en la sucursal a revisar.
  └─ Haz un conteo fisico COMPLETO de todo el inventario de esa sucursal.
  └─ Ajusta TODAS las diferencias con movimientos manuales.
  └─ Revisa el valor estimado del inventario de esa sucursal (tarjeta KPI).
  └─ Revisa cuales productos tienen mucha merma en esa sucursal y analiza por que.
  └─ Actualiza los stock minimos si detectaste que ciertos productos
     se acaban mas rapido de lo que creias EN ESA SUCURSAL.
  └─ Repite el proceso para cada sucursal.

Errores comunes y soluciones

Error o problema	Causa probable	Como resolverlo
”El sistema dice que tengo 20 kg de carne pero en el refrigerador solo hay 8 kg”	No registraste las mermas, no registraste salidas manuales, o hubo robo hormiga. Tambien podria ser que estas comparando el stock de otra sucursal.	1. Revisa el selector de sucursal. Asegurate de estar en la sucursal correcta. 2. Ve a la pestana Mermas y registra la diferencia como merma. 3. Ve a la pestana Movimientos y haz una salida manual por la diferencia. 4. A partir de ahora, registra TODO.
”El boton ‘Agregar ubicacion’ esta deshabilitado”	Tienes el selector en “Todas”. El sistema exige `hasSelectedBranch = true` para crear una ubicacion.	1. En el selector superior, elige una sucursal especifica. 2. Vuelve a la pestana Configuracion > Ubicaciones. 3. Ahora el boton estara habilitado. 4. Verifica que la nueva ubicacion quede con el `branch_id` de la sucursal activa.
”No me aparecen las ubicaciones de la otra sucursal en el filtro ‘Ubicacion‘“	Es el comportamiento correcto. Las ubicaciones tienen `branch_id` y solo te aparecen las de la sucursal activa.	1. Si quieres ver las ubicaciones de otra sucursal, cambia el selector superior a esa sucursal. 2. Las ubicaciones compartidas (`branch_id = null`) si te aparecen en cualquier sucursal.
”Quizo asignar a un item una ubicacion de otra sucursal y el sistema me da error”	`assertLocationBranch` valido que la ubicacion y la sucursal activa no coinciden. No puedes asignar a un item una ubicacion de sucursal A si estas trabajando en sucursal B.	1. Cambia el selector superior a la sucursal a la que pertenece la ubicacion. 2. Edita el item desde alli. 3. Si el item tambien debe existir en la otra sucursal, crealo como un item nuevo alla.
”No se que tipo de item elegir”	La diferencia entre Producto, Ingrediente y Compuesto no es obvia al principio.	Preguntate: 1. Lo vendo DIRECTAMENTE al cliente sin transformarlo? -> Producto. 2. Lo USO para hacer otra cosa? -> Ingrediente. 3. Es algo que YO FABRICO combinando otros items? -> Compuesto.
”Cree 200 items y ahora no encuentro nada”	Falta de categorias y filtros.	1. Ve a Configuracion y crea categorias DETALLADAS. 2. Edita cada item y asigna su categoria correcta. 3. A partir de ahora, usa los filtros de categoria, ubicacion, sucursal y busqueda.
”Los items de stock bajo no son los correctos”	Configuraste mal los niveles de stock minimo POR SUCURSAL.	1. Edita los items y ajusta los stock minimos a la realidad de cada sucursal. El stock minimo de la sucursal A no tiene que ser el mismo que el de la sucursal B. 2. Registra mermas y salidas correctamente en cada sucursal.
”Hay items duplicados en mi inventario”	Creaste el mismo producto dos veces, tal vez en sucursales diferentes.	1. Si los duplicados estan en la misma sucursal, decide cual vas a conservar, transfiere el stock y elimina el duplicado. 2. Si estan en sucursales distintas (ej. carne en sucursal A y carne en sucursal B), es CORRECTO que existan dos items separados, porque cada sucursal tiene su propio stock.
”El valor estimado del inventario me da la suma de todas las sucursales cuando solo quiero ver una”	Tienes el selector en “Todas” y el sistema te consolido.	1. Pon el selector en la sucursal especifica. 2. El valor estimado te mostrara el de esa sucursal.

Preguntas frecuentes

P: Puedo usar el inventario si mi negocio no vende comida? R: Si. El inventario funciona para CUALQUIER tipo de negocio: tiendas de ropa, ferreterias, florerias, farmacias, papelerias, etc. Solo adapta las categorias y unidades de medida a tu giro.

P: Que pasa si vendo algo que no esta en el inventario de esa sucursal? R: El sistema NO descontara ese producto del inventario. Es importante que TODOS los productos que vendas esten registrados como items EN LA SUCURSAL QUE LOS VENDE. Si una sucursal vende un producto que no tiene registrado, el inventario de esa sucursal se desfasa. Cada sucursal debe tener sus propios items.

P: Necesito registrar cada tortilla individual? R: Depende de como las uses. Para una taqueria, puedes registrar las tortillas por PIEZA. Pero si compras 20 paquetes de 100 tortillas, te conviene mas registrar por PAQUETE y luego, en la receta, definir que un taco usa 2 tortillas (= 0.02 paquetes).

P: El sistema descuenta el inventario automaticamente cuando vendo? R: Si tienes configuradas las RECETAS de tus productos compuestos, si, en la sucursal donde se hace la venta. Cuando vendes un “Taco al Pastor” en la sucursal Centro, el sistema descuenta automaticamente los ingredientes en la sucursal Centro. Si otra sucursal tambien vende tacos, su stock se descucenta en su propia sucursal.

P: Puedo tener ubicaciones sin sucursal asignada (branch_id null)? R: Si. Algunas ubicaciones pueden ser null, lo que significa que son compartidas entre todas las sucursales. Esto es util si tienes una bodega central comun a todas las sucursales. Sin embargo, el boton “Agregar ubicacion” siempre crea ubicaciones con el branch_id de la sucursal activa; las ubicaciones null generalmente las crea el soporte tecnico o vienen por defecto en algunas configuraciones.

P: Como creo una ubicacion compartida (branch_id null)? R: Como regla general, el sistema siempre asigna el branch_id de la sucursal activa cuando creas una ubicacion. Si necesitas una ubicacion explicitamente compartida (null), contacta al soporte tecnico para configurarla.

P: Puedo transferir stock entre sucursales? R: Para transferir stock entre sucursales, haz una SALIDA MANUAL en la sucursal de origen (con el selector en esa sucursal) y una ENTRADA MANUAL en la sucursal de destino (con el selector en esa otra sucursal). En cada ajuste, escribe una nota clara indicando que es una transferencia entre sucursales y de cual a cual.

P: Que hace assertLocationBranch? R: Es una validacion interna del sistema que revisa que la ubicacion que estas asignando a un item tenga el mismo branch_id que la sucursal activa. Si no coinciden, el sistema te bloquea. Esto evita errores como asignar a un item de la sucursal A una ubicacion fisica de la sucursal B.

P: Puedo usar codigos de barras con el inventario? R: Revisa si tu plan de Emelit Express incluye soporte para lectores de codigo de barras. Si es asi, puedes asignar un codigo de barras a cada item en el campo SKU y usar un lector para registrar entradas y salidas mas rapido.

P: Que hago si manejo productos que se venden por peso? R: Crea el item con unidad “Kilogramo”. Al vender, especifica la cantidad exacta (ej. 0.250 kg). El sistema descontara la fraccion correspondiente EN ESA SUCURSAL.

P: Cuantos items puedo registrar? R: No hay un limite conocido. Sin embargo, entre mas items tengas, mas importante es que uses categorias, filtros, SKUs y el selector de sucursal para mantener el orden.

P: Puedo importar mi inventario desde Excel? R: Algunas versiones del sistema permiten importacion masiva. Revisa en la pestana Items si hay un boton de “Importar”. Si no esta disponible, contacta a soporte para preguntar si pueden ayudarte con una migracion desde tu archivo de Excel. Si lo haces, asegurate de incluir la columna branch_id para que cada item quede en la sucursal correcta.