Kowal Shipping Rules – Magento-2-Erweiterung für Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren.
- Kompatibilität
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
Beschreibung / Kowal Shipping Rules – Magento-2-Erweiterung für Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren.
MAGENTO 2 · VERSANDMETHODEN · BESCHRÄNKUNGEN · EXTRA FEE
Passen Sie Versandmethoden und -kosten an Ihre tatsächliche Logistik an.
Kowal Shipping Rules
Erstellen Sie eigene Versandmethoden, bedingte Tarife und Beschränkungen. Fügen Sie Gebühren für den Warenkorb oder passende Produkte hinzu und berücksichtigen Sie diese in der Bestellung, Rechnung und Gutschrift.
Bedingungen in der Magento Rule UI · Versandtypen für Produkte · Amasty-Migration
SO FUNKTIONIERT ES IN DER PRAXIS
01 · Methode und Tarife definieren
Sie legen Adresse, Gewicht, Menge und Warenkorbumfang fest.
02 · Beschränkung oder Gebühr hinzufügen
Sie blenden die Methode aus, zeigen einen Fehler an oder berechnen eine Gebühr.
03 · Bestellprozess prüfen
Sie überprüfen Checkout, Rechnung und Gutschrift.
Welche Vorteile bietet das Ihrem Shop?
Entdecken Sie die Funktionen, Einsatzmöglichkeiten und Einstellungen des Moduls.
Erweiterte Magento-2-Versandregeln
Kowal Shipping Rules bildet die tatsächliche Logistik Ihres Shops in Magento 2 ab: mit eigenen Versandmethoden, bedingten Tarifen, Verfügbarkeitsbeschränkungen und zusätzlichen Gebühren.
Statt Bestellungen nach dem Kauf manuell zu korrigieren, zeigen Sie Ihren Kunden bereits während der Bestellung die passende Versandmethode und die richtigen Versandkosten an.
Eigene Versandmethoden
Unterstützen Sie Paletten-, Lokal-, Sperrgut- oder Speziallieferungen sowie weitere für Ihr Unternehmen typische Prozesse.
Bedingte Tarife
Erstellen Sie Regeln auf Grundlage von Land, Region, Postleitzahl, Warenkorbwert, Gewicht und Produktanzahl.
Beschränkungen und Extra Fee
Blenden Sie nicht verfügbare Optionen aus und berechnen Sie Gebühren für Sperrgut, Verpackung, besondere Handhabung oder eine bestimmte Methode.
Versandlogik an einem zentralen Ort
Kombinieren Sie Methoden, Bedingungen, Beschränkungen und Gebühren zu einem einheitlichen Prozess. Dies ist besonders nützlich bei schweren oder ungewöhnlichen Produkten, Lieferzonen und Shops mit komplexerer Logistik.
Wie wird eine Regel eingerichtet?
- Erstellen Sie eine Versandmethode.
- Legen Sie den Tarif und die Anwendungsbedingungen fest.
- Fügen Sie bei Bedarf Beschränkungen oder eine zusätzliche Gebühr hinzu.
- Testen Sie verschiedene Warenkorbszenarien und Lieferadressen.
FAQ
Kann ich eigene Versandmethoden erstellen?
Ja. Das Modul ist für die Erstellung von Methoden vorgesehen, die den tatsächlichen Logistikszenarien Ihres Shops entsprechen.
Können Regeln von der Adresse abhängen?
Ja, sie können unter anderem Land, Region und Postleitzahl berücksichtigen.
Kann eine zusätzliche Gebühr berechnet werden?
Ja. Extra Fee kann beispielsweise Kosten für Verpackung, Sperrgut oder besondere Handhabung abbilden.
Kann eine Methode unter bestimmten Bedingungen ausgeblendet werden?
Ja. Mit Beschränkungen lässt sich die Verfügbarkeit von Methoden abhängig von der Regelkonfiguration einschränken.
Verwaltung von Methoden, Beschränkungen und Gebühren
Sales → Shipping Methods & Rules bietet Shipping Methods, Shipping Restrictions und Extra Fees. Den Carrier kowal_shippingrules aktivieren Sie unter Sales → Delivery Methods. Beschränkungen, Gebühren und Debug konfigurieren Sie unter Sales → Shipping Methods & Rules.
Methoden können anhand von Store View, Kundengruppen und Bedingungen eingeschränkt werden. Mit dem Attribut kowal_shipping_type lassen sich die Versandart von Produkten und die Tarifzuordnung bei gemischten Warenkörben differenzieren.
Gebühren- und Beschränkungsmodi
Eine Beschränkung kann eine Methode ausblenden oder durch einen Fehler mit Meldung ersetzen. Regeln besitzen eine Priorität und eine Option zum Beenden der weiteren Verarbeitung.
Extra Fee unterstützt fixed und percent_subtotal sowie die Berechnung einmal pro Warenkorb, per_item oder per_matching_item. Die Besteuerung der Gebühr hängt von tax_mode und tax_class_id ab. Die Beträge werden in quote, order, invoice und creditmemo übernommen.
Diagnose und Checkout-Implementierung
Der Befehl kowal:shippingrules:stabilization:check führt eine Prüfung durch, ohne Daten zu ändern. Das separate Protokoll befindet sich unter var/log/kowal_shipping_rules.log. Mit separaten Schaltern lassen sich Beschränkungen oder Gebühren deaktivieren.
Das Modul fügt das totals-Segment kowal_shipping_fee zum Standard-Checkout hinzu. Bei Hyvä Checkout und einer individuellen Zusammenfassung muss dessen Darstellung angebunden und der Endbetrag geprüft werden.
Migration von Amasty
Für den normalen Betrieb ist Amasty nicht erforderlich. Die Tools amasty:report und amasty:apply unterstützen die Migration von Beschränkungen und Extra Fee mithilfe von Bericht, Dry-Run und Vorschau.
Der Speichervorgang mit --execute umfasst Datensätze mit dem Status ready. manual_review und unsupported verbleiben zur Analyse. Die Migration deaktiviert weder die Quellmodule noch leitet sie den Datenverkehr um. Prüfen Sie anschließend die Übereinstimmung der Regeln und Warenkorbergebnisse.
Installation über Composer
Paket kowal/module-shipping-rules, Modul Kowal_ShippingRules. Installieren Sie nach der Konfiguration des Zugriffs auf das Kowal-Repository das Paket, aktivieren Sie das Modul, aktualisieren Sie Magento und leeren Sie den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte entsprechend dem Prozess des Shops.
Von der Konfiguration zum Ergebnis
1. Methode und Tarife definieren
Sie legen Adresse, Gewicht, Menge und Warenkorbumfang fest.
2. Beschränkung oder Gebühr hinzufügen
Sie blenden die Methode aus, zeigen einen Fehler an oder berechnen eine Gebühr.
3. Bestellprozess prüfen
Sie überprüfen Checkout, Rechnung und Gutschrift.
Versand für Warenkörbe mit unterschiedlichen Abmessungen
Sie kennzeichnen Produkte mit einem Versandtyp und erstellen Tarife für die jeweiligen Typen. Die Methode kann das Ergebnis als höchsten Preis, Summe oder niedrigsten Tarif zusammenführen.
Eine bedingte Gebühr kann zusätzlichen Verpackungsaufwand abbilden. Sie prüfen den Endbetrag für Adresse, Warenkorb und ausgewählte Methode.
Bilden Sie die Versandregeln Ihres Shops ab
Möchten Sie das Modul an Ihren Shop anpassen? Fragen Sie nach der Implementierung von Kowal Shipping Rules und besprechen Sie die Konfiguration oder benötigte Erweiterungen.
Weitere Informationen
| Übereinstimmung mit der Vorlage | Luma / Leer, KOWAL |
|---|
Installationsanleitung für das Modul
Kowal ShippingRules – Anleitung für Installation, Konfiguration und Bedienung
Zweck des Dokuments
Dieses Dokument beschreibt die praktische Implementierung und Bedienung des ModulsKowal_ShippingRulesin Magento 2. Es richtet sich an Personen, die für die Installation des Moduls, die Shop-Konfiguration, Implementierungstests und die tägliche Verwaltung der Versandregeln verantwortlich sind.
Das Dokument umfasst:
- die Installation des Moduls,
- die Basiskonfiguration,
- die Erstellung von Versandmethoden,
- die Konfiguration von Tarifen,
- die Verwaltung von Beschränkungen für Versandmethoden,
- die Verwaltung zusätzlicher Extra Fees,
- die Diagnose,
- die Migration von Amasty-Modulen,
- eine Checkliste für Tests nach der Implementierung.
Grundlegende Informationen
Technischer Name des Moduls:
Kowal_ShippingRules
Speicherort des Moduls:
vendor/kowal/module-shipping-rules
Carrier-Code:
kowal_shippingrules
Der Code der Versandmethode im Checkout hat folgendes Format:
kowal_shippingrules_<kod_metody>
Beispiel:
kowal_shippingrules_dostawa_paletowa
Voraussetzungen vor der Installation
Vor der Installation muss Folgendes bestätigt werden:
- Der Shop läuft mit Magento 2.4.x,
- die Umgebung verwendet PHP
>=8.1, - das Modul
Kowal_Baseist verfügbar, - eine Sicherung der Dateien und der Datenbank wurde erstellt,
- die Implementierung erfolgt zunächst in einer Test- oder Staging-Umgebung,
- nach der Installation können
setup:upgradeundsetup:di:compile, - die testende Person hat Zugriff auf das Admin-Panel und den Checkout.
Installation des Moduls
Installation über Composer
Die Zugangsdaten für das Composer-Repository – E-Mail-Adresse des Kunden und Lizenz-Token – erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung auf kowal.storeebenfalls im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch das erhaltene Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.
composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-shipping-rules
2. Modul aktivieren
bin/magento module:enable Kowal_ShippingRules
WennKowal_Base noch nicht aktiviert ist, muss es zuvor oder zusammen mit dem Modul aktiviert werden:
bin/magento module:enable Kowal_Base Kowal_ShippingRules
3. Datenbank aktualisieren
bin/magento setup:upgrade
Dieser Befehl erstellt die Modultabellen und fügt die Spalten hinzu, die für die Verarbeitung von Extra Fee in quote, order, invoice und creditmemo erforderlich sind.
4. DI kompilieren
In der Produktionsumgebung:
bin/magento setup:di:compile
5. Cache leeren
bin/magento cache:flush
6. Modulstatus prüfen
bin/magento module:status Kowal_ShippingRules
Das Modul sollte in der Liste der aktiven Module aufgeführt sein.
Prüfung nach der Installation
Führen Sie nach der Installation die Diagnose aus:
bin/magento kowal:shippingrules:stabilization:check
Vollständige Variante im JSON-Format:
bin/magento kowal:shippingrules:stabilization:check --json
Der Befehl ist schreibgeschützt und ändert keine Daten. Er prüft unter anderem:
- das Vorhandensein der Modultabellen,
- die Anzahl der Datensätze,
- fehlerhaftes JSON in Bedingungen,
- aktive Methoden ohne aktive Tarife,
- Extra-Fee-Regeln mit Steuerklasse bei deaktiviertem Steuermodus.
Wenn der Befehl Fehler zurückgibt, darf das Modul erst nach deren Klärung produktiv eingesetzt werden.
Basiskonfiguration
Carrier
Pfad im Magento-Admin-Panel:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules
Felder:
Enabled– aktiviert oder deaktiviert den Carrierkowal_shippingrulesverwenden.Title– Name der Methodengruppe, der im Checkout angezeigt wird.Test Method Name– Name der konfigurierbaren Testmethode.Test Method Price– Preis der konfigurierbaren Testmethode.Sort Order– Reihenfolge des Carriers in der Liste der Versandmethoden.Show Method If Not Applicable– legt fest, ob bei fehlenden verfügbaren Methoden ein Fehler angezeigt wird.Displayed Error Message– Meldung, wenn die Methode nicht verfügbar ist.
Wichtigste Einstellung:
carriers/kowal_shippingrules/active = 1
Wenn der Carrier deaktiviert ist, stehen die im Modul erstellten Methoden im Checkout nicht zur Verfügung.
Diagnose und Notfallfunktionen
Pfad im Magento-Admin-Panel:
Stores / Configuration / Sales / Shipping Methods & Rules
Im AbschnittGeneral Diagnosticsfest:
Enable Debug Logging– protokolliert Details zu den getroffenen Entscheidungen.Shadow Mode– ein Modus zum Vergleichen des Verhaltens während der Migration.
Im AbschnittRestrictionsfest:
Enable Restrictions– aktiviert oder deaktiviert ausschließlich die Beschränkungen.
Im AbschnittExtra Feesfest:
Enable Extra Fees– aktiviert oder deaktiviert ausschließlich die zusätzlichen Gebühren.Fee Tax Mode– legt die Steuerbehandlung für Extra Fee fest.
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 anhand der in der Gebührenregel festgelegten Steuerklasse.
Sichere Standardeinstellungen:
kowal_shippingrules/general/debug = 0
kowal_shippingrules/general/shadow_mode = 0
kowal_shippingrules/restrictions/enabled = 1
kowal_shippingrules/fees/enabled = 1
kowal_shippingrules/fees/tax_mode = none
Modulmenü im Admin-Panel
Pfad:
Sales / Shipping Methods & Rules
Verfügbare Bereiche:
Shipping Methods– Versandmethoden und Tarife,Shipping Restrictions– Beschränkungen für Versandmethoden,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, beispielsweise:
- Palettenlieferung,
- Spezialtransport,
- lokale Lieferung,
- Kurierversand für Sperrgut,
- logistische Abholung,
- eine Methode, die nur für ausgewählte Produkte oder Regionen verfügbar ist.
Methode erstellen
Gehen Sie zu:
Sales / Shipping Methods & Rules / Shipping Methods
Wählen Sie anschließendAdd Newoder bearbeiten Sie eine vorhandene Methode.
Typische Methodenfelder:
Is Active– gibt an, 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 FeldCodefest:
- Verwenden Sie Kleinbuchstaben,
- verwenden Sie keine polnischen Sonderzeichen,
- verwenden Sie keine Leerzeichen,
- verwenden Sie Unterstriche anstelle von Leerzeichen.
Beispiele:
dostawa_paletowa
transport_specjalny
kurier_gabaryt
dostawa_lokalna
Der vollständige Methodencode im Checkout erhält das Carrier-Präfix:
kowal_shippingrules_dostawa_paletowa
Methodentarife
Eine aktive Methode sollte mindestens einen aktiven Tarif besitzen. Wenn für die Methode kein passender Tarif vorhanden ist, wird sie im Checkout nicht angezeigt.
Ein Tarif kann von folgenden Faktoren abhängen:
- Land,
- Region,
- Postleitzahl,
- Warenkorbwert,
- Gewicht,
- Produktmenge,
- Versandtyp,
- Priorität.
Preismodi:
fixed– fester Preis,percent_subtotal– Prozentsatz der Zwischensumme.
Beispiele:
- Preis von 29 PLN für Sendungen bis 30 kg,
- Preis von 149 PLN für Palettenlieferungen,
- 5% des Warenkorbwerts für einen Spezialtransport,
- separater Tarif für ausgewählte Postleitzahlen.
Methodenbedingungen
Die Bedingungen bestimmen, wann eine Methode verfügbar sein soll.
Beispiele:
- Die Methode ist nur für Produkte aus einer ausgewählten Kategorie verfügbar,
- die Methode ist nur bei einem bestimmten Produktattribut verfügbar,
- die Methode ist nur ab einem bestimmten Warenkorbwert verfügbar,
- die Methode ist nur für ein ausgewähltes Lieferland verfügbar.
Wenn keine Bedingungen definiert sind, wird die Methode nur durch Status, Store View, Kundengruppe und den passenden Tarif eingeschränkt.
Verwaltung von Beschränkungen für Versandmethoden
Wann sollten Beschränkungen verwendet werden?
Beschränkungen dienen dazu, Versandmethoden auszublenden oder zu sperren, die für eine bestimmte Bestellung nicht verfügbar sein sollen.
Beispiele:
- Paketstation für Sperrgut ausblenden,
- Auslandsversand für eine ausgewählte Kategorie sperren,
- eine Meldung anzeigen, dass Expressversand für bestellte Produkte nicht verfügbar ist,
- eine Versandmethode für ein ausgewähltes Land ausblenden.
Beschränkung erstellen
Gehen Sie zu:
Sales / Shipping Methods & Rules / Shipping Restrictions
Wählen Sie anschließendAdd Newoder bearbeiten Sie eine vorhandene Beschränkung.
Typische Felder:
Is Active– gibt an, 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– gibt an, ob die weitere Regelprüfung beendet werden soll.Store Views– Store-View-Bereich.Customer Groups– Kundengruppenbereich.Conditions– Übereinstimmungsbedingungen.
Aktionen der Beschränkung
hidefest:
- Die Methode wird ausgeblendet,
- der Kunde sieht sie nicht,
- geeignet für offensichtliche Einschränkungen, beispielsweise Paketstationen bei Sperrgut.
errorfest:
- Die Methode wird als nicht verfügbar angezeigt,
- der Kunde sieht eine Meldung,
- geeignet, wenn der Grund für die Nichtverfügbarkeit erklärt werden sollte.
Priorität und Stop Processing
Regeln werden entsprechend ihrer Priorität geprüft. Eine höhere Priorität bedeutet eine frühere Prüfung.
Stop Processing = Yesbedeutet, dass das Modul nach einer Übereinstimmung mit dieser Beschränkung keine weiteren Beschränkungen für diese Methode prüft.
Empfehlung:
- Verwenden Sie höhere Prioritäten für spezifischere Regeln,
- verwenden Sie niedrigere Prioritäten für allgemeine Regeln,
- Aktivieren Sie
Stop Processing, wenn die Regel abschließend über die Verfügbarkeit der Methode entscheiden soll.
Verwaltung von Extra Fee
Wann sollte Extra Fee verwendet werden?
Extra Fee dient dazu, einer Bestellung zusätzliche Gebühren hinzuzufügen.
Beispiele:
- Gebühr für Sonderverpackungen,
- Zuschlag für Sperrguttransport,
- Gebühr für empfindliche Produkte,
- Logistikgebühr für eine bestimmte Versandmethode,
- Zuschlag für ausgewählte Regionen.
Extra Fee erstellen
Gehen Sie zu:
Sales / Shipping Methods & Rules / Extra Fees
Wählen Sie anschließendAdd Newoder bearbeiten Sie eine vorhandene Gebühr.
Typische Felder:
Is Active– gibt an, ob die Gebühr aktiv ist.Name– interner Name.Label– in den totals angezeigter Name der Gebühr.Target Carrier– Carrier, auf den sich die Gebühr bezieht.Target Method– Methode, auf die sich die Gebühr bezieht.Price Type– Preistyp.Price– Gebührenwert.Apply Mode– Berechnungsweise.Tax Class ID– Steuerklasse, wenn ein Steuermodus verwendet wird.Priority– Priorität.Stop Processing– gibt an, ob die weitere Gebührenberechnung beendet werden soll.Store Views– Store-View-Bereich.Customer Groups– Kundengruppenbereich.Conditions– Bedingungen für die Berechnung.
Preismodi
fixedfest:
- fester Betrag,
- beispielsweise 19 PLN für die Verpackung.
percent_subtotalfest:
- Prozentsatz des Warenkorbwerts,
- beispielsweise 3% des Bestellwerts.
Berechnungsmodi
cartfest:
- eine Gebühr für den gesamten Warenkorb.
per_itemfest:
- Gebühr multipliziert mit der Produktmenge.
per_matching_itemfest:
- Gebühr wird nur für Produkte berechnet, die die Bedingungen erfüllen.
Beispiel:
Wenn die Gebühr für eine besondere Sicherung 5 PLN beträgt und sich 3 Produkte im Warenkorb befinden, die die Bedingung erfüllen, berechnet der Modusper_matching_item15 PLN.
Steuer auf Extra Fee
Standardmäßig wird keine Steuer auf Extra Fee berechnet:
kowal_shippingrules/fees/tax_mode = none
So aktivieren Sie die Steuerberechnung:
- Legen Sie
Fee Tax ModeaufCalculate by Fee Tax Classverwenden. - Tragen Sie
Tax Class IDin der Extra-Fee-Regel ein. - Testen Sie Warenkorb, order, invoice und creditmemo.
Die Steuer auf Extra Fee sollte immer in Verbindung mit der Steuerkonfiguration des jeweiligen Shops geprüft werden.
Verwaltung von Bedingungen
Das Modul verwendet einen Bedingungsgenerator, der den Magento-Regeln ähnelt.
Die Bedingungen können sich unter anderem auf Folgendes beziehen:
- Produktattribute,
- SKU,
- Kategorien,
- Produkttyp,
- Gewicht,
- Preis,
- Warenkorbwert,
- Produktmenge,
- Lieferland,
- Region,
- Ort,
- Postleitzahl,
- Gutschein,
- ausgewählte Versandmethode.
Beispielbedingung für ein Sperrgutprodukt
Annahme:
- Das Produkt besitzt das Attribut
shipping_type, - der Wert für Sperrgut lautet
palletverwenden.
Regel:
Jeżeli produkt w koszyku ma shipping_type = pallet
Mögliche Aktionen:
- Methode
Dostawa paletowa, - Paketstation ausblenden,
- Gebühr
Transport gabarytowyverwenden.
Empfehlungen für die Arbeit mit Bedingungen
- Erstellen Sie zunächst eine einfache Regel und testen Sie sie im Warenkorb,
- vermeiden Sie zu viele Bedingungen innerhalb einer Regel,
- geben Sie Regeln aussagekräftige Namen,
- verwenden Sie für wichtige Regeln eindeutige Produktattribute,
- testen Sie den Warenkorb nach Änderungen an Produktattributen erneut.
Diagnose und Protokollierung
Separate Protokolldatei:
var/log/kowal_shipping_rules.log
Debug kann hier aktiviert werden:
Stores / Configuration / Sales / Shipping Methods & Rules / General Diagnostics
Aktivieren Sie:
Enable Debug Logging = Yes
Empfehlungen:
- Lassen Sie Debug Logging in der Produktionsumgebung nicht dauerhaft aktiviert,
- aktivieren Sie Debug nur während der Diagnose,
- deaktivieren Sie Debug nach Abschluss der Tests,
- analysieren Sie die Protokolle zusammen mit dem Testwarenkorb und der Regelkonfiguration.
Notfallfunktionen
Falls nach der Implementierung ein Problem auftritt, können folgende Elemente unabhängig voneinander deaktiviert werden:
Gesamter Carrier
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = No
Auswirkung:
- Die Methoden des Carriers
kowal_shippingrulessind nicht verfügbar.
Nur Beschränkungen
Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = No
Auswirkung:
- Methoden werden nicht durch Beschränkungen ausgeblendet oder gesperrt.
Nur Extra Fee
Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = No
Auswirkung:
- Zusätzliche Gebühren werden nicht berechnet.
Migration von Amasty
Zweck der Migration
Die Migration von Amasty soll dabei helfen, die Konfiguration von Beschränkungen und Extra Fee zuKowal_ShippingRulesverwenden.
Das Kowal-Modul benötigt Amasty nicht für den normalen Betrieb. Amasty kann als Quelle für Migrationsdaten und als Referenz für Tests verwendet werden.
Unterstützte Datenquellen
Der Migrator analysiert:
amasty_shiprestriction_rule
amasty_extrafee
amasty_extrafee_option
Zieltabellen:
kowal_shipping_restriction
kowal_shipping_fee
Sicherheitsregeln für die Migration
Die Migration wurde mit besonderer Vorsicht konzipiert:
- Der Bericht ist schreibgeschützt,
- der Dry-Run speichert keine Daten,
- apply wird standardmäßig als Vorschau ausgeführt,
- das Speichern erfordert die ausdrückliche Option
--execute, - es werden ausschließlich Datensätze mit dem Status
ready, - Datensätze mit
manual_reviewundunsupportedwerden übersprungen, - die Migration ist dank der Felder
migration_sourceundmigration_source_key, - die Migration deaktiviert Amasty nicht,
- die Migration leitet den Datenverkehr nicht automatisch um.
Schritt 1 – Basisbericht
Führen Sie Folgendes aus:
bin/magento kowal:shippingrules:amasty:report
Der Bericht wird hier gespeichert:
var/report/kowal_shippingrules_amasty_report.json
Der Bericht zeigt das Vorhandensein und die Anzahl der Amasty- und Kowal-Tabellen.
Schritt 2 – Dry-Run der Transformation
Führen Sie Folgendes aus:
bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100
Der Dry-Run erstellt einen Transformationsplan, speichert jedoch keine Daten.
Status der Datensätze:
ready– der Datensatz kann automatisch übertragen werden,manual_review– der Datensatz muss manuell geprüft werden,unsupported– der Datensatz wird vom automatischen Migrator nicht unterstützt.
Wenn der Bericht viele Einträge mitmanual_reviewoderunsupportedenthält, müssen diese Regeln vor apply geprüft werden.
Schritt 3 – Vorschau von apply
Führen Sie Folgendes aus:
bin/magento kowal:shippingrules:amasty:apply --limit=100
Auch hierbei werden noch keine Daten gespeichert. Der Befehl zeigt an, wie viele Datensätze erstellt, übersprungen oder mit einem Fehler beendet würden.
Schritt 4 – apply für Beschränkungen
Nach Freigabe der Vorschau:
bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --execute
Der Befehl speichert nur Beschränkungen mit dem Statusreadyverwenden.
Schritt 5 – apply für Extra Fee
Nach Freigabe der Vorschau:
bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --execute
Der Befehl speichert nur Extra Fees mit dem Statusreadyverwenden.
Schritt 6 – Diagnose nach der Migration
Führen Sie Folgendes aus:
bin/magento kowal:shippingrules:stabilization:check
Prüfen Sie außerdem das Admin-Panel:
Sales / Shipping Methods & Rules / Shipping Restrictions
Sales / Shipping Methods & Rules / Extra Fees
Schritt 7 – Vergleichstests mit Amasty
Bevor die Amasty-Konfiguration deaktiviert oder ersetzt wird, müssen 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 Gutschein,
- Bestellung mit einer ausgewählten Methode, für die Extra Fee gilt.
Prüfen Sie für jeden Warenkorb:
- verfügbare Versandmethoden,
- ausgeblendete Methoden,
- Fehlermeldungen,
- berechnete Extra Fee,
- Brutto- und Nettobeträge, falls tax fee verwendet wird,
- order,
- Invoice,
- creditmemo.
Schritt 8 – Entscheidung über die Umstellung
Erst nach Freigabe der Ergebnisse kann die Umstellung der Produktionskonfiguration geplant werden.
Empfehlungen:
- Deaktivieren Sie Amasty nicht ohne Sicherung,
- löschen Sie die Amasty-Daten nicht unmittelbar nach der Migration,
- deaktivieren Sie zunächst die Funktion über die Konfiguration,
- halten Sie eine Rollback-Möglichkeit bereit,
- erstellen Sie eine Liste der Regeln, die manuell korrigiert werden müssen.
Rollback nach der Migration
Falls ein Problem auftritt:
- Deaktivieren Sie den Carrier
Kowal ShippingRulesverwenden. - Deaktivieren Sie
Enable Restrictionsverwenden. - Deaktivieren Sie
Enable Extra Feesverwenden. - 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
Technik
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, - bei aktiviertem Debug wird die Protokolldatei geschrieben.
Konfiguration
- Der Carrier ist aktiviert,
- mindestens eine Versandmethode wurde erstellt,
- die aktive Methode besitzt einen aktiven Tarif,
- die Store Views sind korrekt eingestellt,
- die Kundengruppen sind korrekt eingestellt,
- Beschränkungen sind aktiviert oder bewusst deaktiviert,
- Extra Fees sind aktiviert oder bewusst deaktiviert,
- der Steuermodus entspricht der Steuerkonfiguration des Shops.
Checkout
- Die Methode wird für einen Warenkorb angezeigt, der die Bedingungen erfüllt,
- die Methode wird nicht angezeigt, wenn kein passender Tarif vorhanden ist,
- die Beschränkung
hideblendet die Methode aus, - die Beschränkung
errorzeigt eine Meldung an, - Extra Fee wird nach Auswahl der Methode in den totals angezeigt,
- beim Wechsel der Versandmethode wird die Gebühr neu berechnet,
- order enthält die Gebührenbeträge,
- invoice enthält die Gebührenbeträge,
- creditmemo erstattet die Gebühr korrekt.
Häufige Probleme
Die Methode wird im Checkout nicht angezeigt
Prüfen Sie:
- ob der Carrier aktiviert ist,
- ob die Methode aktiv ist,
- ob die Methode einen aktiven Tarif besitzt,
- ob der Tarif zu Land, Region, Postleitzahl, Gewicht und Zwischensumme passt,
- ob die Store View korrekt ist,
- ob die Kundengruppe korrekt ist,
- ob die Bedingungen der Methode erfüllt sind,
- ob eine Beschränkung die Methode ausblendet.
Extra Fee wird nicht berechnet
Prüfen Sie:
- ob
Enable Extra Fees = Yes, - ob die Gebühr aktiv ist,
- ob Target Carrier und Target Method korrekt sind,
- ob die Gebührenbedingungen erfüllt sind,
- ob eine Versandmethode ausgewählt wurde,
- ob der Gebührenbetrag größer als null ist,
- ob
Stop Processingeiner früheren Regel die weitere Berechnung beendet 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 Priorität der Regel korrekt ist,
- ob eine andere Regel mit
Stop Processingdie Verarbeitung früher beendet.
Die Steuer auf Extra Fee wird nicht berechnet
Prüfen Sie:
- ob
Fee Tax Mode = Calculate by Fee Tax Class, - ob für die Gebührenregel eine
Tax Class ID, - ob die Magento-Steuerkonfiguration für die Adresse einen Steuersatz zurückgibt,
- ob der Warenkorb eine Lieferadresse besitzt,
- ob die Gebühr tatsächlich berechnet wurde.
Best Practices
- Konfigurieren Sie zunächst einfache Regeln und fügen Sie anschließend weitere Bedingungen hinzu.
- Erstellen Sie für jede wichtige Regel einen Testwarenkorb.
- Verwenden Sie aussagekräftige Namen für Methoden, Beschränkungen und Gebühren.
- Vermeiden Sie mehrere sehr ähnliche Regeln mit derselben Priorität.
- Dokumentieren Sie den Grund für die Erstellung einer Beschränkung oder Gebühr 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, Vorschau, execute, QA.
Zugehörige Dokumente
README.md– technische Beschreibung des Moduls für Entwickler.docs/WDROZENIE.md– ausführliche Implementierungsdokumentation und Architektur.docs/OPIS_MARKETINGOWY.md– Marketingbeschreibung des Moduls.