Kowal Reservation Cleaner pentru Magento 2

Pentru cine este acest modul

Modulul este potrivit dacă:

• stocurile sunt importate periodic din ERP
• Magento nu este sistemul principal de gestiune a stocurilor
• rezervările MSI afectează salable quantity
• este necesară o curățare rapidă, previzibilă și automată a rezervărilor
• magazinul funcționează pe mai multe stock-uri, iar curățarea trebuie să includă doar unele dintre ele

Modulul nu este destinat magazinelor care gestionează stocurile exclusiv în Magento și se bazează pe logica MSI completă, în timp real.

Problema pe care o rezolvă

În Magento 2 standard cu MSI, comenzile, anulările și expedierile succesive salvează date în inventory_reservation. În mediile cu integrare ERP, aceste înregistrări adesea nu mai sunt necesare operațional, dar continuă să influențeze disponibilitatea produselor și diagnosticarea stocurilor.

Cele mai frecvente efecte:

• salable quantity subestimată
• neconcordanțe între Magento și ERP
• creșterea numărului de înregistrări în inventory_reservation
• diagnosticare mai dificilă a problemelor de stoc
• încărcare suplimentară pentru calculele legate de disponibilitate

Funcții principale

• rulare automată prin Magento CRON
• rulare manuală prin CLI
• modurile full_reset, log_only și clean_after_erp_sync
• blocare împotriva rulării paralele a procesului
• reindexare opțională după curățare
• cache clean opțional după finalizare
• logare tehnică într-un fișier
• posibilitatea de a limita curățarea la stock-urile selectate

Cum funcționează modulul

Modulul înregistrează o sarcină CRON rulată frecvent, însă execuția efectivă are loc doar atunci când ora curentă corespunde configurației. Astfel, nu este necesară reconstruirea dinamică a programului de sistem după fiecare modificare a setărilor.

Desfășurarea procesului:

1. Verificarea dacă modulul este activ.
2. Verificarea dacă mediul este permis.
3. Verificarea programului.
4. Aplicarea blocării procesului.
5. Numărarea înregistrărilor de rezervare.
6. Executarea curățării sau doar a logării.
7. Reindexare opțională.
8. Cache clean opțional.
9. Eliberarea blocării și salvarea logului.

Moduri de funcționare

Full Reset

Cea mai simplă și rapidă variantă pentru magazinele ERP-first.

Când curățarea se aplică tuturor stock-urilor, modulul folosește:

TRUNCATE TABLE inventory_reservation

Această soluție este cea mai eficientă la un număr mare de înregistrări.

Log Only

Mod de diagnosticare. Modulul nu șterge datele, ci doar numără înregistrările și salvează rezultatul în log.

Clean After ERP Sync

Mod destinat rulării imediat după importul stocurilor din ERP. Funcțional, curăță rezervările la fel ca full_reset, dar organizează modelul de implementare și programul.

Curățare doar pentru stock-urile selectate

Modulul acceptă și scenariul de curățare doar pentru stock-urile indicate.

Mod de funcționare:

• dacă lista de stock-uri este goală, este curățat întregul tabel de rezervări
• dacă sunt indicate stock-uri concrete, modulul șterge doar înregistrările pentru acele stock_id

În acest caz este utilizată o interogare selectivă:

DELETE FROM inventory_reservation WHERE stock_id IN (...)

Această abordare este mai lentă decât TRUNCATE, dar permite păstrarea rezervărilor pentru celelalte stock-uri și oferă un control mai mare în implementările mai complexe.

Beneficii pentru business

• concordanță mai bună a stocurilor între Magento și ERP
• mai puține erori legate de salable quantity
• diagnosticare mai simplă a stocurilor
• risc mai mic de acumulare a datelor inutile în MSI
• posibilitatea de implementare fără dezactivarea Magento MSI
• proces previzibil și rapid, care poate fi automatizat

Configurare

Panou de administrare:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Cele mai importante setări:

• activarea sau dezactivarea modulului
• alegerea modului de funcționare
• ora și minutul rulării
• alegerea stock-urilor pentru curățare
• activarea reindexării
• tipul de reindexare
• cache clean după proces
• logare
• durata de valabilitate a lock-ului
• limitarea funcționării la mediile selectate

Rulare din CLI

Comanda de bază:

bin/magento kowal:reservation:clean

Exemple de utilizare:

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

Acest lucru permite rularea modulului manual, pentru testare sau direct după finalizarea importului ERP.

Logare și securitate

Logul tehnic este salvat în:

var/log/kowal_reservation_cleaner.log

Modulul include:

• blocarea procesului
• gestionarea excepțiilor
• controlul mediului
• controlul intervalului de timp
• posibilitatea de a lucra în modul log_only

Model de implementare recomandat

Cea mai practică variantă pentru magazinele ERP-first:

• modul full_reset
• logare activă
• program rulat la scurt timp după importul ERP
• reindexare inventory_only sau separat în procesul de integrare
• câmpul de stock-uri lăsat gol pentru curățare completă sau stock-uri indicate acolo unde este necesară varianta selectivă

Limitări

Acest modul:

• nu repară logica MSI
• nu reconstruiește istoricul rezervărilor
• nu înlocuiește o integrare ERP proiectată corect
• nu este o soluție universală pentru toate magazinele Magento

Este un instrument specializat pentru implementările în care ERP gestionează stocul real.

Pachet și nume modul

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

CTA

Aveți nevoie de implementarea sau adaptarea modulului la integrarea ERP, la mai multe stock-uri ori la un program personalizat? Contactați-ne prin kowal.store și descrieți modelul dumneavoastră de sincronizare a stocurilor.