Gutschein-Eingabe vorsehen
Inhalt
1.2 Einkauf im stationären Handel mit Gutschein aus dem Onlineshop
2 Integration der Gutschein-Eingabe
3.1 Bestellabschluss mit nicht anwendbaren Gutscheinen unterbinden
1.1 Einlösen im Onlineshop
Sowohl auf der Warenkorbseite (ws_basket.htm) als auch auf der Bestellübersichtsseite (ws_place_order.htm) können Kunden Ihres Shops Gutscheinnummern eingeben. Die Gutscheinnummer wird von WEBSALE V8s geprüft, wenn der Kunde auf den Button "Gutschein einlösen" klickt und den Gutschein damit aktiviert. Dieses Aktivieren des Gutscheins ist unerlässlich, da der Gutschein ansonsten im weiteren Bestellablauf ignoriert wird.
Hat der Käufer eine ungültige Gutscheinnummer eingegeben, so wird er mit einer entsprechenden Meldung darauf hingewiesen. Mithilfe des Buttons "Gutschein entfernen" kann die ungültige Gutscheinnummer aus dem Eingabefeld entfernt werden. Danach kann der Kunde eine andere Gutscheinnummer eingeben oder seine Bestellung ohne Gutschein fortsetzen.
Waren Eingabe und Prüfung der Gutscheinnummer erfolgreich, kann der Kunde seine Bestellung fortsetzen. Die Ersparnis durch den Gutschein bzw. das zugesteuerte Produkt ist für den Kunden sofort sichtbar. Möchte der Kunde seinen Gutschein doch nicht für diese Bestellung verwenden, können Sie ihm sowohl auf der Warenkorbseite (ws_basket.htm) als auch auf der Bestellübersichtsseite (ws_place_order.htm) einen "Gutschein entfernen"-Button anbieten.
Versucht der Käufer, einen personalisierten Gutschein einzulösen, ohne angemeldet zu sein, kann ihm ein Login-Formular innerhalb der Fehlermeldung angezeigt werden. Nach erfolgreicher Anmeldung kann der Käufer automatisch wieder auf die Warenkorbseite geleitet werden, um den Gutschein erneut einzugeben.
Die Funktion, mehrerer Gutscheine einlösen zu können, wird in diesem Wegweiser erklärt:
Wegweiser: Mehrere Gutscheine einlösen
Gutscheinnummern per Link übertragen
Eine Gutscheinnummer kann bereits beim Aufruf von WEBSALE V8s im URL-Parameter voucher_number angegeben werden, z. B. über einen Link aus einem Newsletter. Diese Gutscheinnummer wird dann automatisch in das Eingabefeld "Gutschein einlösen" während des Checkout-Prozesses eingetragen. Wenn der Kunde den Button "Gutschein einlösen" klickt, wird die Nummer geprüft und übernommen.
Der Parameter wird als &voucher_number oder ?voucher_number an die Shop-URL angehängt, je nachdem, an welcher Stelle er in der URL steht. Näheres dazu siehe Materialien: URL-Parameter.
Beispiel: http://www.xyz.de/?voucher_number=123456
Referenz: Newsletter-Gutscheine
1.2 Einkauf im stationären Handel mit Gutschein aus dem Onlineshop
WEBSALE V8s bietet Ihnen als Händler die Möglichkeit, Gutscheinnummern als Barcodes auf den Gutscheinen auszudrucken. Diese Barcodes können dann an der Kasse im stationären Shop eingescannt werden. Der Barcode wird durch das Tag WS-BarcodeURL als Bild erzeugt. Dieses Tag kann grundsätzlich auf jedem Template integriert werden. Wo Sie das Tag konkret platzieren, hängt davon ab, welche Art von Gutscheinen Sie im Shop anbieten wollen (Kaufgutscheine, Newsletter-Gutscheine, Neukunden-Gutscheine …).
Beispiel:
<img src="~WS-BarcodeURL($INSTANTVOUCHER-VoucherNumber$,TYPE_CODE_128_A,3,JPG)~">
Referenz: WS-BarcodeURL
2 Integration der Gutschein-Eingabe im Shop
Achtung: |
|
|
Für die Integration von Gutschein-Features gibt es neue Tags ( |
Die Integration der Gutscheineingabe umfasst die folgenden Schritte:
Schritt 1: Freischaltung des Gutschein-Generators
Falls Sie den Gutschein-Generator nutzen wollen, muss dieser zunächst freigeschaltet werden. Bitte wenden Sie sich dazu an Ihren WEBSALE-Ansprechpartner.
Hinweis: |
|
|
Wenn Sie Gutscheine verwenden wollen, die von einem externen System generiert werden (und deshalb nicht im WEBSALE-Format vorliegen), müssen Sie im Abschnitt <Voucher-Txt> der Shopkonfiguration shop.config den Parametereintrag ExternalVouchers-Allow = yes hinzufügen. Näheres siehe |
Schritt 2: Einstellungen in der Shopkonfiguration
In der Shopkonfiguration shop.config im Abschnitt <Voucher-Txt> definieren Sie alle Parameter für Gutscheine:
<Voucher-Txt>
Name = Gutschein
Remainder2 = Verfügbarer Restbetrag für Ihre nächste Bestellung:
SpecialSettings1-Allow = no
VoucherNotApplicable = Der eingegebene Gutschein ist mit diesen Produkten leider nicht verwendbar
UsedVoucherNumber = (verwendete Gutscheinnummer: ~VoucherNumber~)
ShowPercentalVoucherDiscountForPosition-Allow = no
VoucherInputLocation = PlaceOrderAndBasket # [PlaceOrder|Basket|PlaceOrderAndBasket]
</Voucher-Txt>
Referenz: Abschnitt Voucher-Txt
Achtung: |
|
|
Achten Sie darauf, den Wert des Parameters VoucherInputLocation korrekt zu setzen, je nachdem, ob Sie die Eingabefelder auf der Warenkorbseite (ws_basket.htm) und/oder auf der Bestellübersichtsseite (ws_place_order.htm) platzieren. |
Schritt 3: Eingabefelder auf der Warenkorbseite (ws_basket.htm) und/oder auf der Bestellübersichtsseite (ws_place_order.htm) platzieren
Die Eingabe des Gutscheins kann sowohl auf der Warenkorbseite (ws_basket.htm) als auch auf der Bestellübersichtsseite (ws_place_order.htm) erfolgen.
Platzieren Sie das Gutscheineingabefeld und die Buttons "Gutschein einlösen" und "Gutschein entfernen" innerhalb von FORM-Basket und/oder FORM-PlaceOrder:
...
<form action="~FORM-Basket~" method="post"> <!-- und/oder form action="~FORM-PlaceOrder~" -->
...
{!VOUCHER-Number}
<!-- wenn keine Gutscheinnummer eingegeben wurde, können die Eingabefelder angezeigt werden -->
Gutscheinnummer: <input type="text" name="~WS-VoucherNumber_input~" value="">
<input type="submit" name="~BT-Voucher~" value="Gutschein einlösen">
{/!VOUCHER-Number}
{VOUCHER-Number}
<!-- Der Käufer hat bereits eine Gutscheinnummer eingegeben bzw. Übergabe per Deep-Link -->
{ST-Voucher_checked}
{!ST-Voucher_OK}
<!-- Wenn die Gutscheinnummer bereits geprüft wurde und nicht gültig ist, die fehlerhafte Eingabe hervorheben -->
<font color="red">
{/!ST-Voucher_OK}
{/ST-Voucher_checked}
Gutscheinnummer: ~VOUCHER-Number~ <input type="submit" name="~BT-Voucher_delete~" value="Gutschein entfernen">
{ST-Voucher_checked}
{!ST-Voucher_OK}
<!-- Wenn die Gutscheinnummer bereits geprüft wurde und nicht gültig ist, die fehlerhafte Eingabe hervorheben -->
</font>
{/!ST-Voucher_OK}
{/ST-Voucher_checked}
{/VOUCHER-Number}
...
</form>
...
Referenz: BT-Voucher
Referenz: BT-Voucher_delete
Referenz: VOUCHER-Number
Referenz: VOUCHER-ChargeID
Referenz: WS-VoucherNumber_input
Referenz: ST-Voucher_OK
Referenz: ST-Voucher_checked
Referenz: MSG-Voucher_success
Referenz: MSG-Voucher_error
Referenz: MSG-Voucher_error_validfrom
Schritt 4: Fehler- und Hinweismeldungen platzieren
Die Fehler- und Hinweismeldungen können Sie frei auf der Warenkorbseite (ws_basket.htm) und/oder auf der Bestellübersichtsseite (ws_place_order.htm) platzieren – je nachdem, auf welchen/m Template(s) die Eingabefelder zuvor integriert wurden.
Jede einzelne Meldung muss durch ein Bereichs-Tag mit entsprechendem Parameter gesteuert werden und lässt sich somit völlig frei gestalten:
{MSG-Voucher_success}
<font color="green">
{MSG-Voucher_success(1)}Der Gutschein wurde übernommen{/MSG-Voucher_success(1)}
{MSG-Voucher_success(2)}Der Gutschein wurde entfernt{/MSG-Voucher_success(2)}
</font>
{/MSG-Voucher_success}
{MSG-Voucher_error}
<font color="red">
{MSG-Voucher_error(1)} Die Gutscheineingabe wurde gesperrt. Sie können für diese Bestellung keinen Gutschein verwenden.{/MSG-Voucher_error(1)}
{MSG-Voucher_error(2)} Ungültige Gutscheinnummer. Bitte überprüfen Sie Ihre Eingabe.{/MSG-Voucher_error(2)}
{MSG-Voucher_error(3)} Dieser Gutschein ist erst ab dem ~MSG-Voucher_error_validfrom~ gültig. Führen Sie die Bestellung zu diesem Zeitpunkt aus oder verwenden Sie einen anderen Gutschein.{/MSG-Voucher_error(3)}
{MSG-Voucher_error(4)} Dieser Gutschein ist abgelaufen. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(4)}
{MSG-Voucher_error(5)} Der Gutschein wurde bereits eingelöst. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(5)}
{MSG-Voucher_error(6)} Bitte melden Sie sich an, um diesen Gutschein einlösen zu können.{/MSG-Voucher_error(6)}
{MSG-Voucher_error(7)} Der Gutschein wurde bereits eingelöst. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(7)}
{MSG-Voucher_error(8)} Dieser Gutschein kann auf die Produkte im Warenkorb nicht angewendet werden. Ändern Sie Ihre Produktauswahl oder geben Sie einen anderen Gutschein ein.{/MSG-Voucher_error(8)}
{MSG-Voucher_error(9)} Dieser Gutschein gilt nur für Neukunden. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(9)}
{MSG-Voucher_error(10)} Dieser Gutschein gilt nur für Neukunden. Bitte melden Sie sich an, um diesen Gutschein einlösen zu können.{/MSG-Voucher_error(10)}
{MSG-Voucher_error(11)} Dieser Gutschein ist nur für Neukunden gültig. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(11)}
{MSG-Voucher_error(12)} Dieser Gutschein gilt nur für Neukunden. Bitte melden Sie sich an, um diesen Gutschein einlösen zu können.{/MSG-Voucher_error(12)}
{MSG-Voucher_error(13)} Die maximale Anzahl an Einlösungen für diesen Gutschein wurde erreicht. Dieser Gutschein kann leider nicht mehr eingelöst werden.{/MSG-Voucher_error(13)}
{MSG-Voucher_error(14)} Die Bestellung kann mit diesem Gutschein nicht aufgegeben werden, da der Gutschein auf kein Produkt aus Ihrem Warenkorb angewendet werden kann. Bitte entfernen Sie den Gutschein oder legen Sie ein Produkt in den Warenkorb, für das der Gutschein gültig ist.{/MSG-Voucher_error(14)}
{MSG-Voucher_error(15)} Zur Eingabe dieser Gutscheinnummer müssen Sie im Shop angemeldet sein. Bitte melden Sie sich an, um diesen Gutschein einlösen zu können.{/MSG-Voucher_error(15)}
{MSG-Voucher_error(16)} Sie können diesen Gutschein leider nicht verwenden, da er nur für bestimmte Kunden gilt. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(16)}
{MSG-Voucher_error(17)} Sie müssen angemeldet sein, um diesen Gutschein verwenden zu können.{/MSG-Voucher_error(17)}
{MSG-Voucher_error(18)} Der Gutschein ist an ein anderes Kundenkonto gebunden. Sie können ihn daher leider nicht verwenden.{/MSG-Voucher_error(18)}
{MSG-Voucher_error(19)} Sie müssen angemeldet sein, um diesen Gutschein verwenden zu können.{/MSG-Voucher_error(19)}
{MSG-Voucher_error(20)} Der eingegebene Gutschein kann nicht gelöscht werden. Bitte melden Sie sich ab und starten Sie den Bestellprozess erneut.{/MSG-Voucher_error(20)}
{MSG-Voucher_error(21)} Dieser Gutschein kann auf die Produkte im Warenkorb nicht angewendet werden. Bitte entfernen Sie den Gutschein oder legen Sie ein Produkt in den Warenkorb, für das der Gutschein gültig ist.{/MSG-Voucher_error(21)}
{MSG-Voucher_error(22)} Dieser Gutschein kann auf die Produkte im Warenkorb nicht angewendet werden, da der Gutschein nur für Produkte mit bestimmtem Lagerbestand gültig ist. Bitte entfernen Sie den Gutschein oder legen Sie ein Produkt in den Warenkorb, für das der Gutschein gültig ist.{/MSG-Voucher_error(22)}
{MSG-Voucher_error(23)} Sie können leider keine Gutscheine verwenden, da Sie von Gutscheinaktionen ausgeschlossen wurden.{/MSG-Voucher_error(23)}
{MSG-Voucher_error(24)} Dieser Gutschein kann nur in der App eingelöst werden! Bitte rufen Sie den Shop in der App auf und lösen Sie den Gutschein dort ein.{/MSG-Voucher_error(24)}
{MSG-Voucher_error(25)} Dieser Gutschein kann leider nicht eingelöst werden, da für Sie bereits ein Kundenrabatt hinterlegt ist. Geben Sie ggf. einen anderen Gutschein ein.{/MSG-Voucher_error(25)}
{MSG-Voucher_error(26)} Diese Gutscheinnummer wurde mehrfach eingegeben. Geben Sie ggf. einen anderen Gutscheincode ein.{/MSG-Voucher_error(26)}
{MSG-Voucher_error(27)} Dieser Gutschein kann leider nicht eingelöst werden, da dieser nicht mit anderen Gutscheinen kombinierbar ist. Geben Sie ggf. einen anderen Gutscheincode ein.{/MSG-Voucher_error(27)}
</font>
{/MSG-Voucher_error}
Referenz: MSG-Voucher_success
Referenz: MSG-Voucher_error
Schritt 5: Link zum Entfernen des verwendeten Gutscheins platzieren (optional)
Platzieren Sie diesen Link, wenn Sie dem Benutzer die Möglichkeit geben möchten, einen Gutschein wieder zu entfernen, solange eine Bestellung noch nicht abgeschlossen ist.
{ST-Voucher_OK}
<a href="~BASKET-VoucherDeleteLink~">Gutschein entfernen</a>
{/ST-Voucher_OK}
Referenz: BASKET-VoucherDeleteLink
Achtung: |
|
|
Wenn in Ihrem Shop ein Mindestbestellwert mit berücksichtigtem Gutscheinrabatt auf Positionsebene gilt (MinimumOrder-ConsiderVoucherDiscount-Allow = yes), ist eine Erweiterung der Warenkorbseite (ws_basket.htm) notwendig. Bitte beachten Sie die Hinweise unter Anpassung bei Shops mit Gutschein-Eingabe auf der Bestellübersichtsseite (ws_place_order.htm) und Mindestbestellwert |
3.1 Bestellabschluss mit nicht anwendbaren Gutscheinen unterbinden
Standardmäßig kann eine Bestellung mit einem gültigen Gutschein aufgegeben werden, auch wenn der Gutschein nicht auf die Bestellung angewandt wird.
Dieser Fall tritt z. B. auf beim Einlösen
▪eines Werbegutscheins für ausschließlich nicht-werbegutscheinfähiger Produkte
▪eines kategorieabhängigen Gutscheins ausschließlich für Produkte, die nicht aus dieser Kategorie stammen.
Dies hat keine Auswirkung auf den Bestellabschluss. Der Kunde muss den Gutschein nicht erst (durch einen zusätzlichen Klick) entfernen.
In besonderen Fällen kann eine erforderliche explizite Löschung des Gutscheins durch den Käufer jedoch sinnvoll sein, etwa wenn durch den Gutschein ein Produkt zugesteuert wird.
Mit dieser Einstellung kann die Bestellung erst nach der Löschung des Gutscheins abgeschlossen werden, wenn dieser nicht auf den Warenkorbinhalt der Bestellung angewandt werden kann.
Schritt 1: Fehlermeldung "MSG-Voucher_error" ergänzen
Ergänzen Sie auf der Seite, auf der Sie die Gutschein-Eingabe integriert haben (Warenkorbseite (ws_basket.htm) oder Bestellübersichtsseite (ws_place_order.htm) die Fehlermeldung MSG-Voucher_error um den Fehlergrund 14 (siehe oben unter Fehler- und Hinweismeldungen platzieren).
Schritt 2: Einstellungen in der Shopkonfiguration shop.config
Fügen Sie den folgenden Parameter im Abschnitt <Voucher-Txt> Ihrer Shopkonfiguration shop.config hinzu und setzen Sie den Wert auf yes:
<Voucher-Txt>
...
PreventOrdersWithVoucherNotApplicable = yes
...
</Voucher-Txt>
Referenz: Abschnitt Voucher-Txt
3.2 Anpassung bei Shops mit Gutschein-Eingabe auf der Bestellübersichtsseite (ws_place_order.htm) und Mindestbestellwert
Die folgende Ergänzung ist relevant, wenn diese Bedingungen auf Ihren Shop zutreffen:
▪Eingabe der Gutscheinnummer nur auf der Bestellübersichtsseite (ws_place_order.htm)
▪Mindestbestellwert mit berücksichtigtem Gutscheinrabatt auf Positionsebene (Parameter MinimumOrder-ConsiderVoucherDiscount-Allow = yes im Abschnitt OrderCondition)
Referenz: Abschnitt OrderConditions
Wenn der Kunde einen Gutschein auf der Bestellübersichtsseite (ws_place_order.htm) eingibt und dadurch der Mindestbestellwert Ihres Shops unterschritten wird, wird der Kunde zurück auf die Warenkorbseite (ws_basket.htm) geleitet. Dort muss er die Möglichkeit haben, den eingegebenen Gutschein zu löschen, bevor er den Bestellprozess fortsetzen kann. Eine erneute Gutschein-Eingabe ist dann nur auf der Bestellübersichtsseite (ws_place_order.htm) möglich.
Button zum Löschen des Gutscheins auf der Warenkorbseite (ws_basket.htm) ergänzen
Ergänzen Sie folgenden Code auf der Warenkorbseite (ws_basket.htm):
Achtung: |
|
|
Für die Integration von Gutschein-Features gibt es neue Tags ( |
...
{MSG-Basket_Notify}
{ST-Voucher_checked}
{VOUCHER-Number}
<input autocomplete="off" type="text" value="~VOUCHER-Number~" disabled>
<input type="submit" name="~BT-Voucher_delete~" value="Gutschein entfernen">
{/VOUCHER-Number}
{/ST-Voucher_checked}
{/MSG-Basket_Notify}
...
Referenz: MSG-Basket_Notify
Referenz: ST-Voucher_checked
Referenz: VOUCHER-Number
Referenz: BT-Voucher_delete