Kowal Reservation Cleaner para Magento 2

MAGENTO 2 · ERP · MSI · STOCKS SELECCIONADOS

Kowal Reservation Cleaner

En una implementación especializada ERP-first, ejecuta una limpieza controlada de reservas para toda la tabla o para stocks seleccionados. Configura la programación, el registro, la reindexación y el bloqueo del proceso.

Cron o CLI · Log Only y Dry Run · Limpieza completa o selectiva

CÓMO FUNCIONA EN LA PRÁCTICA

El módulo encaja si:

• los stocks se importan regularmente desde el ERP
• Magento no es el sistema de almacén principal
• las reservas MSI alteran salable quantity
• se necesita una limpieza de reservas rápida, predecible y automática
• la tienda trabaja con varios stocks y la limpieza debe abarcar solo algunos de ellos

El módulo no está destinado a tiendas que gestionan los stocks únicamente desde Magento y se basan en toda la lógica MSI en tiempo real.

En Magento 2 estándar con MSI, los pedidos, cancelaciones y envíos sucesivos guardan datos en inventory_reservation. En entornos con integración ERP, estos registros a menudo dejan de ser necesarios operativamente, pero siguen influyendo en la disponibilidad de los productos y en el diagnóstico de stocks.

Efectos más habituales:

• salable quantity infravalorada
• desajustes entre Magento y ERP
• número creciente de registros en inventory_reservation
• diagnóstico más difícil de problemas de almacén
• carga adicional en los cálculos relacionados con la disponibilidad

• ejecución automática desde Magento CRON
• ejecución manual mediante CLI
• modos full_reset, log_only y clean_after_erp_sync
• bloqueo frente a la ejecución paralela del proceso
• reindexación opcional después de la limpieza
• cache clean opcional al finalizar
• registro técnico en archivo
• posibilidad de limitar la limpieza a stocks seleccionados

El módulo registra una tarea CRON que se ejecuta con frecuencia, pero la ejecución real solo se produce cuando la hora actual coincide con la configuración. Gracias a ello, no es necesario reconstruir dinámicamente la programación del sistema después de cada cambio de ajustes.

Flujo del proceso:

1. Comprobación de si el módulo está activo.
2. Comprobación de si el entorno está permitido.
3. Comprobación de la programación.
4. Creación del bloqueo del proceso.
5. Recuento de los registros de reservas.
6. Ejecución de la limpieza o solo del registro.
7. Reindexación opcional.
8. Cache clean opcional.
9. Liberación del bloqueo y guardado del log.

La variante más sencilla y rápida para tiendas ERP-first.

Cuando la limpieza afecta a todos los stocks, el módulo utiliza:

TRUNCATE TABLE inventory_reservation

Esta solución es la más eficiente cuando hay una gran cantidad de registros.

Modo de diagnóstico. El módulo no elimina datos, solo cuenta registros y guarda el resultado en el log.

Modo destinado a ejecutarse justo después de importar los stocks desde el ERP. Funcionalmente limpia las reservas igual que full_reset, pero ordena el modelo de implementación y la programación.

El módulo también admite el escenario de limpieza solo para los stocks indicados.

Funcionamiento:

• si la lista de stocks está vacía, se limpia toda la tabla de reservas
• si se indican stocks concretos, el módulo elimina solo los registros de esos stock_id

En este caso se utiliza una consulta selectiva:

DELETE FROM inventory_reservation WHERE stock_id IN (...)

Este enfoque es más lento que TRUNCATE, pero permite conservar las reservas de los demás stocks y ofrece mayor control en implementaciones más complejas.

• mejor coherencia de stocks entre Magento y ERP
• menos errores relacionados con salable quantity
• diagnóstico más sencillo de stocks
• menor riesgo de acumulación de datos innecesarios en MSI
• posibilidad de implementación sin desactivar Magento MSI
• proceso predecible y rápido que puede automatizarse

Panel de administración:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Ajustes principales:

• activar o desactivar el módulo
• selección del modo de funcionamiento
• hora y minuto de ejecución
• selección de stocks para limpiar
• activación de la reindexación
• tipo de reindexación
• cache clean después del proceso
• registro
• tiempo de validez del lock
• limitación del funcionamiento a entornos seleccionados

Comando básico:

bin/magento kowal:reservation:clean

Ejemplos de uso:

bin/magento kowal:reservation:clean --mode=full_resetbin/magento kowal:reservation:clean --mode=log_onlybin/magento kowal:reservation:clean --reindex=inventory_onlybin/magento kowal:reservation:clean --dry-run=1bin/magento kowal:reservation:clean --stocks=1,2

Esto permite ejecutar el módulo manualmente, en modo de prueba o directamente después de finalizar la importación del ERP.

El log técnico se guarda en:

var/log/kowal_reservation_cleaner.log

El módulo incluye:

• bloqueo del proceso
• gestión de excepciones
• control del entorno
• control del intervalo de tiempo
• posibilidad de trabajar en modo log_only

La variante más práctica para tiendas ERP-first:

• modo full_reset
• registro activo
• programación ejecutada poco después de la importación del ERP
• reindexación inventory_only o por separado en el proceso de integración
• campo de stocks vacío para una limpieza completa o stocks indicados cuando se requiere una variante selectiva

Este módulo:

• no corrige la lógica MSI
• no reconstruye el historial de reservas
• no sustituye a una integración ERP correctamente diseñada
• no es una solución universal para todas las tiendas Magento

Es una herramienta especializada para implementaciones en las que el ERP gestiona el stock real.

• Módulo Magento: Kowal_ReservationCleaner
• Paquete Composer: kowal/reservation-cleaner

¿Necesitas implementar o adaptar el módulo a la integración ERP, a múltiples stocks o a una programación no estándar? Ponte en contacto con nosotros a través de kowal.store y describe tu modelo de sincronización de almacén.

Full Reset y Clean After ERP Sync eliminan los registros de reservas en el alcance seleccionado. Con una lista de stocks vacía, el proceso vacía toda la tabla inventory_reservation; con stocks indicados, elimina solo sus registros.

La implementación requiere un modelo en el que el ERP proporcione los stocks correctos después de tener en cuenta el proceso de pedidos. El simple borrado de reservas no confirma la corrección de la disponibilidad ni recrea el historial MSI.

El nombre clean_after_erp_sync describe el uso; no constituye una integración automática con el evento de finalización de la importación del ERP. La ejecución después de la sincronización se organiza mediante CLI o con una programación adecuadamente configurada.

Cron comprueba el intervalo de tiempo configurado y el entorno. La gestión del entorno utiliza APP_ENV o MAGENTO_ENV y el modo Magento. El bloqueo limita las ejecuciones paralelas.

Log Only y --dry-run=1 sirven para contar registros sin eliminarlos. Verifica stock_id, la finalización de la importación del ERP y el salable quantity esperado antes de activar la limpieza.

La reindexación y el cache clean son etapas opcionales. Ajusta inventory_only, la reindexación completa o un proceso de indexación independiente a la integración de almacén real.

Paquete kowal/reservation-cleaner, módulo Kowal_ReservationCleaner. Después de configurar el acceso al repositorio de Kowal, instala el paquete, activa el módulo, actualiza Magento y limpia la cache. En producción, incluye la compilación y el despliegue de contenido estático de acuerdo con el proceso de la tienda.

1. Defines el modelo de sincronización
Confirmas cuándo el ERP transmite los stocks correctos.

2. Compruebas el alcance
Seleccionas los stocks y analizas el resultado de Log Only o Dry Run.

3. Ejecutas el proceso
La programación o CLI realiza la limpieza y la reindexación opcional.

El ERP ha finalizado la importación de stocks. La integración ejecuta el proceso CLI para el alcance de stocks definido y el resultado se guarda en el log.

El modo clean_after_erp_sync no detecta por sí solo la finalización de la importación. El orden de las etapas lo garantiza la programación o la integración ERP.