WMS — Gestión avanzada de almacén

El módulo WMS (Warehouse Management System) de Zentto permite gestionar almacenes con ubicaciones físicas (bins), zonas, procesos de picking, recepción y almacenamiento (put-away).

Nota

El WMS es una funcionalidad avanzada que se activa por almacén. Para almacenes simples sin necesidad de ubicaciones, no es necesario habilitarlo.

Activar WMS en un almacén

1. Vaya a Inventario → Almacenes.
2. Abra el almacén deseado.
3. Active la opción Usa WMS.
4. Configure las zonas y ubicaciones.
5. Guarde los cambios.

Nota de calidad: el endpoint /v1/inventario-avanzado/almacenes-wms retorna 404 en producción. La pantalla puede mostrar spinner infinito. Bug registrado para implementación del endpoint WMS.

Estructura del almacén

Un almacén con WMS se organiza jerárquicamente:

Almacén
├── Zona A — Recepción
│   ├── A-01-01 (Pasillo A, Rack 01, Nivel 01)
│   ├── A-01-02
│   └── A-01-03
├── Zona B — Almacenamiento general
│   ├── B-01-01
│   ├── B-01-02
│   ├── B-02-01
│   └── ...
├── Zona C — Productos de alta rotación
│   ├── C-01-01
│   └── C-01-02
├── Zona D — Despacho
│   └── D-01-01
└── Zona Q — Cuarentena
    └── Q-01-01

Zonas

Las zonas agrupan ubicaciones con un propósito común:

Zona	Propósito	Descripción
Recepción	Ingreso	Donde se descarga la mercancía recibida
Almacenamiento	Guardado	Zona principal de almacenaje
Alta rotación	Picking rápido	Productos que se despachan frecuentemente
Despacho	Salida	Zona de preparación y carga
Cuarentena	Revisión	Productos pendientes de inspección de calidad
Devoluciones	Retornos	Mercancía devuelta pendiente de clasificación

Crear una zona

1. Vaya a Inventario → Almacenes → [Almacén] → Zonas.
2. Haga clic en Nueva zona.
3. Complete:
   • Código — Identificador corto (ej: A, B, REC).
   • Nombre — Nombre descriptivo.
   • Tipo — Recepción, Almacenamiento, Despacho, Cuarentena.
4. Guarde.

Ubicaciones (Bins)

Las ubicaciones son las posiciones físicas exactas donde se almacena mercancía.

Nomenclatura recomendada

[Zona]-[Pasillo]-[Rack]-[Nivel]
Ejemplo: B-03-02-04 = Zona B, Pasillo 3, Rack 2, Nivel 4

Crear ubicaciones

Individual

1. Vaya a la zona deseada.
2. Haga clic en Nueva ubicación.
3. Complete código, tipo y capacidad.

Masiva

1. Vaya a Zonas → Generar ubicaciones.
2. Configure el patrón:
   • Prefijo de zona
   • Rango de pasillos (1-10)
   • Rango de racks (1-5)
   • Rango de niveles (1-4)
3. Haga clic en Generar.
4. El sistema crea automáticamente todas las combinaciones.

Campos de una ubicación

Campo	Descripción
Código	Identificador único (ej: B-03-02-04)
Zona	Zona a la que pertenece
Tipo	Estantería, Piso, Rack, Refrigerado, etc.
Capacidad peso	Peso máximo soportado (kg)
Capacidad volumen	Volumen máximo (m³)
Restricción	Solo ciertos artículos o categorías
Estado	Activa, Bloqueada, Mantenimiento

Procesos WMS

Recepción (Receiving)

Proceso de ingreso de mercancía al almacén:

1. Crear orden de recepción — Se genera automáticamente desde una orden de compra o se crea manualmente.
2. Verificar mercancía — Comparar lo recibido contra lo esperado.
3. Asignar ubicación temporal — Colocar en zona de recepción.
4. Inspección de calidad — Si aplica, mover a cuarentena.
5. Put-away — Almacenar en la ubicación definitiva.

Almacenamiento (Put-away)

El put-away es el proceso de mover mercancía desde recepción a su ubicación de almacenamiento:

1. El sistema sugiere ubicaciones basándose en:
   • Ubicación predeterminada del artículo.
   • Disponibilidad de espacio.
   • Zona asignada a la categoría del artículo.
   • Cercanía a productos similares.
2. El operario confirma o cambia la ubicación sugerida.
3. El sistema registra la ubicación final del artículo.

Picking

El picking es el proceso de recoger artículos para preparar un despacho:

1. Generar orden de picking — Se crea desde un pedido de venta o manualmente.
2. El sistema genera una ruta optimizada que recorre las ubicaciones en orden eficiente.
3. El operario recorre el almacén siguiendo la ruta.
4. Para cada línea, confirma la cantidad recogida.
5. Si hay artículos con trazabilidad, escanea seriales o lotes.
6. Lleva la mercancía a la zona de despacho.

Estrategias de picking

Estrategia	Descripción	Uso
Por pedido	Un picking por pedido	Pedidos grandes o personalizados
Por ola (wave)	Agrupa múltiples pedidos	Alto volumen de pedidos pequeños
Por zona	Cada operario trabaja una zona	Almacenes grandes con muchos operarios

Despacho

1. Verificar la mercancía recogida contra el pedido.
2. Empacar y etiquetar.
3. Confirmar despacho.
4. El sistema genera la salida de inventario y actualiza las ubicaciones.

Mapa del almacén

Zentto ofrece una vista gráfica del almacén que muestra:

• Zonas con código de colores según ocupación.
• Ubicaciones con indicador de llenado.
• Productos en cada ubicación al hacer clic.

Consultar ubicación de un artículo

1. Busque el artículo en Inventario → Artículos.
2. Vea la pestaña Ubicaciones.
3. El sistema muestra en qué ubicaciones está almacenado y cuántas unidades hay en cada una.

Reportes WMS

Reporte	Descripción
Ocupación por zona	Porcentaje de uso de cada zona
Ubicaciones vacías	Lista de bins disponibles
Mapa de calor	Zonas con mayor movimiento
Productividad de picking	Tiempo y unidades por operario
Órdenes pendientes	Recepciones y pickings sin completar

Secciones relacionadas

• Almacenes — Configuración general de almacenes
• Movimientos — Movimientos generados por procesos WMS
• Seriales y Lotes — Trazabilidad combinada con ubicaciones
• Artículos — Ubicación predeterminada del artículo

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, contabilidad, ventas o administración.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.

Componente	Tipo	Ubicación
POST /v1/inventory/wms/receipt	Route Express	web/api/src/routes/inventario/wms.ts
POST /v1/inventory/wms/putaway	Route Express	web/api/src/routes/inventario/wms.ts
POST /v1/inventory/wms/picking	Route Express	web/api/src/routes/inventario/wms.ts
PUT /v1/inventory/wms/picking/:id/lines/:lineId	Route Express	web/api/src/routes/inventario/wms.ts
usp_inv_WMS_Receipt_Create	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_inv_WMS_Putaway_Suggest	Stored procedure sugerencia de ubicación	web/api/sqlweb*/includes/sp/
usp_inv_WMS_Picking_Create	Stored procedure ruta optimizada	web/api/sqlweb*/includes/sp/
usp_inv_StockMove_Insert	Stored procedure movimiento de salida	web/api/sqlweb*/includes/sp/
usp_acc_JournalEntry_Insert	Stored procedure contabilidad (async)	web/api/sqlweb*/includes/sp/
inv.WmsReceipt	Tabla de órdenes de recepción WMS	web/api/migrations/postgres/...
inv.WmsPicking	Tabla de órdenes de picking	web/api/migrations/postgres/...
inv.Location	Tabla de ubicaciones físicas (bins)	web/api/migrations/postgres/...
inv.Quant	Tabla de stock por ubicación	web/api/migrations/postgres/...
WmsPage.tsx	Componente Frontend	web/modular-frontend/packages/module-inventario/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.