Mehrere Gutscheine einlösen - WEBSALE Dokumentation

Standardmäßig nimmt der Shop einen Gutschein je Bestellung an. Mit dieser Erweiterung sind es bis zu zehn. Sobald der Kunde die erste Nummer eingelöst hat, erscheint ein weiteres Eingabefeld. Die Zehn setzt sich zusammen aus dem ersten Gutschein und neun weiteren. Diese Trennung zieht sich durch die ganze Umsetzung: Der erste Gutschein wird im Template wie bisher angesprochen, die neun weiteren stecken in einer Schleife.

Welche Gutscheine sich kombinieren lassen

Nicht jede Gutscheinart ist kombinierbar. Kombinieren lassen sich derzeit:

Gutscheinart	Bedingung
Kauf- und Werbegutscheine mit prozentualem Rabatt	müssen auf Positionsebene ausgewiesen werden, also `ShowPercentalVoucherDiscountForPosition-Allow = yes`
Kaufgutscheine mit festem Betrag	ohne zugewiesenen Mehrwertsteuersatz
Werbegutscheine mit festem Betrag	ohne zugewiesenen Mehrwertsteuersatz
Gutscheine ohne Einfluss auf Positionen oder warenwertabhängige Summen	beispielsweise Versandkostenerlass, Berechtigungscodes und Gutscheine, die kostenfreie Produkte zusteuern

Ein Werbegutschein mit festem Betrag wirkt in dieser Kombination ausnahmslos auf alle Produkte. Der sonst übliche Ausschluss nicht werbegutscheinfähiger Produkte greift hier nicht. Prüfen Sie das, bevor Sie preisgebundene Ware im Sortiment haben.

Ob sich zwei konkrete Gutscheine vertragen, lässt sich zusätzlich je Gutschein steuern. Über die Sonderfunktion für Kombinierbarkeit lassen sich Gutscheine als ausschließlich kennzeichnen oder über Erlaubnis- und Sperrlisten aneinander binden. Schlägt diese Prüfung fehl, erscheint der Ablehnungsgrund 27. Wegweiser: Prozentuale Gutscheine

Voraussetzung

Der Gutschein-Generator muss freigeschaltet sein. Wenden Sie sich dafür 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.

Schritt 1: Die Funktion im Testmodus einschalten

Die Einrichtung läuft bewusst in zwei Stufen. Setzen Sie den Schalter zunächst auf test, dann wirkt die Funktion ausschließlich im Testmodus des Shops und für echte Kunden ändert sich nichts.

<Voucher-Txt>
   MultiVoucher-Allow                      = test
   UseRoundedPercentalMultiVoucherDiscount =        # [yes|no], Voreinstellung: no
   MultiVoucher-MinOrderBehavior           =        # [UseMax], Voreinstellung: Summe
</Voucher-Txt>

Eintrag	Bedeutung
`MultiVoucher-Allow`	`yes` schaltet die Funktion frei, `test` nur im Testmodus des Shops, jeder andere Wert lässt sie aus
`UseRoundedPercentalMultiVoucherDiscount`	`yes` rundet bei prozentualen Gutscheinen die Zwischenergebnisse, sonst wird erst nach Addition aller Gutscheinbeträge gerundet
`MultiVoucher-MinOrderBehavior`	`UseMax` prüft gegen den höchsten Mindestbestellwert der eingelösten Gutscheine, jeder andere Wert gegen deren Summe

MultiVoucher-MinOrderBehavior entscheidet darüber, wie streng die Aktion ist. Drei Gutscheine mit je 50 Euro Mindestbestellwert verlangen in der Voreinstellung einen Warenkorb über 150 Euro, mit UseMax genügen 50 Euro. Das ist die Stellschraube, an der sich der wirtschaftliche Rahmen einer Mehrfachaktion entscheidet.

Das Abschalten ist heikler als das Einschalten. Eine laufende Sitzung, in der schon mehrere Codes stecken, würde durch das Abschalten in einen widersprüchlichen Zustand geraten. Der Shop lässt den Wechsel auf no deshalb nur für Sitzungen wirksam werden, in denen noch kein zusätzlicher Gutschein eingegeben wurde. Bestehende Sitzungen mit mehreren Codes laufen mit der alten Einstellung weiter.

Referenz: Abschnitt Voucher-Txt

Schritt 2: Die Eingabefelder einrichten

Der erste Gutschein bleibt unverändert, die weiteren kommen in die Schleife VOUCHER-MultiVoucher.

<form action="~FORM-Basket~" method="post">

   <!-- Erster Gutschein -->
   <input type="text" name="~WS-VoucherNumber_input~" value="~WS-VoucherNumber~"
          {WS-VoucherNumber} disabled readonly{/WS-VoucherNumber}>
   {WS-VoucherNumber}
      {ST-Voucher_checked}
         <button type="submit" name="~BT-Voucher_delete~">Gutschein löschen</button>
      {/ST-Voucher_checked}
      {!ST-Voucher_checked}
         <button type="submit" name="~BT-Voucher~">Gutschein einlösen</button>
      {/!ST-Voucher_checked}
   {/WS-VoucherNumber}
   {!WS-VoucherNumber}
      <button type="submit" name="~BT-Voucher~">Gutschein einlösen</button>
   {/!WS-VoucherNumber}

   <!-- Weitere Gutscheine -->
   {VOUCHER-MultiVoucher}
      {@VOUCHER-MultiVoucher}
         <input type="text" name="~WS-VoucherNumber_input~" value="~WS-VoucherNumber~"
                {WS-VoucherNumber} disabled readonly{/WS-VoucherNumber}>
         {ST-Voucher_checked}
            <button type="submit" name="~BT-Voucher_delete~">Gutschein löschen</button>
         {/ST-Voucher_checked}
         {!ST-Voucher_checked}
            <button type="submit" name="~BT-Voucher~">Gutschein einlösen</button>
         {/!ST-Voucher_checked}
      {/@VOUCHER-MultiVoucher}
   {/VOUCHER-MultiVoucher}

</form>

In der Schleife stecken nur die zusätzlichen Gutscheine, nicht der erste. Wer alle eingegebenen Nummern anzeigen will, muss das Tag zweimal setzen, einmal außerhalb und einmal innerhalb der Schleife. Diese Aufteilung ist die häufigste Fehlerquelle bei dieser Erweiterung.

Eingegebene Gutscheinnummern:

~WS-VoucherNumber~
{VOUCHER-MultiVoucher}
   {@VOUCHER-MultiVoucher}
      ~WS-VoucherNumber~
   {/@VOUCHER-MultiVoucher}
{/VOUCHER-MultiVoucher}

Innerhalb der Schleife beziehen sich die gutscheinbezogenen Tags auf den jeweiligen Gutschein des Durchlaufs. Das gilt für alle VOUCHER-Tags, die Gutscheindaten lesen, beispielsweise VOUCHER-DataExists, VOUCHER-Number und VOUCHER-ChargeID, sowie zusätzlich für BASKET-VoucherRest, BASKET-VoucherDeleteLink, BASKET-VoucherNotApplicable, BASKET-PR-VoucherApplies und ST-Voucher_OK. Die Werte der zusätzlichen Gutscheine geben Sie nach demselben Muster aus.

{VOUCHER-MultiVoucher}
   {@VOUCHER-MultiVoucher}
      {ST-Voucher_checked}
         Gutschein (~WS-VoucherNumber~)
         ~BASKET-VoucherDiscount~ ~WS-CurrencySymbol~
      {/ST-Voucher_checked}
   {/@VOUCHER-MultiVoucher}
{/VOUCHER-MultiVoucher}

Referenz: WS-VoucherNumber_input · WS-VoucherNumber · ST-Voucher_checked · BT-Voucher_delete · BT-Voucher · VOUCHER-MultiVoucher · BASKET-VoucherDiscount

Schritt 3: Die zwei neuen Fehlermeldungen ergänzen

Mit mehreren Gutscheinen kommen zwei Ablehnungsgründe hinzu, die es vorher nicht geben konnte. Ergänzen Sie beide dort, wo Sie die Gutscheineingabe eingebaut haben.

Grund	Wann er auftritt
26	dieselbe Gutscheinnummer wurde ein zweites Mal eingegeben
27	der Gutschein verträgt sich nicht mit einem bereits eingelösten

{MSG-Voucher_error(26)}
   Diese Gutscheinnummer haben Sie bereits eingegeben.
{/MSG-Voucher_error(26)}

{MSG-Voucher_error(27)}
   Dieser Gutschein lässt sich nicht mit den bereits eingelösten kombinieren.
{/MSG-Voucher_error(27)}

Referenz: MSG-Voucher_error

Schritt 4: Im Testmodus prüfen

Rufen Sie den Shop im Testmodus auf und lösen Sie verschiedene kombinierbare Gutscheine ein.

https://www.beispielshop.de/?test=on
https://www.beispielshop.de/?test=off

Prüfen Sie dabei nicht nur, dass mehrere Codes angenommen werden, sondern auch die Summen. Gerade das Zusammenspiel aus prozentualen und absoluten Gutscheinen und die Rundung lassen sich nur an echten Zahlen beurteilen. Wegweiser: Testmodi des Shops ein-/ausschalten

Schritt 5: Live schalten

Setzen Sie den Schalter auf yes und entfernen Sie alle Klammerungen, die Sie für den Test in die Templates eingebaut haben.

<Voucher-Txt>
   MultiVoucher-Allow = yes
</Voucher-Txt>

Prozentuale und absolute Gutscheine getrennt ausweisen

Prozentuale Gutscheine stecken bereits in der Zwischensumme, absolute werden erst davon abgezogen. Für den Kunden ist das nicht erkennbar, wenn beide in einer Zeile stehen. Deshalb lassen sich beide Arten getrennt ausgeben, und die Bereiche erscheinen nur, wenn es die jeweilige Art überhaupt gibt.

Multivoucher Prozentuale Absolute Getrennt

Die prozentualen Gutscheine bei der Zwischensumme

{BASKET-SubTotalSum}

   Zwischensumme: ~BASKET-SubTotalSum~ ~WS-CurrencySymbol~

   {BASKET-PercentalVoucherDiscountSum}
      nach Abzug prozentualer Gutscheine im Wert von
      ~BASKET-PercentalVoucherDiscountSum~ ~WS-CurrencySymbol~<br>

      {VOUCHER-Number}
         {ST-Voucher_checked}
            {VOUCHER-AmountType_isPercent}
               ~VOUCHER-Number~ ~BASKET-PercentalVoucherDiscount~ ~WS-CurrencySymbol~<br>
            {/VOUCHER-AmountType_isPercent}
         {/ST-Voucher_checked}
      {/VOUCHER-Number}

      {VOUCHER-MultiVoucher}
         {@VOUCHER-MultiVoucher}
            {ST-Voucher_checked}
               {VOUCHER-AmountType_isPercent}
                  ~VOUCHER-Number~ ~BASKET-PercentalVoucherDiscount~ ~WS-CurrencySymbol~<br>
               {/VOUCHER-AmountType_isPercent}
            {/ST-Voucher_checked}
         {/@VOUCHER-MultiVoucher}
      {/VOUCHER-MultiVoucher}
   {/BASKET-PercentalVoucherDiscountSum}

{/BASKET-SubTotalSum}

Das Muster wiederholt sich zweimal, einmal für den ersten Gutschein und einmal in der Schleife. VOUCHER-AmountType_isPercent sorgt dafür, dass in diesem Block nur prozentuale Gutscheine auftauchen.

Die absoluten Gutscheine darunter

{BASKET-VoucherDiscountSum}
   {ST-Voucher_checked}
      Gutschein-Rabatt<br>

      {VOUCHER-Number}
         {ST-Voucher_checked}
            {VOUCHER-AmountType_isAbsolute}
               ~VOUCHER-Number~ ~BASKET-VoucherDiscount~ ~WS-CurrencySymbol~<br>
            {/VOUCHER-AmountType_isAbsolute}
         {/ST-Voucher_checked}
      {/VOUCHER-Number}

      {VOUCHER-MultiVoucher}
         {@VOUCHER-MultiVoucher}
            {ST-Voucher_checked}
               {VOUCHER-AmountType_isAbsolute}
                  ~VOUCHER-Number~ ~BASKET-VoucherDiscount~ ~WS-CurrencySymbol~<br>
               {/VOUCHER-AmountType_isAbsolute}
            {/ST-Voucher_checked}
         {/@VOUCHER-MultiVoucher}
      {/VOUCHER-MultiVoucher}

      ~BASKET-VoucherDiscountSum~ ~WS-CurrencySymbol~
   {/ST-Voucher_checked}
{/BASKET-VoucherDiscountSum}

Die Gesamtersparnis ausweisen (optional)

{ST-Voucher_checked}
   Gewährte Gutschein-Rabatte<br>
      ~WS-DisablePriceAndNumberFormat~
      ~DC-CommercialCalc1_set($BASKET-PercentalVoucherDiscountSum$)~
      ~DC-CommercialCalc1_add($BASKET-VoucherDiscountSum$)~
      ~WS-EnablePriceAndNumberFormat~
      ~DC-CommercialCalc1~ ~WS-CurrencySymbol~<br>

   davon prozentuale Gutscheine:
      ~BASKET-PercentalVoucherDiscountSum~ ~WS-CurrencySymbol~<br>

   davon absolute Gutscheine:
      ~BASKET-VoucherDiscountSum~ ~WS-CurrencySymbol~<br>
{/ST-Voucher_checked}

Die Preisformatierung muss für die Rechnung abgeschaltet werden. Sonst gehen die Beträge mit Tausenderpunkt und Komma in die Addition, und das Ergebnis stimmt nicht. Schalten Sie sie unmittelbar danach wieder ein, damit die Formatierung im übrigen Template erhalten bleibt.

Referenz: BASKET-SubTotalSum · BASKET-PercentalVoucherDiscountSum · BASKET-PercentalVoucherDiscount · BASKET-VoucherDiscountSum · VOUCHER-AmountType_isPercent · VOUCHER-AmountType_isAbsolute · WS-DisablePriceAndNumberFormat · DC-CommercialCalc1_set

​Welche Gutscheine sich kombinieren lassen

​Voraussetzung

​Schritt 1: Die Funktion im Testmodus einschalten

​Schritt 2: Die Eingabefelder einrichten

​Schritt 3: Die zwei neuen Fehlermeldungen ergänzen

​Schritt 4: Im Testmodus prüfen

​Schritt 5: Live schalten

​Prozentuale und absolute Gutscheine getrennt ausweisen

​Die prozentualen Gutscheine bei der Zwischensumme

​Die absoluten Gutscheine darunter

​Die Gesamtersparnis ausweisen (optional)

​Verwandte Themen

Welche Gutscheine sich kombinieren lassen

Voraussetzung

Schritt 1: Die Funktion im Testmodus einschalten

Schritt 2: Die Eingabefelder einrichten

Schritt 3: Die zwei neuen Fehlermeldungen ergänzen

Schritt 4: Im Testmodus prüfen

Schritt 5: Live schalten

Prozentuale und absolute Gutscheine getrennt ausweisen

Die prozentualen Gutscheine bei der Zwischensumme

Die absoluten Gutscheine darunter

Die Gesamtersparnis ausweisen (optional)

Verwandte Themen