Free cookie consent management tool by TermsFeedAktualizacja preferencji plików cookie

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

61,50 € 50,00 €
Installation von COMPOSER
M2-SHIPPING-RULES
  • 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

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 gabaryt hat, 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:

  1. Erstellen Sie die Methode Palettenversand.
  2. Fügen Sie einen Preis für das Land Polen und ein Gewicht oberhalb eines bestimmten Limits hinzu.
  3. Fügen Sie die Bedingung hinzu, dass die Methode für Produkte mit dem Attribut shipping_type = pallet gilt.
  4. Fügen Sie eine Beschränkung hinzu, die die Paketstation für dieselben Produkte ausblendet.
  5. Fügen Sie eine Extra Fee für die Abwicklung von Spezialtransport hinzu.
  6. 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_ShippingRules

Modulpfad:

app/code/Kowal/ShippingRules

Carrier-Code:

kowal_shippingrules

Der Code der Versandmethode im checkout hat das Format:

kowal_shippingrules_

Beispiel:

kowal_shippingrules_dostawa_paletowa

Anforderungen 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_Base ist 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:upgrade und setup:di:compile auszufü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/ShippingRules

2. Aktivieren Sie das Modul

bin/magento module:enable Kowal_ShippingRules

Wenn Kowal_Base noch nicht aktiviert ist, sollte es vorher oder zusammen mit dem Modul aktiviert werden:

bin/magento module:enable Kowal_Base Kowal_ShippingRules

3. Aktualisieren Sie die Datenbank

bin/magento setup:upgrade

Dieser 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:compile

5. Leeren Sie den Cache

bin/magento cache:flush

6. Prüfen Sie den Modulstatus

bin/magento module:status Kowal_ShippingRules

Das 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:check

Vollständige Variante in JSON:

bin/magento kowal:shippingrules:stabilization:check --json

Der 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 & Rules

Felder:

  • Enabled — aktiviert oder deaktiviert den Carrier kowal_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 = 1

Wenn 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 & Rules

Abschnitt 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 = none

Pfad:

Sales / Shipping Methods & Rules

Verfü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 Methods

Wä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_lokalna

Der vollständige Methodencode im checkout hat das Präfix des Carriers:

kowal_shippingrules_dostawa_paletowa

Preise 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 Restrictions

Wä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 Fees

Wä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 = none

Um Steuer zu berechnen:

  1. Setzen Sie Fee Tax Mode auf Calculate by Fee Tax Class.
  2. Füllen Sie Tax Class ID in der Extra-Fee-Regel aus.
  3. 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 = pallet

Mögliche Aktionen:

  • Methode Dostawa paletowa anzeigen,
  • Paketstation ausblenden,
  • fee Transport gabarytowy hinzufü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.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 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 = No

Ergebnis:

  • Methoden des Carriers kowal_shippingrules sind nicht verfügbar.

Nur Beschränkungen

Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = No

Ergebnis:

  • Methoden werden durch Beschränkungen nicht ausgeblendet oder blockiert.

Nur Extra Fee

Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = No

Ergebnis:

  • 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_option

Zieltabellen:

kowal_shipping_restrictionkowal_shipping_fee

Sicherheitsregeln 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 ready gespeichert,
  • Datensätze manual_review und unsupported werden übersprungen,
  • die Migration ist dank der Felder migration_source und migration_source_key idempotent,
  • die Migration deaktiviert Amasty nicht,
  • die Migration schaltet den Traffic nicht automatisch um.

Schritt 1 — Basisbericht

Ausführen:

bin/magento kowal:shippingrules:amasty:report

Der Bericht wird gespeichert unter:

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

Ausführen:

bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100

Dry-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=100

Auch 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 --execute

Der 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 --execute

Der Befehl speichert nur extra fees mit dem Status ready.

Schritt 6 — Diagnostik nach der Migration

Ausführen:

bin/magento kowal:shippingrules:stabilization:check

Prüfen Sie außerdem das Panel:

Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra Fees

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

  1. Deaktivieren Sie den Carrier Kowal ShippingRules.
  2. Deaktivieren Sie Enable Restrictions.
  3. Deaktivieren Sie Enable Extra Fees.
  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

Technisch

  • 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,
  • 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 hide blendet die Methode aus,
  • die Beschränkung error zeigt 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 Processing einer 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 Processing die 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 ID hat,
  • 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.

Fragen und Antworten

Frage
Co robi Kowal ShippingRules?
Antwort
Kowal ShippingRules pozwala zarządzać metodami wysyłki, restrykcjami dostawy i dodatkowymi opłatami w Magento 2. Reguły mogą zależeć od koszyka, produktów, adresu dostawy i wybranej metody wysyłki.
Frage
Czy moduł pozwala tworzyć własne metody wysyłki?
Antwort
Tak. Moduł umożliwia tworzenie metod wysyłki w panelu Magento i przypisywanie do nich stawek oraz warunków dostępności.
Frage
Czy można ukrywać metody dostawy?
Antwort
Tak. Moduł może ukryć metodę dostawy, jeśli zamówienie nie spełnia określonych warunków. Może też pokazać komunikat, że metoda nie jest dostępna.
Frage
Czy można doliczać extra fee?
Antwort
Tak. Extra fee może być naliczane dla całego koszyka, każdej sztuki produktu albo tylko dla produktów spełniających warunki.
Frage
Czy reguły restrykcji mogą działać na atrybutach produktów?
Antwort
Tak. Reguły mogą uwzględniać atrybuty produktów, SKU, kategorię, typ produktu, wagę, cenę i inne dane dostępne w koszyku.
Frage
Czy moduł obsługuje produkty gabarytowe?
Antwort
Tak. To jeden z głównych scenariuszy użycia. Moduł może ukryć niedostępne metody dostawy i doliczyć opłatę za transport gabarytowy.
Frage
Czy moduł nadaje się do sklepów B2B?
Antwort
Tak. Sklepy B2B często potrzebują reguł zależnych od wartości koszyka, grup klientów, regionów dostawy lub typów produktów. Moduł wspiera takie scenariusze.
Frage
Czy moduł zastępuje kilka osobnych rozszerzeń?
Antwort
W wielu przypadkach tak. Kowal ShippingRules łączy funkcje metod wysyłki, restrykcji i dodatkowych opłat.
Frage
Czy obsługa sklepu może pracować z modułem bez programisty?
Antwort
Tak, bieżące reguły można konfigurować w panelu Magento. Programista jest potrzebny głównie przy wdrożeniu, testach technicznych i ewentualnych integracjach z niestandardowym checkoutem.
Write Your Own Review
You're reviewing:Kowal Shipping Rules - Magento 2 Erweiterung für Versandmethoden, Lieferbeschränkungen und zusätzliche Gebühren.
Your Rating