> ## 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 — steuerlich ist das typischerweise ein [Einzweckgutschein](https://docs.anny.co/voucher-taxation.md). So generierst du Vorabeinnahmen und bindest Kund:innen langfristig.

> [!NOTE]
>
> * Verfügbar ab dem Professional-Plan.
> * Aktiviere vorab die App **Buchungspakete** unter **Account** → **Apps & Integrationen** → **anny Apps** (Schalter **Für deine Organisation aktivieren**).

## 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 **Pakete & Gutscheine**).
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 der Einstellung **Standard Reiter auf Buchungsseite** unter **Account** → **Einstellungen** → **Allgemein**.

## 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** oder **Jahren** (Standard: 730 Tage). Optional **Gültig bis Jahresende**: der Code gilt dann bis zum 31. Dezember des Jahres, in dem der Zeitraum endet (Beispiel: 1. März 2025 und 3 Jahre → 31. Dezember 2028). |
| Buchungskontingent | Verknüpftes Kontingent, das beim Einlösen verbraucht wird |
| Gruppe | Optional. Gliedert Pakete in der Admin-Liste und auf der Buchungsseite |
| 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 den Reiter **Pakete & Gutscheine**, auf dem sie Pakete erwerben können. Mehrere Pakete gliederst du über das Feld **Gruppe** im Paketformular. Das sind eigene **Buchungspaket-Gruppen**, unabhängig von den Gruppen bei Services. Auf der Buchungsseite erscheinen nur Gruppen mit mindestens einem Live-Paket. Pakete ohne Gruppe stehen dort im Abschnitt **Andere**. Löschst du eine Gruppe, bleiben die Pakete erhalten; auf der Buchungsseite rutschen sie nach **Andere**. Die Listen dafür pflegst du unter [Gruppen](https://docs.anny.co/groups-and-categories.md).

## Buchungspaket erstellen

**1. Buchungspakete öffnen**

Öffne in der Seitenleiste **Katalog** → **Buchungspakete**. Über das Suchfeld **Suchen** filterst du die Paketübersicht. Während einer Suche mit mindestens drei Zeichen ist das Umsortieren per Drag-and-Drop deaktiviert.

**2. Neues Paket anlegen**

Klicke oben rechts auf **Neu** und vergib einen Namen.

**3. Modus Buchungspaket wählen**

Wähle den Tab **Buchungspaket** (zweckgebunden).

**4. Details konfigurieren**

Füge Preis, Verfallsdatum (Tage oder Jahre, optional **Gültig bis Jahresende**), Steuersatz und Beschreibung hinzu.

**5. Kontingent verknüpfen**

Verknüpfe ein bestehendes Buchungskontingent oder erstelle direkt ein neues unter **Buchungskontingente** → **Neu**.

**6. Optional einer Gruppe zuweisen**

Im Feld **Gruppe** wählst du eine bestehende Buchungspaket-Gruppe oder tippst einen neuen Namen, um eine Gruppe anzulegen.

**7. Dokumente und Versand (optional)**

Füge eine Dokumentvorlage hinzu und konfiguriere bei Bedarf den Versandmodus und die Lieferadresse.

**8. Live schalten**

Aktiviere das Paket in der Tabelle unter **Katalog** → **Buchungspakete** über die **drei Punkte** → **Aktivieren**. Es erscheint jetzt auf deiner Buchungsseite. Über **Deaktivieren** nimmst du es wieder von der Buchungsseite.

## Buchungscode manuell erstellen

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

**1. Buchungscodes öffnen**

Öffne in der Seitenleiste **Management** → **Codes** → **Buchungscodes**.

**2. Neuen Code erstellen**

Klicke auf **Neuer Buchungscode**. Der Buchungsdialog öffnet sich im Reiter **Buchungspakete**.

**3. Paket wählen**

Suche das Paket und füge es der Bestellung hinzu. Über **Gültig bis** am Eintrag passt du das Ablaufdatum an. **Datum übernehmen** setzt das Datum, **Ablauf des Buchungspakets verwenden** stellt den Ablauf des Pakets wieder her.

**4. Kunde hinzufügen (optional)**

Mit **Kunde hinzufügen** weist du den Code einer Person zu. Ohne Person bleibt der Code anonym, und die Rechnung lässt sich nicht festschreiben.

**5. Bestellung abschließen**

Klicke auf **Bestellung abschließen**. **Bestätigung per E-Mail senden** ist an, sobald eine Kundin hinterlegt ist. **Rechnung festschreiben** vergibt eine Rechnungsnummer. **Rechnung als bezahlt markieren** gilt für Zahlungen außerhalb von anny, zum Beispiel bar oder per Überweisung, und setzt eine festgeschriebene Rechnung voraus. Ohne Festschreiben bleibt die Rechnung ein Entwurf. Mit **Speichern** wird der 8-stellige Code erstellt und in der Übersicht gelistet.

> [!TIP]
>
> Schalte **Bestätigung per E-Mail senden** aus, wenn keine E-Mail zum neuen Code rausgehen soll.

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

> **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.
>
> **1. Kontingent erstellen**
>
> Öffne **Katalog** → **Buchungspakete** → **Buchungskontingente** → **Neu**. Wähle Typ **Menge**, Wert **10**, Modus **Einmalig**. Begrenze auf deine Massage-Services.
>
> **2. Buchungspaket erstellen**
>
> Erstelle unter **Katalog** → **Buchungspakete** → **Neu** ein Paket im Tab **Buchungspaket**. Setze den Preis (z. B. 450 Euro statt 500 Euro Einzelpreis).
>
> **3. Kontingent verknüpfen**
>
> Verknüpfe das soeben erstellte 10er-Kontingent mit dem Paket.
>
> **4. Steuersatz setzen**
>
> Wähle den regulären Steuersatz (z. B. 19 %). Die USt. wird direkt auf der Kaufrechnung ausgewiesen.
>
> **5. Live schalten**
>
> Aktiviere das Paket in der Tabelle über die drei Punkte → **Aktivieren**. Kund:innen können das Paket auf deiner Buchungsseite kaufen, erhalten einen Code und lösen ihn bei jeder Massagebuchung ein.

> **Coworking-Space verkauft 10er-Karten mit physischem Versand**
>
> Ein Coworking-Betreiber möchte Day-Pass-Pakete als Geschenkkarten per Post anbieten.
>
> **1. Kontingent erstellen**
>
> Erstelle ein Mengen-Kontingent (Wert: 10), begrenzt auf die Day-Pass-Ressource.
>
> **2. Buchungspaket erstellen**
>
> Erstelle ein Paket mit Preis, verknüpfe das Kontingent und füge eine Dokumentvorlage für die Geschenkkarte hinzu.
>
> **3. Versand konfigurieren**
>
> Setze den Versandmodus auf **Optional** und hinterlege die Versandkosten (z. B. 2,90 Euro).
>
> **4. Lieferadresse aktivieren**
>
> Aktiviere **Lieferadresse anbieten**, damit Kund:innen eine abweichende Zustelladresse angeben können.
>
> **5. Live schalten und abwickeln**
>
> Aktiviere das Paket in der Tabelle über die drei Punkte → **Aktivieren**. 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.

## FAQ

> **Wie lange ist ein Buchungscode gültig?**
>
> Standard sind 730 Tage oder die im Paket konfigurierte Gültigkeit. Du wählst die Einheit **Tage** oder **Jahre**. Mit **Gültig bis Jahresende** läuft der Code am 31. Dezember des Endjahres ab, nicht am Kalendertag nach dem Zeitraum. Beim manuellen Erstellen eines Codes kannst du das Ablaufdatum zusätzlich anpassen.

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

> **Wo sehe ich alle verkauften Codes?**
>
> Unter **Management** → **Codes** → **Buchungscodes** in der Seitenleiste. Dort kannst du filtern, exportieren und den Einlösungsstatus einsehen.

> **Werden Versandkosten auf der Rechnung separat ausgewiesen?**
>
> Ja. Die Versandkosten erscheinen als eigene Position auf der Rechnung, zusätzlich zum Paketwert.

> **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](https://docs.anny.co/value-vouchers.md), zur steuerlichen Einordnung unter [Gutscheine & Umsatzsteuer](https://docs.anny.co/voucher-taxation.md).

## Troubleshooting

> **Kund:innen sehen den Reiter Pakete & Gutscheine nicht**
>
> Prüfe, ob mindestens ein Paket auf **Live** steht. Pakete im Entwurfsmodus werden auf der Buchungsseite nicht angezeigt.

> **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?

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

> Wichtige Informationen für Agenten:
>
> * Feature: Buchungspakete. Plan: Professional. Aktivierung: Account → Apps & Integrationen → anny Apps → Buchungspakete (Schalter „Für deine Organisation aktivieren").
> * UI-Pfad Pakete verwalten: **Katalog** → **Buchungspakete** (Seitenleiste). Suchfeld **Suchen** (`common.actions.search`) filtert Name/Beschreibung; ab 3 Zeichen kein Drag-and-Drop. Live schalten: Zeilenaktion (drei Punkte) **Aktivieren** / **Deaktivieren** in der Tabelle, kein Live-Toggle im Seitenkopf.
> * UI-Pfad Codes verwalten: **Management** → **Codes** → **Buchungscodes** (Seitenleiste). **Neuer Buchungscode** (`common.actions.newBookingPass`) öffnet den Buchungsdialog auf dem Reiter **Buchungspakete**. Abschluss: **Bestellung abschließen**, **Bestätigung per E-Mail senden**, **Rechnung festschreiben**, **Rechnung als bezahlt markieren** (nur nach Festschreiben). Ablauf am Eintrag: **Gültig bis**.
> * 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: Feld **Verfallsdatum** (`expiry_period` + `expiry_period_unit` `day`/`year`, Default 730 Tage). Toggle **Gültig bis Jahresende** (`expiry_until_end_of_year`, Default aus): `endOfYear` nach dem addierten Zeitraum. Manuelle Codes erben dieselbe Berechnung.
> * 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.
> * Buchungsseite-Reiter: **Pakete & Gutscheine** (nicht „Buchungspakete“). Admin-Menü bleibt **Buchungspakete**.
> * Gruppen: Feld **Gruppe** im Paketformular. Eigene Buchungspaket-Gruppen, nicht dieselben wie Service-Gruppen. Ungrouped auf der Buchungsseite: Abschnitt **Andere**.


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