Kowal Reservation Cleaner für Magento 2

MAGENTO 2 · ERP · MSI · AUSGEWÄHLTE STOCKS

Kowal Reservation Cleaner

Führen Sie in einer spezialisierten ERP-first-Implementierung kontrollierte Bereinigungen der gesamten Reservierungstabelle oder ausgewählter Stocks aus. Konfigurieren Sie Zeitplan, Protokollierung, Neuindexierung und Prozesssperre.

Cron oder CLI · Log Only und Dry Run · Vollständige oder selektive Bereinigung

SO FUNKTIONIERT ES IN DER PRAXIS

Das Modul eignet sich, wenn:

• Bestände regelmäßig aus dem ERP importiert werden
• Magento nicht das führende Warenwirtschaftssystem ist
• MSI-Reservierungen Folgendes beeinträchtigen: salable quantity
• eine schnelle, vorhersehbare und automatische Reservierungsbereinigung erforderlich ist
• der Shop mehrere Stocks nutzt und nur bestimmte bereinigt werden sollen

Das Modul ist nicht für Shops bestimmt, die Bestände ausschließlich in Magento verwalten und auf die vollständige MSI-Echtzeitlogik angewiesen sind.

In Standard-Magento 2 mit MSI schreiben Bestellungen, Stornierungen und Lieferungen Daten in inventory_reservation. Bei ERP-Integrationen sind diese Datensätze operativ häufig nicht mehr nötig, beeinflussen aber weiterhin Produktverfügbarkeit und Bestandsdiagnose.

Häufigste Auswirkungen:

• zu niedrige Werte für salable quantity
• Abweichungen zwischen Magento und ERP
• zunehmende Datensatzanzahl in inventory_reservation
• erschwerte Diagnose von Bestandsproblemen
• zusätzliche Belastung der Verfügbarkeitsberechnungen

• automatische Ausführung über Magento-CRON
• manuelle Ausführung über CLI
• Modi full_reset, log_only und clean_after_erp_sync
• Sperre gegen parallele Prozessausführung
• optionale Neuindexierung nach der Bereinigung
• optionales cache clean nach Abschluss
• technische Dateiprotokollierung
• Bereinigung auf ausgewählte Stocks begrenzen

Das Modul registriert einen häufig laufenden CRON-Job, führt den Prozess jedoch nur aus, wenn die aktuelle Zeit der Konfiguration entspricht. Der Systemzeitplan muss dadurch nach Einstellungsänderungen nicht dynamisch neu aufgebaut werden.

Prozessablauf:

1. Prüfen, ob das Modul aktiv ist.
2. Prüfen, ob die Umgebung zulässig ist.
3. Zeitplan prüfen.
4. Prozesssperre setzen.
5. Reservierungsdatensätze zählen.
6. Bereinigung oder ausschließlich Protokollierung ausführen.
7. Optionale Neuindexierung.
8. Optionales cache clean.
9. Sperre lösen und Protokoll speichern.

Die einfachste und schnellste Variante für ERP-first-Shops.

Bei der Bereinigung aller Stocks verwendet das Modul:

TRUNCATE TABLE inventory_reservation

Dies ist bei großen Datensatzmengen besonders effizient.

Diagnosemodus: Das Modul löscht keine Daten, sondern zählt Datensätze und protokolliert das Ergebnis.

Modus für die Ausführung unmittelbar nach dem ERP-Bestandsimport. Funktional bereinigt er Reservierungen wie full_reset, strukturiert aber Implementierungsmodell und Zeitplan.

Das Modul unterstützt auch die Bereinigung ausschließlich ausgewählter Stocks.

Funktionsweise:

• bei leerer Stock-Liste wird die gesamte Reservierungstabelle bereinigt
• bei ausgewählten Stocks entfernt das Modul nur Datensätze für diese stock_id

Dabei wird eine selektive Abfrage verwendet:

DELETE FROM inventory_reservation WHERE stock_id IN (...)

Dieser Ansatz ist langsamer als TRUNCATE, erhält aber Reservierungen anderer Stocks und ermöglicht mehr Kontrolle bei komplexeren Implementierungen.

• bessere Bestandsübereinstimmung zwischen Magento und ERP
• weniger Fehler im Zusammenhang mit salable quantity
• einfachere Bestandsdiagnose
• geringeres Risiko unnötiger Datenansammlung in MSI
• Implementierung ohne Abschaltung von Magento MSI möglich
• vorhersehbarer, schneller und automatisierbarer Prozess

Adminbereich:

Stores -> Configuration -> Kowal -> Reservation Cleaner

Die wichtigsten Einstellungen:

• Modul aktivieren oder deaktivieren
• Betriebsmodus auswählen
• Ausführungsstunde und -minute
• Stocks zur Bereinigung auswählen
• Neuindexierung aktivieren
• Art der Neuindexierung
• cache clean nach dem Prozess
• Protokollierung
• Gültigkeitsdauer der Sperre
• Ausführung auf ausgewählte Umgebungen begrenzen

Grundbefehl:

bin/magento kowal:reservation:clean

Beispielverwendung:

bin/magento kowal:reservation:clean --mode=full_reset bin/magento kowal:reservation:clean --mode=log_only bin/magento kowal:reservation:clean --reindex=inventory_only bin/magento kowal:reservation:clean --dry-run=1 bin/magento kowal:reservation:clean --stocks=1,2

So führen Sie das Modul manuell, testweise oder direkt nach Abschluss des ERP-Imports aus.

Das technische Protokoll wird gespeichert unter:

var/log/kowal_reservation_cleaner.log

Das Modul enthält:

• Prozesssperre
• Exception-Behandlung
• Umgebungsprüfung
• Prüfung des Zeitfensters
• Betriebsmöglichkeit im Modus log_only

Die praktischste Variante für ERP-first-Shops:

• Modus full_reset
• aktive Protokollierung
• Zeitplan kurz nach dem ERP-Import
• Neuindexierung inventory_only oder separat im Integrationsprozess
• leeres Stocks-Feld für vollständige Bereinigung oder ausgewählte Stocks für selektive Bereinigung

Dieses Modul:

• repariert die MSI-Logik nicht
• rekonstruiert keine Reservierungshistorie
• ersetzt keine korrekt geplante ERP-Integration
• ist keine Universallösung für alle Magento-Shops

Es ist ein spezialisiertes Werkzeug für Implementierungen, in denen das ERP den tatsächlichen Lagerbestand verwaltet.

• Magento-Modul: Kowal_ReservationCleaner
• Composer-Paket: kowal/reservation-cleaner

Benötigen Sie eine Implementierung oder Anpassung an Ihre ERP-Integration, mehrere Stocks oder einen individuellen Zeitplan? Kontaktieren Sie uns über kowal.store und beschreiben Sie Ihr Bestandsynchronisationsmodell.

Full Reset und Clean After ERP Sync löschen Reservierungsdatensätze im gewählten Umfang. Bei leerer Stock-Liste wird inventory_reservation vollständig geleert; bei ausgewählten Stocks werden nur deren Datensätze entfernt.

Die Implementierung erfordert ein Modell, in dem das ERP unter Berücksichtigung des Bestellprozesses korrekte Bestände liefert. Das Löschen von Reservierungen bestätigt keine korrekte Verfügbarkeit und stellt keine MSI-Historie wieder her.

clean_after_erp_sync beschreibt den Anwendungsfall, keine automatische Integration mit dem ERP-Importabschluss. Die Ausführung nach der Synchronisation organisieren Sie per CLI oder über einen passenden Zeitplan.

Cron prüft das konfigurierte Zeitfenster und die Umgebung. Die Umgebungsbehandlung nutzt APP_ENV oder MAGENTO_ENV sowie den Magento-Modus. Eine Sperre begrenzt parallele Ausführungen.

Log Only und --dry-run=1 zählen Datensätze, ohne sie zu löschen. Prüfen Sie stock_id, Abschluss des ERP-Imports und erwartete Salable Quantity vor Aktivierung der Bereinigung.

Neuindexierung und cache clean sind optionale Schritte. Stimmen Sie inventory_only, vollständige Neuindexierung oder einen separaten Indexprozess auf Ihre tatsächliche Lagerintegration ab.

Paket kowal/reservation-cleaner, Modul Kowal_ReservationCleaner. Nachdem Sie den Zugriff auf das Kowal-Repository konfiguriert haben, installieren Sie das Paket, aktivieren das Modul, aktualisieren Magento und leeren den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte gemäß dem Bereitstellungsprozess des Shops.

1. Synchronisationsmodell festlegen
Bestätigen Sie, wann das ERP korrekte Bestände übermittelt.

2. Umfang prüfen
Stocks auswählen und Log-Only- oder Dry-Run-Ergebnis analysieren.

3. Prozess starten
Zeitplan oder CLI führt Bereinigung und optionale Neuindexierung aus.

Das ERP hat den Bestandsimport abgeschlossen. Die Integration startet den CLI-Prozess für den festgelegten Stock-Umfang und protokolliert das Ergebnis.

clean_after_erp_sync erkennt den Importabschluss nicht selbst. Zeitplan oder ERP-Integration stellen die Reihenfolge sicher.