Kowal Reservation Cleaner voor Magento 2

Voor wie is deze module bedoeld

De module is geschikt als:

• voorraadniveaus regelmatig vanuit ERP worden geïmporteerd
• Magento niet het primaire magazijnsysteem is
• MSI-reserveringen de salable quantity verstoren
• er behoefte is aan snelle, voorspelbare en automatische opschoning van reserveringen
• de webshop met meerdere stocks werkt en de opschoning alleen geselecteerde stocks moet omvatten

De module is niet bedoeld voor webshops die de voorraad uitsluitend aan Magento-zijde beheren en vertrouwen op de volledige MSI-logica in real time.

Het probleem dat wordt opgelost

In standaard Magento 2 met MSI slaan opeenvolgende bestellingen, annuleringen en verzendingen gegevens op in inventory_reservation. In omgevingen met ERP-integratie zijn deze records operationeel vaak niet meer nodig, maar ze blijven de productbeschikbaarheid en de diagnose van voorraadniveaus beïnvloeden.

De meest voorkomende gevolgen:

• te lage salable quantity
• afwijkingen tussen Magento en ERP
• een groeiend aantal records in inventory_reservation
• lastigere diagnose van voorraadproblemen
• extra belasting voor berekeningen rond beschikbaarheid

Belangrijkste functies

• automatische uitvoering via Magento CRON
• handmatige uitvoering via CLI
• modi full_reset, log_only en clean_after_erp_sync
• blokkering tegen parallelle uitvoering van het proces
• optionele herindexering na opschoning
• optionele cache clean na afronding
• technische logging naar een bestand
• mogelijkheid om de opschoning te beperken tot geselecteerde stocks

Hoe de module werkt

De module registreert een CRON-taak die vaak wordt uitgevoerd, maar de daadwerkelijke uitvoering vindt alleen plaats wanneer de huidige tijd overeenkomt met de configuratie. Daardoor hoeft het systeemschema niet dynamisch opnieuw te worden opgebouwd na elke wijziging van de instellingen.

Procesverloop:

1. Controleren of de module actief is.
2. Controleren of de omgeving is toegestaan.
3. Controleren van het schema.
4. Instellen van de procesvergrendeling.
5. Tellen van reserveringsrecords.
6. Uitvoeren van de opschoning of alleen logging.
7. Optionele herindexering.
8. Optionele cache clean.
9. Vrijgeven van de vergrendeling en opslaan van de log.

Werkmodi

Full Reset

De eenvoudigste en snelste variant voor ERP-first webshops.

Wanneer de opschoning alle stocks betreft, gebruikt de module:

TRUNCATE TABLE inventory_reservation

Deze oplossing is het meest efficiënt bij een groot aantal records.

Log Only

Diagnostische modus. De module verwijdert geen gegevens, maar telt alleen records en schrijft het resultaat weg in de log.

Clean After ERP Sync

Modus bedoeld om direct na de import van voorraadniveaus uit ERP te worden uitgevoerd. Functioneel worden reserveringen opgeschoond zoals bij full_reset, maar deze modus ordent het implementatiemodel en het schema.

Opschoning alleen voor geselecteerde stocks

De module ondersteunt ook het scenario waarbij alleen aangegeven stocks worden opgeschoond.

Werking:

• als de lijst met stocks leeg is, wordt de volledige reserveringstabel opgeschoond
• als specifieke stocks zijn opgegeven, verwijdert de module alleen records voor deze stock_id

In dat geval wordt een selectieve query gebruikt:

DELETE FROM inventory_reservation WHERE stock_id IN (...)

Deze aanpak is langzamer dan TRUNCATE, maar maakt het mogelijk reserveringen voor de overige stocks te behouden en biedt meer controle bij complexere implementaties.

Zakelijke voordelen

• betere overeenstemming van voorraadniveaus tussen Magento en ERP
• minder fouten rond salable quantity
• eenvoudigere diagnose van voorraadniveaus
• kleiner risico op groei van onnodige gegevens in MSI
• mogelijkheid tot implementatie zonder Magento MSI uit te schakelen
• voorspelbaar en snel proces dat kan worden geautomatiseerd

Configuratie

Adminpanel:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Belangrijkste instellingen:

• module in- of uitschakelen
• keuze van de werkmodus
• uur en minuut van uitvoering
• selectie van stocks voor opschoning
• herindexering inschakelen
• type herindexering
• cache clean na het proces
• logging
• geldigheidsduur van de lock
• werking beperken tot geselecteerde omgevingen

Uitvoeren via CLI

Basiscommando:

bin/magento kowal:reservation:clean

Voorbeeldgebruik:

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

Hiermee kan de module handmatig, testmatig of direct na voltooiing van de ERP-import worden uitgevoerd.

Logging en veiligheid

De technische log wordt opgeslagen in:

var/log/kowal_reservation_cleaner.log

De module bevat:

• procesvergrendeling
• afhandeling van uitzonderingen
• omgevingscontrole
• controle van het tijdslot
• mogelijkheid om in de modus log_only te werken

Aanbevolen implementatiemodel

De meest praktische variant voor ERP-first webshops:

• modus full_reset
• actieve logging
• schema dat kort na de ERP-import wordt uitgevoerd
• herindexering inventory_only of afzonderlijk binnen het integratieproces
• leeg stocks-veld voor volledige opschoning of opgegeven stocks waar een selectieve variant vereist is

Beperkingen

Deze module:

• herstelt de MSI-logica niet
• reconstrueert de reserveringsgeschiedenis niet
• vervangt geen correct ontworpen ERP-integratie
• is geen universele oplossing voor alle Magento webshops

Dit is een gespecialiseerd hulpmiddel voor implementaties waarin ERP de werkelijke voorraad beheert.

Pakket en modulenaam

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

CTA

Heeft u implementatie of aanpassing van de module nodig voor ERP-integratie, meerdere stocks of een aangepast schema? Neem contact met ons op via kowal.store en beschrijf uw model voor voorraadsynchronisatie.