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

# Wertgutscheine

> Biete flexible Geldwert-Gutscheine an, die Kund:innen als Zahlungsmittel bei beliebigen Buchungen einlösen können.

Ein Wertgutschein ist ein Mehrzweckgutschein mit reinem Geldwert, den Kund:innen flexibel für beliebige kostenpflichtige Leistungen einsetzen können. Im Gegensatz zu zweckgebundenen Buchungspaketen ist der Gutschein nicht an eine bestimmte Ressource oder ein Kontingent gebunden, sondern funktioniert beim Einlösen als Zahlungsmittel.

<Info>
  * Verfügbar ab dem Professional-Plan.
  * Aktiviere vorab das Feature **Buchungspakete** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert das Konzept?

Wertgutscheine nutzen eine besondere steuerliche Logik (Mehrzweckgutschein gemäß EU-Richtlinie):

1. **Beim Kauf**: Die Rechnung weist 0 % USt. aus. Der Kunde zahlt nur den Nettobetrag, da zum Kaufzeitpunkt noch unklar ist, für welche Leistung (mit welchem Steuersatz) der Gutschein eingesetzt wird.
2. **Beim Einlösen**: Der Gutscheinwert wird als Zahlungsmittel auf die Buchung angerechnet. Die korrekte Umsatzsteuer wird erst auf der finalen Buchungsrechnung ausgewiesen.

Das unterscheidet Wertgutscheine grundlegend von zweckgebundenen Buchungspaketen, bei denen die USt. bereits beim Kauf berechnet wird.

**Zwei Varianten:**

* **Fester Betrag**: Du definierst einen exakten Wert (z. B. 50 Euro). Kund:innen kaufen genau diesen Betrag.
* **Freier Betrag**: Kund:innen wählen den Wert selbst. Du setzt optional einen Standardbetrag und einen Mindestbetrag.

Nach dem Kauf erhalten Kund:innen einen **8-stelligen Buchungscode**, den sie im Checkout einer beliebigen kostenpflichtigen Buchung als Zahlungsmittel eingeben.

## Wann nutze ich das?

* **Du möchtest Geschenkgutscheine verkaufen**: Kund:innen kaufen einen Gutschein für Freunde oder Familie, die sich selbst aussuchen, was sie buchen.
* **Du willst Kund:innen einen flexiblen Wunschbetrag ermöglichen**: Aktiviere den freien Betrag mit Mindestgrenze.
* **Du möchtest bei Stornierungen kein Geld zurückerstatten, sondern Guthaben binden**: Verknüpfe den Wertgutschein mit deinen Stornierungsbedingungen.
* **Du brauchst Gutscheine für Promotions oder Entschädigungen**: Erstelle Codes manuell im Admin-Bereich.
* **Nicht geeignet für**: Kontingente für eine bestimmte Leistung (z. B. 10er-Karte). Nutze dafür ein zweckgebundenes Buchungspaket.

## Zusammenhang mit anderen Features

| Feature                 | Zusammenhang                                                                                                                      |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Buchungspakete & Codes  | Wertgutscheine sind ein Modus innerhalb der Buchungspakete-Funktion. Die Code-Logik ist identisch.                                |
| Stornierungsbedingungen | Wertgutscheine können als Erstattungsform konfiguriert werden. Bei Stornierung erhält der Kunde automatisch einen Code.           |
| Online-Zahlung          | Der Gutscheinwert wird beim Einlösen mit dem Buchungspreis verrechnet. Bei Teilverrechnung zahlt der Kunde den Restbetrag online. |

## Einstellungen & Optionen

| Einstellung (Admin)       | Beschreibung                                                                            |
| ------------------------- | --------------------------------------------------------------------------------------- |
| Fester Betrag             | Exakter Gutscheinwert, z. B. 50 Euro                                                    |
| Freier Betrag             | Kund:innen wählen selbst                                                                |
| Standardbetrag            | Vorausgefüllter Wert bei freiem Betrag                                                  |
| Mindestbetrag             | Untergrenze bei freiem Betrag                                                           |
| Verfallsdatum             | Gültigkeit des Codes (Standard: 2 Jahre)                                                |
| Rechtliche Dokumente      | Dokumente, die beim Kauf bestätigt werden müssen                                        |
| Nutzung begrenzen         | Einlösung auf bestimmte Ressourcen einschränken (Kategorie, Gruppe, Ressource, Service) |
| Dokumentvorlage           | Dokument, das beim Kauf an Kund:innen gesendet wird                                     |
| Vor-Ort-Dokumentvorlage   | Zweites Template nur für Admin-Zwecke (z. B. Ausdruck)                                  |
| Lieferadresse anbieten    | Abweichende Lieferadresse im Checkout abfragen                                          |
| Geschäftsadresse anbieten | Geschäftsadresse im Checkout abfragen                                                   |
| Versand                   | Deaktiviert, Optional oder Immer (inkl. Versandkosten)                                  |
| Stornierung als Gutschein | Verknüpfung mit Stornierungsbedingungen einer Ressource                                 |

Auf der Buchungsseite erscheinen Wertgutscheine im Reiter "Buchungspakete". Bei freiem Betrag sehen Kund:innen ein Eingabefeld für ihren Wunschbetrag.

## Wertgutschein erstellen

<Steps>
  <Step title="Buchungspakete öffnen">
    Öffne **Buchungspakete** in der Menüleiste links.
  </Step>

  <Step title="Neues Paket anlegen">
    Klicke auf **Neu+** und wähle den Tab **Wertgutschein**.
  </Step>

  <Step title="Name und Betrag konfigurieren">
    Vergib einen Namen (z. B. "Geschenkgutschein"). Trage einen festen Standardbetrag ein (z. B. 50 Euro) oder setze den Mindestbetrag auf 0, damit Kund:innen den Betrag frei wählen können.
  </Step>

  <Step title="Verfallsdatum setzen">
    Lege die Gültigkeit in Tagen fest (Standard: 720 Tage).
  </Step>

  <Step title="Beschreibung hinzufügen">
    Ergänze eine Beschreibung, die auf der Buchungsseite angezeigt wird.
  </Step>

  <Step title="Optionale Einstellungen">
    Konfiguriere bei Bedarf: Dokumentvorlage, Nutzung begrenzen, Lieferadresse anbieten, Geschäftsadresse anbieten und Versandmodus.
  </Step>

  <Step title="Live schalten">
    Aktiviere den **Live-Toggle** oben rechts. Der Wertgutschein erscheint jetzt auf deiner Buchungsseite im Reiter "Buchungspakete".
  </Step>
</Steps>

<Tip>
  In den Account-Einstellungen kannst du festlegen, ob Buchungspakete auf der Buchungsseite als Standardreiter angezeigt werden.
</Tip>

## Nutzung begrenzen

Obwohl Wertgutscheine grundsätzlich als Mehrzweckgutschein konzipiert sind, kannst du die Einlösung optional auf bestimmte Ressourcen einschränken. Klicke dazu im Paket-Editor auf **Nutzung begrenzen** und wähle eine oder mehrere Ressourcen, Gruppen, Kategorien oder Services aus.

<Tip>
  Die Begrenzung ist optional. Ohne Einschränkung kann der Gutschein für jede kostenpflichtige Buchung in deiner Organisation eingelöst werden.
</Tip>

## Versandmodus und Lieferadresse

Wenn du physische Gutscheinkarten per Post versenden möchtest, kannst du pro Wertgutschein einen Versandmodus einstellen:

| Modus       | Verhalten                                                           |
| ----------- | ------------------------------------------------------------------- |
| Deaktiviert | Kein Versand, rein digitale Zustellung                              |
| Optional    | Kund:innen wählen im Checkout, ob Versand gewünscht ist             |
| Immer       | Versand ist verpflichtend, Versandkosten werden automatisch addiert |

Zusätzlich kannst du einen Versandkostenbetrag hinterlegen, der zum Gutscheinpreis addiert wird.

Mit den Toggles **Lieferadresse anbieten** und **Geschäftsadresse anbieten** fragst du im Checkout zusätzliche Adressfelder ab, damit die Zustellung an die richtige Adresse erfolgt.

Im Admin-Bereich siehst du, welche Gutscheine noch versendet werden müssen, und kannst sie nach dem Versand als **versendet** markieren.

## Stornierung als Wertgutschein konfigurieren

Anstatt bei einer Stornierung den Betrag zurückzuüberweisen, kannst du den Stornierungswert automatisch in einen Buchungscode umwandeln. Der Kunde erhält den Code per E-Mail und kann ihn bei der nächsten Buchung einlösen. Richte dies in der jeweiligen Buchungsoption im Reiter **Änderung & Stornierung** ein.

<Warning>
  Die automatische Gutschein-Erstattung funktioniert nur bei bereits festgeschriebenen Rechnungen. Bei Rechnungsentwürfen greift die Logik nicht.
</Warning>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Kosmetikstudio mit Geschenkgutscheinen (fester Betrag)">
    Ein Studio möchte 50-Euro-Gutscheine verkaufen, die Kund:innen für beliebige Behandlungen einlösen können.
  </Accordion>

  <Accordion title="Yoga-Studio mit Stornierungsguthaben statt Rückerstattung">
    Ein Studio möchte bei Stornierungen keinen Geldbetrag zurückerstatten, sondern Kund:innen einen Gutschein für die nächste Buchung geben.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Warum steht auf der Kaufrechnung 0 % USt.?">
    Das ist die korrekte steuerliche Behandlung eines Mehrzweckgutscheins. Da beim Kauf noch nicht feststeht, für welche Leistung der Gutschein eingesetzt wird, darf keine USt. ausgewiesen werden. Die Steuer wird erst bei der Einlösung berechnet.
  </Accordion>

  <Accordion title="Was passiert, wenn der Gutscheinwert höher ist als der Buchungspreis?">
    Nur der benötigte Betrag wird vom Gutschein abgezogen. Das Restguthaben bleibt auf dem Code erhalten und kann bei einer späteren Buchung verwendet werden.
  </Accordion>

  <Accordion title="Kann ein Wertgutschein für mehrere Buchungen genutzt werden?">
    Ja, solange noch Restguthaben auf dem Code vorhanden ist.
  </Accordion>

  <Accordion title="Funktioniert die Stornierung als Gutschein auch bei Teilerstattungen?">
    Ja. Der Gutscheincode wird mit dem jeweiligen Erstattungsbetrag ausgestellt, inklusive gebuchter Add-ons.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen kein Eingabefeld für den freien Betrag">
    Prüfe, ob der Modus auf **Wertgutschein** gesetzt ist und der frei wählbare Betrag aktiviert wurde. Stelle zudem sicher, dass Kund:innen über die übergeordnete Organisationsseite zugreifen, nicht über einen direkten Ressourcen-Link.
  </Accordion>

  <Accordion title="Bei Stornierung wird kein Gutscheincode verschickt">
    Die automatische Umwandlung greift nur bei festgeschriebenen Rechnungen. Prüfe, ob die Rechnung zum Zeitpunkt der Stornierung bereits finalisiert war. Bei Rechnungsentwürfen wird kein Code generiert.
  </Accordion>

  <Accordion title="Der Gutscheincode wird beim Einlösen nicht akzeptiert">
    Prüfe die Gültigkeit des Codes (Verfallsdatum). Importierte Codes können in seltenen Fällen Verrechnungsfehler auslösen. Wende dich mit dem Code an den Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Wertgutscheine (Modus B der Buchungspakete). Plan: Professional.
> * UI-Pfad: **Buchungspakete** (Menüleiste) → Neu+ → Modus Wertgutschein.
> * UI-Pfad Stornierung als Gutschein: Ressource → Buchungsoptionen → **Änderung & Stornierung**.
> * Steuerlogik: Kauf = 0 % USt. (Mehrzweckgutschein). Einlösung = USt. auf Buchungsrechnung.
> * Stornierungsgutschein: NUR bei festgeschriebenen Rechnungen. Add-ons werden eingerechnet.
> * Restguthaben: Bleibt auf dem Code erhalten, kann mehrfach verwendet werden.
> * Freier Betrag: Nur über Organisationsseite erreichbar, nicht über Direkt-Links zu Ressourcen.
> * Abgrenzung Buchungspaket (Modus A): Zweckgebunden, USt. beim Kauf, Einlösung = Rabatt.
> * Abgrenzung Rabattcodes: Prozentual/absoluter Preisnachlass im Checkout, kein Guthaben.
> * TWINT: Unterstützt keine Gutscheinzahlung separat, der Gutschein wird vor der Zahlung verrechnet.
> * Nutzung begrenzen: Optional, Einschränkung auf Ressource/Gruppe/Kategorie/Service. Ohne Begrenzung = für alle kostenpflichtigen Buchungen gültig.
> * Versandmodus (seit Juni 2026): Deaktiviert/Optional/Immer. Versandkosten werden addiert. Admin kann als "versendet" markieren.
> * Lieferadresse/Geschäftsadresse: Toggle pro Gutschein, fragt zusätzliche Adressfelder im Checkout ab.
> * Vor-Ort-Dokumentvorlage (seit Juli 2026): Zweites Dokument nur für Admin-Zwecke, wird nicht an Kund:innen gesendet.