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

# Gutscheine

> Gutscheine im Admin-Interface anlegen und verwalten: Gutschein-Chargen erstellen, Kaufgutscheinvorlagen für verkaufte Gutscheine anlegen und Gutscheinvorlagen wiederverwenden.

export const confGutscheine = "Marketing → Gutscheine";

Gutscheine werden im Admin-Interface unter dem Dienst {confGutscheine} angelegt und verwaltet. Auf dieser Seite wird beschrieben, wie ein Gutschein erstellt wird, welche Einstellungen dabei zur Verfügung stehen und welche Unterschiede es bei Kauf- und Werbegutscheinen gibt.

Die Seite [Praxisbeispiele Gutscheine](/gutscheine) beschreibt unter anderem, wie Gutscheine ins Template eingebunden werden können. Wie ein Produkt zu einem verkaufbaren Gutschein wird, ist unter [Kaufgutschein-Produkt anlegen](/admin-interface/katalog/produkte/kaufgutschein-produkt) beschrieben.

***

## Aufruf des Dienstes

Den Dienst erreichen Sie über folgende URL:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.<ihr-shop>.de/admin/vouchers
```

***

## Gutschein und Gutschein-Charge

Ein Gutschein ist der Code, den ein Kunde im Shop eilösen kann. Eine Gutschein-Charge regelt alles um den Gutschein herum, beispielsweise Wert, Währung, Gültigkeitszeitraum und Einlösebedingungen. Jeder Gutschein gehört zu genau einer Charge und erbt deren Einstellungen.<br /><br />Beim Anlegen eines Gutscheines entsteht daher immer eine Charge und, je nach Vorgangsweise, die Gutscheine darin.<br /><br />Die Charge wird über ihre ID angesprochen. Diese ID ist die einzige Angabe, mit der anderen Stellen im System auf eine Charge verweisen, beispielsweise ein Kaufgutschein-Produkt.

<Warning>
  Die Chargen-ID ist nicht die Bezeichnung der Charge. Wenn beim Anlegen keine ID eingetragen wird, vergibt das System eine fortlaufende Nummer wie beispielsweise "122".
</Warning>

***

## Die Bereiche der Gutscheinverwaltung

Der Dienst gliedert sich in drei Reiter mit folgenden Inhalten:

| Reiter                   | Inhalt                                                                              | Wofür                                                                                        |
| ------------------------ | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Gutscheine**           | Alle Gutschein-Chargen mit Bezeichnung, Chargen-ID, Anzahl, Gutscheinwert und Label | Übersicht der vorhandenen Gutschein-Chargen                                                  |
| **Kaufgutscheinvorlage** | Vorlagen, aus denen beim Kauf eines Kaufgutschein-Produkts Gutscheine entstehen     | Verkaufbare Gutscheine, siehe [Kaufgutscheinvorlage anlegen](#kaufgutscheinvorlage-anlegen). |
| **Gutscheinvorlagen**    | Wiederverwendbare Vorbelegungen der Eingabemaske                                    | Wiederkehrende Aktionen schneller anlegen                                                    |

<Frame caption="Screenshot Stand 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/gutscheine_drei_wege.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=f7d70d65232ad60614371b29a73726bc" alt="Gutscheine Drei Wege" width="1897" height="1014" data-path="images/gutscheine_drei_wege.png" />
</Frame>

<Note>
  In der Liste der Chargen ist die Spalte "Anzahl" das schnellste Erkennungsmerkmal. Steht dort eine Zahl größer als null, enthält die Charge fertige Gutscheincodes. Steht dort `0`, gehört die Charge zu einer Kaufgutscheinvorlage, deren Codes erst mit einer Bestellung entstehen.
</Note>

***

## Gutscheinarten

Beim Anlegen wird unter "Art des Gutscheins" zwischen zwei Arten unterschieden. Die getroffene Auswahl entscheidet darüber, auf welche Positionen der Gutschein wirkt.

| Art                | Wirkung                                                                                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Werbegutschein** | Wirkt nur auf Produkte, bei denen das Feld "Zulässig für Wertgutscheine" gesetzt ist. Damit lassen sich Warengruppen von Rabattaktionen ausnehmen.     |
| **Kaufgutschein**  | Wirkt als Zahlungsmittel auf alle Positionen und übergeht diese Einschränkung. Diese Einstellung gilt für verkaufte Gutscheine und Geschenkgutscheine. |

***

## Eine Gutschein-Charge anlegen

Über "+ Neuer Gutschein" öffnet sich eine Maske mit mehreren Abschnitten. Sie wird von oben nach unten ausgefüllt, die Abschnitte sind zugleich als Reiter erreichbar.

### Vorlage

Zunächst wird eine Gutscheinvorlage ausgewählt oder die Option "Ohne Vorlage" gewählt. Erst nach dieser Auswahl werden die weiteren Abschnitte angezeigt. Eine gewählte Vorlage belegt die entsprechenden Felder und sperrt die übrigen.

### Allgemeine Einstellungen

<Frame caption="Screenshot Stand 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/gutschein_neuer_gutschein_anlegen.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=31f188b39a2e2654436c58d2a4fbf213" alt="Gutschein Neuer Gutschein Anlegen" width="1906" height="1014" data-path="images/gutschein_neuer_gutschein_anlegen.png" />
</Frame>

| Feld                                                    | Bedeutung                                                                                                                                                                   |
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aktiv**                                               | Steuert, ob die Gutscheine der Charge eingelöst werden können.                                                                                                              |
| **Bezeichnung**                                         | Pflichtfeld. Name der Charge. Leerzeichen sind nicht erlaubt, das Feld wird sonst als fehlerhaft markiert.                                                                  |
| **Chargen-ID**                                          | Frei vergebbare ID der Charge. Bleibt das Feld leer, vergibt das System eine fortlaufende Nummer. Eine bereits vergebene ID wird abgelehnt.                                 |
| **Gutscheincode manuell festlegen**                     | Erlaubt die Eingabe eines eigenen Codes. Sinnvoll nur, wenn genau ein Gutschein erzeugt wird.                                                                               |
| **Gutscheincode**                                       | Der manuell vergebene Code. Ohne den Schalter darüber erzeugt das System die Codes selbst.                                                                                  |
| **Anzahl**                                              | Anzahl der zu erzeugenden Gutscheincodes. Für Kaufgutscheinvorlagen ohne Bedeutung, siehe [Kaufgutscheinvorlage anlegen](#kaufgutscheinvorlage-anlegen).                    |
| **Maximale Anzahl der Einlösungen festlegen**           | Begrenzt, wie oft ein Gutschein insgesamt eingelöst werden kann.                                                                                                            |
| **Gutschein von verschiedenen Kunden einlösbar**        | Erlaubt die Einlösung durch mehrere Kunden.                                                                                                                                 |
| **Maximale Anzahl der Einlösungen pro Kunde festlegen** | Begrenzt die Einlösungen je Kunde.                                                                                                                                          |
| **Art des Gutscheins**                                  | Pflichtfeld. Werbegutschein oder Kaufgutschein, siehe [Gutscheinarten](#gutscheinarten).                                                                                    |
| **Labels**                                              | Stichworte zur Charge. Über Labels wird gesteuert, welche Gutscheine sich in einer Bestellung miteinander kombinieren lassen. Ohne Eingabe setzt der Shop das Label selbst. |

### Gutscheinwert

Die Verrechnungsart legt fest, ob der Gutschein einen absoluten Betrag abzieht, einen prozentualen Rabatt gewährt oder einen prozentualen Rabatt bis zu einem Höchstbetrag gewährt.

Darunter steht für jede Währung eine Zeile mit Währung, Mehrwertsteuer-ID, Gutscheinwert und Mindestbestellwert. Über "Weitere Währung hinzufügen" können weitere Zeilen hinzugefügt werden. Ein Gutschein wirkt nur in Währungen, für die eine Zeile existiert.

In diesem Abschnitt befinden sich noch zwei weitere Einstellungen:

* **Restbetrag**: Bei "Restbetrag wiederverwendbar" bleibt ein nicht ausgeschöpfter Betrag erhalten und kann später erneut eingelöst werden. Bei "Restbetrag verfällt" ist der Gutschein nach der ersten Einlösung verbraucht.
* **kostenloser Versand**: Setzt bei Einlösung die Versandkosten auf null.

### Weitere Abschnitte

| Abschnitt                                        | Inhalt                                                                     |
| ------------------------------------------------ | -------------------------------------------------------------------------- |
| **Subshops**                                     | In welchen Subshops die Gutscheine gelten.                                 |
| **Zeitraum der Gültigkeit**                      | Beginn ab Generierung oder ab einem Datum, Ende offen oder zu einem Datum. |
| **Zielgruppe**                                   | Einschränkung auf Neukunden, Bestandskunden oder einzelne Kunden.          |
| **Produkte automatisch in den Warenkorb legen**  | Produkte, die beim Einlösen automatisch hinzugefügt werden.                |
| **Einlösebedingungen - Kategorien und Produkte** | Einschränkung der Gültigkeit auf bestimmte Kategorien oder Produkte.       |

### Speichern

Der Button "Gutschein generieren" ist ein geteilter Button. Der Pfeil daneben öffnet drei weitere Optionen. Die Auswahl entscheidet darüber, was tatsächlich generiert wird:

<Frame caption="Screenshot Stand 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/button_gutschein_generieren_geoeffnet.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=9cbb59bf423eabaf26a665ce5c685fc3" alt="Button Gutschein Generieren Geoeffnet" width="435" height="181" data-path="images/button_gutschein_generieren_geoeffnet.png" />
</Frame>

| Aktion                                           | Ergebnis                                                                        |
| ------------------------------------------------ | ------------------------------------------------------------------------------- |
| Gutschein generieren                             | Erzeugt die eingestellte Anzahl fertiger Gutscheincodes in einer neuen Charge.  |
| Gutschein generieren und schließen               | Wie oben, schließt danach die Maske.                                            |
| Gutschein generieren und als Vorlage speichern   | Wie oben, sichert die Eingaben zusätzlich als Gutscheinvorlage.                 |
| **Gutschein als Kaufgutscheinvorlage speichern** | Erzeugt keine Codes, sondern eine Kaufgutscheinvorlage samt zugehöriger Charge. |

***

## Kaufgutscheinvorlage anlegen

Eine Kaufgutscheinvorlage ist die Grundlage für Gutscheine, die im Shop verkauft werden. Sie enthält selbst keine Codes. Diese entstehen erst, wenn ein Kunde ein [Kaufgutschein-Produkt](/admin-interface/katalog/produkte/kaufgutschein-produkt) bestellt, und zwar einer je bestellter Einheit.

Die Vorlage wird in derselben Maske angelegt wie eine gewöhnliche Charge:

<Steps>
  <Step title="Bezeichnung und Chargen-ID vergeben">
    Die Bezeichnung wird zur Kaufgutscheinvorlagen-ID. Die Chargen-ID sollte manuell und sprechend vergeben werden, beispielsweise `geschenkgutschein`, denn genau dieser Wert wird später am Produkt eingetragen. Bleibt das Feld leer, muss die erzeugte Nummer hinterher in der Liste gesucht werden.
  </Step>

  <Step title="Art des Gutscheins auf Kaufgutschein stellen">
    Verkaufte Gutscheine sind ein Zahlungsmittel und sollen unabhängig davon wirken, ob einzelne Produkte für Wertgutscheine freigegeben sind.
  </Step>

  <Step title="Gutscheinwert absolut, aber ohne Betrag">
    Die Verrechnungsart ist auf "absolut" eingestellt, der Gutscheinwert bleibt bei `0`. Den tatsächlichen Wert setzt der Preis des verkauften Produkts. Die Charge sollte nur eine Währung führen. Beim Restbetrag ist "Restbetrag wiederverwendbar" die richtige Wahl, sonst verfällt bei einer Teileinlösung der Rest des gekauften Guthabens.
  </Step>

  <Step title="Über das Pfeilmenü speichern">
    Im Menü neben "Gutschein generieren" den Eintrag "**Gutschein als Kaufgutscheinvorlage speichern"** wählen. Der Hauptknopf würde stattdessen fertige Gutscheincodes anlegen, die ein Kaufgutschein-Produkt nicht verwenden kann.
  </Step>
</Steps>

Nach dem Speichern steht der Eintrag im Reiter Kaufgutscheinvorlage mit Vorlagen-ID und Chargen-ID bereit. Dieselbe Charge erscheint zusätzlich im Reiter Gutscheine mit der Anzahl `0`.

<Frame caption="Screenshot Stand 01.09.2026">
  <img src="https://mintcdn.com/websaleag-44ee7ea6/cF4ADxA5wsk-HyAI/images/kaufgutscheinvorlage_erstellt.png?fit=max&auto=format&n=cF4ADxA5wsk-HyAI&q=85&s=91a7469042a0b1a99e7132aa75da2735" alt="Kaufgutscheinvorlage Erstellt" width="1900" height="1020" data-path="images/kaufgutscheinvorlage_erstellt.png" />
</Frame>

Der nächste Schritt zur Erstellung eines Kaufgutscheins ist die Produktseite → [Kaufgutschein-Produkt anlegen](/admin-interface/katalog/produkte/kaufgutschein-produkt).

***

## Gutscheinvorlagen

Mit einer Gutscheinvorlage werden die Eingaben der Maske gespeichert, sodass wiederkehrende Aktionen nicht jedes Mal neu ausgefüllt werden müssen. Sie wird über den Eintrag "Gutschein generieren und als Vorlage speichern" angelegt und steht anschließend im Abschnitt "Vorlage" oben zur Auswahl.

Vorlagen wirken nur beim Anlegen. Eine geänderte oder gelöschte Vorlage hat keinen Einfluss auf bereits erzeugte Chargen und Gutscheine.

***

## Anzeige im Shop

Wie Gutscheine im Shop erscheinen, bestimmt das Template. Im Admin-Interface gibt es dafür keine Einstellungen.

* Das Eingabefeld für den Gutscheincode, die Liste der eingelösten Gutscheine und die Fehlertexte werden im Template ausgegeben. Beispiele dazu stehen in den [Praxisbeispielen Gutscheine](/gutscheine).
* Welche Daten dabei zur Verfügung stehen, beschreibt das Modul [\$wsVoucher](/frontend/referenz/module/wsvoucher).
* Verkaufte Gutscheine erscheinen nicht über dieses Modul, sondern am Warenkorbartikel, siehe [Kaufgutschein-Produkt anlegen](/admin-interface/katalog/produkte/kaufgutschein-produkt).

***

## Begriffe und technische Namen

| Konzept                          | Admin-Interface      | Schnittstelle        |
| -------------------------------- | -------------------- | -------------------- |
| Gruppe von Gutscheinen           | Gutschein-Charge     | `vouchers/charges`   |
| Einzelner Code                   | Gutschein            | `vouchers`           |
| Vorlage für verkaufte Gutscheine | Kaufgutscheinvorlage | `vouchers/templates` |
| Vorbelegung der Eingabemaske     | Gutscheinvorlage     | `vouchers/presets`   |
| Verweis auf eine Charge          | Chargen-ID           | `chargeId`           |

***

## Wegweiser

* [Kaufgutschein-Produkt anlegen](/admin-interface/katalog/produkte/kaufgutschein-produkt) beschreibt den zweiten Teil des Ablaufs.
* [API-Referenz Gutscheine](/schnittstellen/admin-interface-api/api-referenz-gutscheine) beschreibt dieselben Objekte über die Schnittstelle.
* [Praxisbeispiele Gutscheine](/gutscheine) zeigt das Einlösen im Shop-Template.
* [checkout - Bestellablauf](/konfiguration/checkout-bestellablauf) beschreibt die Einstellungen zum Einlösen im Bestellablauf.


## Related topics

- [Daten-Migration](/migration/daten-migration.md)
- [Praxisbeispiele - Gutscheine](/gutscheine.md)
- [API-Referenz Gutscheine](/schnittstellen/admin-interface-api/api-referenz-gutscheine.md)
- [Storefront API Gutscheine](/schnittstellen/storefront-api/storefront-api-gutscheine.md)
- [$wsVoucher - Gutscheine](/frontend/referenz/module/wsvoucher.md)