StartseiteDokumentationMindermengenzuschlag

    Mindermengenzuschlag

    Automatische Zuschläge mit Staffelung, Fortschrittsanzeige und Kundengruppen-Steuerung

    Zur Plugin-Seite →Anleitung & Konfiguration →

    Ü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.

    Aktuelle Version: 1.0.8

    Aenderungen v1.0.8 (13.04.2026):

  1. •manufacturerLink in composer.json ergaenzt

    2. Aenderungen v1.0.7 (09.04.2026):

  2. •Widget zeigt jetzt gruene Erfolgsmeldung wenn Mindestbestellwert erreicht (statt komplett zu verschwinden)
  3. •Fortschrittsbalken zeigt 100% bei erreichtem Schwellwert

    4. Das Plugin verfuegt ueber vollstaendige Lifecycle-Methoden: install, update, activate, deactivate und uninstall.

    Systemvoraussetzungen

  4. •Shopware 6.7 oder höher
  5. •PHP 8.1 oder höher
  6. •MySQL 8.0 oder höher

    7. Installation

  7. 1.Plugin über den Shopware Plugin-Manager installieren oder manuell in custom/plugins/BronnMinimumQuantitySurcharge ablegen
  8. 2.Plugin im Plugin-Manager aktivieren
  9. 3.Cache leeren:
    10. php bin/console cache:clear

    Konfiguration

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

    Allgemein:

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

    15. Staffel 1:

  15. •**Staffel 1 aktivieren?** (`BronnMinimumQuantitySurcharge.config.tier1Active`, Typ: `bool`, Standard: `true`)
  16. •**Schwellwert** (`BronnMinimumQuantitySurcharge.config.tier1Threshold`, Typ: `float`, Standard: `30`)
  17. •**Zuschlagswert** (`BronnMinimumQuantitySurcharge.config.tier1Value`, Typ: `float`, Standard: `5.00`)

    18. Staffel 2:

  18. •**Staffel 2 aktivieren?** (`BronnMinimumQuantitySurcharge.config.tier2Active`, Typ: `bool`, Standard: `false`)
  19. •**Schwellwert** (`BronnMinimumQuantitySurcharge.config.tier2Threshold`, Typ: `float`, Standard: `50`)
  20. •**Zuschlagswert** (`BronnMinimumQuantitySurcharge.config.tier2Value`, Typ: `float`, Standard: `3.00`)

    21. Staffel 3:

  21. •**Staffel 3 aktivieren?** (`BronnMinimumQuantitySurcharge.config.tier3Active`, Typ: `bool`, Standard: `false`)
  22. •**Schwellwert** (`BronnMinimumQuantitySurcharge.config.tier3Threshold`, Typ: `float`, Standard: `80`)
  23. •**Zuschlagswert** (`BronnMinimumQuantitySurcharge.config.tier3Value`, Typ: `float`, Standard: `1.50`)

    24. Ausnahmen:

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

    25. Anzeige:

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

    27. 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 bronn-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:

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

    29. 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/bronn-minimum-quantity-surcharge.de-DE.json):

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

    35. 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/):

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

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

  41. •`bronn-minimum-quantity-surcharge-widget.plugin.js` -- Widget für Zuschlagsanzeige
  42. •`bronn-minimum-quantity-surcharge-trigger.plugin.js` -- Trigger für dynamische Updates

    43. Storefront-Controller:

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

    44. Kompatibilität

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

    49. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenAngebotsanfragenBestelllisten

    Bereit für professionelles B2B?

    Statt 30.000–80.000 € Individualentwicklung: fertige, getestete Plugins — einsatzbereit in Stunden.

    • Alle 12 Plugins im vollen Funktionsumfang
    • Persönliche Einführung durch den Entwickler
    • Individuelle Beratung für deinen Use Case
    Kostenlose Demo anfordernPlugins ansehen

    Keine Kreditkarte nötig · Unverbindlich · Antwort innerhalb von 24h