> ## Documentation Index > Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt > Use this file to discover all available pages before exploring further. # INSTANTVOUCHER- (Kaufgutscheine zum Ausdrucken) > Betrag, Nummer, Währung und Gültigkeit eines gekauften Gutscheins im PDF-Template ausgeben, mit sauberer Behandlung unbefristeter Gutscheine. Kaufgutscheine zum Ausdrucken sind Gutscheine, die der Kunde als Produkt bestellt und anschließend als PDF erhält. Das Aussehen dieses PDF bestimmen Sie über ein eigenes Template, und die `INSTANTVOUCHER-`Tags füllen es mit den Daten des gekauften Gutscheins. Alle sieben Tags gelten ausschließlich in diesem Template. Welches es ist, legen Sie in der Shopkonfiguration `shop.config` im Abschnitt `` beim Parameter `InstantVoucherPDF` fest. Außerhalb dieses Templates bleiben die Tags leer, weil die Gutscheindaten dort nicht vorliegen. Die Tags beschreiben immer genau einen Gutschein, nämlich den gerade erzeugten. Bestellt ein Kunde mehrere, entsteht für jeden ein eigenes PDF aus demselben Template. Wegweiser: [Kaufgutscheine zum Ausdrucken](https://dokumentation.websale.de/v8s/gutscheine-anbieten/kaufgutscheine-zum-ausdrucken.md) · Referenz: Abschnitt Templates ## Die Werte des Gutscheins | Tag | Liefert | | - | - | | `INSTANTVOUCHER-Amount` | den Wert des Gutscheins, im Preisformat des Shops | | `INSTANTVOUCHER-CurrencyCode` | den Währungscode, beispielsweise EUR | | `INSTANTVOUCHER-CurrencySymbol` | das Währungssymbol, beispielsweise € | | `INSTANTVOUCHER-VoucherNumber` | die Gutscheinnummer | | `INSTANTVOUCHER-ValidUntil_day` | den Tag, bis zu dem der Gutschein gilt | | `INSTANTVOUCHER-ValidUntil_month` | den zugehörigen Monat | | `INSTANTVOUCHER-ValidUntil_year` | das zugehörige Jahr | ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}

~INSTANTVOUCHER-Amount~ ~INSTANTVOUCHER-CurrencySymbol~

Gutscheinnummer: ~INSTANTVOUCHER-VoucherNumber~

``` `INSTANTVOUCHER-Amount` ist bereits im Preisformat des Shops formatiert, also mit dem eingestellten Dezimal- und Tausendertrennzeichen. Sie müssen nichts nachformatieren und können das Tag auch nicht mit einer anderen Stellenzahl aufrufen. Währungscode und Währungssymbol sind zwei verschiedene Tags, weil beide ihre Berechtigung haben. Das Symbol liest sich neben dem Betrag natürlicher, der Code ist eindeutig und eignet sich für den Fußbereich oder für Gutscheine, die ins Ausland gehen. ## Die Gültigkeit ausgeben Die drei Datumsbestandteile sind einzelne Tags, damit Sie das Datum in der Schreibweise des jeweiligen Landes zusammensetzen können. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} Gültig bis ~INSTANTVOUCHER-ValidUntil_day~.~INSTANTVOUCHER-ValidUntil_month~.~INSTANTVOUCHER-ValidUntil_year~ ``` > [!WARNING] > > Nicht jeder Gutschein ist befristet. Ist kein Gültigkeitsdatum hinterlegt, geben alle drei Tags nichts aus, und aus der Zeile oben wird ein nacktes "Gültig bis .." auf dem gedruckten Gutschein. Klammern Sie die Zeile deshalb. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {INSTANTVOUCHER-ValidUntil_year}

Gültig bis ~INSTANTVOUCHER-ValidUntil_day~.~INSTANTVOUCHER-ValidUntil_month~.~INSTANTVOUCHER-ValidUntil_year~

{/INSTANTVOUCHER-ValidUntil_year} {!INSTANTVOUCHER-ValidUntil_year}

Dieser Gutschein ist unbefristet gültig.

{/!INSTANTVOUCHER-ValidUntil_year} ``` Prüfen Sie dabei das Jahr. Das Shopsystem gibt den Tag nur aus, wenn er zwischen 1 und 31 liegt, den Monat nur zwischen 1 und 12 und das Jahr nur ab 2015. Fehlt das Datum, sind alle drei leer. Das Jahr ist von den dreien das aussagekräftigste, weil ein gültiges Datum immer eines hat. ## Auf einen bestimmten Wert prüfen Jedes der sieben Tags lässt sich als Klammerung mit einem Vergleichswert im Argument verwenden. Der Bereich greift dann, wenn der Wert genau übereinstimmt. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {INSTANTVOUCHER-CurrencyCode(EUR)}

Einlösbar in allen deutschen Filialen.

{/INSTANTVOUCHER-CurrencyCode(EUR)} {INSTANTVOUCHER-CurrencyCode(CHF)}

Einlösbar in allen Schweizer Filialen.

{/INSTANTVOUCHER-CurrencyCode(CHF)} ``` Die Schreibweise des Vergleichswerts spielt keine Rolle. > [!WARNING] > > Beim Betrag vergleichen Sie gegen den **formatierten** Wert, also gegen die Zeichenkette, die das Tag auch ausgeben würde. `{INSTANTVOUCHER-Amount(50)}` greift deshalb nicht bei einem Fünfzig-Euro-Gutschein, weil das Tag "50,00" liefert. Für Fallunterscheidungen nach Betragshöhe ist dieses Verfahren ungeeignet. ## Die Tags im Überblick | Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag | | - | - | - | - | - | | `INSTANTVOUCHER-Amount` | ja | ja | ja | – | | `INSTANTVOUCHER-CurrencyCode` | ja | ja | ja | – | | `INSTANTVOUCHER-CurrencySymbol` | ja | ja | ja | – | | `INSTANTVOUCHER-VoucherNumber` | ja | ja | ja | – | | `INSTANTVOUCHER-ValidUntil_day` | ja | ja | ja | – | | `INSTANTVOUCHER-ValidUntil_month` | ja | ja | ja | – | | `INSTANTVOUCHER-ValidUntil_year` | ja | ja | ja | – | Alle sieben Tags verhalten sich gleich. Sie gelten nur in dem Template, das unter `InstantVoucherPDF` eingetragen ist. Die Schreibweise des Tagnamens spielt keine Rolle. ## Verwandte Themen * Wegweiser: [Kaufgutscheine zum Ausdrucken](https://dokumentation.websale.de/v8s/gutscheine-anbieten/kaufgutscheine-zum-ausdrucken.md) * Referenz: [VOUCHER- (Gutscheine)](https://dokumentation.websale.de/v8s/referenz/tags/voucher-gutschein.md) * Referenz: [Abschnitt Templates](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#templates) ## Related topics - [Kaufgutscheine zum Ausdrucken](https://dokumentation.websale.de/v8s/gutscheine-anbieten/kaufgutscheine-zum-ausdrucken.md) - [Kaufgutscheine mit mehreren Motiven anbieten](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-kaufgutscheine-mehrere-motive.md) - [Gutscheine im Warenkorb](https://dokumentation.websale.de/v8s/referenz/tags/basket/gutscheine-im-warenkorb.md) - [PDF-Anhang der Bestelleingangsbestätigung](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/pdf-anhang-der-bestelleingangsbestaetigung.md) - [Gutscheine anbieten: Übersicht](https://dokumentation.websale.de/v8s/gutscheine-anbieten/gutscheine-anbieten-uebersicht.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.