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.
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:
Kowal ShippingRules ordnet diese Situationen. Das Modul ermöglicht es, Logistikregeln in das Magento-Panel zu verlagern und sie bei der Versandauswahl automatisch anzuwenden.
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.
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.
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.
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.
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.
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:
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:
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:
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:
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:
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:
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
gabaryt hat, Paketstation ausblenden.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:
shipping_type = pallet gilt.Standard-Magento ermöglicht die Konfiguration grundlegender Liefermethoden, aber komplexere Szenarien erfordern zusätzliche Erweiterungen oder individuelle Anpassungen.
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 bündelt Methoden, Beschränkungen und Extra Fee in einem Modul. Dadurch sind Lieferregeln leichter zu verstehen, zu pflegen und zu testen.
Das Modul ist kein direktes SEO-Tool, kann aber indirekt das Einkaufserlebnis unterstützen, das für Conversion und Shop-Qualität wichtig ist:
Eine bessere Versandabwicklung kann die Zahl abgebrochener Warenkörbe aufgrund unklarer Kosten oder nicht verfügbarer Versandmethoden verringern.
| Übereinstimmung mit der Vorlage | Luma / Leer, KOWAL |
|---|
Dieses Dokument beschreibt die praktische Implementierung und Nutzung des Moduls Kowal_ShippingRules in Magento 2. Es richtet sich an Personen, die für die Installation des Moduls, die Shop-Konfiguration, Implementierungstests und die tägliche Verwaltung von Versandregeln verantwortlich sind.
Das Dokument umfasst:
Technischer Name des Moduls:
Kowal_ShippingRulesSpeicherort des Moduls:
vendor/kowal/module-shipping-rulesCarrier-Code:
kowal_shippingrulesDer Code der Versandmethode im Checkout hat folgendes Format:
kowal_shippingrules_Beispiel:
kowal_shippingrules_dostawa_paletowaVor der Installation ist zu bestätigen:
>=8.1,Kowal_Base ist verfügbar,setup:upgrade und setup:di:compile ausgeführt werden,Die Zugangsdaten zum Composer-Repository, also die E-Mail-Adresse des Kunden und der Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind außerdem nach der Anmeldung im Kundenbereich unter kowal.store verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.
composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-shipping-rulesbin/magento module:enable Kowal_ShippingRulesWenn Kowal_Base noch nicht aktiviert ist, muss es zuvor oder zusammen mit dem Modul aktiviert werden:
bin/magento module:enable Kowal_Base Kowal_ShippingRulesbin/magento setup:upgradeDieser Befehl erstellt die Modultabellen und fügt die Spalten hinzu, die für die Unterstützung von Extra Fee in quote, order, invoice und creditmemo erforderlich sind.
In der Produktionsumgebung:
bin/magento setup:di:compilebin/magento cache:flushbin/magento module:status Kowal_ShippingRulesDas Modul sollte in der Liste der aktiven Module erscheinen.
Führen Sie nach der Installation die Diagnose 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:
Wenn der Befehl Fehler zurückgibt, sollte das Modul nicht für den Produktivbetrieb aktiviert werden, bevor diese geklärt sind.
Pfad im Magento-Panel:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & RulesFelder:
Enabled — aktiviert oder deaktiviert den Carrier kowal_shippingrules.Title — Name der Methodengruppe, die im Checkout sichtbar ist.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.Die wichtigste Einstellung:
carriers/kowal_shippingrules/active = 1Wenn der Carrier deaktiviert ist, sind die im Modul erstellten Methoden im Checkout nicht verfügbar.
Pfad im Magento-Panel:
Stores / Configuration / Sales / Shipping Methods & RulesAbschnitt General Diagnostics:
Enable Debug Logging — speichert Entscheidungsdetails im Log.Shadow Mode — Modus, der zum Vergleich des Verhaltens während der Migration vorbereitet ist.Abschnitt Restrictions:
Enable Restrictions — aktiviert oder deaktiviert nur Einschränkungen.Abschnitt Extra Fees:
Enable Extra Fees — aktiviert oder deaktiviert nur zusätzliche Gebühren.Fee Tax Mode — legt fest, wie die Steuer für Extra Fee behandelt wird.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 = nonePfad:
Sales / Shipping Methods & RulesVerfügbare Bereiche:
Shipping Methods — Versandmethoden und Tarife,Shipping Restrictions — Einschränkungen für Liefermethoden,Extra Fees — zusätzliche Gebühren.Eine Versandmethode sollte erstellt werden, wenn der Shop eine eigene Lieferoption benötigt, z. B.:
Gehen Sie zu:
Sales / Shipping Methods & Rules / Shipping MethodsWählen Sie anschließend Add New oder bearbeiten Sie eine vorhandene Methode.
Typische Felder der 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 — Anzeigereihenfolge.Store Views — Sichtbarkeit für Store Views.Customer Groups — Sichtbarkeit für Kundengruppen.Conditions — Bedingungen für die Verfügbarkeit der Methode.Empfehlungen für das Feld Code:
Beispiele:
dostawa_paletowatransport_specjalnykurier_gabarytdostawa_lokalnaDer vollständige Methodencode im Checkout erhält das Carrier-Präfix:
kowal_shippingrules_dostawa_paletowaEine aktive Methode sollte mindestens einen aktiven Tarif haben. Wenn eine Methode keinen passenden Tarif hat, erscheint sie nicht im Checkout.
Ein Tarif kann abhängig sein von:
Preismodi:
fixed — fester Preis,percent_subtotal — Prozentsatz des Subtotals.Beispiele:
Bedingungen legen fest, wann eine Methode verfügbar sein soll.
Beispiele:
Wenn die Bedingungen leer sind, wird die Methode nur durch Status, Store View, Customer Group und einen passenden Tarif eingeschränkt.
Einschränkungen dienen dazu, Versandmethoden auszublenden oder zu blockieren, die für eine bestimmte Bestellung nicht verfügbar sein sollten.
Beispiele:
Gehen Sie zu:
Sales / Shipping Methods & Rules / Shipping RestrictionsWählen Sie anschließend Add New oder bearbeiten Sie eine vorhandene Einschränkung.
Typische Felder:
Is Active — ob die Einschränkung aktiv ist.Name — interner Name.Target Carrier — Carrier, auf den sich die Einschränkung bezieht.Target Method — Methode, auf die sich die Einschränkung bezieht.Action — Wirkungsweise.Message — Meldung für den Kunden.Priority — Priorität.Stop Processing — ob die weitere Prüfung von Regeln beendet werden soll.Store Views — Store View-Bereich.Customer Groups — Bereich der Kundengruppen.Conditions — Matching-Bedingungen.hide:
error:
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 dem Abgleich dieser Einschränkung keine weiteren Einschränkungen für diese Methode prüft.
Empfehlung:
Stop Processing, wenn die Regel die Verfügbarkeit der Methode endgültig entscheiden soll.Extra Fee dient dazu, einer Bestellung zusätzliche Gebühren hinzuzufügen.
Beispiele:
Gehen Sie zu:
Sales / Shipping Methods & Rules / Extra FeesWählen Sie anschließend 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, der in den totals sichtbar ist.Target Carrier — Carrier, auf den sich die fee bezieht.Target Method — Methode, auf die sich die fee bezieht.Price Type — Preistyp.Price — Wert der Gebühr.Apply Mode — Berechnungsart.Tax Class ID — Steuerklasse, wenn tax mode verwendet wird.Priority — Priorität.Stop Processing — ob die weitere Berechnung von fee beendet werden soll.Store Views — Store View-Bereich.Customer Groups — Bereich der Kundengruppen.Conditions — Bedingungen für die Berechnung.fixed:
percent_subtotal:
cart:
per_item:
per_matching_item:
Beispiel:
Wenn die Gebühr für besondere Sicherung 5 zł beträgt und sich im Warenkorb 3 Produkte befinden, die die Bedingung erfüllen, berechnet der Modus per_matching_item 15 zł.
Standardmäßig wird keine Steuer auf Extra Fee berechnet:
kowal_shippingrules/fees/tax_mode = noneUm Steuer zu berechnen:
Fee Tax Mode auf Calculate by Fee Tax Class.Tax Class ID in der Extra Fee-Regel aus.Die Steuer auf Extra Fee sollte stets mit der Steuerkonfiguration des jeweiligen Shops geprüft werden.
Das Modul verwendet einen Bedingungsgenerator, der den Magento-Regeln ähnelt.
Bedingungen können sich unter anderem beziehen auf:
Annahme:
shipping_type,pallet.Regel:
Jeżeli produkt w koszyku ma shipping_type = palletMögliche Aktionen:
Dostawa paletowa anzeigen,Transport gabarytowy hinzufügen.Dedizierte Logdatei:
var/log/kowal_shipping_rules.logDebug kann aktiviert werden unter:
Stores / Configuration / Sales / Shipping Methods & Rules / General DiagnosticsAktivieren Sie:
Enable Debug Logging = YesEmpfehlungen:
Wenn nach der Implementierung ein Problem auftritt, können Sie unabhängig voneinander deaktivieren:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = NoEffekt:
kowal_shippingrules sind nicht verfügbar.Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = NoEffekt:
Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = NoEffekt:
Die Migration von Amasty soll helfen, die Konfiguration von Einschränkungen und extra fee nach Kowal_ShippingRules zu übertragen.
Das Kowal-Modul benötigt Amasty nicht für den normalen Betrieb. Amasty kann als Quelle für Migrationsdaten sowie als Referenzpunkt während der Tests verwendet werden.
Der Migrator analysiert:
amasty_shiprestriction_ruleamasty_extrafeeamasty_extrafee_optionZieltabellen:
kowal_shipping_restrictionkowal_shipping_feeDie Migration wurde vorsichtig konzipiert:
--execute,ready gespeichert,manual_review und unsupported werden übersprungen,migration_source und migration_source_key idempotent,Führen Sie aus:
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-Tabellen sowie der Kowal-Tabellen.
Führen Sie aus:
bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100Dry-run erstellt einen Transformationsplan, speichert jedoch nichts.
Status der Datensätze:
ready — Datensatz kann automatisch übertragen werden,manual_review — Datensatz erfordert eine manuelle Analyse,unsupported — 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.
Führen Sie aus:
bin/magento kowal:shippingrules:amasty:apply --limit=100Auch dies speichert noch keine Daten. Der Befehl zeigt, wie viele Datensätze erstellt, übersprungen oder mit Fehler beendet würden.
Nach Freigabe der preview:
bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --executeDer Befehl speichert nur Einschränkungen mit dem Status ready.
Nach Freigabe der preview:
bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --executeDer Befehl speichert nur extra fees mit dem Status ready.
Führen Sie aus:
bin/magento kowal:shippingrules:stabilization:checkPrüfen Sie außerdem das Panel:
Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra FeesVor dem Deaktivieren oder Ersetzen der Amasty-Konfiguration sollten die Ergebnisse für Testwarenkörbe verglichen werden.
Empfohlene Warenkörbe:
Prüfen Sie für jeden Warenkorb:
Erst nach Freigabe der Ergebnisse kann die Umschaltung der Produktionskonfiguration geplant werden.
Empfehlungen:
Wenn ein Problem auftritt:
Kowal ShippingRules.Enable Restrictions.Enable Extra Fees.module:status zeigt Kowal_ShippingRules als aktiv an,setup:upgrade wurde ohne Fehler abgeschlossen,setup:di:compile wurde ohne Fehler abgeschlossen,cache:flush wurde ausgeführt,stabilization:check gibt keine Fehler zurück,Shipping Methods & Rules,hide blendet die Methode aus,error zeigt eine Meldung an,Prüfen Sie:
Prüfen Sie:
Enable Extra Fees = Yes,Stop Processing einer früheren Regel die weitere Berechnung nicht gestoppt hat.Prüfen Sie:
Enable Restrictions = Yes,Stop Processing die Verarbeitung nicht früher beendet.Prüfen Sie:
Fee Tax Mode = Calculate by Fee Tax Class,Tax Class ID hat,README.md — technische Beschreibung des Moduls für Entwickler.docs/WDROZENIE.md — ausführliche Implementierungsdokumentation und Architektur.docs/OPIS_MARKETINGOWY.md — Marketingbeschreibung des Moduls.