> ## 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.

# Gutschein bearbeiten Seitenreferenz

> Beschreibt alle Felder, Bereiche und Aktionen des Gutscheinformulars in VOUCHER!: Titel, Beschreibung, Kategorien, Vorlage, Gültigkeit, Einlösung und Gutscheinelemente.

Das Gutscheinformular dient zum Erstellen und Bearbeiten einzelner Gutscheine innerhalb der VOUCHER! (der Online-Gutscheinverkauf) Komponente. Du erreichst das Formular über die Gutscheinübersicht durch Klick auf einen bestehenden Gutschein oder über **Neu**.

Jedes Textfeld ist mehrsprachig und wird pro Sprache (Deutsch, Italienisch, Englisch) eingegeben. Du wechselst die Sprache über die Sprachauswahl oberhalb der Felder.

## Allgemein

| Feld                                              | Gültige Werte                        | Hinweise                                                                                                                                                                                                                                 |
| ------------------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Titel**                                         | Freitext pro Sprache                 | Titel des Gutscheins, der im Widget und auf dem Gutschein angezeigt wird.                                                                                                                                                                |
| **Beschreibung**                                  | Freitext pro Sprache                 | Beschreibung des Gutscheins, die im Widget unterhalb des Titels angezeigt wird.                                                                                                                                                          |
| **Kategorien**                                    | Alle bestehenden Gutscheinkategorien | Kategorien, in denen dieser Gutschein im Widget angezeigt werden soll. Mehrfachauswahl möglich. Wenn keine Kategorie ausgewählt ist, erscheint der Gutschein nicht in einer Kategorie-Filterung.                                         |
| **Bild für Vorschau**                             | Bild aus der Bildverwaltung          | Vorschaubild, das im Widget bei der Gutscheinauswahl angezeigt wird. Pflichtfeld.                                                                                                                                                        |
| **Vorlage**                                       | Alle aktiven Gutscheinvorlagen       | Die Gestaltungs­vorlage, die für die Erzeugung des PDF-Gutscheins verwendet wird. Über **Konfigurieren** öffnest du den Editor für die Vorlagenkonfiguration (siehe Abschnitt „Vorlagenkonfiguration"). Pflichtfeld.                     |
| **Gültigkeit in Tagen**                           | Unbegrenzt, Begrenzt                 | „Unbegrenzt": Der Gutschein hat kein Ablaufdatum. „Begrenzt": Es erscheint ein zusätzliches Feld für die Anzahl Tage ab Kauf. Standard bei „Begrenzt": 365 Tage.                                                                         |
| **Anzahl Tage**                                   | Ganzzahl ≥ 1                         | Nur sichtbar, wenn **Gültigkeit in Tagen** auf „Begrenzt" steht. Bestimmt, wie viele Tage ab Kauf der Gutschein eingelöst werden kann.                                                                                                   |
| **Einmalige vollständige Einlösung erforderlich** | Checkbox (aktiviert/deaktiviert)     | Aktiviert: Der Gutschein kann nur ein einziges Mal eingelöst werden, dabei wird der gesamte Wert verbraucht. Deaktiviert (Standard): Der Gutschein kann in mehreren Schritten teilweise eingelöst werden, bis der Wert aufgebraucht ist. |

## Vorlagenkonfiguration

Über den Knopf **Konfigurieren** im Feld **Vorlage** öffnest du den Bildschirm zur Anpassung der ausgewählten Vorlage. Die Konfiguration bestimmt, wie der ausgestellte Gutschein als PDF aussieht.

| Feld                                         | Gültige Werte                                                    | Hinweise                                                                                                                                                                                                                                                 |
| -------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Auswählbare Bilder**                       | Mehrere Bilder aus der Bildverwaltung                            | Aus diesen Bildern wählt der Käufer beim Kauf eines aus. Über **Konfigurieren** öffnest du den Bildmanager. Die Reihenfolge legst du per Drag-and-Drop über den Hamburger-Knopf fest. Das ausgewählte Standardbild ist mit einem grünen Rahmen markiert. |
| **Logo**                                     | Bild aus der Bildverwaltung                                      | Logo des Betriebs, das auf dem Gutschein angezeigt wird. Pflichtfeld. Das Standardlogo muss ersetzt werden, bevor du speichern kannst.                                                                                                                   |
| **Preis kann beim Kauf ausgeblendet werden** | Ja, Nein                                                         | Bei „Ja" kann der Käufer beim Kauf entscheiden, ob der Preis auf dem Gutschein angezeigt wird.                                                                                                                                                           |
| **Preis standardmäßig anzeigen**             | Ja, Nein                                                         | Bei „Ja" wird der Preis auf dem Gutschein standardmäßig angezeigt. Nur relevant, wenn **Preis kann beim Kauf ausgeblendet werden** auf „Ja" steht.                                                                                                       |
| **Angezeigte Kontaktdaten**                  | Name, E-Mail, Telefon, Website, Postleitzahl, Stadt, Straße, CIN | Mehrfachauswahl, welche Kontaktdaten des Betriebs auf dem Gutschein erscheinen sollen.                                                                                                                                                                   |
| **Anrede** (pro Sprache)                     | Freitext pro Sprache                                             | Anrede auf dem Gutschein. Kann beim Kauf vom Käufer geändert werden.                                                                                                                                                                                     |
| **Nachricht** (pro Sprache)                  | Freitext pro Sprache                                             | Nachricht auf dem Gutschein. Kann beim Kauf vom Käufer geändert werden.                                                                                                                                                                                  |
| **Ausgestellt am** (pro Sprache)             | Freitext pro Sprache                                             | Text, der das Ausstellungsdatum auf dem Gutschein beschreibt.                                                                                                                                                                                            |
| **Einlösbar bis** (pro Sprache)              | Freitext pro Sprache                                             | Text, der das Ablaufdatum auf dem Gutschein beschreibt.                                                                                                                                                                                                  |
| **Preisbeschreibung** (pro Sprache)          | Freitext pro Sprache                                             | Text, der den Preis auf dem Gutschein beschreibt.                                                                                                                                                                                                        |
| **Hinweis** (pro Sprache)                    | Freitext pro Sprache                                             | Kleingedruckter Hinweis auf dem Gutschein.                                                                                                                                                                                                               |

## Gutscheinelemente

Im Abschnitt **Gutscheinelemente** legst du fest, was der Gutschein konkret beinhaltet. Es gibt zwei Typen, die du über die Knöpfe **Leistungs-Element hinzufügen** und **Wert-Element hinzufügen** anlegst.

* Mehrere Leistungs-Elemente sind erlaubt (z. B. eine Massage und ein Frühstück).
* Pro Gutschein ist maximal ein Wert-Element erlaubt. Der Knopf **Wert-Element hinzufügen** ist deaktiviert, sobald bereits ein Wert-Element vorhanden ist.

Über den Hamburger-Knopf an einem Element änderst du die Reihenfolge per Drag-and-Drop. Über den Löschen-Knopf entfernst du ein Element.

### Wert-Element

Ein Wert-Element ist ein Geldbetrag. Beim Kauf legt der Käufer im Widget innerhalb der vorgegebenen Grenzen den Wert fest.

| Feld             | Gültige Werte        | Hinweise                                                                                               |
| ---------------- | -------------------- | ------------------------------------------------------------------------------------------------------ |
| **Titel**        | Freitext pro Sprache | Titel des Wert-Elements, der im Widget und auf dem Gutschein angezeigt wird. Standard: „Wert-Element". |
| **Beschreibung** | Freitext pro Sprache | Beschreibung des Wert-Elements im Widget. Standard: „Geldwert auswählen".                              |
| **Standardwert** | Dezimalzahl in Euro  | Beim Aufruf im Widget vorausgewählter Wert. Muss zwischen **Mindestwert** und **Maximalwert** liegen.  |
| **Mindestwert**  | Dezimalzahl in Euro  | Kleinster Wert, den der Käufer auswählen kann. Standard: 50 €.                                         |
| **Maximalwert**  | Dezimalzahl in Euro  | Größter Wert, den der Käufer auswählen kann. Standard: 1.000 €.                                        |

### Leistungs-Element

Ein Leistungs-Element entspricht einer konkreten Leistung aus deinen Extras (z. B. eine Massage). Beim Kauf legt der Käufer im Widget die Anzahl der Einheiten fest.

| Feld               | Gültige Werte                                      | Hinweise                                                                                                                                             |
| ------------------ | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Extra**          | Alle Extras aus den Extra-Kategorien des Mandanten | Auswahl der Leistung, auf die sich das Gutscheinelement bezieht. Nur Extras aus Kategorien mit mindestens einem Extra werden angeboten. Pflichtfeld. |
| **Standardanzahl** | Ganzzahl                                           | Beim Aufruf im Widget vorausgewählte Anzahl. Muss zwischen **Mindestanzahl** und **Maximalanzahl** liegen.                                           |
| **Mindestanzahl**  | Ganzzahl ≥ 0                                       | Kleinste Anzahl an Einheiten, die der Käufer auswählen kann.                                                                                         |
| **Maximalanzahl**  | Ganzzahl                                           | Größte Anzahl an Einheiten, die der Käufer auswählen kann.                                                                                           |

## Abhängigkeiten

* Das Feld **Anzahl Tage** ist nur sichtbar, wenn **Gültigkeit in Tagen** auf „Begrenzt" steht.
* Der Knopf **Wert-Element hinzufügen** ist deaktiviert, sobald bereits ein Wert-Element in den Gutscheinelementen vorhanden ist.
* Vor dem Speichern müssen ein **Bild für Vorschau**, mindestens ein Bild unter **Auswählbare Bilder**, ein Standardbild und ein eigenes **Logo** gewählt sein. Fehlende Pflichtangaben werden beim Speichern als Fehler angezeigt.
* **Extra** im Leistungs-Element zeigt nur Extras an, deren Kategorie mindestens ein Extra enthält. Sind keine Extras im Mandanten angelegt, kann kein Leistungs-Element gespeichert werden.

## Aktionen

| Aktion                      | Beschreibung                                                     |
| --------------------------- | ---------------------------------------------------------------- |
| **Konfigurieren**           | Öffnet die Vorlagenkonfiguration für den aktuellen Gutschein.    |
| **Speichern**               | Speichert den Gutschein. Die Seite bleibt geöffnet.              |
| **Speichern und schließen** | Speichert den Gutschein und kehrt zur Gutscheinübersicht zurück. |
| **Löschen**                 | Löscht den aktuellen Gutschein nach Bestätigung.                 |

## Verwandte Artikel

* [Einen neuen Gutschein erstellen](./create-voucher) -- Schritt-für-Schritt-Anleitung
* [Gutscheinkategorie bearbeiten Seitenreferenz](./voucher-category-edit) -- Felder einer Gutscheinkategorie
* [VOUCHER! Einstellungen Seitenreferenz](../voucher) -- alle Felder und Einstellungen der Komponente
* [VOUCHER! einrichten](../setup-voucher) -- Voraussetzungen und Einrichtungsschritte
