> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.anex.is/llms.txt
> Use this file to discover all available pages before exploring further.

# Gutscheinvorlage bearbeiten Seitenreferenz

> Beschreibt das Formular einer Gutscheinvorlage im Admin-Bereich der Anexis CLOUD!: Name, Standardkonfiguration, HTML- und CSS-Editoren für Hoch- und Querformat, Live-Vorschau und Prüfung beim Speichern.

Im Formular einer Gutscheinvorlage gestaltest du, wie die Gutscheine von VOUCHER! (der Online-Gutscheinverkauf) als PDF aussehen. Du öffnest es über die Liste **Gutscheinvorlagen**, entweder mit **Neu** oder mit einem Klick auf eine Zeile. Nur Super-Admins können Vorlagen öffnen und speichern.

Die Überschrift lautet bei einer neuen Vorlage „Einstellungen - Neue Vorlage", sonst „Einstellungen - Name". Eine neue Vorlage startet mit dem Namen „Template", einer Standardkonfiguration mit Beispieltexten und leeren HTML- und CSS-Feldern.

## Allgemein

| Feld | Gültige Werte | Hinweise |
| - | - | - |
| **Name** | Freitext, max. 500 Zeichen | Name der Vorlage. Leerzeichen am Anfang und Ende werden entfernt. |

## Konfiguration

Der Bereich **Konfiguration** hat links sechs Registerkarten und rechts eine Live-Vorschau im DIN-A4-Format.

| Feld | Gültige Werte | Hinweise |
| - | - | - |
| **Standardkonfiguration** | Siehe Abschnitt unten | Startwerte für Logo, Bild, Preisanzeige, Kontaktdaten und Texte. Neue Gutscheine der Betriebe übernehmen diese Werte, danach passen die Betriebe sie selbst an. |
| **Allgemeines CSS** | CSS oder SCSS | Gilt für Hoch- und Querformat. Wird vor dem CSS des jeweiligen Formats eingefügt. |
| **HTML (Hochformat)** | HTML mit Handlebars-Ausdrücken | Aufbau des Gutscheins im Hochformat. Die Vorschau wechselt auf Hochformat. |
| **CSS (Hochformat)** | CSS oder SCSS | Styles nur für das Hochformat. Die Vorschau wechselt auf Hochformat. |
| **HTML (Querformat)** | HTML mit Handlebars-Ausdrücken | Aufbau des Gutscheins im Querformat. Die Vorschau wechselt auf Querformat. |
| **CSS (Querformat)** | CSS oder SCSS | Styles nur für das Querformat. Die Vorschau wechselt auf Querformat. |
| **Vorschau** | Gerenderter Gutschein | Aktualisiert sich nach jeder Änderung mit Beispieldaten (Testhotel, Gutscheincode „ACDE2345", Wert 100). Zeigt „Wird geladen..." während der Erzeugung und „Fehler", wenn die Vorlage nicht gerendert werden kann. |

### Standardkonfiguration

| Feld | Gültige Werte | Hinweise |
| - | - | - |
| **Bild** | Bild-URL | Das Bild, das auf dem Gutschein angezeigt wird. Muss eine gültige URL sein. |
| **Logo** | Bild-URL | Logo, das auf dem Gutschein angezeigt wird. Muss eine gültige URL sein. Standard ist das Anexis-Logo. |
| **Preis kann beim Kauf ausgeblendet werden** | Ja, Nein | Legt fest, ob der Käufer den Preis auf dem Gutschein ein- und ausblenden kann. Standard: Nein. |
| **Preis standardmäßig anzeigen** | Ja, Nein | Standard: Ja. Wirkt als Vorauswahl, wenn **Preis kann beim Kauf ausgeblendet werden** auf „Ja" steht. |
| **Angezeigte Kontaktdaten** | Name, E-Mail, Telefon, Website, Postleitzahl, Stadt, Straße, CIN | Mehrfachauswahl. Kontaktdaten des Betriebs, die auf dem Gutschein erscheinen. Standard: alle außer Name und CIN. |
| Sprachregisterkarten | Deutsch, Italienisch, Englisch | Die folgenden Texte pflegst du pro Sprache. Beim Wechsel der Registerkarte zeigt die Vorschau diese Sprache. |
| **Anrede** | Freitext pro Sprache | Anrede auf dem Gutschein. Der Käufer kann sie beim Kauf ändern. |
| **Nachricht** | Freitext pro Sprache | Nachricht auf dem Gutschein. Der Käufer kann sie beim Kauf ändern. |
| **Hinweis** | Freitext pro Sprache | Kleingedruckter Hinweis auf dem Gutschein. |
| **Preisbeschreibung** | Freitext pro Sprache | Text, der den Preis beschreibt. |
| **Ausgestellt am** | Freitext pro Sprache | Text, der das Ausstellungsdatum beschreibt. |
| **Einlösbar bis** | Freitext pro Sprache | Text, der das Ablaufdatum beschreibt. |

### Daten im HTML

Die Gutscheine werden mit [Handlebars](https://handlebarsjs.com/) gerendert. Über die Schaltfläche **Info** unten rechts in den HTML-Editoren öffnest du die vollständige Liste der verfügbaren Daten (RenderingModel). Die wichtigsten Daten:

* `texts.title`, `texts.text` -- Anrede und Nachricht in der Sprache des Gutscheins
* `staticTexts.hint`, `staticTexts.priceDescription`, `staticTexts.issuedOn`, `staticTexts.redeemableUntil` -- die festen Texte
* `companyData` -- Kontaktdaten des Betriebs, zum Beispiel `companyData.name` oder `companyData.city`
* `voucher` -- Gutscheindaten wie `voucher.code`, `voucher.value`, `voucher.dateCreated`, `voucher.validUntil` und `voucher.voucherElements`
* `logo.url`, `selectedImage.url`, `shouldShowPrice`, `visibleCompanyData` -- Werte aus der Konfiguration
* `{{{qrCode}}}` -- QR-Code des Gutscheincodes als SVG
* `{{{style}}}` -- das kompilierte CSS inklusive `<style>`-Tag

Preise formatierst du mit dem Filter `formatPrice`, Datumswerte mit `formatDate`.

## Abhängigkeiten

* Die Vorschau zeigt das Hochformat, solange zuletzt eine Hochformat-Registerkarte aktiv war, und das Querformat nach einer Querformat-Registerkarte. **Standardkonfiguration** und **Allgemeines CSS** behalten das zuletzt gewählte Format.
* **Preis standardmäßig anzeigen** ist für den Käufer nur änderbar, wenn **Preis kann beim Kauf ausgeblendet werden** auf „Ja" steht.
* Beim Speichern rendert die Anexis CLOUD! die Vorlage in Deutsch, Italienisch und Englisch, jeweils im Hoch- und Querformat. Schlägt das fehl, erscheint „Rendering fehlgeschlagen", und die Vorlage wird nicht gespeichert.

## Aktionen

| Aktion | Beschreibung |
| - | - |
| **Info** | Nur in den HTML-Registerkarten. Zeigt Hinweise zu Handlebars und die Liste der verfügbaren Daten. |
| **Speichern** | Prüft und speichert die Vorlage und bleibt im Formular. Tastenkombination: Strg + S. |
| **Speichern und schließen** | Prüft und speichert die Vorlage und kehrt zur Liste **Gutscheinvorlagen** zurück. Tastenkombination: Strg + Umschalt + S. |
| **Eintrag löschen** | Nur bei gespeicherten Vorlagen sichtbar. Löscht die Vorlage nach der Sicherheitsabfrage „Sicher?". Wird sie noch verwendet, erscheint „Vorlage wird noch verwendet". |

## Verwandte Artikel

* [Eine Gutscheinvorlage anlegen](https://docs.cloud.anex.is/de/admin/voucher/create-voucher-template.md) -- Voraussetzungen und Einrichtungsschritte
* [Gutscheinvorlagen ändern und löschen](https://docs.cloud.anex.is/de/admin/voucher/manage-voucher-templates.md) -- Schritt-für-Schritt-Anleitung
* [Gutscheinvorlagen Seitenreferenz](./voucher-templates) -- die Liste aller Vorlagen
* [Gutschein bearbeiten Seitenreferenz](../../mandants/components/voucher/voucher-edit) -- Vorlagenkonfiguration aus Sicht der Betriebe


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.