Kowal Shipping Rules - Magento 2 Erweiterung für Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren.
Versand in einem Onlineshop ist selten einfach. Standardmäßige Magento-Einstellungen funktionieren bei einfachen Szenarien, werden aber schnell unzureichend, wenn ein Shop Produkte mit unterschiedlichen Abmessungen, Gewichten, Transportanforderungen oder Bearbeitungskosten verkauft. In der Praxis bedeutet das, bestimmte Liefermethoden auszublenden, Verpackungsgebühren hinzuzufügen, Ausnahmen für konkrete Produkte anzuwenden und Regeln abhängig von Land, Warenkorbwert oder Produktattributen zu erstellen.
Kowal ShippingRules wurde entwickelt, um solche Regeln in einem einzigen Modul zu verwalten. Die Erweiterung vereint drei Bereiche, die oft auf mehrere separate Add-ons verteilt sind: Versandmethoden, Beschränkungen von Liefermethoden und Extra Fee. Dadurch kann der Shop die Versandlogik strukturierter und vorhersehbarer verwalten.
Das Modul ermöglicht es, eigene Versandmethoden in Magento 2 zu erstellen, ihnen Preise zuzuweisen, festzulegen, wann eine Methode sichtbar sein soll, nicht verfügbare Lieferoptionen zu blockieren und zusätzliche Gebühren nur dann zu berechnen, wenn sie durch die Bestellbedingungen gerechtfertigt sind. Die Regeln können auf Warenkorbdaten, Lieferadresse, gewählter Versandmethode und Produktattributen basieren.
Der größte Wert des Moduls ist die Kontrolle. Der Shop-Administrator kann Regeln definieren, die verfügbare Liefermethoden und Gebühren automatisch an eine konkrete Bestellung anpassen. Der Kunde sieht passendere Lieferoptionen, und das Shop-Team reduziert die Anzahl manueller Korrekturen nach der Bestellung.
Das Problem, das das Modul löst
In vielen Magento 2 Shops hängen Kosten und Verfügbarkeit der Lieferung von mehr Faktoren ab als nur vom Warenkorbwert. Produkte können sich in Gewicht, Größe, Verpackungsart, Kategorie, Transporttyp oder Beschädigungsrisiko unterscheiden. Zusätzlich kann der Shop unterschiedliche Regeln für bestimmte Länder, Regionen, Postleitzahlen, Kundengruppen oder Versandmethoden haben.
Ohne dedizierte Regeln treten typische Probleme auf:
- der Kunde wählt eine Paketstation für ein Produkt, das dort nicht hineinpasst,
- der Shop zahlt bei schweren oder sperrigen Produkten beim Versand drauf,
- das Team muss den Kunden nach der Bestellung kontaktieren,
- ein Teil der Regeln wird manuell außerhalb von Magento gepflegt,
- Logistikgebühren sind vor dem Kauf nicht im Warenkorb sichtbar,
- Versandmethoden sind sichtbar, obwohl sie nicht verfügbar sein sollten,
- Lieferregeln sind auf mehrere Module verteilt und schwer zu pflegen.
Kowal ShippingRules ordnet diese Situationen. Das Modul ermöglicht es, Logistikregeln in das Magento-Panel zu verlagern und sie bei der Versandauswahl automatisch anzuwenden.
Was zeichnet Kowal ShippingRules aus?
Ein Modul statt mehrerer separater Erweiterungen
Kowal ShippingRules kombiniert die Verwaltung von Versandmethoden, Beschränkungen und zusätzlichen Gebühren. Dadurch muss der Shop kein separates Modul für Staffeltabellen, kein separates Modul zum Blockieren von Liefermethoden und kein weiteres Modul für Extra Fee pflegen.
Regeln auf Basis von Bestelldaten
Entscheidungen können vom Warenkorbinhalt, Produktattributen, Bestellwert, Gewicht, Produktanzahl, Lieferort und der gewählten Versandmethode abhängen. So lassen sich reale Logistikszenarien abbilden und nicht nur einfache Preise nach Land oder Gewicht.
Mehr Transparenz für den Kunden
Der Kunde sieht Versandmethoden, die zur Bestellung passen. Wenn eine Methode nicht verfügbar ist, kann der Shop sie ausblenden oder eine Nachricht mit dem Grund der Nichtverfügbarkeit anzeigen. Das reduziert Missverständnisse beim Abschluss des Kaufs.
Bessere Kontrolle der Betriebskosten
Zusätzliche Gebühren können nur in ausgewählten Fällen berechnet werden: für sperrige, empfindliche oder speziell zu verpackende Produkte oder für bestimmte Liefermethoden. So kann der Shop Logistikkosten zurückholen, die zuvor in der Marge verborgen waren.
Vorbereitung auf die Migration von Amasty
Das Modul wurde als unabhängige Lösung konzipiert, berücksichtigt aber das Szenario des Wechsels von Amasty-Modulen für Versand, Beschränkungen und Extra Fee. Dadurch kann es als Richtung für die Konsolidierung der Versandkonfiguration in einem Modul genutzt werden.
Für wen ist dieses Modul geeignet?
Kowal ShippingRules ist für Magento 2 Shops gedacht, die mehr Flexibilität bei der Verwaltung der Lieferung benötigen, als die Standardkonfiguration von Magento bietet.
Das Modul ist besonders nützlich für Shops, die:
- schwere, empfindliche, lange, zerbrechliche oder großformatige Produkte verkaufen,
- unterschiedliche Lieferregeln für verschiedene Produktkategorien haben,
- nicht verfügbare Versandmethoden ausblenden müssen,
- Gebühren für Verpackung, Spezialtransport oder logistische Bearbeitung berechnen,
- eigene Liefermethoden ohne wiederholten Entwicklungsaufwand erstellen möchten,
- Regeln verwenden, die von Produktattributen abhängen,
- die manuelle Bearbeitung von Ausnahmen nach der Bestellung reduzieren möchten,
- mehrere für den Versand zuständige Module ordnen oder ersetzen möchten.
Die wichtigsten Funktionen
Eigene Versandmethoden erstellen
Das Modul ermöglicht die Erstellung von Versandmethoden, die direkt im Magento-Panel verwaltet werden. Jede Methode kann einen eigenen Namen, Code, eine Beschreibung, Sortierung, Aktivitätsstatus und Verfügbarkeitsbedingungen haben.
Beispiele:
- Palettenversand für schwere Produkte,
- Spezialtransport für Produkte mit besonderem Sicherungsbedarf,
- Kurier für Sperrgut für ausgewählte Kategorien,
- Lokale Lieferung für ausgewählte Postleitzahlen,
- Logistikabholung für individuelle Bestellungen.
Versandpreise abhängig von Bedingungen
Den Methoden können Preise zugewiesen werden, die von Bestellparametern abhängen. Die Preise können unter anderem nach Land, Region, Postleitzahl, Zwischensumme, Gewicht, Produktanzahl und Versandtyp gefiltert werden.
Beispiele:
- ein anderer Lieferpreis für Bestellungen über einem bestimmten Gewicht,
- ein separater Preis für ausgewählte Länder,
- ein vom Warenkorbwert abhängiger Preis,
- unterschiedliche Preise für Standard- und Sperrgutprodukte,
- Priorität von Preisen, wenn mehrere Regeln gleichzeitig passen.
Beschränkungen von Liefermethoden
Kowal ShippingRules ermöglicht es, die Verfügbarkeit von Versandmethoden einzuschränken. Eine Regel kann eine Methode ausblenden oder dem Kunden eine Meldung anzeigen, dass diese Lieferform für diese Bestellung nicht verfügbar ist.
Beispiele:
- Ausblenden der Paketstation für zu große Produkte,
- Blockieren des Auslandsversands für ausgewählte Produkte,
- Ausblenden einer Expressmethode für Bestellungen mit Produkten, die kommissioniert werden müssen,
- Anzeigen der Meldung: Diese Liefermethode ist für Sperrgutprodukte nicht verfügbar.
Extra Fee, also zusätzliche Gebühren
Das Modul ermöglicht die Berechnung zusätzlicher Gebühren auf Basis von Regeln. Extra Fee kann für den gesamten Warenkorb, für jede Stückzahl eines Produkts oder für Produkte berechnet werden, die bestimmte Bedingungen erfüllen.
Beispiele:
- Gebühr für Sonderverpackung,
- Gebühr für Sperrguttransport,
- Aufpreis für Produkte, die zusätzlichen Schutz erfordern,
- Logistikgebühr für eine bestimmte Liefermethode,
- Aufpreis für Bestellungen in ausgewählte Regionen.
Bedingungen ähnlich den Magento-Regeln
Kowal ShippingRules verwendet den aus Magento bekannten Bedingungsgenerator. Für Shop-Mitarbeiter bedeutet das eine Arbeitsweise, die der Konfiguration von Warenkorbpreisregeln ähnelt: Bedingung, Operator und Wert auswählen.
Die Bedingungen können sich beziehen auf:
- SKU,
- Produktkategorie,
- Produkttyp,
- Gewicht,
- Preis,
- ausgewählte Produktattribute,
- Warenkorbwert,
- Produktanzahl,
- Lieferland,
- Region,
- Stadt,
- Postleitzahl,
- Couponcode,
- gewählte Versandmethode.
Geschäftliche Vorteile
Weniger Verluste beim Versand
Nicht alle Bestellungen verursachen die gleichen Logistikkosten. Sperrige, empfindliche oder speziell zu verpackende Produkte erzeugen oft zusätzliche Kosten. Kowal ShippingRules ermöglicht es, diese Kosten kontrolliert zu berechnen, statt sie in der Marge zu verstecken oder nach der Bestellung manuell zu bearbeiten.
Weniger fehlerhafte Bestellungen
Wenn der Kunde eine Liefermethode wählt, die nicht zum Produkt passt, muss der Shop das Problem später manuell lösen. Das Modul begrenzt solche Situationen, weil es nicht verfügbare Methoden schon vor der Bestellung ausblenden kann.
Bessere Kommunikation mit dem Kunden
Statt eine Methode ohne Erklärung zu entfernen, kann der Shop dem Kunden eine Nachricht anzeigen. Das ist besonders nützlich, wenn die Einschränkung aus Produkteigenschaften, dem Standort oder Transportanforderungen resultiert.
Schnellere Auftragsabwicklung
Automatische Regeln reduzieren die Anzahl der Ausnahmen, die vom Vertrieb oder der Logistik bearbeitet werden müssen. Wenn der Shop die Lieferregeln bereits im Warenkorb klar definiert, müssen nach dem Kauf weniger Fälle korrigiert werden.
Ein Ort für die Versandverwaltung
Methoden, Beschränkungen und zusätzliche Gebühren sind miteinander verknüpft. Ihre Pflege in einem einzigen Modul reduziert das Risiko von Konflikten und erleichtert die Kontrolle der Konfiguration.
Beispielhafte Einsatzszenarien
Shop mit großformatigen Produkten
Der Shop verkauft Produkte, die nicht mit einem Standardkurier oder an eine Paketstation versendet werden können. Der Administrator kann solche Produkte mit einem Attribut kennzeichnen und dann eine Regel erstellen, die die Paketstation ausblendet, Palettenversand anzeigt und eine Sperrgutgebühr hinzufügt.
Ergebnis: Der Kunde sieht sofort die richtige Liefermethode, und der Shop muss ihn nach dem Kauf nicht wegen eines Aufpreises kontaktieren.
Shop mit empfindlichen Produkten
Produkte, die zusätzlichen Schutz benötigen, können Verpackungskosten verursachen. Das Modul ermöglicht es, eine Gebühr nur dann zu berechnen, wenn sich ein Produkt im Warenkorb befindet, das die Bedingung erfüllt.
Ergebnis: Der Shop deckt die Verpackungskosten, und der Kunde kennt den vollständigen Preis vor der Bestellung.
Shop mit lokaler Lieferung
Der Shop kann die Methode Lokale Lieferung nur für ausgewählte Postleitzahlen oder Regionen bereitstellen. Für andere Standorte ist die Methode nicht sichtbar.
Ergebnis: Der Kunde wählt keine Lieferung, die der Shop nicht ausführen kann.
B2B-Shop
Im B2B-Vertrieb können Versandkosten von Kundengruppen, Bestellwert, Region oder Produkttyp abhängen. Das Modul ermöglicht die Erstellung von Regeln, die besser zur Handelspolitik des Shops passen.
Ergebnis: Der Shop kann unterschiedliche Regeln für verschiedene Kundentypen anwenden, ohne mehrere separate Prozesse zu pflegen.
Shop mit internationaler Lieferung
Ausgewählte Produkte sind möglicherweise nicht für den Auslandsversand verfügbar. Das Modul ermöglicht es, Liefermethoden für bestimmte Länder oder Produktbedingungen einzuschränken.
Ergebnis: Der Shop reduziert das Risiko von Bestellungen, die er gemäß den Bedingungen oder den Einschränkungen des Versanddienstleisters nicht erfüllen kann.
Aufpreis für eine bestimmte Versandmethode
Wenn die gewählte Liefermethode zusätzliche Bearbeitungskosten verursacht, kann eine Extra Fee damit verknüpft werden.
Ergebnis: Die Gebühr erscheint nur dann, wenn der Kunde eine bestimmte Versandmethode auswählt.
Beispiele für konfigurierbare Regeln
- Wenn das Produkt das Attribut
gabarythat, Paketstation ausblenden. - Wenn das Gewicht des Warenkorbs das festgelegte Limit überschreitet, Palettenversand anzeigen.
- Wenn das Lieferland außerhalb von Polen liegt, ausgewählte Methoden ausblenden.
- Wenn sich im Warenkorb ein Produkt aus der Kategorie empfindlich befindet, Verpackungsgebühr berechnen.
- Wenn der Warenkorbwert unter einem festgelegten Betrag liegt, zusätzliche Logistikgebühr berechnen.
- Wenn der Kunde Spezialtransport wählt, Extra Fee berechnen.
- Wenn die Postleitzahl nicht zum bedienten Gebiet gehört, lokale Lieferung ausblenden.
- Wenn die Bestellung ein Produkt eines bestimmten Typs enthält, nur ausgewählte Liefermethoden anzeigen.
Wie sieht die Arbeit mit dem Modul aus?
Der Shop-Administrator arbeitet im Magento-Panel. Zuerst erstellt er eine Versandmethode, danach weist er ihr Preise und Bedingungen zu. Wenn Einschränkungen erforderlich sind, kann er eine Beschränkung für eine konkrete Methode oder eine Gruppe von Methoden hinzufügen. Wenn die Bestellung eine zusätzliche Gebühr enthalten soll, erstellt der Administrator eine Extra-Fee-Regel.
Beispielhafter Prozess:
- Erstellen Sie die Methode Palettenversand.
- Fügen Sie einen Preis für das Land Polen und ein Gewicht oberhalb eines bestimmten Limits hinzu.
- Fügen Sie die Bedingung hinzu, dass die Methode für Produkte mit dem Attribut
shipping_type = palletgilt. - Fügen Sie eine Beschränkung hinzu, die die Paketstation für dieselben Produkte ausblendet.
- Fügen Sie eine Extra Fee für die Abwicklung von Spezialtransport hinzu.
- Prüfen Sie einen Testwarenkorb und bestätigen Sie, dass der Kunde die richtigen Optionen sieht.
Vergleich des Ansatzes
Standardkonfiguration von Magento
Standard-Magento ermöglicht die Konfiguration grundlegender Liefermethoden, aber komplexere Szenarien erfordern zusätzliche Erweiterungen oder individuelle Anpassungen.
Mehrere separate Module
Der Shop kann ein separates Modul für Preise, ein separates für Beschränkungen und ein separates für Gebühren verwenden. Das Problem ist dann die Aufrechterhaltung der Konsistenz zwischen den Konfigurationen.
Kowal ShippingRules
Kowal ShippingRules bündelt Methoden, Beschränkungen und Extra Fee in einem Modul. Dadurch sind Lieferregeln leichter zu verstehen, zu pflegen und zu testen.
Elemente mit Einfluss auf das SEO des Shops
Das Modul ist kein direktes SEO-Tool, kann aber indirekt das Einkaufserlebnis unterstützen, das für Conversion und Shop-Qualität wichtig ist:
- der Kunde sieht reale Versandkosten schneller,
- der checkout ist vorhersehbarer,
- weniger Bestellungen müssen nach dem Kauf korrigiert werden,
- der Shop kann logistische Einschränkungen klar kommunizieren,
- Lieferregeln sind konsistenter mit dem Produktangebot.
Eine bessere Versandabwicklung kann die Zahl abgebrochener Warenkörbe aufgrund unklarer Kosten oder nicht verfügbarer Versandmethoden verringern.
Kowal ShippingRules — Installations-, Konfigurations- und Bedienungsanleitung
Ziel des Dokuments
Dieses Dokument beschreibt die praktische Implementierung und Bedienung des Moduls Kowal_ShippingRules in Magento 2. Es richtet sich an Personen, die für die Modulinstallation, die Shop-Konfiguration, Implementierungstests und die tägliche Verwaltung der Versandregeln verantwortlich sind.
Das Dokument umfasst:
- die Installation des Moduls,
- die Grundkonfiguration,
- das Erstellen von Versandmethoden,
- die Konfiguration von Preisen,
- die Verwaltung von Beschränkungen für Liefermethoden,
- die Verwaltung zusätzlicher Gebühren Extra Fee,
- Diagnostik,
- die Migration von Amasty-Modulen,
- eine Checkliste für Tests nach der Implementierung.
Grundlegende Informationen
Technischer Name des Moduls:
Kowal_ShippingRulesModulpfad:
app/code/Kowal/ShippingRulesCarrier-Code:
kowal_shippingrulesDer Code der Versandmethode im checkout hat das Format:
kowal_shippingrules_Beispiel:
kowal_shippingrules_dostawa_paletowaAnforderungen vor der Installation
Vor der Installation sollte bestätigt werden:
- der Shop läuft auf Magento 2.4.x,
- die Umgebung verwendet PHP
>=8.1, - das Modul
Kowal_Baseist verfügbar, - es wurde ein Backup der Dateien und der Datenbank erstellt,
- die Implementierung wird zuerst auf einer Test- oder Staging-Umgebung durchgeführt,
- nach der Installation ist es möglich,
setup:upgradeundsetup:di:compileauszuführen, - die testende Person hat Zugriff auf das Admin-Panel und den checkout.
Installation des Moduls
1. Laden Sie das Modul hoch
Das Modul sollte sich im Verzeichnis befinden:
app/code/Kowal/ShippingRules2. Aktivieren Sie das Modul
bin/magento module:enable Kowal_ShippingRulesWenn Kowal_Base noch nicht aktiviert ist, sollte es vorher oder zusammen mit dem Modul aktiviert werden:
bin/magento module:enable Kowal_Base Kowal_ShippingRules3. Aktualisieren Sie die Datenbank
bin/magento setup:upgradeDieser Befehl erstellt die Modultabellen und fügt Spalten hinzu, die für die Verwaltung von Extra Fee in quote, order, invoice und creditmemo erforderlich sind.
4. Kompilieren Sie DI
In der Produktion:
bin/magento setup:di:compile5. Leeren Sie den Cache
bin/magento cache:flush6. Prüfen Sie den Modulstatus
bin/magento module:status Kowal_ShippingRulesDas Modul sollte in der Liste der aktiven Module erscheinen.
Kontrolle nach der Installation
Führen Sie nach der Installation die Diagnostik aus:
bin/magento kowal:shippingrules:stabilization:checkVollständige Variante in JSON:
bin/magento kowal:shippingrules:stabilization:check --jsonDer Befehl ist read-only und ändert keine Daten. Er prüft unter anderem:
- das Vorhandensein der Modultabellen,
- die Anzahl der Datensätze,
- fehlerhaftes JSON der Bedingungen,
- aktive Methoden ohne aktive Preise,
- Extra-Fee-Regeln mit tax class bei deaktiviertem Steuermodus.
Wenn der Befehl Fehler zurückgibt, sollte das Modul nicht in den produktiven Einsatz übernommen werden, bevor diese geklärt sind.
Grundkonfiguration
Carrier
Pfad im Magento-Panel:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & RulesFelder:
Enabled— aktiviert oder deaktiviert den Carrierkowal_shippingrules.Title— Name der Methodengruppe, sichtbar im checkout.Test Method Name— Name der Test-Konfigurationsmethode.Test Method Price— Preis der Test-Konfigurationsmethode.Sort Order— Reihenfolge des Carriers in der Liste der Liefermethoden.Show Method If Not Applicable— ob ein Fehler angezeigt werden soll, wenn keine Methoden verfügbar sind.Displayed Error Message— Meldung, wenn die Methode nicht verfügbar ist.
Wichtigste Einstellung:
carriers/kowal_shippingrules/active = 1Wenn der Carrier deaktiviert ist, sind im Modul erstellte Methoden im checkout nicht verfügbar.
Diagnostik und Notfallfunktionen
Pfad im Magento-Panel:
Stores / Configuration / Sales / Shipping Methods & RulesAbschnitt General Diagnostics:
Enable Debug Logging— speichert Details der Entscheidungen im Log.Shadow Mode— ein Modus zum Vergleich des Verhaltens während der Migration.
Abschnitt Restrictions:
Enable Restrictions— aktiviert oder deaktiviert nur die Beschränkungen.
Abschnitt Extra Fees:
Enable Extra Fees— aktiviert oder deaktiviert nur die zusätzlichen Gebühren.Fee Tax Mode— bestimmt die Art der Steuerbehandlung für Extra Fee.
Verfügbare Steuermodi:
Do Not Calculate Tax— das Modul berechnet keine Steuer auf Extra Fee.Calculate by Fee Tax Class— das Modul berechnet die Steuer gemäß der in der Fee-Regel festgelegten Steuerklasse.
Standardmäßige, sichere Einstellungen:
kowal_shippingrules/general/debug = 0kowal_shippingrules/general/shadow_mode = 0kowal_shippingrules/restrictions/enabled = 1kowal_shippingrules/fees/enabled = 1kowal_shippingrules/fees/tax_mode = noneModulmenü im Panel
Pfad:
Sales / Shipping Methods & RulesVerfügbare Bereiche:
Shipping Methods— Versandmethoden und Preise,Shipping Restrictions— Beschränkungen von Liefermethoden,Extra Fees— zusätzliche Gebühren.
Verwaltung von Versandmethoden
Wann sollte eine Versandmethode erstellt werden?
Eine Versandmethode sollte erstellt werden, wenn der Shop eine eigene Lieferoption benötigt, z. B.:
- Palettenversand,
- Spezialtransport,
- lokale Lieferung,
- Kurier für Sperrgutprodukte,
- Logistikabholung,
- eine Methode, die nur für ausgewählte Produkte oder Regionen verfügbar ist.
Erstellen einer Methode
Gehen Sie zu:
Sales / Shipping Methods & Rules / Shipping MethodsWählen Sie dann Add New oder bearbeiten Sie eine vorhandene Methode.
Typische Felder einer Methode:
Is Active— ob die Methode aktiv ist.Code— technischer Code der Methode.Name— für den Kunden sichtbarer Name.Description— Beschreibung der Methode.Sort Order— Reihenfolge der Anzeige.Store Views— Sichtbarkeit für die store view.Customer Groups— Sichtbarkeit für Kundengruppen.Conditions— Verfügbarkeitsbedingungen der Methode.
Empfehlungen für das Feld Code:
- verwenden Sie Kleinbuchstaben,
- verwenden Sie keine polnischen Zeichen,
- verwenden Sie keine Leerzeichen,
- verwenden Sie Unterstriche statt Leerzeichen.
Beispiele:
dostawa_paletowatransport_specjalnykurier_gabarytdostawa_lokalnaDer vollständige Methodencode im checkout hat das Präfix des Carriers:
kowal_shippingrules_dostawa_paletowaPreise der Methode
Eine aktive Methode sollte mindestens einen aktiven Preis haben. Wenn eine Methode keinen passenden Preis hat, erscheint sie nicht im checkout.
Ein Preis kann abhängen von:
- Land,
- Region,
- Postleitzahl,
- Warenkorbwert,
- Gewicht,
- Produktanzahl,
- Versandtyp,
- Priorität.
Preismodi:
fixed— fester Preis,percent_subtotal— Prozentsatz der Zwischensumme.
Beispiele:
- Preis 29 zł für Sendungen bis 30 kg,
- Preis 149 zł für Palettenversand,
- 5% des Warenkorbwerts für Spezialtransport,
- separater Preis für ausgewählte Postleitzahlen.
Bedingungen der Methode
Die Bedingungen legen fest, wann die Methode verfügbar sein soll.
Beispiele:
- Methode nur für Produkte aus einer ausgewählten Kategorie verfügbar,
- Methode nur bei einem bestimmten Produktattribut verfügbar,
- Methode nur für einen Warenkorb über einem bestimmten Wert verfügbar,
- Methode nur für ein ausgewähltes Lieferland verfügbar.
Wenn die Bedingungen leer sind, wird die Methode nur durch Status, store view, customer group und den passenden Preis eingeschränkt.
Verwaltung von Beschränkungen für Liefermethoden
Wann sollten Beschränkungen verwendet werden?
Beschränkungen dienen zum Ausblenden oder Blockieren von Versandmethoden, die für eine bestimmte Bestellung nicht verfügbar sein sollten.
Beispiele:
- Paketstation für Sperrgutprodukte ausblenden,
- Auslandsversand für eine ausgewählte Kategorie blockieren,
- eine Meldung anzeigen, dass Expressversand für Auftragsprodukte nicht verfügbar ist,
- eine Liefermethode für ein ausgewähltes Land ausblenden.
Erstellen einer Beschränkung
Gehen Sie zu:
Sales / Shipping Methods & Rules / Shipping RestrictionsWählen Sie dann Add New oder bearbeiten Sie eine vorhandene Beschränkung.
Typische Felder:
Is Active— ob die Beschränkung aktiv ist.Name— interner Name.Target Carrier— Carrier, auf den sich die Beschränkung bezieht.Target Method— Methode, auf die sich die Beschränkung bezieht.Action— Funktionsweise.Message— Meldung für den Kunden.Priority— Priorität.Stop Processing— ob die weitere Prüfung von Regeln gestoppt werden soll.Store Views— Bereich der store view.Customer Groups— Bereich der Kundengruppen.Conditions— Bedingungen für die Zuordnung.
Aktionen von Beschränkungen
hide:
- die Methode wird ausgeblendet,
- der Kunde sieht sie nicht,
- gut für offensichtliche Einschränkungen, z. B. Paketstation für Sperrgut.
error:
- die Methode wird als nicht verfügbar angezeigt,
- der Kunde sieht eine Meldung,
- gut, wenn der Grund der Nichtverfügbarkeit erklärt werden sollte.
Priorität und Stop Processing
Regeln werden nach Priorität geprüft. Eine höhere Priorität bedeutet eine frühere Prüfung.
Stop Processing = Yes bedeutet, dass das Modul nach Zuordnung dieser Beschränkung keine weiteren Beschränkungen für diese Methode prüft.
Empfehlung:
- verwenden Sie höhere Prioritäten für detailliertere Regeln,
- verwenden Sie niedrigere Prioritäten für allgemeine Regeln,
- aktivieren Sie
Stop Processing, wenn die Regel die Verfügbarkeit der Methode endgültig bestimmen soll.
Verwaltung von Extra Fee
Wann sollte Extra Fee verwendet werden?
Extra Fee dient dazu, zusätzliche Gebühren zur Bestellung hinzuzufügen.
Beispiele:
- Gebühr für Sonderverpackung,
- Aufpreis für Sperrguttransport,
- Gebühr für empfindliche Produkte,
- Logistikgebühr für eine bestimmte Liefermethode,
- Aufpreis für ausgewählte Regionen.
Erstellen von Extra Fee
Gehen Sie zu:
Sales / Shipping Methods & Rules / Extra FeesWählen Sie dann Add New oder bearbeiten Sie eine vorhandene Gebühr.
Typische Felder:
Is Active— ob die fee aktiv ist.Name— interner Name.Label— Name der Gebühr, sichtbar in totals.Target Carrier— Carrier, auf den sich die fee bezieht.Target Method— Methode, auf die sich die fee bezieht.Price Type— Typ des Preises.Price— Wert der Gebühr.Apply Mode— Art der Berechnung.Tax Class ID— Steuerklasse, wenn der tax mode verwendet wird.Priority— Priorität.Stop Processing— ob die weitere Berechnung von fee gestoppt werden soll.Store Views— Bereich der store view.Customer Groups— Bereich der Kundengruppen.Conditions— Bedingungen für die Berechnung.
Preismodi
fixed:
- fester Betrag,
- z. B. 19 zł für Verpackung.
percent_subtotal:
- Prozentsatz des Warenkorbwerts,
- z. B. 3% des Bestellwerts.
Berechnungsmodi
cart:
- eine Gebühr für den gesamten Warenkorb.
per_item:
- Gebühr multipliziert mit der Produktanzahl.
per_matching_item:
- Gebühr wird nur für Produkte berechnet, die die Bedingungen erfüllen.
Beispiel:
Wenn die Gebühr für eine spezielle Sicherung 5 zł beträgt und sich 3 Produkte im Warenkorb befinden, die die Bedingung erfüllen, berechnet der Modus per_matching_item 15 zł.
Steuer auf Extra Fee
Standardmäßig wird auf Extra Fee keine Steuer berechnet:
kowal_shippingrules/fees/tax_mode = noneUm Steuer zu berechnen:
- Setzen Sie
Fee Tax ModeaufCalculate by Fee Tax Class. - Füllen Sie
Tax Class IDin der Extra-Fee-Regel aus. - Testen Sie Warenkorb, order, invoice und creditmemo.
Die Steuer auf Extra Fee sollte jedes Mal mit der Steuerkonfiguration des konkreten Shops überprüft werden.
Verwaltung von Bedingungen
Das Modul verwendet einen Bedingungsgenerator ähnlich den Magento-Regeln.
Die Bedingungen können sich unter anderem beziehen auf:
- Produktattribute,
- SKU,
- Kategorie,
- Produkttyp,
- Gewicht,
- Preis,
- Warenkorbwert,
- Produktanzahl,
- Lieferland,
- Region,
- Stadt,
- Postleitzahl,
- Coupon,
- gewählte Versandmethode.
Beispiel einer Bedingung für ein Sperrgutprodukt
Annahme:
- das Produkt hat das Attribut
shipping_type, - der Wert für Sperrgut ist
pallet.
Regel:
Jeżeli produkt w koszyku ma shipping_type = palletMögliche Aktionen:
- Methode
Dostawa paletowaanzeigen, - Paketstation ausblenden,
- fee
Transport gabarytowyhinzufügen.
Empfehlungen bei der Arbeit mit Bedingungen
- Erstellen Sie zuerst eine einfache Regel und testen Sie sie im Warenkorb,
- vermeiden Sie zu viele Bedingungen in einer Regel,
- benennen Sie Regeln mit verständlichen Namen,
- verwenden Sie für wichtige Regeln eindeutige Produktattribute,
- testen Sie den Warenkorb nach Änderungen an Produktattributen erneut.
Diagnostik und Logging
Dedizierte Logdatei:
var/log/kowal_shipping_rules.logDebug kann hier aktiviert werden:
Stores / Configuration / Sales / Shipping Methods & Rules / General DiagnosticsAktivieren Sie:
Enable Debug Logging = YesEmpfehlungen:
- lassen Sie Debug Logging in der Produktion nicht dauerhaft aktiviert,
- aktivieren Sie Debug nur für die Dauer der Diagnose,
- deaktivieren Sie Debug nach Abschluss der Tests,
- analysieren Sie die Logs zusammen mit dem Testwarenkorb und der Regelkonfiguration.
Notfallfunktionen
Wenn nach der Implementierung ein Problem auftritt, kann unabhängig deaktiviert werden:
Der gesamte Carrier
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = NoErgebnis:
- Methoden des Carriers
kowal_shippingrulessind nicht verfügbar.
Nur Beschränkungen
Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = NoErgebnis:
- Methoden werden durch Beschränkungen nicht ausgeblendet oder blockiert.
Nur Extra Fee
Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = NoErgebnis:
- zusätzliche Gebühren werden nicht berechnet.
Migration von Amasty
Ziel der Migration
Die Migration von Amasty soll dabei helfen, die Konfiguration von Beschränkungen und Extra Fee nach Kowal_ShippingRules zu übertragen.
Das Kowal-Modul benötigt Amasty für den normalen Betrieb nicht. Amasty kann als Quelle für Migrationsdaten und als Referenzpunkt während der Tests verwendet werden.
Unterstützte Datenquellen
Der Migrator analysiert:
amasty_shiprestriction_ruleamasty_extrafeeamasty_extrafee_optionZieltabellen:
kowal_shipping_restrictionkowal_shipping_feeSicherheitsregeln der Migration
Die Migration wurde vorsichtig konzipiert:
- der Bericht ist read-only,
- dry-run speichert keine Daten,
- apply arbeitet standardmäßig als preview,
- das Speichern erfordert die ausdrückliche Option
--execute, - es werden nur Datensätze mit dem Status
readygespeichert, - Datensätze
manual_reviewundunsupportedwerden übersprungen, - die Migration ist dank der Felder
migration_sourceundmigration_source_keyidempotent, - die Migration deaktiviert Amasty nicht,
- die Migration schaltet den Traffic nicht automatisch um.
Schritt 1 — Basisbericht
Ausführen:
bin/magento kowal:shippingrules:amasty:reportDer Bericht wird gespeichert unter:
var/report/kowal_shippingrules_amasty_report.jsonDer Bericht zeigt das Vorhandensein und die Anzahl der Amasty- und Kowal-Tabellen.
Schritt 2 — dry-run der Transformation
Ausführen:
bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100Dry-run erstellt einen Transformationsplan, speichert aber nichts.
Status der Datensätze:
ready— der Datensatz kann automatisch übertragen werden,manual_review— der Datensatz erfordert eine manuelle Analyse,unsupported— der Datensatz wird vom automatischen Migrator nicht unterstützt.
Wenn der Bericht viele manual_review oder unsupported enthält, sollten diese Regeln vor apply analysiert werden.
Schritt 3 — preview apply
Ausführen:
bin/magento kowal:shippingrules:amasty:apply --limit=100Auch dies speichert noch keine Daten. Der Befehl zeigt, wie viele Datensätze erstellt, übersprungen oder mit Fehlern beendet würden.
Schritt 4 — apply der Beschränkungen
Nach Freigabe des preview:
bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --executeDer Befehl speichert nur Beschränkungen mit dem Status ready.
Schritt 5 — apply von Extra Fee
Nach Freigabe des preview:
bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --executeDer Befehl speichert nur extra fees mit dem Status ready.
Schritt 6 — Diagnostik nach der Migration
Ausführen:
bin/magento kowal:shippingrules:stabilization:checkPrüfen Sie außerdem das Panel:
Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra FeesSchritt 7 — Vergleichstests mit Amasty
Bevor die Amasty-Konfiguration deaktiviert oder ersetzt wird, sollten die Ergebnisse für Testwarenkörbe verglichen werden.
Empfohlene Warenkörbe:
- Standardprodukt,
- Sperrgutprodukt,
- empfindliches Produkt,
- mehrere Produkte mit unterschiedlichen Bedingungen,
- Bestellung mit verschiedenen Lieferländern,
- Bestellung mit verschiedenen Postleitzahlen,
- Bestellung mit Coupon,
- Bestellung mit ausgewählter, von Extra Fee betroffener Methode.
Prüfen Sie für jeden Warenkorb:
- verfügbare Liefermethoden,
- ausgeblendete Methoden,
- Fehlermeldungen,
- berechnete extra fee,
- Brutto-/Nettobeträge, wenn tax fee verwendet wird,
- order,
- invoice,
- creditmemo.
Schritt 8 — Entscheidung über die Umschaltung
Erst nach Freigabe der Ergebnisse kann die Umschaltung der produktiven Konfiguration geplant werden.
Empfehlungen:
- deaktivieren Sie Amasty nicht ohne Backup,
- löschen Sie Amasty-Daten nicht direkt nach der Migration,
- deaktivieren Sie zuerst die Funktion auf Konfigurationsebene,
- bewahren Sie die Möglichkeit eines Rollbacks,
- erstellen Sie eine Liste von Regeln, die manuelle Korrekturen erfordern.
Rollback nach der Migration
Wenn ein Problem auftritt:
- Deaktivieren Sie den Carrier
Kowal ShippingRules. - Deaktivieren Sie
Enable Restrictions. - Deaktivieren Sie
Enable Extra Fees. - Stellen Sie die bisherige Amasty-Konfiguration wieder her.
- Prüfen Sie den checkout.
- Bewahren Sie die Migrationsberichte für die Analyse auf.
Checkliste nach der Implementierung
Technisch
module:statuszeigtKowal_ShippingRulesals aktiv an,setup:upgradewurde ohne Fehler abgeschlossen,setup:di:compilewurde ohne Fehler abgeschlossen,cache:flushwurde ausgeführt,stabilization:checkgibt keine Fehler zurück,- das Admin-Panel zeigt das Menü
Shipping Methods & Rules, - die Logdatei wird bei aktiviertem Debug beschrieben.
Konfiguration
- der Carrier ist aktiviert,
- mindestens eine Versandmethode wurde erstellt,
- eine aktive Methode hat einen aktiven Preis,
- store views sind korrekt eingestellt,
- customer groups sind korrekt eingestellt,
- Beschränkungen sind aktiviert oder bewusst deaktiviert,
- extra fees sind aktiviert oder bewusst deaktiviert,
- tax mode entspricht der Steuerkonfiguration des Shops.
Checkout
- die Methode erscheint für einen Warenkorb, der die Bedingungen erfüllt,
- die Methode erscheint nicht, wenn kein passender Preis vorhanden ist,
- die Beschränkung
hideblendet die Methode aus, - die Beschränkung
errorzeigt eine Meldung an, - extra fee erscheint in totals nach der Methodenauswahl,
- eine Änderung der Versandmethode berechnet die fee neu,
- order enthält fee-Beträge,
- invoice enthält fee-Beträge,
- creditmemo erstattet fee korrekt.
Häufigste Probleme
Die Methode erscheint nicht im checkout
Prüfen Sie:
- ob der Carrier aktiviert ist,
- ob die Methode aktiv ist,
- ob die Methode einen aktiven Preis hat,
- ob der Preis zu Land, Region, Postleitzahl, Gewicht und Zwischensumme passt,
- ob die store view korrekt ist,
- ob die customer group korrekt ist,
- ob die Bedingungen der Methode erfüllt sind,
- ob eine Beschränkung die Methode nicht ausblendet.
Extra Fee wird nicht berechnet
Prüfen Sie:
- ob
Enable Extra Fees = Yes, - ob die fee aktiv ist,
- ob target carrier und target method korrekt sind,
- ob die Bedingungen der fee erfüllt sind,
- ob eine Versandmethode ausgewählt wurde,
- ob der Preis der fee größer als null ist,
- ob
Stop Processingeiner früheren Regel die weitere Berechnung nicht gestoppt hat.
Die Beschränkung funktioniert nicht
Prüfen Sie:
- ob
Enable Restrictions = Yes, - ob die Beschränkung aktiv ist,
- ob target carrier und target method korrekt sind,
- ob die Bedingungen der Beschränkung erfüllt sind,
- ob die Regelpriorität korrekt ist,
- ob eine andere Regel mit
Stop Processingdie Verarbeitung nicht früher beendet.
Steuer auf Extra Fee wird nicht berechnet
Prüfen Sie:
- ob
Fee Tax Mode = Calculate by Fee Tax Class, - ob die fee-Regel eine gesetzte
Tax Class IDhat, - ob die Magento-Steuerkonfiguration einen Steuersatz für die Adresse zurückgibt,
- ob der Warenkorb eine Lieferadresse hat,
- ob die fee tatsächlich berechnet wird.
Best Practices
- Konfigurieren Sie zuerst einfache Regeln und fügen Sie dann weitere Bedingungen hinzu.
- Erstellen Sie für jede wichtige Regel einen Testwarenkorb.
- Verwenden Sie verständliche Namen für Methoden, Beschränkungen und fee.
- Vermeiden Sie mehrere sehr ähnliche Regeln mit derselben Priorität.
- Dokumentieren Sie den Grund für die Erstellung einer Beschränkung oder fee im Namen.
- Führen Sie nach Änderungen an Produktattributen einen checkout-Test durch.
- Aktivieren Sie Debug Logging nur für die Dauer der Diagnose.
- Führen Sie die Migration von Amasty schrittweise durch: Bericht, dry-run, preview, execute, QA.
Zugehörige Dokumente
README.md— technische Modulbeschreibung für Entwickler.docs/WDROZENIE.md— detaillierte Implementierungsdokumentation und Architektur.docs/OPIS_MARKETINGOWY.md— Marketingbeschreibung des Moduls.




















