Kowal Shipping Rules – Magento-2-Erweiterung für Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren.

Kowal ShippingRules ist ein Magento-2-Modul für die erweiterte Versandverwaltung in Onlineshops.
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
61,50 €
E-Mail an einen Freund

Zu diesem Produkt anfragen

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?

  1. Erstellen Sie eine Versandmethode.
  2. Legen Sie den Tarif und die Anwendungsbedingungen fest.
  3. Fügen Sie bei Bedarf Beschränkungen oder eine zusätzliche Gebühr hinzu.
  4. 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 ModulKowal_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önnensetup: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

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 SieStop 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:

  1. Legen SieFee Tax ModeaufCalculate by Fee Tax Classverwenden.
  2. Tragen SieTax Class IDin der Extra-Fee-Regel ein.
  3. 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 Attributshipping_type,
  • der Wert für Sperrgut lautetpalletverwenden.

Regel:

Jeżeli produkt w koszyku ma shipping_type = pallet

Mögliche Aktionen:

  • MethodeDostawa paletowa,
  • Paketstation ausblenden,
  • GebührTransport 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 Carrierskowal_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 Statusready,
  • Datensätze mitmanual_reviewundunsupportedwerden übersprungen,
  • die Migration ist dank der Feldermigration_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:

  1. Deaktivieren Sie den CarrierKowal ShippingRulesverwenden.
  2. Deaktivieren SieEnable Restrictionsverwenden.
  3. Deaktivieren SieEnable Extra Feesverwenden.
  4. Stellen Sie die bisherige Amasty-Konfiguration wieder her.
  5. Prüfen Sie den Checkout.
  6. 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änkunghideblendet die Methode aus,
  • die Beschränkungerrorzeigt 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:

  • obEnable 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,
  • obStop Processingeiner früheren Regel die weitere Berechnung beendet hat.

Die Beschränkung funktioniert nicht

Prüfen Sie:

  • obEnable 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 mitStop Processingdie Verarbeitung früher beendet.

Die Steuer auf Extra Fee wird nicht berechnet

Prüfen Sie:

  • obFee Tax Mode = Calculate by Fee Tax Class,
  • ob für die Gebührenregel eineTax 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.
Klicken Sie, um das Karussell zu überspringen

Wir haben weitere Produkte gefunden, die Sie interessieren könnten!

Schreiben Sie eine Bewertung
Sie bewerten: Kowal Shipping Rules – Magento-2-Erweiterung für Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren.
Ihre Bewertung:
Preis
Qualität
Support
loader
Wird geladen …

Ihre Bewertung wurde zur Moderation übermittelt.

Fragen und Antworten

Frage
Was macht Kowal ShippingRules?
Antwort
Kowal ShippingRules verwaltet Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren in Magento 2. Regeln können vom Warenkorb, Produkten, Lieferadresse und der gewählten Versandmethode abhängen.
Frage
Kann das Modul eigene Versandmethoden erstellen?
Antwort
Ja. Sie können Versandmethoden im Magento-Admin erstellen und ihnen Preise sowie Verfügbarkeitsbedingungen zuweisen.
Frage
Können Versandmethoden ausgeblendet werden?
Antwort
Ja. Das Modul kann eine Methode ausblenden, wenn eine Bestellung die Bedingungen nicht erfüllt, und eine Meldung über ihre Nichtverfügbarkeit anzeigen.
Frage
Können zusätzliche Gebühren berechnet werden?
Antwort
Ja. Eine zusätzliche Gebühr kann für den gesamten Warenkorb, jede Produkteinheit oder nur passende Produkte gelten.
Frage
Können Beschränkungsregeln Produktattribute verwenden?
Antwort
Ja. Regeln können Produktattribute, SKU, Kategorie, Produkttyp, Gewicht, Preis und weitere Warenkorbdaten berücksichtigen.
Frage
Unterstützt das Modul sperrige Produkte?
Antwort
Ja. Dies ist ein wichtiger Anwendungsfall. Das Modul kann nicht verfügbare Versandmethoden ausblenden und eine Gebühr für Sperrguttransport hinzufügen.
Frage
Eignet sich das Modul für B2B-Shops?
Antwort
Ja. B2B-Shops benötigen häufig Regeln nach Warenkorbwert, Kundengruppe, Lieferregion oder Produkttyp. Das Modul unterstützt solche Szenarien.
Frage
Ersetzt das Modul mehrere separate Erweiterungen?
Antwort
In vielen Fällen ja. Kowal ShippingRules vereint Versandmethoden, Beschränkungen und Zusatzgebühren.
Frage
Kann das Shop-Team das Modul ohne Entwickler bedienen?
Antwort
Ja. Laufende Regeln können im Magento-Admin konfiguriert werden. Entwickler werden vor allem für Implementierung, technische Tests und gegebenenfalls die Integration mit einem individuellen Checkout benötigt.
Cookie-Einstellungen ändern