> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Mindestbestellwert und Mindermengenzuschlag

> Kleine Bestellungen ausschließen oder mit einem Zuschlag belegen, einzelne Produkte davon ausnehmen und den Zuschlag kundenindividuell festlegen.

Kleine Bestellungen kosten in der Abwicklung ungefähr so viel wie große. Unterhalb eines bestimmten Warenwerts trägt eine Bestellung sich deshalb nicht mehr.

Dagegen gibt es zwei Mittel, und beide werden im Abschnitt `<OrderConditions>` der `shop.config` eingerichtet.

| | Mindestbestellwert | Mindermengenzuschlag |
| - | - | - |
| Wirkung | die Bestellung ist nicht möglich | die Bestellung kostet extra |
| Der Käufer | muss nachlegen | darf kaufen und zahlt einen Aufschlag |

Die beiden schließen sich nicht aus. Sie können einen niedrigen Mindestbestellwert setzen und darüber eine Zuschlagsschwelle legen. Überlegen Sie aber, was der Käufer im Warenkorb erlebt. Zwei Hürden hintereinander sind einer zu viel.

Referenz: [Abschnitt OrderConditions](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/warenkorb-und-bestellprozess.md#orderconditions)

## Mindestbestellwert

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ...
   MinimumOrder-Value = 25.00
   ...
</OrderConditions>
```

Liegt der Warenwert darunter, ist keine Bestellung möglich. Der fehlende Betrag steht im Template zur Verfügung, sodass Sie dem Käufer sagen können, wie viel ihm noch fehlt.

Ein Mindestbestellwert ohne Angabe des Fehlbetrags ist ärgerlich. Der Käufer sieht nur, dass es nicht weitergeht. Geben Sie die Differenz im Warenkorb aus, das ist der Unterschied zwischen einer Sackgasse und einer Aufforderung.

### Zusammenspiel mit Gutscheinen

Ein Gutschein senkt den Warenwert. Damit kann er den Käufer unter den Mindestbestellwert drücken, obwohl der Warenkorb vorher darüber lag. Dafür gibt es drei Schalter.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ...
   MinimumOrder-ConsiderVoucherDiscount-Allow = no
   MinimumOrder-VoucherBase                   = total
   MinimumOrder-AllowOrderWithoutVoucher      = yes
   ...
</OrderConditions>
```

| Parameter | Bedeutung |
| - | - |
| `MinimumOrder-ConsiderVoucherDiscount-Allow` | `no` rechnet Gutscheinrabatte auf Positionsebene wieder auf die Berechnungsgrundlage auf. Ein Gutschein kann den Käufer dann nicht mehr unter den Mindestbestellwert drücken. Voreinstellung ist `yes` |
| `MinimumOrder-VoucherBase` | Bezugsgröße für den Mindestbestellwert eines Gutscheins. `total` rechnet gegen den gesamten Warenkorb, `voucherApplicable` nur gegen die Positionen, auf die der Gutschein wirkt. Voreinstellung ist `total` |
| `MinimumOrder-AllowOrderWithoutVoucher` | `yes` deaktiviert bei nicht erreichtem Mindestbestellwert eines Gutscheins nur den Gutschein, statt die Bestellung zu blockieren. Voreinstellung ist `no` |

`MinimumOrder-AllowOrderWithoutVoucher = yes` ist fast immer die freundlichere Einstellung. Der Käufer verliert den Gutschein, behält aber die Bestellung. Andernfalls steht er vor einer Blockade, die er nur versteht, wenn Sie es ihm im Template erklären.

### Produkte vom Mindestbestellwert ausnehmen

Manche Produkte sollen nicht mitzählen, beispielsweise Geschenke im Rahmen einer Kundenbindungsmaßnahme oder andere Artikel zum Preis von null.

Setzen Sie dafür im Warenwirtschaftssystem oder im WSPManager das Produktdatenfeld `IgnoreMinOrder` auf `y`.

| Feld | Werte | Wirkung |
| - | - | - |
| `IgnoreMinOrder` | `y` | Der Mindestbestellwert wird für diesen Warenkorb nicht geprüft |
| | leer oder anderer Wert | der Mindestbestellwert gilt. Voreinstellung |

## Mindermengenzuschlag

Der Zuschlag braucht zwei Angaben: ab welchem Warenwert er entfällt und wie hoch er ist.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ...
   SurchargeLimit-Value = 15.00
   Surcharge-Value      = 5.00
   Surcharge-Txt        = Mindermengenzuschlag
   ...
</OrderConditions>
```

| Parameter | Bedeutung |
| - | - |
| `SurchargeLimit-Value` | Unterhalb dieses Warenwerts fällt der Zuschlag an |
| `Surcharge-Value` | die Höhe des Zuschlags |
| `Surcharge-Txt` | die Bezeichnung, unter der er in der Aufstellung erscheint |

> [!WARNING]
>
> Beide Werte müssen größer als null sein. Ohne `SurchargeLimit-Value` rechnet der Shop den Zuschlag gar nicht erst, ohne `Surcharge-Value` bleibt er bei null. Ein halb gesetzter Zuschlag meldet sich nicht, er passiert einfach nicht.

### Die beiden Berechnungsgrundlagen

Womit der Warenwert verglichen wird, legt `SurchargeCalculation-Mode` fest.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ...
   SurchargeCalculation-Mode = subtotal
   ...
</OrderConditions>
```

| Wert | Berechnungsgrundlage |
| - | - |
| `subtotal` | die Zwischensumme des Warenkorbs, einschließlich aller Rabatte. Voreinstellung |
| `totalsumofproducts` | die Summe der Positionen, bei denen das Produktfeld `IgnoreForSurcharge` nicht gesetzt ist |

> [!WARNING]
>
> Im Modus `totalsumofproducts` werden Rabatte wie "Nimm 3, zahl 2" und eingelöste Bonuspunkte **nicht** in die Berechnungsgrundlage einbezogen. Der Shop addiert die Positionssummen der beteiligten Produkte. Wenn Sie solche Rabatte einsetzen und sie den Zuschlag beeinflussen sollen, ist `subtotal` der richtige Modus.

### Produkte vom Zuschlag ausnehmen

Das ist der eigentliche Zweck des Modus `totalsumofproducts`. Zwei Fälle machen ihn nötig.

**Treue-Gutschriften** sind im Shop Produkte mit negativem Preis. Ein Käufer legt für 20 Euro Ware in den Warenkorb und löst eine Gutschrift über 10 Euro ein. Der Warenkorbwert fällt auf 10 Euro, und bei einer Schwelle von 15 Euro wäre plötzlich ein Zuschlag fällig. Der Käufer würde für das Einlösen seiner Treueprämie bestraft.

**Treue-Geschenke** sind für den Käufer kostenlos. Liegen nur Geschenke im Warenkorb, beträgt der Warenwert null, und der Zuschlag wäre erst recht fällig.

In beiden Fällen nehmen Sie die betreffenden Produkte aus der Berechnung heraus.

#### Schritt 1: Die Produkte kennzeichnen

Setzen Sie im Warenwirtschaftssystem oder im WSPManager das technische Produktdatenfeld `IgnoreForSurcharge`.

| Feld | Werte | Wirkung |
| - | - | - |
| `IgnoreForSurcharge` | `y` | Das Produkt zählt nicht zur Berechnungsgrundlage |
| | leer oder anderer Wert | Das Produkt zählt mit. Voreinstellung |

Eine Freischaltung durch die WEBSALE AG ist dafür nicht nötig.

#### Schritt 2: Den Modus umstellen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<OrderConditions>
   ...
   SurchargeCalculation-Mode = totalsumofproducts
   ...
</OrderConditions>
```

> [!WARNING]
>
> Das Feld `IgnoreForSurcharge` wirkt **ausschließlich** in diesem Modus. Solange `SurchargeCalculation-Mode` auf `subtotal` steht, ändert die Kennzeichnung der Produkte nichts. Das ist die häufigste Ursache dafür, dass die Ausnahme scheinbar nicht greift.

#### Was daraus folgt

Der Zuschlag fällt nur an, wenn beides zutrifft: Es liegt mindestens ein nicht ausgenommenes Produkt im Warenkorb, und deren Warenwert liegt unter der Schwelle.

Beispiel mit einer Schwelle von 15 Euro und einem Zuschlag von 5 Euro:

| Warenkorb | Warenwert der nicht ausgenommenen Produkte | Zuschlag |
| - | - | - |
| mindestens ein nicht ausgenommenes Produkt | unter 15 Euro | 5 Euro |
| mindestens ein nicht ausgenommenes Produkt | ab 15 Euro | keiner |
| ausschließlich ausgenommene Produkte | 0 Euro | keiner |

Die dritte Zeile ist der Grund für die ganze Konstruktion. Ein Warenkorb mit ausschließlich Geschenken hat den Warenwert null, liegt also unter jeder Schwelle. Weil aber kein zuschlagspflichtiges Produkt darin liegt, bleibt der Zuschlag aus.

### Anzeige im Template

Auf der Produktdetailseite zeigen Sie innerhalb der `PR-Data`-Klammerung an, ob ein Produkt zur Berechnung zählt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-Data}
   ...
   {PR-IgnoreForSurcharge}
      Dieses Produkt wird nicht zur Berechnung des Mindermengenzuschlags herangezogen.
   {/PR-IgnoreForSurcharge}

   {!PR-IgnoreForSurcharge}
      Dieses Produkt unterliegt der Berechnung des Mindermengenzuschlags.
   {/!PR-IgnoreForSurcharge}
   ...
{/PR-Data}
```

Auf der Warenkorbseite steht dasselbe je Position zur Verfügung.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BASKET-PR-Data}
   ...
   {BASKET-PR-IgnoreForSurcharge}
      Dieses Produkt wird nicht zur Berechnung des Mindermengenzuschlags herangezogen.
   {/BASKET-PR-IgnoreForSurcharge}

   {!BASKET-PR-IgnoreForSurcharge}
      Dieses Produkt unterliegt der Berechnung des Mindermengenzuschlags.
   {/!BASKET-PR-IgnoreForSurcharge}
   ...
{/BASKET-PR-Data}
```

Der Warenwert, der tatsächlich zur Berechnung herangezogen wurde, ist dagegen ein Wert für den **ganzen** Warenkorb.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BASKET-PR-Data}
   ...
{/BASKET-PR-Data}

Relevanter Warenwert für den Mindermengenzuschlag: ~BASKET-SurchargeCalculationBasis~
```

> [!WARNING]
>
> `~BASKET-SurchargeCalculationBasis~` gehört **außerhalb** der Schleife `{BASKET-PR-Data}`. Innerhalb würde derselbe Warenkorbwert einmal je Position ausgegeben.

Referenz: [PR-Data](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md#die-tags-im-uberblick) · [PR-IgnoreForSurcharge](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [BASKET-PR-Data](https://dokumentation.websale.de/v8s/referenz/tags/basket/mehrfach-lieferadressen-und-belegexemplare.md#basket-pr-d) · [BASKET-PR-IgnoreForSurcharge](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb.md) · [BASKET-SurchargeCalculationBasis](https://dokumentation.websale.de/v8s/referenz/tags/basket/warenkorbsummen.md#basket-surchargecalculationbasis)

### Zuschlag je Kunde festlegen

Schwelle und Höhe des Zuschlags lassen sich auch pro Kunde hinterlegen, in den Kundendaten. Beide Werte sind dabei unabhängig voneinander: Ein Kunde kann eine eigene Schwelle bei allgemeiner Zuschlagshöhe haben oder umgekehrt.

Ein kundenindividueller Wert hat Vorrang vor dem Wert aus der `shop.config`. Das ist der übliche Weg, Großkunden oder Wiederverkäufern eine andere Kondition einzuräumen, ohne für sie einen eigenen Shop zu betreiben.

### Tags für den Zuschlag

| Tag | Liefert |
| - | - |
| `SURCHARGE-Limit` | die geltende Schwelle |
| `SURCHARGE-Limit_IsConfigDependent` | trifft zu, wenn die Schwelle aus der `shop.config` kommt |
| `SURCHARGE-Limit_IsUserDependent` | trifft zu, wenn die Schwelle aus den Kundendaten kommt |
| `SURCHARGE-Limit_Code` | die Herkunft der Schwelle als Zahlenwert |
| `SURCHARGE-Value` | die geltende Höhe des Zuschlags |
| `SURCHARGE-Value_IsConfigDependent` | trifft zu, wenn die Höhe aus der `shop.config` kommt |
| `SURCHARGE-Value_IsUserDependent` | trifft zu, wenn die Höhe aus den Kundendaten kommt |
| `SURCHARGE-Value_Code` | die Herkunft der Höhe als Zahlenwert |

Die Herkunfts-Tags sind vor allem bei der Fehlersuche wertvoll. Wenn ein Kunde einen unerwarteten Zuschlag sieht, zeigen sie sofort, ob der Wert aus der Shopkonfiguration oder aus seinem Kundenkonto stammt.

Referenz: [SURCHARGE- (Mindermengenzuschlag)](https://dokumentation.websale.de/v8s/referenz/tags/surcharge-mindermengenzuschlag.md)

## Verwandte Themen

* Wegweiser: [Warenkorb](https://dokumentation.websale.de/v8s/marketing-produkte/geschenkprodukte.md#warenkorb)
* Wegweiser: [Gutscheine](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/gutscheine.md)
* Wegweiser: [Bonuspunkte](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md#bonuspunkte)


## Related topics

- [Warenkorb und Bestellprozess](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/warenkorb-und-bestellprozess.md)
- [Warenkorbsummen](https://dokumentation.websale.de/v8s/referenz/tags/basket/warenkorbsummen.md)
- [Bestellmenge eines Produkts](https://dokumentation.websale.de/v8s/produkte/bestellmenge-eines-produkts.md)
- [Versandart abhängig von Mindestbestellwert und Lieferadresse](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-versandart-ausgegraut.md)
- [Prime-Shopping](https://dokumentation.websale.de/v8s/marketing-funktionen/prime-shopping.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.