Kaufgutscheine können Käufer erwerben, um sie beispielsweise zu verschenken. Dieser Gutscheintyp ist auch ideal als "Last-Minute"-Geschenk verwendbar, weil er vom Käufer unmittelbar aus dem Shop heruntergeladen werden kann.

Kaufgutscheine werden im Shop wie reguläre Produkte behandelt. In dem Moment, wo der Kunde einen solchen Gutschein in den Warenkorb legt, erzeugt der Shop eine Gutscheinnummer oder entnimmt diese einem zuvor angelegten Pool.

Die Kaufgutscheine zum Ausdrucken können an sichere Zahlungsarten geknüpft werden.

Nach der Bezahlung im Shop wird dem Käufer die Gutscheinnummer sofort angezeigt.

Darüber hinaus wird je Gutscheinnummer eine PDF-Datei (über eine Template-Vorlage) als Download-Link angeboten, die vom Käufer ausgedruckt werden kann. In dieser Datei werden alle wesentlichen Gutscheindaten, wie Gutscheinnummer, Gutscheinbetrag, Gültigkeit usw. angezeigt.

Eine Anleitung zum Integrieren von Kaufgutscheinen zum Ausdrucken mit mehreren Motiven finden Sie im Abschnitt "Anwendungsbeispiele" dieser Dokumentation:

Anwendungsbeispiel: Kaufgutscheine zum Ausdrucken mit mehreren Motiven anbieten

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.

Schritt 2: "Gutscheine anbieten" integrieren

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

Wegweiser: Gutschein-Eingabe vorsehen

Schritt 3: Anlegen der Kaufgutscheine als Produkte

Bei den Kaufgutscheinen handelt es sich um Produkte, die wie alle anderen Produkte in den Warenkorb gelegt werden und dem üblichen Bestellvorgang unterliegen.

Die Kaufgutscheine müssen also entsprechend angelegt und definiert werden. Hierzu wird ein neues Produktfeld "InstantVoucherProduct" angelegt. Um das Gutscheinprodukt zu definieren, werden sämtliche im Folgenden beschriebenen Werte hintereinander als String in das Feld eingetragen. Der gesamte String wird durch das Tag <g> eingerahmt:

InstantVoucherProduct:

<g><1>Gutscheinprodukt y/n</1><2>ChargenID</2><3>Vorlagenwert überschreiben y/n</3><4>Gutscheinnummer neu generieren oder aus Pool nehmen y/n</4></g>

Tag 1:

▪y: Gutscheinprodukt ist aktiv

▪n: Gutscheinprodukt ist inaktiv bzw. kein Gutscheinprodukt. Alle weiteren Felder werden ignoriert.

Tag 2:

▪ChargenID

Tag 3:

▪y: Der Wert des Gutscheins entspricht dem Produktpreis. Ein evtl. vorhandener Vorlagenwert bzw. Gutscheinwert aus einem Pool wird überschrieben.

▪n: Der Wert des Gutscheins ist der Vorlagenwert bzw. der Gutscheinwert aus einem Pool

Tag 4:

▪y: Gutscheinnummer soll neu generiert werden

▪n: Gutscheinnummer soll aus einem vorhandenen Gutscheinnummern-Pool genommen werden

Beispiel:

<g><1>y</1><2>Kaufgutscheine</2><3>y</3><4>y</4></g>

In der Regel werden für den Produktpreis/Gutscheinwert Varianten verwendet. Die Variante "Gutscheinwert" kann beispielsweise folgende Werte haben:

Gutscheinwert:

▪10 EUR

▪20 EUR

▪50 EUR

▪100 EUR

▪200 EUR

▪500 EUR

Schritt 4: Anlegen der Gutscheinnummern/Importieren des Gutscheinnummern-Pools

Der Shop unterstützt zwei Methoden, um Gutscheinnummern automatisch zu generieren. Entweder werden Gutscheinnnummern mittels Gutschein-Generator im Online-Servicebereich der WEBSALE AG angelegt, oder es werden von einem ERP-/Warenwirtschafts-System Gutscheinnummern importiert, die in einem Gutscheinnummern-Pool vorgehalten/gespeichert werden.

Anlegen von Gutscheinen im OSB

Im Gutschein-Generator können Gutscheine und Gutscheinvorlagen angelegt werden. (Eine Gutscheinvorlage enthält alle wesentlichen Daten/Einstellungen der automatisch generierten Gutscheine.)

Import eines Gutscheinnummern-Pools

Dem Shop kann per Importdatei ein Gutscheinnummern-Pool übermittelt werden. Das Format der Importdatei wird in einer separaten Dokumentation beschrieben, die Sie gerne von der WEBSALE AG anfordern können.

Beim Gutscheinprodukt muss das Tag 4 entsprechend auf "n" gesetzt werden.

Tag 4:

▪y: Gutscheinnummer soll neu generiert werden

▪n: Gutscheinnummer soll aus einem vorhandenen Gutscheinnummern-Pool genommen werden

Voraussetzung ist, dass jedem importierten Gutschein eine ChargenID zugewiesen wird, da diese beim Gutscheinprodukt angegeben werden muss.

Weitere Informationen zum Anlegen von Gutscheinen und Gutscheinvorlagen mittels Gutschein-Generator finden Sie unter "Gutscheine anlegen oder importieren".

Schritt 5: Zahlungsarten für Kaufgutscheine festlegen

Im Shop kann eingestellt werden, dass nur noch Online-Bezahlmethoden (z. B. Kreditkarte, PayPal, Sofortüberweisung) angeboten werden, wenn mindestens ein Kaufgutschein im Warenkorb liegt. Da der Besteller nach dem Kauf eines Gutscheinproduktes die angezeigte Gutscheinnummer unmittelbar einlösen kann, empfiehlt es sich, diese Funktion im Shop zu aktivieren.

Stellen Sie bei den Zahlungsarten ein, die Sie in Ihrem Shop anbieten, ob diese für den Kauf eines Kaufgutscheins gelten sollen. Für jede Zahlungsart legen Sie das separat fest: in der Shopkonfiguration shop.config im Abschnitt <PaymentXXX-Txt> über den Parameter InstantVoucherProducts-Allow.

<PaymentXXX-Txt>
...
   InstantVoucherProducts-Allow = yes
...
</PaymentXXX-Txt>

Referenz: PaymentXXX-Txt

Schritt 6: Anzeige auf der Produktübersichtsseite (ws_category.htm) und Produktdetailansicht (ws_product.htm) (optional)

Kaufgutscheine können auf der Produktübersichtsseite (ws_category.htm) und Produktdetailansicht (ws_product.htm) gesondert geklammert werden.

Fügen Sie hierzu folgenden Bereich auf dem gewünschten Template hinzu.

Beispiel:

{PR-InstantVoucherProduct}
   Das Produkt ist ein Kaufgutschein.
{/PR-InstantVoucherProduct}

Referenz: PR-InstantVoucherProduct

Schritt 7: Anzeige auf der Warenkorbseite (ws_basket.htm) (optional)

Kaufgutscheine können auch auf der Warenkorbseite (ws_basket.htm) gesondert geklammert werden.

Fügen Sie hierzu folgenden Bereich auf dem Template hinzu.

Beispiel:

{BASKET-PR-InstantVoucherProduct}
   Das Produkt ist ein Kaufgutschein.
{/BASKET-PR-InstantVoucherProduct}

Referenz: BASKET-PR-InstantVoucherProduct

Schritt 8: Anzeige der generierten Gutscheinnummer

Die automatisch generierte Gutscheinnummer sowie der Link zum PDF-Download des Gutscheins kann auf folgenden Seiten angezeigt werden:

▪HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm)

▪Bestelleingangsbestätigungs-E-Mail

▪Bestellhistorie

Beispiel: Anzeige der Gutscheinnummer auf der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm)

{@BASKET-PR-Data}
   ...
   {BASKET-PR-InstantVoucherProduct} 
      {BASKET-PR-InstantVoucherProductData} 
         {@BASKET-PR-InstantVoucherProductData} 
         ...
         Gutscheinnummer: ~BASKET-PR-InstantVoucherProductData_VoucherNumber~ 
         <a href="~WS-Start~~BASKET-PR-InstantVoucherProductData_PDFLinkPart~">Link</a> 
         ...
         {/@BASKET-PR-InstantVoucherProductData} 
      {/BASKET-PR-InstantVoucherProductData} 
   {/BASKET-PR-InstantVoucherProduct} 
   ...
{/@BASKET-PR-Data}

Referenz: BASKET-PR-InstantVoucherProduct

Referenz: BASKET-PR-InstantVoucherProductData

Referenz: BASKET-PR-InstantVoucherProductData_VoucherNumber

Referenz: BASKET-PR-InstantVoucherProductData_PDFLinkPart

Referenz: BASKET-PR-Data

Referenz: WS-Start

Schritt 9: Template zum PDF-Download des Kaufgutscheins erstellen

Um den Kaufgutschein als PDF-Download anzubieten, ist ein eigenes Template notwendig.

1. Template zuweisen

Weisen Sie ein neues Template in Ihrer Shopkonfiguration shop.config im Abschnitt <Templates> dem Parameter InstantVoucherPDF zu.

Beispiel:

<Templates>
...
   InstantVoucherPDF = ws_instant_voucher.htm   #Template PDF-Download Gutschein
...
</Templates>

Referenz: Abschnitt Templates

2. Template anlegen und speichern

Legen Sie ein neues Template an, das dem Kunden als PDF-Download zur Verfügung stehen soll und integrieren Sie darin die Daten des Kaufgutscheins.

Speichern Sie dieses Template unter dem Namen wie im vorigen Schritt angegeben in Ihrem Templateverzeichnis, z. B. benutzer/templates/translation.

Beispiel:

...
Gutschein:
Betrag: ~INSTANTVOUCHER-Amount~ ~INSTANTVOUCHER-CurrencyCode~ ~INSTANTVOUCHER-CurrencySymbol~
Nummer: ~INSTANTVOUCHER-VoucherNumber~ 
Gültig bis: ~INSTANTVOUCHER-ValidUntil_day~.~INSTANTVOUCHER-ValidUntil_month~.~INSTANTVOUCHER-ValidUntil_year~ 
...

Referenz: INSTANTVOUCHER-Amount

Referenz: INSTANTVOUCHER-CurrencyCode

Referenz: INSTANTVOUCHER-CurrencySymbol

Referenz: INSTANTVOUCHER-ValidUntil_day

Referenz: INSTANTVOUCHER-ValidUntil_month

Referenz: INSTANTVOUCHER-ValidUntil_year

Referenz: INSTANTVOUCHER-VoucherNumber

2a. (optional für stationäre Shops:) Gutscheinnummer als Barcode auf dem Template ausgeben: Barcode-Generator

Wenn Sie neben dem Onlineshop auch ein Ladengeschäft betreiben, können Sie Gutscheinnummern als Barcodes auf den Gutscheinen ausdrucken. Diese Barcodes lassen Ihre Kunden dann an der Kasse im stationären Shop einfach einscannen. 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 …).

Referenz: WS-BarcodeURL

3. PDF-Dateiname angeben

Geben Sie im Abschnitt <PDFGenerator> Ihrer Shopkonfiguration shop.config im Parameter InstantVoucherPDFFilename den Dateinamen der zu generierenden PDF-Datei an.

Beispiel:

<PDFGenerator>
...
   InstantVoucherPDFFilename = gutschein.pdf
...
</PDFGenerator>

Referenz: Abschnitt PDFGenerator

Schritt 10: Fehlermeldung anlegen

Legen Sie im Parameter InstantVoucherError des Abschnittes <NotifyMessages-Txt> Ihrer Shopkonfiguration shop.config eine Fehlermeldung fest.

<NotifyMessages-Txt>
...
   InstantVoucherError = Es ist ein Fehler aufgetreten. Bitte versuchen Sie es erneut oder wenden Sie sich an den Shopbetreiber.
...
</NotifyMessages-Txt>

Referenz: NotifyMessages-Txt

Schritt 11: Download-Option in der Bestellhistorie zur Verfügung stellen

Um zu vermeiden, dass die E-Mail zur Bestellbestätigung gelöscht wird und der Kunde dann keine Möglichkeit mehr hat, den Gutschein auszudrucken, können Sie auf der WEBSALE-Bestellhistorie (ws_order_history.htm) einen Download-Link hinzufügen:

{@OH-S-Item}
...
   {@OH-S-InstantVoucherProduct}
      <a href="~WS-Start~~OH-P-PDFLinkPart~">Gutschein ausdrucken</a>
      Gutscheinnummer: ~OH-P-Number~
   {/@OH-S-InstantVoucherProduct}
...
{/@OH-S-Item}

Referenz: OH-S-"technische ID"

Referenz: OH-P-"technische ID"

Referenz: WS-Start

Wenden Sie sich bitte an das WEBSALE Support-Team, falls Sie hierzu Fragen haben.