Gutscheine abhängig von Produktdaten

Diese Funktion ermöglicht es Ihnen, Gutscheine nur für solche Produkte anzubieten, die einen definierten Wert in einem bestimmten Produktdatenfeld aufweisen. Die Prüfung ist auch mit freien Produktdatenfeldern möglich.

Integration

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 Referenz: Abschnitt "Voucher-Txt" der shop.config

Schritt 2: Ergänzung in der Shopkonfiguration shop.config

Das ausgewählte Produktdatenfeld muss dem Warenkorb übergeben werden. Dazu ergänzen Sie die Shopkonfiguration shop.config mit folgendem Eintrag:

<AdditionalProductFieldsInBasket>
   +Field =          # tech. Name des Produktdatenfeldes
</AdditionalProductFieldsInBasket>

Referenz: Abschnitt AdditionalProductFieldsInBasket

Schritt 3: Gutschein konfigurieren im OSB-Dienst Gutschein-Generator

Die Bedingungen, ob ein Gutschein für die Produkte im Warenkorb gültig sein soll, werden beim Anlegen des Gutscheins im OSB-Dienst Gutschein-Generator definiert. Tragen Sie dazu im Feld "Kundenspezifische Features" (ganz unten) eine Zeichenkette nach folgendem Schema ein:
 

<g><t>AdditionalProductFieldsFilter</t><setbehavior>asUnit</setbehavior><filter><fieldname>Feldname</fieldname><valueInList>a,b,c</valueInList></filter></g>

Tag

Beschreibung

<g>...</g>

Die Aktivierung dieser Funktion erfolgt innerhalb dieser Gruppierung.

<t>...</t>

Als Typ muss "AdditionalProductFieldsFilter" eingetragen werden.

<setbehavior>...</setbehavior>

Legt das Verhalten des Gutscheins für Setprodukte fest (optional):

asUnit: Set-Unterprodukte werden als Einheit betrachtet und die Prüfung erfolgt für das Set-Oberprodukt. Der Gutschein gilt entweder für alle oder für kein Setprodukt (Standard)

single: Set-Unterprodukte werden einzeln geprüft. Der Gutschein gilt dann je nach Produktkonfiguration entweder für alle, manche oder keine Produkte des Sets.

<filter>...</filter>

Die Definition der Bedingungen erfolgt innerhalb dieser Filter-Tags.

<fieldname>...</fieldname>

Geben Sie hier den technischen Feldname des zu prüfenden (freien) Produktdatenfeldes ein.

<valueInList>...</valueInList>

Geben Sie hier eine kommaseparierte Liste mit Werten an, die im Produktdatenfeld enthalten sein muss. Verwenden Sie keine trennenden Leerzeichen.

Die Gesamtlänge der Zeichenkette ist auf 1000 Zeichen beschränkt. Sie können im Gutschein-Generator mehrere Filter nacheinander angeben, die dann oder-verknüpft sind.

Schritt 4: Ausgabe der Gutschein-Generator-Konfiguration

Für die informative Ausgabe der Konfigurationen im Gutschein-Generator fügen Sie folgendes Code-Beispiel in ein beliebiges Template:

...
{VOUCHER-SpecialFeatures_AddProdFieldsFilter}
   Der eingegebene Gutscheincode ist ein "Gutschein abhängig von Produktdaten".
   Es sind ~VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter~ Prüfungen beim Gutschein konfiguriert:
 
   {@VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter}
      Technischer Feldname: ~VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter_FieldName~<br>
      Wert: ~VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter_ValueInList~<br>
      Verhalten bei Setprodukten: ~VOUCHER-SpecialFeatures_AddProdFieldsFilter_SetBehavior~
   {/@VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter}
 
{/VOUCHER-SpecialFeatures_AddProdFieldsFilter}
 
{!VOUCHER-SpecialFeatures_AddProdFieldsFilter}
   Es wurde kein "Gutschein abhängig von Produktdaten" eingegeben.
{/!VOUCHER-SpecialFeatures_AddProdFieldsFilter}
...

Referenz: VOUCHER-SpecialFeatures_AddProdFieldsFilter
Referenz: VOUCHER-SpecialFeatures_AddProdFieldsFilter_SetBehavior
Referenz: VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter
Referenz: VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter_FieldName
Referenz: VOUCHER-SpecialFeatures_AddProdFieldsFilter_Filter_ValueInList

Schritt 5: Fehlermeldung 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 21:

{MSG-Voucher_error(21)}
   Dieser Gutschein kann auf die Produkte im Warenkorb nicht angewendet werden.<br>
   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)}

Referenz: MSG-Voucher_error

Haben Sie alle Schritte durchgeführt, ist die Funktion in Ihrem Shop aktiv.