Gutscheine mit mehreren Währungen

Wenn Sie mehrere Subshops mit unterschiedlichen Währungen betreiben, können Sie Gutscheinen eine Liste mit mehreren gewünschten Währungen und den jeweiligen Gutscheinwerten zuweisen.

Je nachdem, welche Währung für den Subshop konfiguriert ist, in dem der Kunde den Gutschein einlöst, wird der jeweilige hinterlegte Gutscheinwert angewendet. Auch die Optionen "Mindestbestellwert" und "Maximalbetrag" (bei prozentualen Gutscheinen) können für alle Währungen in der Liste angegeben werden. Etwaige Gutschein-Restbeträge können ebenfalls in allen Währungen eingelöst werden (auch in unterschiedlichen Währungen/Subshops).

Integration

Gehen Sie folgendermaßen vor, um die Funktionalität "Produkte mittels Gutschein zusteuern" in Ihrem Shop einzubauen:

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: "Anbieten von Gutscheinen" integrieren

Wenn Sie in Ihrem Shop noch keine Gutscheine anbieten, müssen Sie zunächst die Gutscheineingabe auf der Warenkorbseite (ws_basket.htm) und/oder auf der Bestellübersichtsseite (ws_place_order.htm) integrieren.

Wegweiser: Gutschein-Eingabe vorsehen

Schritt 3: Erstellen des Gutscheins mit mehreren Währungen (Gutschein-Generator)

Legen Sie den Gutschein im Online-Servicebereich, Dienst Gutschein-Generator, mit Ihren gewünschten Einstellungen an.

Schritt 4: Anzeige auf einer beliebigen Shop-Seite

Für den Gutschein (in diesem Beispiel mit der Gutscheinnummer 123) können u. a. folgende Informationen zur Einlösung angezeigt werden:

...
{VOUCHER-LoadData(123)}
   {VOUCHER-DataExists}

      {VOUCHER-MultiCurrency_AbsoluteAmountData}
         Gültige Gutscheinwerte: ~VOUCHER-MultiCurrency_AbsoluteAmountData~
      {/VOUCHER-MultiCurrency_AbsoluteAmountData}

      {VOUCHER-MultiCurrency_AbsoluteAmountUsedData}
         Bereits eingelöste Beträge: ~VOUCHER-MultiCurrency_AbsoluteAmountUsedData~
      {/VOUCHER-MultiCurrency_AbsoluteAmountUsedData}

      {VOUCHER-MultiCurrency_CurrenciesData}
         Gültige Währungen für diesen Gutschein: ~VOUCHER-MultiCurrency_CurrenciesData~
      {/VOUCHER-MultiCurrency_CurrenciesData}

      {VOUCHER-MultiCurrency_MaxDiscountData}
         Gültiger Maximalbetrag für diesen Gutschein: ~VOUCHER-MultiCurrency_MaxDiscountData~
      {/VOUCHER-MultiCurrency_MaxDiscountData}

      {VOUCHER-MultiCurrency_MinOrderData}
         Gültiger Mindestbestellwert für diesen Gutschein: ~VOUCHER-MultiCurrency_MinOrderData~
      {/VOUCHER-MultiCurrency_MinOrderData}

   {/VOUCHER-DataExists}
{/VOUCHER-LoadData(123)}
...

Referenz: VOUCHER-MultiCurrency_CurrenciesData

Referenz: VOUCHER-MultiCurrency_MinOrderData

Referenz: VOUCHER-MultiCurrency_MaxDiscountData

Referenz: VOUCHER-MultiCurrency_AbsoluteAmountData

Referenz: VOUCHER-MultiCurrency_AbsoluteAmountUsedData

Bitte beachten Sie, dass die o. g. VOUCHER-Tags eine Liste der entsprechenden Daten im technischen Format ausgeben, z. B. <g><c>3-stelliger ISO-Code Währung 1</c><a>Betrag 1</a></g><g><c>3-stelliger ISO-Code Währung 2</c><a>Betrag 2</a></g>...

Sie können diese Daten mithilfe der Tags DC-DynamicLoop1…3_setSeparatorTags(), DC-DynamicLoop1…3_settaggedData() und DC-FPX_extractTaggedData() auf dem Template verarbeiten/aufbereiten, um sie z. B. in tabellarischer Form anzuzeigen.

Beispiel für Gutscheinwerte und Währungen:

...
{VOUCHER-MultiCurrency_AbsoluteAmountData} 
 
  Plain: ~VOUCHER-MultiCurrency_AbsoluteAmountData~<br> 
  Escaped: ~DC-FP1_set($VOUCHER-MultiCurrency_AbsoluteAmountData$)~~DC-FP1~
 
  ~DC-DynamicLoop1_setSeparatorTags(<g>,</g>)~ 
  ~DC-DynamicLoop1_settaggeddata($VOUCHER-MultiCurrency_AbsoluteAmountData$)~ 
 
     {@DC-DynamicLoop1} 
 
       ~DC-FP1_set($DC-DynamicLoop1_data$)~ 
       ~DC-FP1_extractTaggedData(<c>,</c>)~ 
 
       ~DC-FP1~: 
 
       ~DC-FP1_set($DC-DynamicLoop1_data$)~ 
       ~DC-FP1_extractTaggedData(<a>,</a>)~ 
 
       ~DC-FP1~ 
 
     {/@DC-DynamicLoop1} 
 
{/VOUCHER-MultiCurrency_AbsoluteAmountData} 
...

Referenz: DC-DynamicLoop1…3

Referenz: DC-DynamicLoop1…3_setSeparatorTags()

Referenz: DC-DynamicLoop1…3_settaggedData()

Referenz: DC-FPX

Referenz: DC-FPX_set()

Referenz: DC-FPX_extractTaggedData()

Referenz: DC-SPX_extractTaggedData()

Referenz: WS-DisableXSSProtectionOnce

Sollten Sie über die im vorstehenden Beispiel dargestellten Informationen hinaus Zugriff auf weitere Datenfelder benötigen, die der Gutschein-Generator erzeugt, finden Sie weitere Tags sowie ein Codebeispiel, das die Anwendung einer Reihe von Tags verdeutlicht, im Abschnitt "Referenz" dieser Dokumentation.

Referenz: VOUCHER-