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

# Rabattcodes

> Erstelle absolute oder prozentuale Rabattcodes, die Kund:innen im Checkout eingeben, um einen Preisnachlass auf ihre Buchung zu erhalten.

Mit Rabattcodes bietest du deinen Kund:innen einen direkten Preisnachlass im Checkout. Du erstellst einen Code, legst den Rabatt fest (absolut oder prozentual) und bestimmst optional, für welche Ressourcen er gilt und wie oft er eingelöst werden darf. Kund:innen geben den Code im Buchungsprozess ein und der Preis wird sofort reduziert.

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

## Wie funktioniert das Konzept?

Ein Rabattcode ist ein frei wählbarer Zeichencode (z. B. "SOMMER20"), den Kund:innen im Checkout eingeben. Der hinterlegte Rabatt wird direkt vom Buchungspreis abgezogen. Im Gegensatz zu Buchungscodes gibt es kein Guthaben, das über mehrere Buchungen hinweg verbraucht wird: Der Rabattcode reduziert den Preis der aktuellen Buchung einmalig.

Die Logik ist einfach:

* Kund:in gibt den Code im Checkout ein.
* anny prüft: Ist der Code gültig (Ablaufdatum, verfügbare Anzahl, passende Ressource)?
* Bei Erfolg wird der Rabatt angewendet und der reduzierte Preis angezeigt.
* Auf der Rechnung erscheint der Originalpreis abzüglich des Rabatts.

<Tip>
  Rabattcodes können auch für kostenlose Buchungen genutzt werden: Setze einen 100-%-Rabatt, um eine Ressource für ausgewählte Personen kostenfrei zugänglich zu machen.
</Tip>

## Wann nutze ich das?

* **Du führst eine Promotion oder Marketingaktion durch**: Erstelle einen Code mit begrenzter Anzahl und Ablaufdatum.
* **Du willst Bestandskund:innen oder Partner:innen einen Sondertarif geben**: Erstelle einen Code mit unbegrenzter Anzahl, beschränkt auf bestimmte Ressourcen.
* **Du möchtest eine Buchung komplett kostenfrei anbieten**: Setze einen 100-%-Rabatt für eine bestimmte Ressource.
* **Nicht geeignet für**: Guthabenlogik über mehrere Buchungen (nutze dafür Buchungspakete/Wertgutscheine) oder wiederkehrende Rabatte auf Abos (Abo-Rabatte werden direkt im Admin bei der Abo-Erstellung hinterlegt).

## Zusammenhang mit anderen Features

| Feature                | Zusammenhang                                                                                                                     |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Buchungspakete & Codes | Abgrenzung: Buchungscodes sind einlösbares Guthaben mit Kontingent. Rabattcodes sind reine Preisnachlässe ohne Guthaben.         |
| Dynamisches Pricing    | Rabattcodes und dynamische Preisregeln können kombiniert werden. Der Rabatt wird auf den dynamisch berechneten Preis angewendet. |
| Zusatzoptionen         | Mit dem Toggle "Zusatzoptionen inkludieren" wird der Rabatt auch auf gebuchte Add-ons angewendet.                                |

## Einstellungen & Optionen

| Einstellung (Admin)        | Beschreibung                                                       |
| -------------------------- | ------------------------------------------------------------------ |
| Gutscheincode              | Der Code, den Kund:innen im Checkout eingeben                      |
| Interne Beschreibung       | Nur für Admins sichtbare Notiz zum Verwendungszweck                |
| Absoluter Rabatt           | Fester Betrag in Euro, der abgezogen wird                          |
| Relativer Rabatt           | Prozentualer Abzug vom Buchungspreis                               |
| Ablaufdatum                | Datum und Uhrzeit, bis wann der Code gültig ist                    |
| Verfügbare Anzahl          | Wie oft der Code insgesamt eingelöst werden kann                   |
| Einmal pro Kunde           | Toggle: begrenzt die Einlösung auf einmal pro Kund:in (per E-Mail) |
| Gültige für Ressourcen     | Optionale Einschränkung auf Ressourcen; leer = accountweit gültig  |
| Zusatzoptionen inkludieren | Rabatt gilt auch für gebuchte Add-ons                              |

Im Checkout sehen Kund:innen ein Eingabefeld für den Rabattcode. Nach erfolgreicher Eingabe wird der reduzierte Preis direkt angezeigt.

<Tip>
  "Gültige für Ressourcen" ist optional. Lässt du das Feld leer, gilt der Rabattcode accountweit für alle Ressourcen. Trage einzelne Ressourcen ein, um den Code gezielt einzuschränken.
</Tip>

## Rabattcode erstellen

<Steps>
  <Step title="Rabattcodes öffnen">
    Öffne **Rabattcodes** in der Menüleiste links (sichtbar nach Feature-Aktivierung).
  </Step>

  <Step title="Neuen Code anlegen">
    Klicke auf **Neu+**. anny generiert automatisch einen Code, den du überschreiben kannst.
  </Step>

  <Step title="Rabatt festlegen">
    Trage entweder einen **absoluten Rabatt** (z. B. 10 Euro) oder einen **relativen Rabatt** (z. B. 20 %) ein. Setze nicht beide gleichzeitig.
  </Step>

  <Step title="Einschränkungen setzen">
    Wähle unter **Gültige für Ressourcen** optional die Ressource(n) aus, für die der Code gelten soll. Lässt du das Feld leer, gilt der Code accountweit. Setze optional ein Ablaufdatum und eine verfügbare Anzahl.
  </Step>

  <Step title="Zusatzoptionen (optional)">
    Aktiviere **Zusatzoptionen inkludieren**, wenn der Rabatt auch auf Add-ons angewendet werden soll.
  </Step>

  <Step title="Einlösung pro Kund:in begrenzen (optional)">
    Aktiviere den Toggle **Einmal pro Kunde**, wenn jede Person den Code nur einmal einlösen darf. anny prüft die Einlösung anhand der E-Mail-Adresse.
  </Step>

  <Step title="Speichern">
    Der Code ist sofort aktiv und kann von Kund:innen im Checkout verwendet werden.
  </Step>
</Steps>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Seminarhaus gibt 20 % Rabatt für eine Frühlingsaktion">
    Ein Seminarhaus möchte im Frühling eine Promotion laufen lassen: 20 % auf alle Räume, begrenzt auf 50 Einlösungen.

    <Steps>
      <Step title="Code erstellen">
        Öffne **Rabattcodes** → **Neu+**. Setze den Code auf "FRUEHLING20".
      </Step>

      <Step title="Rabatt konfigurieren">
        Trage 20 % als relativen Rabatt ein.
      </Step>

      <Step title="Ressourcen zuweisen">
        Wähle unter **Gültige für Ressourcen** alle Seminarräume aus.
      </Step>

      <Step title="Einschränkungen setzen">
        Setze die verfügbare Anzahl auf 50 und das Ablaufdatum auf Ende Mai.
      </Step>

      <Step title="Ergebnis">
        Kund:innen geben "FRUEHLING20" im Checkout ein und erhalten 20 % Rabatt. Nach 50 Einlösungen oder nach dem Ablaufdatum ist der Code nicht mehr gültig.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Betreiber bietet Partner:innen kostenfreie Day Passes">
    Ein Coworking-Space möchte Kooperationspartner:innen kostenfreie Tagesbuchungen ermöglichen, ohne ein Abo oder Kontingent einzurichten.

    <Steps>
      <Step title="Code erstellen">
        Öffne **Rabattcodes** → **Neu+**. Setze den Code auf "PARTNER100".
      </Step>

      <Step title="100 % Rabatt setzen">
        Trage 100 % als relativen Rabatt ein.
      </Step>

      <Step title="Ressource zuweisen">
        Wähle die Day-Pass-Ressource aus.
      </Step>

      <Step title="Anzahl begrenzen">
        Setze die verfügbare Anzahl auf die gewünschte Menge (z. B. 10).
      </Step>

      <Step title="Ergebnis">
        Partner:innen geben "PARTNER100" ein und buchen kostenfrei. Nach 10 Einlösungen ist der Code aufgebraucht.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Kursanbieter gibt einen Rabattcode für den ersten Kursbesuch">
    Ein Aktivitätsanbieter möchte neuen Teilnehmer:innen einen Rabatt für ihren ersten Kursbesuch geben. Jede Person soll den Code genau einmal nutzen können, auch wenn sie später weitere Kurse bucht.

    <Steps>
      <Step title="Code erstellen">
        Öffne **Rabattcodes** → **Neu+**. Setze den Code auf "ERSTERKURS".
      </Step>

      <Step title="Rabatt konfigurieren">
        Trage den gewünschten Rabatt ein, z. B. 50 % als relativen Rabatt.
      </Step>

      <Step title="Ressource zuweisen">
        Wähle unter **Gültige für Ressourcen** die Kurs-Ressource(n) aus.
      </Step>

      <Step title="Einmal pro Kunde aktivieren">
        Aktiviere den Toggle **Einmal pro Kunde**, damit jede Person den Code nur beim ersten Checkout einlösen kann.
      </Step>

      <Step title="Ergebnis">
        Teilnehmer:innen geben "ERSTERKURS" beim ersten Kursbuchen ein und erhalten den Rabatt. Bei späteren Buchungen wird derselbe Code für dieselbe E-Mail-Adresse nicht erneut angerechnet.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich einen Rabattcode für alle Ressourcen gleichzeitig anlegen?">
    Ja. Lass das Feld **Gültige für Ressourcen** einfach leer, dann gilt der Code accountweit für alle Ressourcen. Alternativ wählst du gezielt einzelne Ressourcen aus, um den Code einzuschränken.
  </Accordion>

  <Accordion title="Was passiert, wenn absoluter und relativer Rabatt gleichzeitig gesetzt sind?">
    Setze nur einen der beiden Werte. Wenn versehentlich beide gesetzt sind, wird der relative Rabatt priorisiert.
  </Accordion>

  <Accordion title="Können Kund:innen mehrere Rabattcodes in einer Buchung kombinieren?">
    Nein. Pro Buchung kann nur ein Rabattcode eingegeben werden.
  </Accordion>

  <Accordion title="Gilt der Rabattcode auch für Buchungen auf Anfrage?">
    Ja, sofern im Checkout ein Rabattcode-Eingabefeld angezeigt wird. Bei einigen Konfigurationen (z. B. Sofort-Bestätigung ohne Checkout-Schritt) kann das Feld fehlen.
  </Accordion>

  <Accordion title="Wie stelle ich sicher, dass jede:r Kund:in einen Code nur einmal nutzen kann?">
    Aktiviere beim Erstellen oder Bearbeiten des Codes den Toggle **Einmal pro Kunde**. anny prüft die Einlösung dann anhand der E-Mail-Adresse und rechnet den Code pro Person nur einmal an.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Im Checkout wird kein Feld für den Rabattcode angezeigt">
    Prüfe, ob das Feature **Rabattcodes** unter **Account-Einstellungen** → **Features** aktiviert ist. Stelle zudem sicher, dass für die gebuchte Ressource ein gültiger Code existiert.
  </Accordion>

  <Accordion title="Der Code wird abgelehnt, obwohl er existiert">
    Mögliche Ursachen: Das Ablaufdatum ist überschritten, die verfügbare Anzahl ist aufgebraucht, oder der Code gilt nicht für die ausgewählte Ressource. Prüfe alle drei Einschränkungen. Ist der Toggle **Einmal pro Kunde** aktiv, prüfe zusätzlich, ob die E-Mail-Adresse den Code bereits eingelöst hat.
  </Accordion>

  <Accordion title="Der Rabatt wird im Checkout nicht korrekt angezeigt">
    In eingebetteten Widgets konnte es vorkommen, dass der Originalpreis kurzzeitig angezeigt wird. Lade die Seite neu. Wenn das Problem bestehen bleibt, wende dich an den Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Rabattcodes. Plan: Professional. Aktivierung: Account-Einstellungen → Features → Rabattcodes.
> * UI-Pfad: **Rabattcodes** (Menüleiste links, nach Aktivierung sichtbar).
> * "Gültige für Ressourcen" ist optional. Leer = Code gilt accountweit für alle Ressourcen. Mit Einträgen = Code gilt nur für die gewählten Ressourcen.
> * Pro Buchung nur EIN Rabattcode möglich.
> * Toggle "Einmal pro Kunde": Wenn aktiv, ist der Code pro Kund:in nur einmal einlösbar. Identifikation der Kund:in erfolgt über die E-Mail-Adresse.
> * "Verfügbare Anzahl" (Gesamtzahl aller Einlösungen) und "Einmal pro Kunde" (max. 1 pro Person) sind unabhängig und kombinierbar.
> * Wenn "Einmal pro Kunde" aktiv und dieselbe E-Mail-Adresse den Code bereits eingelöst hat: Code wird im Checkout nicht erneut angerechnet, auch bei späteren Buchungen nicht.
> * Kombination mit Buchungscodes: Möglich. Rabattcode reduziert den Preis, Buchungscode verrechnet Guthaben auf den Restbetrag.
> * Kombination mit dynamischem Pricing: Rabatt wird auf den dynamisch berechneten Endpreis angewendet.
> * Toggle "Zusatzoptionen inkludieren": Wenn aktiv, gilt der Rabatt auf Hauptbuchung + Add-ons. Wenn inaktiv, nur auf Hauptbuchung.
> * Abgrenzung Buchungscodes: Guthaben mit Kontingent, einlösbar über mehrere Buchungen. Rabattcodes: Einmalige Preisreduktion pro Buchung.
> * Abgrenzung Abo-Rabatte: Prozentualer Rabatt bei manueller Abo-Erstellung im Admin. Kein Code, kein Self-Service.
> * Bekanntes Problem: Bei "Buchung auf Anfrage" konnte das Rabattcode-Feld in älteren Versionen fehlen (Bug gefixt).
> * Verwechslungsgefahr für Endkund:innen: "Buchungscode" vs. "Rabattcode" im Checkout. Buchungscode = Paket-Guthaben, Rabattcode = Preisnachlass.