Der Shop unterstützt zwei Vorgehensweisen, um Gutscheinnummern automatisch zu generieren und in den Shop zu importieren. Entweder wird eine Gutscheinvorlage mittels des Online-Servicebereich-Dienstes Gutschein-Generator angelegt und es werden so Gutscheinnummern erzeugt, oder es werden Gutscheinnummern von einem externen Warenwirtschafts- oder ERP-System importiert.

Gutscheine im OSB-Dienst "Gutschein-Generator" anlegen

Mittels des Gutschein-Generators können Sie Gutscheine und Gutscheinvorlagen anlegen. Eine Gutscheinvorlage enthält alle wesentlichen Daten und Einstellungen für automatisch generierte Gutscheine, wie z. B.

▪Chargen-ID

▪Betrag (absolut oder prozentual)

▪Gutscheinnummer

▪Subshops, in denen der Gutschein eingelöst werden kann

▪Mindestbestellwert

▪Standard-Währung

▪MwSt.-Satz

▪Gültigkeitsdauer

▪eventuelle Einschränkungen (Zahl der Einlösungen, Kategorien, Produkte)

▪Ersteller der Gutschein-Charge (Referenz: VOUCHER-ChargeCreator)

▪Chargen-Label (Referenz: VOUCHER-ChargeLabel)

Gutscheine im Gutschein-Generator anlegen und Einlösen auf bestimmte Produkte beschränken

Wenn Sie das Einlösen von Gutscheinen auf bestimmte Produkte beschränken wollen, ist dies durch Eingabe einer kommagetrennten Liste von Produktnummern in das entsprechende Feld im Gutschein-Generator ohne weiteres möglich. Wenn die Liste sehr umfangreich ist, können Sie auch Platzhalter (Wildcards: *, ?) verwenden, um bestimmte Zeichenfolgen in den Produktnummern nicht von Hand mehrfach eingeben zu müssen. In diesem Fall muss vor die Produktnummer mit Wildcard ein "WC:" gesetzt werden, um der Shop-Software mitzuteilen, dass die folgende Produktnummer Platzhalterzeichen enthält.

Wie in der IT allgemein üblich, steht * für ein oder mehrere beliebige nachfolgende Zeichen, darf jedoch nur an letzter Stelle im String verwendet werden.

Beispiele (Produktnummern)

WC:PSCA* => Gutschein gilt für alle Produkte, deren Nummern mit "PSCA" beginnen, z. B. PSCA, PSCA1, PSCA8ZE5T).

WC:PS* => Gutschein gilt für alle Produkte, deren Nummern mit "PS" beginnen, z. B. PS, PS45GG, PS78RT21IG).

? steht für ein beliebiges Zeichen und kann ein- oder mehrmals an beliebiger Position verwendet werden.

Beispiele (Produktnummern):

WC:PS?A => Gutschein gilt für alle Produkte, deren Nummern 4-stellig sind, mit "PS" beginnen, mit A enden und an 3. Position einen beliebigen Buchstaben oder Ziffer haben, z. B. PSAA, PSZA, PS0A, PS5A.

WC:PS?? => Gutschein gilt für alle Produkte, deren Nummern 4-stellig sind, mit "PS" beginnen und mit zwei beliebigen Buchstaben oder Ziffern enden, z. B. PS12, PS1R, PSZZ.

WC:?C12 => Gutschein gilt für alle Produkte, deren Nummern mit einem beliebigem Buchstaben oder einer Ziffer beginnen, worauf C12 im Produktindex folgt, z. B. AC12, 2C12.

Auch Kombinationen von ? und * sind möglich.

Beispiele:

WC:PS?A* => Gutschein gilt für alle Produkte, deren Nummern mit "PS" beginnen, an dritter Stelle einen beliebigen Buchstaben oder Ziffer haben, nachfolgend ein A und danach beliebig lange Buchstaben- und Ziffernkombinationen, z. B. PSRA12A3E, PS7A532R64TI.

WC:?C* => Gutschein gilt für alle Produkte, deren Nummern mit einem beliebigem Buchstaben oder Ziffer beginnen, worauf ein "C" folgt und die danach beliebige Buchstaben- und Ziffernkombinationenn enthalten, z. B. 1C, 1CFG5DE, OC3, ZCGH567I.

Referenz: VOUCHER_CatProdFilter_data_type_isWildCard

Gutscheine aus einem Warenwirtschafts-/ERP-System importieren

Die Gutscheinnummern können von einem Warenwirtschafts-/ERP-System erzeugt und über eine Import-Schnittstelle in den Shop importiert werden. Da solche Gutscheine dann nicht im WEBSALE-Format vorliegen, müssen Sie vor einem Import im Abschnitt Voucher-Txt Ihrer Shopkonfiguration shop.config den Parametereintrag ExternalVouchers-Allow = yes hinzufügen.

Referenz: Abschnitt "Voucher-Txt" der shop.config

Näheres zur Konfiguration der Importdatei finden Sie in der SFTP-/SOAP-Schnittstellendokumentation unter https://doku.websale.de/schnittstellen.