> ## 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 anlegen oder importieren > Gutscheinnummern mit dem Gutschein-Generator im Online-Servicebereich erzeugen oder aus einem Warenwirtschaftssystem importieren, inklusive Produktfilter mit Platzhaltern. Damit ein Kunde einen Gutscheincode eingeben kann, müssen die Codes zuerst im Shop bekannt sein. Dafür gibt es zwei Wege, und Sie entscheiden sich einmal für einen davon. | Weg | Wann sinnvoll | | - | - | | Gutschein-Generator im Online-Servicebereich | Sie erzeugen die Codes im Shopsystem selbst und steuern alle Bedingungen dort | | Import aus einem Warenwirtschafts- oder ERP-System | die Codes entstehen bereits in Ihrem Vorsystem, beispielsweise weil dort auch der stationäre Handel abgerechnet wird | ## Gutscheine im Gutschein-Generator anlegen Der Gutschein-Generator erzeugt Gutscheine immer aus einer Gutscheinvorlage. Die Vorlage hält alle Eigenschaften fest, die für die erzeugten Gutscheine gelten sollen, sodass Sie sie nicht für jeden einzelnen Code wiederholen müssen. | Angabe | Wofür sie steht | | - | - | | Chargen-ID | fasst alle aus dieser Vorlage erzeugten Gutscheine zu einer Charge zusammen | | Betrag | absolut oder prozentual | | Gutscheinnummer | das Format der erzeugten Codes | | Subshops | in welchen Subshops der Gutschein eingelöst werden darf | | Mindestbestellwert | ab welchem Warenwert der Gutschein greift | | Standard-Währung | die Währung, in der der Betrag gilt | | Mehrwertsteuersatz | der für den Gutschein anzusetzende Satz | | Gültigkeitsdauer | Beginn und Ende der Gültigkeit | | Einschränkungen | Zahl der Einlösungen, Kategorien, Produkte | | Ersteller der Charge | wer die Charge angelegt hat | | Chargen-Label | eine frei vergebene Bezeichnung für die Charge | Referenz: [VOUCHER-ChargeCreator](https://dokumentation.websale.de/v8s/referenz/tags/voucher-gutschein.md#nummer-charge-und-wahrung) · [VOUCHER-ChargeLabel](https://dokumentation.websale.de/v8s/referenz/tags/voucher-gutschein.md#nummer-charge-und-wahrung) Ersteller und Chargen-Label sind nicht nur Verwaltungsangaben. Beide lassen sich im Template ausgeben und eignen sich dafür, Aktionen auseinanderzuhalten, wenn mehrere Chargen gleichzeitig im Umlauf sind. ## Das Einlösen auf bestimmte Produkte beschränken Soll ein Gutschein nur für einen Teil Ihres Sortiments gelten, tragen Sie im Gutschein-Generator eine kommagetrennte Liste von Produktnummern in das dafür vorgesehene Feld ein. Neben Produktnummern kennt der Filter auch Produktindizes und Kategorieindizes. Bei umfangreichen Sortimenten wird eine solche Liste schnell unhandlich. Deshalb lassen sich Platzhalter verwenden, die eine ganze Gruppe von Nummern auf einmal treffen. ### Platzhalter kennzeichnen Ein Eintrag mit Platzhaltern muss das Präfix `WC:` tragen. Ohne dieses Präfix vergleicht der Shop den Eintrag Zeichen für Zeichen, und `*` sowie `?` gelten dann als gewöhnliche Zeichen der Produktnummer. ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} PSCA Vergleich auf genau diese Produktnummer WC:PSCA* Vergleich mit Platzhalter ``` ### Die beiden Platzhalter | Zeichen | Bedeutung | Position | | - | - | - | | `?` | genau ein beliebiges Zeichen | an jeder Stelle, auch mehrfach | | `*` | kein, ein oder beliebig viele weitere Zeichen | **nur am Ende** | `*` steht auch für gar kein Zeichen. `WC:PSCA*` trifft deshalb sowohl `PSCA1` als auch `PSCA` selbst. `?` verlangt ein vorhandenes Zeichen. Endet ein Muster nicht auf `*`, müssen Muster und Produktnummer gleich lang sein. `WC:PS?A` trifft also niemals eine dreistellige Nummer. Der Vergleich beachtet die Groß- und Kleinschreibung nicht. `WC:ps*` und `WC:PS*` treffen dieselben Produkte. > [!WARNING] > > Setzen Sie `*` nicht an das Ende, bricht der Shop nicht ab, sondern behandelt ab dieser Stelle **alles als Treffer**. Ein Muster wie `WC:PS*A` wirkt damit wie `WC:PS*` und macht den Gutschein für weit mehr Produkte gültig als beabsichtigt. Im Protokoll erscheint dazu ein Fehlereintrag, im Shop fällt es niemandem auf. Prüfen Sie jedes Muster daraufhin, dass `*` das letzte Zeichen ist. ### Beispiele | Muster | Trifft | Beispiele | | - | - | - | | `WC:PSCA*` | alle Nummern, die mit `PSCA` beginnen | `PSCA`, `PSCA1`, `PSCA8ZE5T` | | `WC:PS*` | alle Nummern, die mit `PS` beginnen | `PS`, `PS45GG`, `PS78RT21IG` | | `WC:PS?A` | vierstellige Nummern, die mit `PS` beginnen, an dritter Stelle ein beliebiges Zeichen haben und auf `A` enden | `PSAA`, `PSZA`, `PS0A`, `PS5A` | | `WC:PS??` | vierstellige Nummern, die mit `PS` beginnen | `PS12`, `PS1R`, `PSZZ` | | `WC:?C12` | vierstellige Nummern mit beliebigem ersten Zeichen, gefolgt von `C12` | `AC12`, `2C12` | | `WC:PS?A*` | Nummern, die mit `PS` beginnen, an dritter Stelle ein beliebiges Zeichen und an vierter ein `A` haben, danach beliebig weiter | `PSRA12A3E`, `PS7A532R64TI` | | `WC:?C*` | Nummern mit beliebigem ersten Zeichen, gefolgt von `C` und beliebig weiter | `1C`, `1CFG5DE`, `0C3`, `ZCGH567I` | Referenz: [VOUCHER-CatProdFilter\_data\_type\_isWildCard](https://dokumentation.websale.de/v8s/referenz/tags/voucher-gutschein.md#produkt-und-kategoriefilter) ### Positivliste und Negativliste Der Filter kennt zwei Richtungen. Ein gewöhnlicher Eintrag ist eine Positivliste: Der Gutschein greift nur, wenn mindestens eine Warenkorbposition auf einen der Einträge passt. Ein Eintrag mit vorangestelltem `!` ist eine Negativliste und schließt aus. ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} PSCA*, !PSCA9* ``` Der Ausschluss hat Vorrang. Passt eine Position auf einen negativen Eintrag, ist der Gutschein für sie nicht anwendbar, auch wenn sie zugleich auf einen positiven Eintrag passt. Der Grund ist, dass eine ausdrückliche Ausnahme immer gewollt ist, während eine Positivliste oft weit gefasst wird. > [!WARNING] > > Enthält der Warenkorb keine einzige passende Position, lehnt der Shop den Gutschein ab und meldet, dass der Warenkorb nicht zum Gutschein passt. Das ist der häufigste Grund für Rückfragen zu vermeintlich defekten Aktionscodes. Testen Sie einen produktabhängigen Gutschein deshalb immer mit einem Warenkorb, der wirklich passt, und mit einem, der nicht passt. ## Gutscheine aus einem Warenwirtschafts- oder ERP-System importieren Erzeugt Ihr Vorsystem die Gutscheinnummern, werden diese über eine Import-Schnittstelle in den Shop übernommen. Solche Nummern liegen in der Regel nicht im WEBSALE-Format vor, deshalb muss der Shop das zulassen. Ergänzen Sie dafür in der Shopkonfiguration `shop.config` im Abschnitt `` den folgenden Eintrag. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ExternalVouchers-Allow = yes ``` > [!WARNING] > > Setzen Sie diesen Eintrag **vor** dem ersten Import. Ohne ihn weist der Shop Nummern zurück, die nicht seinem eigenen Format entsprechen. Referenz: [Abschnitt Voucher-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/preise-steuern-und-waehrung.md#voucher-txt) ## Verwandte Themen * Wegweiser: [Gutscheine anbieten: Übersicht](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md) * Wegweiser: [Gutschein-Eingabe vorsehen](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutschein-eingabe-vorsehen.md) * Referenz: [VOUCHER-](https://dokumentation.websale.de/v8s/referenz/tags/voucher-gutschein.md) ## Related topics - [Prozentuale Gutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/prozentuale-gutscheine.md) - [Newsletter-Gutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/newsletter-gutscheine.md) - [Neukunden-Gutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/neukunden-gutscheine.md) - [Gutscheine mit mehreren Währungen](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-mit-mehreren-waehrungen.md) - [Gutscheine abhängig von Produktdaten](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-abhaengig-von-produktdaten.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.