Kowal Reservation Cleaner voor Magento 2

MAGENTO 2 · ERP · MSI · GESELECTEERDE STOCKS

Kowal Reservation Cleaner

Start in een gespecialiseerde ERP-first implementatie gecontroleerde opschoning van reserveringen voor de volledige tabel of voor geselecteerde stocks. Stel het schema, logging, reindexering en procesvergrendeling in.

Cron of CLI · Log Only en Dry Run · Volledige of selectieve opschoning

HOE DIT IN DE PRAKTIJK WERKT

De module is geschikt als:

• voorraadstanden regelmatig uit ERP worden geïmporteerd
• Magento niet het primaire voorraadsysteem is
• MSI-reserveringen de salable quantity verstoren
• snelle, voorspelbare en automatische opschoning van reserveringen nodig is
• de shop met meerdere stocks werkt en de opschoning alleen geselecteerde stocks moet omvatten

De module is niet bedoeld voor shops die voorraadstanden uitsluitend aan de Magento-zijde beheren en vertrouwen op de volledige realtime MSI-logica.

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 beïnvloeden ze nog steeds de productbeschikbaarheid en de diagnose van voorraadstanden.

De meest voorkomende gevolgen:

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

• automatisch starten via Magento CRON
• handmatig starten via CLI
• modi full_reset, log_only en clean_after_erp_sync
• vergrendeling tegen parallelle uitvoering van het proces
• optionele reindexering na opschoning
• optionele cache clean na afloop
• technische logging naar een bestand
• mogelijkheid om opschoning te beperken tot geselecteerde stocks

De module registreert een CRON-taak die vaak wordt gestart, 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 instellingen.

Procesverloop:

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

De eenvoudigste en snelste variant voor ERP-first shops.

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.

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

Modus bedoeld om direct na de import van voorraadstanden uit ERP te starten. Functioneel worden reserveringen net als bij full_reset opgeschoond, maar het implementatiemodel en het schema worden hierdoor beter geordend.

De module ondersteunt ook het scenario waarin alleen de opgegeven 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 die 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 geeft meer controle in complexere implementaties.

• betere consistentie van voorraadstanden tussen Magento en ERP
• minder fouten rond salable quantity
• eenvoudigere diagnose van voorraadstanden
• 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

Beheerpaneel:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Belangrijkste instellingen:

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

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 kun je de module handmatig, testmatig of direct na afloop van de ERP-import starten.

Het 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

De meest praktische variant voor ERP-first shops:

• modus full_reset
• actieve logging
• schema dat kort na de ERP-import wordt gestart
• reindexering inventory_only of apart in het integratieproces
• leeg stockveld voor volledige opschoning of opgegeven stocks waar een selectieve variant vereist is

Deze module:

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

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

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

Heb je implementatie nodig of wil je de module aanpassen aan je ERP-integratie, meerdere stocks of een aangepast schema? Neem contact met ons op via kowal.store en beschrijf je synchronisatiemodel voor voorraad.

Full Reset en Clean After ERP Sync verwijderen reserveringsrecords binnen de geselecteerde scope. Bij een lege lijst met stocks leegt het proces de volledige tabel inventory_reservation; bij opgegeven stocks worden alleen de bijbehorende records verwijderd.

De implementatie vereist een model waarin ERP de juiste voorraadstanden levert nadat het bestelproces is meegenomen. Alleen het verwijderen van reserveringen bevestigt niet dat de beschikbaarheid correct is en herstelt de MSI-geschiedenis niet.

De naam clean_after_erp_sync beschrijft het gebruik; het is geen automatische integratie met de gebeurtenis van een voltooide ERP-import. De start na synchronisatie organiseer je via CLI of een passend gekozen schema.

Cron controleert het ingestelde tijdslot en de omgeving. Omgevingsafhandeling gebruikt APP_ENV of MAGENTO_ENV en de Magento-modus. De vergrendeling beperkt parallelle uitvoeringen.

Log Only en --dry-run=1 dienen om records te tellen zonder ze te verwijderen. Controleer stock_id, het afronden van de ERP-import en de verwachte salable quantity voordat je opschoning inschakelt.

Reindexering en cache clean zijn optionele stappen. Stem inventory_only, volledige reindexering of een apart indexeringsproces af op de daadwerkelijke voorraadintegratie.

Pakket kowal/reservation-cleaner, module Kowal_ReservationCleaner. Nadat je toegang tot de Kowal-repository hebt geconfigureerd, installeer je het pakket, schakel je de module in, werk je Magento bij en leeg je de cache. Neem in productie compilatie en deployment van statische content mee volgens het proces van de shop.

1. Je bepaalt het synchronisatiemodel
Je bevestigt wanneer ERP de juiste voorraadstanden doorgeeft.

2. Je controleert de scope
Je kiest stocks en analyseert het resultaat van Log Only of Dry Run.

3. Je start het proces
Het schema of CLI voert de opschoning en optionele reindexering uit.

ERP heeft de voorraadimport voltooid. De integratie start het CLI-proces voor de vastgestelde scope van stocks en het resultaat wordt naar het log geschreven.

De modus clean_after_erp_sync detecteert het einde van de import niet zelf. De volgorde van stappen wordt verzorgd door het schema of de ERP-integratie.