StartseiteDokumentationMindermengenzuschlag

    Mindermengenzuschlag

    Automatische Zuschläge bei Unterschreitung des Mindestbestellwerts

    Zur Plugin-Seite →

    Überblick

    Das Plugin fügt automatisch einen Mindermengenzuschlag zum Warenkorb hinzu, wenn der Bestellwert unter einem konfigurierbaren Schwellenwert liegt. Der Zuschlag erscheint als separates Line Item im Warenkorb und wird transparent ausgewiesen.

    Das Plugin unterstützt bis zu drei Staffeln mit unterschiedlichen Schwellwerten und Zuschlagshöhen, sowohl als fester Betrag als auch prozentual. Es enthält einen Fortschrittsbalken, Kundengruppen-Steuerung und Kategorie-Ausnahmen.

    Systemvoraussetzungen

  1. •Shopware 6.7 oder höher
  2. •PHP 8.1 oder höher
  3. •MySQL 8.0 oder höher

    4. Installation

  4. 1.Plugin über den Shopware Plugin-Manager installieren oder manuell in custom/plugins/BcMinimumQuantitySurcharge ablegen
  5. 2.Plugin im Plugin-Manager aktivieren
  6. 3.Cache leeren:
    7. php bin/console cache:clear

    Konfiguration

    Die Plugin-Konfiguration befindet sich unter Erweiterungen > Meine Erweiterungen > BC Mindermengenzuschlag > Konfiguration (config.xml).

    Allgemein:

  7. •**Mindermengenzuschlag aktivieren?** (`BcMinimumQuantitySurcharge.config.active`, Typ: `bool`, Standard: `true`): Globaler Schalter.
  8. •**Zuschlagsart** (`BcMinimumQuantitySurcharge.config.surchargeType`, Typ: `single-select`, Standard: `fixed`): `fixed` (Fester Betrag) oder `percentage` (Prozentual vom fehlenden Betrag).
  9. •**Berechnungsgrundlage** (`BcMinimumQuantitySurcharge.config.calculationBase`, Typ: `single-select`, Standard: `gross`): `gross` (Brutto inkl. MwSt.) oder `net` (Netto exkl. MwSt.).
  10. •**Steuersatz für den Zuschlag** (`BcMinimumQuantitySurcharge.config.lineItemTax`, Typ: `sw-entity-single-select`, Entity: `tax`): Steuersatz, der auf den Zuschlag angewendet wird. Leer = steuerfrei.
  11. •**Kundengruppen** (`BcMinimumQuantitySurcharge.config.customerGroups`, Typ: `sw-entity-multi-id-select`, Entity: `customer_group`): Zuschlag nur für diese Kundengruppen. Leer = alle.

    12. Staffel 1:

  12. •**Staffel 1 aktivieren?** (`BcMinimumQuantitySurcharge.config.tier1Active`, Typ: `bool`, Standard: `true`)
  13. •**Schwellwert** (`BcMinimumQuantitySurcharge.config.tier1Threshold`, Typ: `float`, Standard: `30`)
  14. •**Zuschlagswert** (`BcMinimumQuantitySurcharge.config.tier1Value`, Typ: `float`, Standard: `5.00`)

    15. Staffel 2:

  15. •**Staffel 2 aktivieren?** (`BcMinimumQuantitySurcharge.config.tier2Active`, Typ: `bool`, Standard: `false`)
  16. •**Schwellwert** (`BcMinimumQuantitySurcharge.config.tier2Threshold`, Typ: `float`, Standard: `50`)
  17. •**Zuschlagswert** (`BcMinimumQuantitySurcharge.config.tier2Value`, Typ: `float`, Standard: `3.00`)

    18. Staffel 3:

  18. •**Staffel 3 aktivieren?** (`BcMinimumQuantitySurcharge.config.tier3Active`, Typ: `bool`, Standard: `false`)
  19. •**Schwellwert** (`BcMinimumQuantitySurcharge.config.tier3Threshold`, Typ: `float`, Standard: `80`)
  20. •**Zuschlagswert** (`BcMinimumQuantitySurcharge.config.tier3Value`, Typ: `float`, Standard: `1.50`)

    21. Ausnahmen:

  21. •**Kategorien von Berechnung ausschließen** (`BcMinimumQuantitySurcharge.config.excludedCategories`, Typ: `sw-entity-multi-id-select`, Entity: `category`): Produkte aus diesen Kategorien werden bei der Warenkorbwert-Berechnung nicht berücksichtigt.

    22. Anzeige:

  22. •**Hinweis auf Produktdetailseite anzeigen?** (`BcMinimumQuantitySurcharge.config.showOnProductPage`, Typ: `bool`, Standard: `true`)
  23. •**Fortschrittsbalken anzeigen?** (`BcMinimumQuantitySurcharge.config.showProgressBar`, Typ: `bool`, Standard: `true`): Zeigt einen visuellen Balken, der den fehlenden Betrag bis zum zuschlagsfreien Einkauf darstellt.

    24. Funktionen

    Cart Processor

    Der MinimumQuantitySurchargeProcessor implementiert CartProcessorInterface und CartDataCollectorInterface. Bei jeder Warenkorb-Berechnung wird geprüft, ob der Warenkorbwert (brutto oder netto, je nach Konfiguration) unter dem konfigurierten Schwellwert liegt. Wenn ja, wird ein Zuschlag als Line Item hinzugefügt.

    Drei-Staffel-System

    Bis zu drei Staffeln können parallel aktiv sein. Die passende Staffel wird anhand des Warenkorbwerts bestimmt -- die höchste Staffel, deren Schwellwert unterschritten wird, greift.

    Transparente Darstellung

    Der Zuschlag erscheint als separates Line Item im Warenkorb und in der Bestellübersicht. Der Snippet bc-minimum-quantity-surcharge.surchargeLineItemLabel wird als Label verwendet.

    Fortschrittsbalken

    Ein visueller Fortschrittsbalken zeigt dem Kunden, wie viel noch bis zum zuschlagsfreien Einkauf fehlt.

    Automatische Entfernung

    Sobald der Warenkorbwert den Schwellwert erreicht oder überschreitet, wird der Zuschlag automatisch entfernt.

    Events & Hooks

    Das Plugin verwendet keine eigenen Event-Klassen. Es reagiert auf folgende Shopware-Events:

  24. •**`ProductPageLoadedEvent`** (`Shopware\Storefront\Page\Product\ProductPageLoadedEvent`) -- Der `MinimumQuantitySurchargeSubscriber` ergänzt Zuschlagsinformationen auf der Produktdetailseite.
  25. •**`MinimumQuantitySurchargePageLoadedEvent`** (`BcMinimumQuantitySurcharge\Storefront\Page\MinimumQuantitySurchargePageLoadedEvent`) -- Eigenes Page-Event für die Zuschlagswidget-Seite.

    26. Der Cart Processor greift direkt in die Warenkorb-Berechnung ein (kein Event, sondern Shopware Cart-Pipeline).

    Textbausteine (Snippets)

    Storefront-Snippets (src/Resources/snippet/de_DE/bc-minimum-quantity-surcharge.de-DE.json):

  26. •`bc-minimum-quantity-surcharge.surchargeLineItemLabel` -- "Mindermengenzuschlag"
  27. •`bc-minimum-quantity-surcharge.surchargeLineItemDescription` -- Beschreibung mit Platzhaltern `%threshold%` und `%star%`
  28. •`bc-minimum-quantity-surcharge.hintSurchargeActive` -- Hinweis bei aktivem Zuschlag mit `%surchargeAmount%`, `%remaining%`, `%threshold%`
  29. •`bc-minimum-quantity-surcharge.hintNoSurcharge` -- Hinweis bei erreichtem Mindestbestellwert
  30. •`bc-minimum-quantity-surcharge.progressRemaining` -- Fortschrittsbalken-Text mit `%remaining%` und `%threshold%`
  31. •`bc-minimum-quantity-surcharge.progressComplete` -- "Mindestbestellwert erreicht -- kein Zuschlag!"

    32. Verfügbar in DE und EN.

    Datenbank-Tabellen

    Das Plugin erstellt keine eigenen Datenbank-Tabellen. Die Zuschlagsberechnung erfolgt vollständig über die Plugin-Konfiguration und den Cart Processor zur Laufzeit.

    Admin-Integration

    Die Konfiguration erfolgt über die Standard-Plugin-Konfiguration. Es gibt kein separates Admin-Modul.

    Der Zuschlag ist in Bestellungen als eigenes Line Item sichtbar und wird in der Bestellübersicht und im Bestelldetail korrekt ausgewiesen.

    Storefront-Integration

    Das Plugin modifiziert folgende Storefront-Bereiche:

    Templates (src/Resources/views/storefront/):

  32. •`page/minimum-quantity-surcharge/hint.html.twig` -- Zuschlagshinweis-Seite
  33. •`component/line-item/line-item.html.twig` -- Line-Item-Darstellung im Warenkorb
  34. •`component/line-item/element/label.html.twig` -- Label-Element für das Zuschlag-Line-Item
  35. •`component/bc-minimum-quantity-surcharge/progress-bar.html.twig` -- Fortschrittsbalken-Komponente
  36. •`component/bc-minimum-quantity-surcharge/hint-widget.html.twig` -- Hinweis-Widget
  37. •`component/delivery-information.html.twig` -- Erweiterung der Lieferinformationen

    38. JavaScript-Plugins (src/Resources/app/storefront/src/minimum-quantity-surcharge/):

  38. •`bc-minimum-quantity-surcharge-widget.plugin.js` -- Widget für Zuschlagsanzeige
  39. •`bc-minimum-quantity-surcharge-trigger.plugin.js` -- Trigger für dynamische Updates

    40. Storefront-Controller:

  40. •`MinimumQuantitySurchargeController` mit eigener Route (definiert in `routes.xml`)

    41. Kompatibilität

  41. •Kompatibel mit allen anderen Plugins der Bronner B2B Suite
  42. •Kompatibel mit Standard-Shopware-Themes
  43. •Der Zuschlag wird korrekt in der Steuerberechnung berücksichtigt
  44. •Getestet mit Shopware 6.7.x
  45. •Unterstützt Multi-Sales-Channel

    46. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenAngebotsanfragenBestelllisten