Kowal Reservation Cleaner per Magento 2

MAGENTO 2 · ERP · MSI · STOCK SELEZIONATI

Kowal Reservation Cleaner

In un’implementazione specializzata ERP-first, avvia una pulizia controllata delle prenotazioni per l’intera tabella o per stock selezionati. Configura pianificazione, logging, reindicizzazione e blocco del processo.

Cron o CLI · Log Only e Dry Run · Pulizia completa o selettiva

COME FUNZIONA IN PRATICA

Il modulo è adatto se:

• le giacenze di magazzino vengono importate regolarmente dall’ERP
• Magento non è il sistema principale di gestione del magazzino
• le prenotazioni MSI alterano la salable quantity
• serve una pulizia delle prenotazioni rapida, prevedibile e automatica
• lo store lavora su più stock e la pulizia deve riguardare solo alcuni di essi

Il modulo non è pensato per store che gestiscono le giacenze esclusivamente lato Magento e si basano sulla logica MSI completa in tempo reale.

In Magento 2 standard con MSI, ordini successivi, annullamenti e spedizioni registrano dati in inventory_reservation. Negli ambienti con integrazione ERP questi record spesso non sono più necessari a livello operativo, ma continuano a influire sulla disponibilità dei prodotti e sulla diagnosi delle giacenze.

Effetti più comuni:

• salable quantity sottostimata
• disallineamenti tra Magento ed ERP
• numero crescente di record in inventory_reservation
• diagnosi più complessa dei problemi di magazzino
• carico aggiuntivo per i calcoli legati alla disponibilità

• avvio automatico da Magento CRON
• avvio manuale tramite CLI
• modalità full_reset, log_only e clean_after_erp_sync
• blocco contro l’esecuzione parallela del processo
• reindicizzazione opzionale dopo la pulizia
• cache clean opzionale al termine
• logging tecnico su file
• possibilità di limitare la pulizia agli stock selezionati

Il modulo registra un’attività CRON eseguita frequentemente, ma l’esecuzione effettiva avviene solo quando l’orario corrente coincide con la configurazione. In questo modo non è necessario ricostruire dinamicamente la pianificazione di sistema dopo ogni modifica delle impostazioni.

Flusso del processo:

1. Verifica che il modulo sia attivo.
2. Verifica che l’ambiente sia consentito.
3. Verifica della pianificazione.
4. Applicazione del blocco del processo.
5. Conteggio dei record di prenotazione.
6. Esecuzione della pulizia o del solo logging.
7. Reindicizzazione opzionale.
8. Cache clean opzionale.
9. Rilascio del blocco e registrazione del log.

La variante più semplice e veloce per store ERP-first.

Quando la pulizia riguarda tutti gli stock, il modulo utilizza:

TRUNCATE TABLE inventory_reservation

Questa soluzione è la più efficiente con un numero elevato di record.

Modalità diagnostica. Il modulo non elimina i dati, ma si limita a contare i record e a salvare il risultato nel log.

Modalità pensata per essere avviata subito dopo l’importazione delle giacenze dall’ERP. Dal punto di vista funzionale pulisce le prenotazioni come full_reset, ma rende più ordinato il modello di implementazione e la pianificazione.

Il modulo supporta anche lo scenario di pulizia solo per gli stock indicati.

Funzionamento:

• se l’elenco degli stock è vuoto, viene pulita l’intera tabella delle prenotazioni
• se sono indicati stock specifici, il modulo elimina solo i record relativi a quei stock_id

In questo caso viene utilizzata una query selettiva:

DELETE FROM inventory_reservation WHERE stock_id IN (...)

Questo approccio è più lento di TRUNCATE, ma consente di mantenere le prenotazioni per gli altri stock e offre maggiore controllo nelle implementazioni più complesse.

• migliore coerenza delle giacenze tra Magento ed ERP
• meno errori legati alla salable quantity
• diagnosi più semplice delle giacenze di magazzino
• minor rischio di accumulo di dati non necessari in MSI
• possibilità di implementazione senza disattivare Magento MSI
• processo prevedibile e rapido, automatizzabile

Pannello di amministrazione:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Impostazioni principali:

• attivazione o disattivazione del modulo
• scelta della modalità operativa
• ora e minuto di avvio
• selezione degli stock da pulire
• attivazione della reindicizzazione
• tipo di reindicizzazione
• cache clean dopo il processo
• logging
• durata di validità del lock
• limitazione dell’esecuzione agli ambienti selezionati

Comando base:

bin/magento kowal:reservation:clean

Esempi di utilizzo:

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

Questo consente di avviare il modulo manualmente, per test o direttamente dopo il completamento dell’importazione ERP.

Il log tecnico viene salvato in:

var/log/kowal_reservation_cleaner.log

Il modulo include:

• blocco del processo
• gestione delle eccezioni
• controllo dell’ambiente
• controllo dello slot temporale
• possibilità di lavorare in modalità log_only

La variante più pratica per store ERP-first:

• modalità full_reset
• logging attivo
• pianificazione avviata poco dopo l’importazione ERP
• reindicizzazione inventory_only oppure separata nel processo di integrazione
• campo stock vuoto per la pulizia completa oppure stock indicati dove è richiesta la variante selettiva

Questo modulo:

• non corregge la logica MSI
• non ricostruisce lo storico delle prenotazioni
• non sostituisce un’integrazione ERP progettata correttamente
• non è una soluzione universale per tutti gli store Magento

È uno strumento specializzato per implementazioni in cui l’ERP gestisce la reale giacenza di magazzino.

• Magento module: Kowal_ReservationCleaner
• Composer package: kowal/reservation-cleaner

Hai bisogno di implementare il modulo o adattarlo all’integrazione ERP, a più stock o a una pianificazione non standard? Contattaci tramite kowal.store e descrivi il tuo modello di sincronizzazione del magazzino.

Full Reset e Clean After ERP Sync eliminano i record delle prenotazioni nell’ambito selezionato. Con l’elenco degli stock vuoto, il processo svuota l’intera tabella inventory_reservation; con stock indicati, elimina solo i relativi record.

L’implementazione richiede un modello in cui l’ERP fornisca le giacenze corrette dopo aver considerato il processo degli ordini. La sola eliminazione delle prenotazioni non conferma la correttezza della disponibilità e non ricostruisce lo storico MSI.

Il nome clean_after_erp_sync descrive l’utilizzo; non rappresenta un’integrazione automatica con l’evento di completamento dell’importazione ERP. L’avvio dopo la sincronizzazione viene organizzato tramite CLI o tramite una pianificazione adeguata.

Cron verifica lo slot temporale configurato e l’ambiente. La gestione dell’ambiente utilizza APP_ENV o MAGENTO_ENV e la modalità Magento. Il blocco limita le esecuzioni parallele.

Log Only e --dry-run=1 servono a contare i record senza eliminarli. Verifica stock_id, completamento dell’importazione ERP e salable quantity attesa prima di attivare la pulizia.

Reindicizzazione e cache clean sono fasi opzionali. Scegli inventory_only, la reindicizzazione completa o un processo di indicizzazione separato in base alla reale integrazione di magazzino.

Pacchetto kowal/reservation-cleaner, modulo Kowal_ReservationCleaner. Dopo aver configurato l’accesso al repository Kowal, installa il pacchetto, abilita il modulo, aggiorna Magento e svuota la cache. In produzione considera la compilazione e il deploy dei contenuti statici in base al processo dello store.

1. Definisci il modello di sincronizzazione
Verifichi quando l’ERP trasmette le giacenze corrette.

2. Controlli l’ambito
Selezioni gli stock e analizzi il risultato di Log Only o Dry Run.

3. Avvii il processo
La pianificazione o la CLI esegue la pulizia e la reindicizzazione opzionale.

L’ERP ha completato l’importazione delle giacenze. L’integrazione avvia il processo CLI per l’ambito di stock definito e il risultato viene salvato nel log.

La modalità clean_after_erp_sync non rileva autonomamente il completamento dell’importazione. La sequenza delle fasi è garantita dalla pianificazione o dall’integrazione ERP.