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

# Neukunden-Gutscheine

> Einen Gutschein ausgeben, den nur Neukunden für ihre Erstbestellung einlösen können, und festlegen, wer im Shop als Neukunde gilt.

Ein Neukunden-Gutschein belohnt die erste Bestellung. Technisch ist er ein Universal-Gutschein, dem beim Anlegen die Einschränkung "nur für Neukunden" mitgegeben wird. Der Code kann beliebig verbreitet werden, einlösen kann ihn aber nur, wer im Shop noch nicht gekauft hat.

Die eigentliche Arbeit steckt in einer einzigen Frage: Wer gilt in Ihrem Shop überhaupt als Neukunde? Davon hängt ab, ob die Aktion funktioniert oder ob sie genau die Leute aussperrt, die sie erreichen soll.

## Wer als Neukunde gilt

Der Shop kennt zwei Definitionen. Welche gilt, legen Sie in der Konfiguration fest.

| Definition | Kriterium | Wann sie passt |
| - | - | - |
| `NoCustomerNumber` (Voreinstellung) | Der Kunde hat noch keine Kundennummer | Shops ohne angebundenes Warenwirtschaftssystem, in denen die Kundennummer erst mit der ersten Bestellung entsteht |
| `NoOrder` | Für den Kunden liegt noch keine Bestellung vor | Shops mit Warenwirtschaftssystem, das Kundennummern unabhängig von Bestellungen vergibt |

### Warum die Voreinstellung mit einem Warenwirtschaftssystem zum Problem wird

Manche Interessenten melden sich im Shop an, bestellen aber nicht sofort. Ist ein Warenwirtschaftssystem angebunden, kann dieses dem Konto bereits eine Kundennummer zuweisen, ohne dass je eine Bestellung stattgefunden hat.

Bei der Voreinstellung `NoCustomerNumber` genügt das, damit der Shop den Interessenten als Bestandskunden einstuft. Wenn er dann Wochen später mit seinem Gutschein wiederkommt, wird der Gutschein abgelehnt, obwohl er noch nie etwas gekauft hat.

`NoOrder` löst genau diesen Fall: Der Shop prüft dann nicht die Kundennummer, sondern ob für den Kunden bereits eine Bestellung vorliegt. Ist das nicht der Fall, bleibt er Neukunde und kann den Gutschein bei seiner Erstbestellung einlösen.

> [!WARNING]
>
> Ohne Warenwirtschaftssystem ändert `NoOrder` praktisch nichts, mit einem angebundenen System ist es meist die einzig brauchbare Einstellung. Prüfen Sie vor dem Start einer Neukunden-Aktion, wann in Ihrem Zusammenspiel die Kundennummer entsteht. Läuft die Aktion erst einmal, melden sich nur die wenigsten Betroffenen. Die meisten brechen ab.

Für beide Definitionen muss der Kunde angemeldet sein. Ohne Anmeldung kann der Shop weder Kundennummer noch Bestellhistorie prüfen und lehnt den Gutschein mit dem Hinweis ab, dass eine Anmeldung erforderlich ist.

## Voraussetzungen

**Der Gutschein-Generator muss freigeschaltet sein.** Wollen Sie ihn nutzen, wenden Sie sich an Ihren WEBSALE-Ansprechpartner.

Kommen die Gutscheine aus einem externen System und liegen deshalb nicht im WEBSALE-Format vor, ergänzen Sie im Abschnitt `<Voucher-Txt>` der `shop.config` den Eintrag `ExternalVouchers-Allow = yes`.

**Die Gutscheineingabe muss im Shop integriert sein.** Bietet Ihr Shop noch keine Gutscheine an, fehlt das Eingabefeld auf der Warenkorbseite `ws_basket.htm` und der Bestellübersichtsseite `ws_place_order.htm`.

Wegweiser: [Gutschein-Eingabe vorsehen](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutschein-eingabe-vorsehen.md)

## Schritt 1: Die Neukunden-Definition festlegen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Voucher-Txt>
   NewCustomerDefinition = NoOrder
</Voucher-Txt>
```

Erkennt der Shop den Wert nicht, verwendet er `NoCustomerNumber`. Ein Tippfehler fällt deshalb nicht als Fehler auf, sondern schaltet stillschweigend auf die Voreinstellung zurück. Prüfen Sie die Schreibweise.

> [!WARNING]
>
> Die Einstellung gilt für den gesamten Shop, nicht je Gutschein oder je Charge. Sie können nicht eine Aktion nach Kundennummer und eine andere nach Bestellhistorie prüfen lassen.

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

## Schritt 2: Den Gutschein anlegen

Legen Sie den Gutschein im Gutschein-Generator im Online-Servicebereich als Universal-Gutschein an und wählen Sie dort die Einschränkung auf Neukunden.

Wegweiser: [Gutscheine anlegen oder importieren](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anlegen-oder-importieren.md)

## Schritt 3: Die passenden Fehlermeldungen hinterlegen

Ein Neukunden-Gutschein wird häufiger abgelehnt als ein gewöhnlicher, einfach weil die Bedingung enger ist. Ohne hinterlegte Texte sieht der Kunde eine leere Meldung und weiß nicht, warum sein Code nicht angenommen wird.

Für Neukunden-Gutscheine sind vier Ablehnungsgründe einschlägig.

| Grund | Wann er auftritt |
| - | - |
| 9 | kundenspezifischer Gutschein nur für Neukunden, der Kunde ist keiner |
| 10 | kundenspezifischer Neukundengutschein, der Kunde ist nicht angemeldet |
| 11 | Gutschein nur für Neukunden, der Kunde ist keiner |
| 12 | Gutschein nur für Neukunden, der Kunde ist nicht angemeldet |

Die Gründe 10 und 12 sind die wichtigsten. Sie treffen jeden, der den Code eingibt, bevor er sich anmeldet, und das ist der Regelfall bei einer Werbeaktion. Der Text sollte deshalb nicht nur die Ablehnung nennen, sondern zur Anmeldung führen.

Wegweiser: [Gutschein-Eingabe vorsehen, Abschnitt "Meldungen platzieren"](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutschein-eingabe-vorsehen.md)

## Verwandte Themen

* Wegweiser: [Gutscheine anbieten: Übersicht](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md)
* Wegweiser: [Gutscheine anlegen oder importieren](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anlegen-oder-importieren.md)
* Wegweiser: [Gutschein-Eingabe vorsehen](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutschein-eingabe-vorsehen.md)
* Wegweiser: [Universal- und Werbegutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md)


## Related topics

- [Newsletter-Gutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/newsletter-gutscheine.md)
- [Gutscheine anbieten: Übersicht](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md)
- [Gutscheine](https://dokumentation.websale.de/admin-interface/marketing/gutscheine.md)
- [WS-SFTP-Gutscheindaten (to-Shop)](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-sftp-gutscheindaten-to-shop.md)
- [Gutschein-Eingabe vorsehen](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutschein-eingabe-vorsehen.md)


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