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

# Zuschüsse gewähren

> Einzelnen Kunden ein Guthaben auf einem Zuschusskonto gutschreiben, das der Shop von der Endsumme abzieht und über mehrere Bestellungen hinweg fortschreibt.

Ein Zuschuss ist ein Guthaben, das Sie einem einzelnen Kunden in der Kundendatenbank hinterlegen. Der Shop zieht es im Warenkorb von der Endsumme ab. Was nicht verbraucht wird, bleibt für die nächste Bestellung stehen.

Damit lassen sich Prämien, Gutschriften, Boni und ähnliche Vergünstigungen abbilden, ohne für jeden Fall einen Gutschein auszustellen. Der Unterschied zum Gutschein: Der Zuschuss hängt am Kundenkonto, nicht an einem Code, und der Kunde muss nichts eingeben.

## Wie der Zuschuss verrechnet wird

| Schritt | Was geschieht |
| - | - |
| Der Kunde legt Produkte in den Warenkorb | Der Shop liest das Zuschussguthaben aus dem Kundenkonto |
| Das Guthaben ist kleiner als die Endsumme | Das gesamte Guthaben wird abgezogen, der Kunde zahlt die Differenz |
| Das Guthaben ist größer als die Endsumme | Es wird nur so viel abgezogen, wie die Bestellung kostet |
| Nach der Bestellung | Der verbrauchte Betrag geht in die Bestelldaten, der Rest bleibt auf dem Konto |

Der Shop zieht nie mehr ab, als die Bestellung kostet. Eine Bestellsumme unter null kann dadurch nicht entstehen.

> [!WARNING]
>
> Das Verrechnen und das Fortschreiben des Kontos sind zwei verschiedene Dinge. Der Shop rechnet den Zuschuss in der Bestellung an und schreibt den verbrauchten sowie den verbleibenden Betrag in die Bestelldaten. Den Kontostand selbst pflegen Sie über den Kundenimport. Prüfen Sie deshalb, dass Ihr Warenwirtschaftssystem die Werte aus den Bestelldaten auch zurückschreibt, sonst behält der Kunde sein volles Guthaben.

## Voraussetzung

Der Zuschuss kommt aus dem Kundenimportmodul. Sprechen Sie mit Ihrem WEBSALE Ansprechpartner, wenn Sie es noch nicht einsetzen.

## Schritt 1: Die Funktion in der Shopkonfiguration aktivieren

Ergänzen Sie in der `shop.config` den Abschnitt `CustomerSubvention`.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<CustomerSubvention>
   Allow         = yes
   Name-Txt      = Zuschuss
   Remainder-Txt = Verfügbarer Zuschuss für Ihre nächste Bestellung:
   VATType       = static
</CustomerSubvention>
```

| Parameter | Bedeutung |
| - | - |
| `Allow` | mit `yes` ist die Funktion aktiv |
| `Name-Txt` | Bezeichnung des verrechneten Zuschusses in den Bestelldaten |
| `Remainder-Txt` | Bezeichnung des verbleibenden Guthabens in den Bestelldaten |
| `VATType` | `static` oder `dynamic`. Steuert, ob die Mehrwertsteuer des Zuschusses statisch oder dynamisch berechnet wird. Ohne Angabe gilt `static` |

`Name-Txt` und `Remainder-Txt` sind keine Template-Texte. Der Shop schreibt sie als Bezeichner in die Bestelldaten, neben den jeweiligen Betrag. Ihr Warenwirtschaftssystem und Ihre Bestellbestätigung greifen darauf zu. Die Texte im Template schreiben Sie in Schritt 2 selbst.

Referenz: [Abschnitt CustomerSubvention](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/preise-steuern-und-waehrung.md#customersubvention)

## Schritt 2: Den Kontostand im Template anzeigen

Zwei Tags geben Auskunft über das Guthaben.

| Tag | Inhalt |
| - | - |
| `WS-SubventionAccount` | das gesamte Guthaben des Kunden vor dieser Bestellung |
| `WS-SubventionRemainder` | das Guthaben, das nach dieser Bestellung übrig bleibt |
| `BASKET-SubventionRest` | ebenfalls das verbleibende Guthaben, greift als Klammerung aber nur, wenn tatsächlich etwas übrig bleibt |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-SubventionAccount}
   Ihr Zuschussguthaben: ~WS-SubventionAccount~ ~WS-Currency~
{/WS-SubventionAccount}

{BASKET-SubventionRest}
   Für Ihre nächste Bestellung bleiben: ~BASKET-SubventionRest~ ~WS-Currency~
{/BASKET-SubventionRest}
```

> [!WARNING]
>
> Verwenden Sie für den verbleibenden Betrag `BASKET-SubventionRest` und nicht `WS-SubventionRemainder`. Als Klammerung prüft `WS-SubventionRemainder` nämlich, ob der Kunde **überhaupt** ein Guthaben hat, nicht ob nach dieser Bestellung noch etwas übrig ist. Wer sein ganzes Guthaben verbraucht, liest dann "Für Ihre nächste Bestellung bleiben: 0,00 EUR". `BASKET-SubventionRest` greift nur bei einem echten Rest.

Als Einzeltag liefern beide Tags denselben Betrag. Der Unterschied liegt ausschließlich im Verhalten als Klammerung. Wenn Sie den Betrag ohnehin unbedingt ausgeben wollen, ist `WS-SubventionRemainder` unproblematisch.

Beide Tags stoßen bei Bedarf die Summenberechnung an. Sie können sie deshalb auch auf Seiten einsetzen, auf denen der Warenkorb noch nicht gerechnet wurde.

Referenz: [WS-SubventionAccount](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md#die-tags-im-uberblick) · [WS-SubventionRemainder](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md#zuschusse) · [BASKET-SubventionRest](https://dokumentation.websale.de/v8s/referenz/tags/basket/warenkorbsummen.md#abzuge)

## Schritt 3: Zuschüsse je Kunde hinterlegen

Das Guthaben steht im Kundenkonto im Feld `Subvention` und wird über den Kundenimport gesetzt. Den Namen des Import-Parameters entnehmen Sie der Kundenimport-Dokumentation.

Ein Zuschuss gilt genau für den Kunden, in dessen Konto er steht. Gastbesteller haben kein Konto und können deshalb keinen Zuschuss erhalten.

## Was in den Bestelldaten ankommt

Ist die Funktion aktiv, schreibt der Shop zu jeder Bestellung diese Felder.

| Feld | Inhalt |
| - | - |
| `CustomerSubvention` | der in dieser Bestellung verrechnete Betrag |
| `CustomerSubventionVATRate` | der zugehörige Mehrwertsteuersatz |
| `CustomerSubventionVATIndex` | der zugehörige Steuersatz-Index |
| `CustomerSubvention_DName` | der Text aus `Name-Txt` |
| `CustomerSubvention_DValue` | der verrechnete Betrag formatiert und mit Minuszeichen |
| `CustomerSubventionRemainder` | das verbleibende Guthaben |
| `CustomerSubventionRemainder_DName` | der Text aus `Remainder-Txt` |
| `CustomerSubventionRemainder_DValue` | das verbleibende Guthaben formatiert |

Die vier Felder mit `_DName` und `_DValue` erscheinen nur, wenn der jeweilige Betrag ungleich null ist. Ein Kunde ohne verbleibendes Guthaben erzeugt also kein `CustomerSubventionRemainder_DName`. Wenn Ihr Warenwirtschaftssystem diese Felder auswertet, muss es mit ihrem Fehlen umgehen können.

Die drei Zahlenfelder ohne Namenszusatz werden dagegen immer geschrieben, auch mit dem Wert 0,00.

## Verwandte Themen

* Wegweiser: [Bonuspunkte](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md#bonuspunkte)
* Wegweiser: [Gutscheine anbieten: Übersicht](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md)


## Related topics

- [Warenkorb, Preise, Währung und Bonus](https://dokumentation.websale.de/v8s/referenz/tags/ws/warenkorb-preise-waehrung-und-bonus.md)
- [Warenkorbsummen](https://dokumentation.websale.de/v8s/referenz/tags/basket/warenkorbsummen.md)
- [Preise, Steuern und Währung](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/preise-steuern-und-waehrung.md)
- [Weitere Import-Dateien](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-sftp-kunden-pro/weitere-import-dateien.md)
- [Anmeldung & Benutzerverwaltung von strapi](https://dokumentation.websale.de/strapi-cms/anmeldung-benutzerverwaltung-von-strapi.md)


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