Almacenes

Crea almacenes y secciones (incluida la categoría sucursal) y define dónde se guarda cada producto.

Un almacén en Mosce ERP es cualquier lugar donde guardas mercancía: una bodega, una sucursal, un vehículo de reparto o un almacén virtual para consignaciones. Dentro de cada almacén organizas el espacio en secciones jerárquicas (pasillos, estantes, gavetas).

Tiempo de lectura: ~4 min

Cuándo usar esto

Configura los almacenes antes de empezar a registrar inventario. Los necesitas para:

Recibir mercancía de una orden de compra.
Vender desde el POS o desde una factura (cada producto sale del almacén que lo tiene en stock).
Hacer ajustes y transferencias.
Ver niveles de stock segmentados por ubicación.

Importante: en Mosce ERP no existe un módulo de “Sucursales” aparte. Si tienes varias sucursales físicas, crea un almacén por cada una con tipo Sucursal (BRANCH). Cada sucursal queda como un almacén independiente con sus propias secciones y stock.

Antes de empezar

Tu rol debe tener los permisos warehouses:create, warehouses:update y warehouses:delete según la acción.
Decide cuál será tu almacén por defecto. Mosce ERP exige que siempre haya al menos uno marcado como default y activo.
Ten lista la dirección de cada ubicación (opcional pero recomendable para los PDFs y reportes).

Paso a paso

1. Crear un almacén

Ve a Inventario → Almacenes en el menú lateral.
Haz clic en Nuevo almacén.
Llena el formulario:
- Nombre - visible en la app, ej. Almacén Central.
- Código - se genera automáticamente del nombre (slug). Solo necesitas ajustarlo si ya está en uso por otro almacén.
- Tipo - elige entre:
  - Principal (MAIN): tu bodega central.
  - Sucursal (BRANCH): una tienda o punto de venta físico aparte.
  - Vehículo (VEHICLE): unidad móvil (camión, moto de reparto).
  - Virtual (VIRTUAL): consignaciones, mercancía en tránsito o stock que no vive en una ubicación física.
- Almacén por defecto - actívalo si quieres que este sea el que Mosce ERP use cuando no se especifique uno.
- Dirección y Notas son opcionales.
Guarda. Mosce ERP crea atómicamente el almacén y una sección raíz llamada General para que ya puedas registrar stock.

2. Crear secciones dentro del almacén

Las secciones subdividen el espacio físico (pasillos, anaqueles, gavetas). Cada InventoryItem - el registro de stock por producto - vive en una sección, no en el almacén directamente.

Entra al detalle del almacén desde el listado.
En la tarjeta Secciones haz clic en Agregar sección.
Llena:
- Nombre, ej. Pasillo A.
- Código (slug auto-generado).
- Sección padre - déjalo vacío para una sección raíz, o elige una sección existente para anidarla.
- Capacidad y unidad (unidades, kg, litros, m³). Es informativo: Mosce ERP no bloquea movimientos por capacidad, solo te ayuda a planificar.
Guarda.

Puedes anidar secciones hasta 5 niveles de profundidad. Una sección inactiva desactiva en cascada a sus subsecciones (no podrás recibir ni transferir hacia ellas).

3. Asignar el almacén default de un producto

En la ficha del producto (Operaciones → Productos) puedes establecer un almacén por defecto para ese producto. Cuando vendas o ajustes ese producto sin especificar ubicación, Mosce ERP usa ese almacén primero.

Si el producto no tiene default, Mosce ERP usa el almacén default del tenant.

4. Editar, desactivar o eliminar

Editar - desde el detalle del almacén, botón Editar (puedes cambiar tipo, dirección, notas, etc.).
Desactivar - toggle de activación en el detalle. Un almacén inactivo no aparece en selectores de venta, compra o transferencia, pero conserva su historial.
Eliminar - botón de basurero. Solo es posible si el almacén no tiene stock activo. Si tiene stock, primero hay que transferirlo o ajustarlo a cero.

Resultado esperado

Cada ubicación física o lógica de tu negocio está representada como un almacén con su tipo correcto.
Cada almacén tiene al menos una sección donde registrar stock.
Hay exactamente un almacén marcado como default activo.
Tus productos tienen asignado un almacén default (opcional pero recomendado).

Errores comunes

No se puede eliminar: el almacén tiene stock activo - transfiere o ajusta el stock a cero antes de eliminar.
Ya existe un almacén con ese código - cambia el nombre o ajusta el slug manualmente al crear.
Debe existir al menos un almacén activo por defecto - no puedes desactivar o quitar el flag al único default. Marca primero otro como default.
La profundidad máxima de secciones es 5 niveles - reorganiza la jerarquía o crea la sub-sección un nivel más arriba.