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

# Buchungspakete & Codes

> Erstelle käufliche Pakete und Gutscheine, die Kund:innen als 8-stelligen Buchungscode bei zukünftigen Buchungen einlösen können.

Mit Buchungspaketen bietest du deinen Kund:innen käufliche Leistungspakete an, die sie später per Buchungscode bei einer Buchung einlösen. Ein Buchungspaket ist zweckgebunden: Es enthält ein konkretes Kontingent (z. B. 10 Buchungen für einen bestimmten Kurs) und die Umsatzsteuer wird beim Kauf ausgewiesen. So generierst du Vorabeinnahmen und bindest Kund:innen langfristig.

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

## Wie funktioniert das Konzept?

Ein Buchungspaket ist ein konkretes Leistungskontingent mit festem Preis. Die Umsatzsteuer wird direkt beim Kauf des Pakets ausgewiesen. Das spätere Einlösen des Codes funktioniert technisch als Preisreduzierung (Rabatt) auf die gebuchte Leistung.

Der Ablauf:

1. Du erstellst ein Buchungspaket mit Preis, Beschreibung und verknüpftem Kontingent.
2. Kund:innen kaufen das Paket auf deiner Buchungsseite (Reiter "Buchungspakete").
3. Kund:innen erhalten einen **8-stelligen Buchungscode**.
4. Bei zukünftigen Buchungen geben sie den Code im Checkout ein und der Preis wird reduziert.

<Tip>
  Mit `default-list="packages"` kannst du auf eigenen Webseiten die Buchungspakete als Standardreiter einbetten, unabhängig von den Account-Einstellungen.
</Tip>

## Wann nutze ich das?

* **Du verkaufst Mehrfachkarten** (z. B. 10er-Karte für Kurse): Erstelle ein Buchungspaket mit Mengen-Kontingent.
* **Du möchtest Vorabeinnahmen erzielen und Kund:innen binden**: Pakete mit vergünstigtem Gesamtpreis motivieren zum Kauf.
* **Du willst physische Gutscheinkarten verkaufen**: Nutze den Versandmodus, um Pakete per Post zuzustellen.
* **Nicht geeignet für**: Wiederkehrende Zahlungen (nutze Abos), flexible Geldwert-Gutscheine ohne Zweckbindung (nutze Wertgutscheine) oder reine Preisnachlässe (nutze Rabattcodes).

## Zusammenhang mit anderen Features

| Feature                  | Zusammenhang                                                                                                                  |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| Buchungskontingente      | Jedes Buchungspaket ist mit einem Kontingent verknüpft, das beim Einlösen verbraucht wird.                                    |
| Rechtliche Dokumente     | Dokumente können dem Paket hinzugefügt werden, die im Checkout akzeptiert/unterschrieben werden müssen.                       |
| Wiederkehrende Buchungen | Jeder Serientermin verbraucht das Paket-Kontingent einzeln. Stornierte Termine werden seit Juli 2026 korrekt zurückerstattet. |

## Einstellungen & Optionen

| Einstellung (Admin)       | Beschreibung                                              |
| ------------------------- | --------------------------------------------------------- |
| Name & Beschreibung       | Titel und Erklärungstext für die Buchungsseite            |
| Preis                     | Festpreis inkl. Steuersatz                                |
| Steuersatz                | Regulärer Satz (wird beim Kauf ausgewiesen)               |
| Verfallsdatum             | Gültigkeit des Codes in Tagen (Standard: 730 Tage)        |
| Buchungskontingent        | Verknüpftes Kontingent, das beim Einlösen verbraucht wird |
| 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                          |
| Live/Entwurf              | Sichtbarkeit auf der Buchungsseite                        |

Auf der Buchungsseite sehen Kund:innen einen eigenen Reiter "Buchungspakete", auf dem sie Pakete erwerben können.

## Buchungspaket erstellen

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

  <Step title="Neues Paket anlegen">
    Klicke oben rechts auf **Neu+** und vergib einen Namen.
  </Step>

  <Step title="Modus Buchungspaket wählen">
    Wähle den Tab **Buchungspaket** (zweckgebunden).
  </Step>

  <Step title="Details konfigurieren">
    Füge Preis, Verfallsdatum (in Tagen), Steuersatz und Beschreibung hinzu.
  </Step>

  <Step title="Kontingent verknüpfen">
    Verknüpfe ein bestehendes Buchungskontingent oder erstelle direkt ein neues unter **Buchungskontingente** → **Neu+**.
  </Step>

  <Step title="Dokumente und Versand (optional)">
    Füge eine Dokumentvorlage hinzu und konfiguriere bei Bedarf den Versandmodus und die Lieferadresse.
  </Step>

  <Step title="Live schalten">
    Setze das Paket über den **Live-Toggle** oben rechts auf aktiv. Es erscheint jetzt auf deiner Buchungsseite.
  </Step>
</Steps>

## Buchungscode manuell erstellen

Du kannst Buchungscodes auch direkt im Admin-Bereich ausstellen, z. B. für Bestandskund:innen oder Vor-Ort-Verkäufe.

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

  <Step title="Neuen Code erstellen">
    Klicke auf **Neu+** und wähle das gewünschte Buchungspaket aus.
  </Step>

  <Step title="Kunden zuweisen (optional)">
    Hinterlege eine:n Kund:in für den Code. Anonyme Codes ohne Kundenzuweisung sind ebenfalls möglich.
  </Step>

  <Step title="Rechnungsoptionen wählen">
    Entscheide: **Rechnung fertigstellen** (Kunde zahlt online), **Bereits bezahlt** (Vor-Ort-Zahlung), oder **ohne Rechnung** (Entwurf).
  </Step>

  <Step title="Gültigkeit anpassen">
    Passe bei Bedarf das Ablaufdatum an (Standard: 730 Tage oder Paket-Gültigkeit).
  </Step>

  <Step title="Speichern">
    Der 8-stellige Code wird erstellt und in der Übersicht gelistet. Er kann exportiert oder gefiltert werden.
  </Step>
</Steps>

<Tip>
  Deaktiviere vor dem Speichern die Benachrichtigungs-Glocke, wenn der Kunde nicht per E-Mail über den neuen Code informiert werden soll.
</Tip>

## Versandmodus konfigurieren

Wenn du Buchungspakete als physische Karte oder Brief versenden möchtest, kannst du pro Paket 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 Paketpreis addiert wird. Im Admin-Bereich siehst du, welche Pakete noch versendet werden müssen, und kannst sie nach dem Versand als **versendet** markieren.

## Lieferadresse und Geschäftsadresse

Mit den Toggles **Lieferadresse anbieten** und **Geschäftsadresse anbieten** kannst du im Checkout zusätzliche Adressfelder abfragen. Das ist besonders nützlich, wenn die Standardadresse nicht der tatsächlichen Zustelladresse entspricht (z. B. bei Equipment-Versand ins Homeoffice).

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Massagestudio verkauft eine 10er-Karte">
    Ein Studio möchte 10 Massagen als vergünstigtes Paket anbieten. Kund:innen kaufen die Karte online und lösen sie bei jeder Buchung ein.

    <Steps>
      <Step title="Kontingent erstellen">
        Öffne **Buchungspakete** → **Buchungskontingente** → **Neu+**. Wähle Typ **Menge**, Wert **10**, Modus **Einmalig**. Begrenze auf deine Massage-Services.
      </Step>

      <Step title="Buchungspaket erstellen">
        Erstelle unter **Buchungspakete** → **Neu+** ein Paket im Tab **Buchungspaket**. Setze den Preis (z. B. 450 Euro statt 500 Euro Einzelpreis).
      </Step>

      <Step title="Kontingent verknüpfen">
        Verknüpfe das soeben erstellte 10er-Kontingent mit dem Paket.
      </Step>

      <Step title="Steuersatz setzen">
        Wähle den regulären Steuersatz (z. B. 19 %). Die USt. wird direkt auf der Kaufrechnung ausgewiesen.
      </Step>

      <Step title="Live schalten">
        Aktiviere den Live-Toggle. Kund:innen können das Paket auf deiner Buchungsseite kaufen, erhalten einen Code und lösen ihn bei jeder Massagebuchung ein.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Space verkauft 10er-Karten mit physischem Versand">
    Ein Coworking-Betreiber möchte Day-Pass-Pakete als Geschenkkarten per Post anbieten.

    <Steps>
      <Step title="Kontingent erstellen">
        Erstelle ein Mengen-Kontingent (Wert: 10), begrenzt auf die Day-Pass-Ressource.
      </Step>

      <Step title="Buchungspaket erstellen">
        Erstelle ein Paket mit Preis, verknüpfe das Kontingent und füge eine Dokumentvorlage für die Geschenkkarte hinzu.
      </Step>

      <Step title="Versand konfigurieren">
        Setze den Versandmodus auf **Optional** und hinterlege die Versandkosten (z. B. 2,90 Euro).
      </Step>

      <Step title="Lieferadresse aktivieren">
        Aktiviere **Lieferadresse anbieten**, damit Kund:innen eine abweichende Zustelladresse angeben können.
      </Step>

      <Step title="Live schalten und abwickeln">
        Aktiviere den Live-Toggle. Wenn eine Kund:in den Versand wählt, werden die Versandkosten addiert. Im Admin siehst du offene Sendungen und markierst sie nach Versand als erledigt.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wie lange ist ein Buchungscode gültig?">
    Standard sind 730 Tage (2 Jahre) oder die im Paket konfigurierte Gültigkeit. Die Gültigkeit kann beim Erstellen eines Codes individuell angepasst werden.
  </Accordion>

  <Accordion title="Kann ich Codes ohne Kundenzuweisung erstellen?">
    Ja. Seit Juli 2026 können anonyme Codes ohne hinterlegten Kunden erstellt werden, z. B. für Sammelverkäufe oder Promotions.
  </Accordion>

  <Accordion title="Wo sehe ich alle verkauften Codes?">
    Unter **Buchungscodes** in der Menüleiste. Dort kannst du filtern, exportieren und den Einlösungsstatus einsehen.
  </Accordion>

  <Accordion title="Werden Versandkosten auf der Rechnung separat ausgewiesen?">
    Ja. Die Versandkosten erscheinen als eigene Position auf der Rechnung, zusätzlich zum Paketwert.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Buchungspaket und Wertgutschein?">
    Ein Buchungspaket ist zweckgebunden (konkretes Kontingent, USt. beim Kauf, Einlösung als Rabatt). Ein Wertgutschein ist ein Mehrzweckgutschein (reiner Geldwert, 0 % USt. beim Kauf). Mehr dazu im Artikel Wertgutscheine.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen den Reiter Buchungspakete nicht">
    Prüfe, ob mindestens ein Paket auf **Live** steht. Pakete im Entwurfsmodus werden auf der Buchungsseite nicht angezeigt.
  </Accordion>

  <Accordion title="Der Buchungscode wird im Checkout nicht akzeptiert">
    Prüfe: Ist das Verfallsdatum überschritten? Ist das verknüpfte Kontingent aufgebraucht? Gilt das Kontingent für die gewählte Ressource?
  </Accordion>

  <Accordion title="Importierte Buchungscodes lösen einen Fehler aus">
    Bei importierten Codes kann es vorkommen, dass die Verrechnung beim Einlösen fehlschlägt. Wende dich in diesem Fall an den Support mit Angabe des Paketnamens und des betroffenen Codes.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Buchungspakete. Plan: Professional. Aktivierung: Account-Einstellungen → Features → Buchungspakete.
> * UI-Pfad Pakete verwalten: **Buchungspakete** (Menüleiste links).
> * UI-Pfad Codes verwalten: **Buchungscodes** (Menüleiste links).
> * Buchungspaket = zweckgebunden: USt. beim Kauf, Einlösung = Rabatt auf Buchungspreis.
> * Anonyme Codes (seit Juli 2026): Erstellung ohne Kundenpflicht möglich.
> * Zweites Dokument-Template (seit Juli 2026): Admin-only Dokument, z. B. für Vor-Ort-Ausdruck ("Vor-Ort-Dokumentvorlage").
> * Versandmodus (seit Juni 2026): Deaktiviert/Optional/Immer. Versandkosten werden addiert. Admin kann als "versendet" markieren.
> * Lieferadresse (seit Mai 2026): Toggle pro Paket, fragt abweichende Lieferadresse im Checkout ab.
> * Geschäftsadresse (seit Juli 2026): Toggle pro Paket, fragt Geschäftsadresse im Checkout ab.
> * Verfallsdatum: Standardwert 730 Tage, konfigurierbar pro Paket.
> * Abgrenzung Wertgutscheine: Mehrzweckgutschein, 0 % USt. beim Kauf, Einlösung = Zahlungsmittel. Eigener Artikel.
> * Abgrenzung Rabattcodes: Prozentuale/absolute Preisnachlässe im Checkout OHNE Guthabenlogik.
> * Abgrenzung Abos: Abos = wiederkehrende Zahlungen. Buchungspakete = Einmalkauf.