Ubicaciones Almacén

Gestiona ubicaciones físicas dentro de almacenes con estructura jerárquica (pasillo, estante, compartimento).

Pasos

1. Ve a la pestaña “Almacenes → Ubicaciones”.
2. Clic en ”+ Nueva Ubicación”.
3. Selecciona el almacén padre.
4. Completa los campos obligatorios (ver tabla abajo).
5. (Opcional) Define estructura jerárquica (pasillo, estante, compartimento).
6. Clic en “Guardar” — ubicación creada.

Consejo

Usa códigos alfanuméricos cortos para facilitar la identificación (ej: A1-E2-C3 = Pasillo A1, Estante E2, Compartimento C3).

Campos obligatorios

Campo	Descripción	Ejemplo
Almacén	Almacén padre	Almacén Central
Nombre	Identificador descriptivo	Zona de Ropa
Código	Código único de ubicación	A1-E2-C3

Campos opcionales — Estructura jerárquica

Campo	Descripción	Ejemplo
Pasillo	Identificador de pasillo	A1
Estante	Número de estantería	E2
Compartimento	Compartimento específico	C3

Cómo sé que lo hice bien

• La ubicación aparece en la lista con su código único.
• Puedes asignar productos a la ubicación.
• El código se puede usar en transferencias de stock.

Errores comunes

Mensaje	Causa	Solución
”El almacén es requerido”	No seleccionaste almacén	Elige un almacén de la lista
”El nombre es requerido”	Campo vacío	Introduce nombre descriptivo
”El código es requerido”	Campo vacío	Introduce código único
”Código duplicado”	Ya existe	Usa código diferente

🔧 Detalles Técnicos — Ubicaciones Almacén

Tablas involucradas:

Tabla	Columnas clave	FK
warehouse_locations	id, warehouse_id, name, code, description, aisle, shelf, bin, is_active	warehouses

Tipo de dato:

interface LocationData {
  id: string;
  warehouse_id: string;
  name: string;
  code: string;
  description?: string;
  aisle?: string;
  shelf?: string;
  bin?: string;
  is_active: boolean;
}

Componente:

• Sub-módulo: /src/features/products/sub-modules/warehouse/
• LocationManager.tsx — Gestión de ubicaciones
• LocationSelector.tsx — Selector de ubicaciones en formularios

Queries de diagnóstico:

-- Ubicaciones de un almacén
SELECT id, name, code, aisle, shelf, bin
FROM warehouse_locations
WHERE warehouse_id = '<warehouse_id>'
  AND is_active = true
ORDER BY code;

-- Productos por ubicación
SELECT wl.code as ubicacion, p.name, sm.quantity
FROM stock_movements sm
INNER JOIN warehouse_locations wl ON wl.id = sm.warehouse_location_to_id
INNER JOIN products p ON p.id = sm.product_id
WHERE wl.warehouse_id = '<warehouse_id>'
  AND sm.movement_type = 'entrada';

Query keys:

• Ubicación: /src/features/products/sub-modules/warehouse/api/query-keys.ts
• warehouseLocationKeys.all
• warehouseLocationKeys.byWarehouse(warehouseId)

---