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

# SURCHARGE- (Mindermengenzuschlag)

> Grenze und Höhe des Mindermengenzuschlags im Template ausgeben und unterscheiden, ob die Werte aus der Shopkonfiguration stammen oder am Kundenkonto hinterlegt sind.

Bei kleinen Bestellungen steht der Aufwand für Verpackung und Versand in keinem Verhältnis zum Warenwert. Deshalb kennt das Shopsystem den Mindermengenzuschlag: Bleibt der Warenwert unter einer bestimmten Grenze, kommt ein fester Betrag auf die Rechnung.

Zwei Zahlen beschreiben das vollständig, nämlich die Grenze und der Betrag. Beide können aus der Shopkonfiguration kommen oder am einzelnen Kundenkonto hinterlegt sein. Genau das machen die acht Tags dieser Seite sichtbar.

Wegweiser: [Mindermengenzuschlag](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/mindestbestellwert-und-mindermengenzuschlag.md#mindermengenzuschlag)

> [!WARNING]
>
> Diese Tags beschreiben die **Regel**, nicht das Ergebnis. Sie sagen, ab wann und in welcher Höhe ein Zuschlag erhoben würde, und zwar unabhängig davon, was gerade im Warenkorb liegt. Ob für die aktuelle Bestellung tatsächlich ein Zuschlag berechnet wurde und wie hoch er ausgefallen ist, steht in den Warenkorbsummen.

Referenz: [BASKET- (Warenkorbsummen)](https://dokumentation.websale.de/v8s/referenz/tags/basket/besondere-produktarten-im-warenkorb.md)

## Die beiden Werte

| Tag | Liefert |
| - | - |
| `SURCHARGE-Limit` | die Grenze, unterhalb derer ein Zuschlag anfällt |
| `SURCHARGE-Value` | die Höhe des Zuschlags |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{SURCHARGE-Limit}
   <p>
      Bei Bestellungen unter ~SURCHARGE-Limit~ ~WS-Currency~ berechnen wir einen
      Mindermengenzuschlag von ~SURCHARGE-Value~ ~WS-Currency~.
   </p>
{/SURCHARGE-Limit}
```

Beide Tags geben den Betrag bereits im Zahlenformat des Shops aus, also mit dem konfigurierten Dezimal- und Tausendertrennzeichen und zwei Nachkommastellen. Das Währungszeichen gehört nicht dazu, dafür nehmen Sie `WS-Currency`.

Als Klammerung greifen beide, wenn ihr Wert nicht null ist. Eine Grenze von null bedeutet, dass überhaupt kein Mindermengenzuschlag vorgesehen ist, und ein Betrag von null bedeutet, dass zwar eine Grenze besteht, aber nichts berechnet wird. Beide Fälle lassen sich damit sauber abfangen.

> [!WARNING]
>
> Die Grenze entscheidet allein darüber, ob überhaupt gerechnet wird. Steht sie auf null, findet keine Prüfung statt, selbst wenn ein Betrag hinterlegt ist.

## Woher die Werte stammen

Grenze und Betrag werden getrennt voneinander bestimmt. Für jeden der beiden gilt: Ist der Käufer angemeldet und steht in seinem Kundenkonto ein Wert, zählt dieser. Sonst zählt der Wert aus der Shopkonfiguration.

| Tag | Greift |
| - | - |
| `SURCHARGE-Limit_IsConfigDependent` | die Grenze stammt aus der Shopkonfiguration |
| `SURCHARGE-Limit_IsUserDependent` | die Grenze stammt aus dem Kundenkonto |
| `SURCHARGE-Value_IsConfigDependent` | der Betrag stammt aus der Shopkonfiguration |
| `SURCHARGE-Value_IsUserDependent` | der Betrag stammt aus dem Kundenkonto |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{SURCHARGE-Value_IsUserDependent}
   <p class="hinweis">Für Ihr Konto gilt ein gesonderter Mindermengenzuschlag.</p>
{/SURCHARGE-Value_IsUserDependent}
```

> [!WARNING]
>
> Grenze und Betrag können aus unterschiedlichen Quellen kommen. Steht im Kundenkonto nur eine abweichende Grenze, dann greift `SURCHARGE-Limit_IsUserDependent` und zugleich `SURCHARGE-Value_IsConfigDependent`. Formulieren Sie den Hinweistext entsprechend, denn "Sonderkonditionen" trifft diesen Mischfall nur halb.

Die vier Tags sind reine Klammerungen und schließen sich paarweise aus. Statt der negativen Klammerung von `_IsConfigDependent` nehmen Sie deshalb besser `_IsUserDependent`, das liest sich im Template verständlicher.

### Die technischen Codes

Zu jedem Paar gibt es ein Tag, das dieselbe Unterscheidung als Zahl ausgibt.

| Tag | Wert |
| - | - |
| `SURCHARGE-Limit_Code` | `0` aus der Shopkonfiguration, `1` kundenindividuell |
| `SURCHARGE-Value_Code` | `0` aus der Shopkonfiguration, `1` kundenindividuell |

Beide sind ausschließlich Einzel-Tags. Für eine Fallunterscheidung im Template nehmen Sie die vier Klammerungen, die Codes eignen sich eher für die Übergabe an eigene Skripte.

> [!WARNING]
>
> Der kundenindividuelle Wert greift auch dann, wenn er auf null steht. Ein Kundenkonto mit einem hinterlegten Zuschlag von `0,00` zahlt also keinen Mindermengenzuschlag, und `SURCHARGE-Value_IsUserDependent` greift trotzdem. Ein leeres Feld im Kundenkonto ist etwas anderes als eine hinterlegte Null, nur das leere Feld führt zurück auf die Shopkonfiguration.

## Wann der Zuschlag tatsächlich anfällt

Für die Formulierung der Texte im Template ist es hilfreich zu wissen, wie das Shopsystem rechnet. Drei Bedingungen müssen zugleich erfüllt sein.

| Bedingung | Bedeutung |
| - | - |
| Die Berechnungsgrundlage liegt **unter** der Grenze | genau auf der Grenze fällt kein Zuschlag an |
| Der Betrag ist größer als null | sonst gibt es nichts zu berechnen |
| Im Warenkorb liegt mindestens ein Produkt, das zur Grundlage zählt | sonst wird nichts aufgeschlagen |

> [!WARNING]
>
> Die Grenze wird nicht erreicht, sondern unterschritten. Wer genau den Betrag der Grenze bestellt, zahlt keinen Zuschlag.

Worauf sich die Grenze bezieht, steht im Parameter `SurchargeCalculation-Mode` der Shopkonfiguration. Bei `subtotal`, der Voreinstellung, ist es die Zwischensumme des Warenkorbs einschließlich aller Rabatte. Bei `totalsumofproducts` ist es die Summe der einzelnen Positionen, wobei Produkte übersprungen werden, die für den Mindermengenzuschlag ausgenommen sind.

Nur im Modus `totalsumofproducts` wirkt die produktseitige Ausnahme. Besteht ein Warenkorb ausschließlich aus ausgenommenen Produkten, zählt die Grundlage als leer, und es wird kein Zuschlag berechnet. Im Modus `subtotal` wird diese Ausnahme nicht ausgewertet.

Der Zuschlag wird kaufmännisch gerundet und mit einem eigenen Mehrwertsteuersatz in die Gesamtsumme eingerechnet. Welcher Satz das ist, steht in der Shopkonfiguration bei den globalen Kosten.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `SURCHARGE-Limit` | ja | ja | ja | – |
| `SURCHARGE-Limit_Code` | ja | – | – | – |
| `SURCHARGE-Limit_IsConfigDependent` | – | ja | ja | – |
| `SURCHARGE-Limit_IsUserDependent` | – | ja | ja | – |
| `SURCHARGE-Value` | ja | ja | ja | – |
| `SURCHARGE-Value_Code` | ja | – | – | – |
| `SURCHARGE-Value_IsConfigDependent` | – | ja | ja | – |
| `SURCHARGE-Value_IsUserDependent` | – | ja | ja | – |

Alle acht Tags sind auf allen Templates zulässig und an keinen Seitenzustand gebunden. Sie stehen damit auch auf der Produktseite oder im Kundenkonto zur Verfügung, nicht erst im Warenkorb.

## Verwandte Themen

* Wegweiser: [Mindermengenzuschlag](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/mindestbestellwert-und-mindermengenzuschlag.md#mindermengenzuschlag)
* Wegweiser: [Kundenkonto](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/kundenkonto.md)
* Referenz: BASKET- (Warenkorbsummen)
* Referenz: Die Parameter `Surcharge-Value`, `SurchargeLimit-Value` und `SurchargeCalculation-Mode` in der Shopkonfiguration


## Related topics

- [Mindestbestellwert und Mindermengenzuschlag](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/mindestbestellwert-und-mindermengenzuschlag.md)
- [Übersicht Bestelldaten](https://dokumentation.websale.de/v8s/materialien/uebersicht-bestelldaten.md)
- [Warenkorb anzeigen und löschen](https://dokumentation.websale.de/v8s/warenkorb/warenkorb-anzeigen-loeschen.md)
- [Warenkorbsummen](https://dokumentation.websale.de/v8s/referenz/tags/basket/warenkorbsummen.md)
- [Warenkorb und Bestellprozess](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/warenkorb-und-bestellprozess.md)


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