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

# Produkte & Zusatzoptionen

> Biete Produkte wie Getränke oder Equipment sowie zusätzliche und empfohlene Ressourcen direkt im Buchungsprozess an.

Mit Zusatzoptionen erweiterst du die Buchung eines Services um drei Dinge: **Produkte** (Extras wie Getränke, Handtücher oder Equipment), **Zusätzliche Ressourcen** (werden als Sub-Buchung im selben Zeitraum mitgebucht) und **Empfohlene Ressourcen** (werden beim Checkout als eigene Buchung vorgeschlagen). Produkte legst du zentral unter **Produkte** an. Welche Zusatzoptionen ein Service anbietet, legst du im Tab **Zusatzoptionen** des Services fest.

> [!NOTE]
>
> Den Tab **Zusatzoptionen** siehst du erst, wenn das Feature aktiv ist. Öffne dafür in der Seitenleiste **Apps & Integrationen**, wähle die Kategorie **anny Apps** und öffne **Service Zusatzoptionen**. Schalte dort **Für deine Organisation aktivieren** ein.

## Wie funktionieren Zusatzoptionen?

### Produkte

Produkte sind Extras, die Kund:innen während der Buchung zu einem Service hinzufügen. Die Verfügbarkeit ist unbeschränkt, abgerechnet wird nach gewählter Anzahl und hinterlegtem Preis.

Alle Produkte deiner Organisation findest du in der Seitenleiste unter **Produkte**. Die Tabelle zeigt pro Produkt die Gruppe, den Preis, die Preisart und ob es hervorgehoben ist oder von Dritten angeboten wird. Über die Filter **Gruppe**, **Hervorgehoben** und **Drittanbieter** grenzt du die Liste ein.

![Seite Produkte: Tabelle mit sieben Produkten wie Handtuchverleih, Yogamatte und Protein-Shake, jeweils mit Gruppe, Preis, Preisart und den Spalten Hervorgehoben und Drittanbieter](https://mintcdn.com/anny-85c98540/F42XR9Qo633KmWK1/images/add-ons/products-list.png?fit=max\&auto=format\&n=F42XR9Qo633KmWK1\&q=85\&s=4639a76bff7f1a946f38627e1909ad58)

Der Ablauf:

1. Du legst ein Produkt mit Name, Preis und Regeln an.
2. Du ordnest es einem oder mehreren Services zu.
3. Kund:innen sehen das Produkt bei der Buchung dieser Services und können es hinzufügen.
4. Die Abrechnung erfolgt automatisch anhand von Anzahl und Preis.

#### Preisarten

| Preisart | Beschreibung |
| - | - |
| Preis pro Einheit | Festpreis pro Stück, z. B. 3 € pro Yogamatte. |
| Preis pro Intervall | Preis pro Zeiteinheit der Buchung. Unter **Abrechnung pro** legst du das Intervall fest, z. B. 1 Stunde. Abgerechnet wird jedes angefangene Intervall. |
| Relativer Preis | Prozentsatz der Zwischensumme der Buchung. Alle Produkte ohne relativen Preis zählen zur Zwischensumme, Sub-Buchungen nicht. Beispiel: 20 % bei 20 € Zwischensumme ergeben 4 €. |

Mit **Staffelpreis hinzufügen** legst du einen günstigeren Preis ab einer bestimmten Anzahl fest. Ab dieser Anzahl gilt der Staffelpreis für die gesamte Menge. Beispiel: Eine Yogamatte kostet 3 €, ab 5 Stück 2,50 € pro Stück. Wer 6 Matten bucht, zahlt 15 €.

Mit **Preis ausblenden** zeigst du Kund:innen keinen Preis an, z. B. wenn der finale Preis erst nach der Buchung feststeht.

#### Produktgruppen

Produkte lassen sich in Gruppen ordnen, z. B. "Getränke" oder "Equipment". Gruppen sind optional. Eine neue Gruppe legst du direkt im Feld **Gruppe** eines Produkts an, indem du einen neuen Namen eintippst. Alle Gruppen verwaltest du in den **Einstellungen** im Reiter **Gruppen** unter **Produktgruppen**.

### Zusätzliche Ressourcen

Zusätzliche Ressourcen werden zusammen mit dem Service gebucht. Kund:innen wählen sie nach dem Datum aus. Die Ressource wird als Sub-Buchung an die Hauptbuchung gehängt und übernimmt immer deren Zeitraum (**Gleicher Zeitraum**). Ändert sich die Hauptbuchung, passt sich die Sub-Buchung an. Das Datum der Sub-Buchung selbst lässt sich nicht ändern.

### Empfohlene Ressourcen

Empfohlene Ressourcen werden beim Checkout als separate Buchungen angeboten. Pro Empfehlung wählst du den **Vorausgewählten Service** und den **Zeitraum** relativ zur Buchung des Services. Kund:innen legen die Empfehlung als eigene Buchung in den Warenkorb.

| Zeitraum | Beschreibung |
| - | - |
| Innerhalb des Zeitraums | Die empfohlene Buchung liegt im Zeitfenster der Hauptbuchung. |
| Nach Buchungsende | Die empfohlene Buchung beginnt nach dem Ende der Hauptbuchung. |
| Vor Buchungsbeginn | Die empfohlene Buchung endet vor dem Beginn der Hauptbuchung. |
| Übernachtungen | Die empfohlene Buchung wird als Übernachtung gebucht. |

## Wann nutze ich das?

* **Du bietest Extras zu einer Buchung an** (z. B. Getränke, Leihmaterial, eine Bewirtungspauschale): Nutze **Produkte**.
* **Du willst eine weitere Ressource fest an die Buchung koppeln** (z. B. einen zweiten Raum im selben Zeitraum): Nutze **Zusätzliche Ressourcen**.
* **Du willst ergänzende Angebote vorschlagen, die als eigene Buchung funktionieren** (z. B. einen Parkplatz oder einen Raum nach dem Kurs): Nutze **Empfohlene Ressourcen**.
* **Nicht geeignet für**: Abhängige Ressourcen, die unsichtbar im Hintergrund blockiert werden sollen (z. B. ein Raum, der automatisch mitgebucht wird). Dafür nutzt du [Smart Availability](https://docs.anny.co/smart-availability.md).

## Zusammenhang mit anderen Features

* [**Smart Availability**](https://docs.anny.co/smart-availability.md): Smart Availability blockiert Ressourcen im Hintergrund. Zusatzoptionen sind für Kund:innen sichtbar und wählbar.
* [**Änderung von Buchungen**](https://docs.anny.co/modify-bookings.md): Ist im Tab **Änderung & Stornierung** des Services **Nachträgliche Bearbeitung von Serviceoptionen erlauben** aktiv, können Kund:innen ihre Produkte nach der Buchung selbst anpassen.
* [**Dynamisches Pricing**](https://docs.anny.co/dynamic-pricing.md): Produktpreise sind unabhängig von den dynamischen Preismodifikatoren des Services.
* [**Wiederkehrende Buchungen**](https://docs.anny.co/recurring-bookings.md): Produkte werden bei Serien pro Termin übernommen und können pro Termin angepasst werden.

## Produkt anlegen

**1. Produkte öffnen**

Öffne in der Seitenleiste **Produkte** und klicke auf **Neu**. Es öffnet sich ein Fenster zum Anlegen.

**2. Name und Gruppe festlegen**

Gib einen **Name** ein, wähle optional eine **Gruppe** und klicke auf **Speichern**. Die Detailseite des neuen Produkts öffnet sich.

**3. Allgemeine Informationen ergänzen**

Lade bei Bedarf ein **Titelbild** hoch und ergänze **Untertitel** und **Beschreibung**. Diese Texte sehen Kund:innen bei der Auswahl.

**4. Preis festlegen**

Wähle unter **Preisgestaltung** die Preisart, gib den Preis ein und prüfe die **UST. Rate**. Füge bei Bedarf Staffelpreise hinzu. Der Preis erscheint nun oben unter dem Produktnamen.

**5. Mengen und Regeln festlegen**

Öffne **Mengen & Vorauswahl** sowie **Buchung & Abrechnung** und passe die Einstellungen an. Änderungen speicherst du mit **Speichern** oben rechts.

**6. Services zuordnen**

Wechsle zum Abschnitt **Services** und wähle rechts unter **Alle Services** die Services aus, bei denen das Produkt angeboten wird. Die Services erscheinen links in der Liste.

![Detailseite eines Produkts, Abschnitt Preisgestaltung: Preis pro Einheit 3 Euro, UST. Rate 19 %, zwei Staffelpreise ab 5 und ab 10 Stück, darunter die Bereiche Mengen & Vorauswahl und Buchung & Abrechnung](https://mintcdn.com/anny-85c98540/F42XR9Qo633KmWK1/images/add-ons/products-detail.png?fit=max\&auto=format\&n=F42XR9Qo633KmWK1\&q=85\&s=5d0a283845f6f4fc85e5ead3180b156d)

## Zusatzoptionen eines Services einrichten

**1. Service öffnen**

Öffne in der Seitenleiste **Services**, wähle den Service aus und wechsle zum Tab **Zusatzoptionen**. Du siehst die Abschnitte **Produkte**, **Zusätzliche Ressourcen** und **Empfohlene Ressourcen**.

**2. Produkte zuordnen**

Klicke im Abschnitt **Produkte** rechts unter **Alle Produkte** auf das Plus-Icon neben einem Produkt oder ziehe es nach links. Mit **Neu** legst du direkt hier ein neues Produkt an. Das Produkt steht nun links in der Liste des Services.

**3. Reihenfolge festlegen**

Ziehe die Produkte links am Griff in die gewünschte Reihenfolge. In dieser Reihenfolge sehen Kund:innen sie bei der Buchung.

**4. Ressourcen hinzufügen**

Füge in den Abschnitten **Zusätzliche Ressourcen** und **Empfohlene Ressourcen** auf dieselbe Weise Ressourcen aus **Alle Ressourcen** hinzu. Bei empfohlenen Ressourcen wählst du anschließend **Vorausgewählter Service** und **Zeitraum**.

**5. Speichern**

Klicke oben rechts auf **Speichern**. Die Zusatzoptionen erscheinen ab sofort bei der Buchung dieses Services.

![Service Barre class, Tab Zusatzoptionen: links vier zugeordnete Produkte mit Preis, rechts Alle Produkte mit weiteren Produkten und der Schaltfläche Neu](https://mintcdn.com/anny-85c98540/F42XR9Qo633KmWK1/images/add-ons/products-service.png?fit=max\&auto=format\&n=F42XR9Qo633KmWK1\&q=85\&s=19d0136cfdd18e5ade446d7ecf3383c5)

> [!TIP]
>
> Die Zuordnung funktioniert in beide Richtungen: Am Produkt wählst du die Services, am Service die Produkte. Die Reihenfolge der Produkte legst du immer am jeweiligen Service fest.

## Einstellungen & Optionen

### Produkt: Allgemeine Informationen

| Einstellung | Beschreibung |
| - | - |
| Titelbild | Optionales Bild im Format 16:9 (PNG, JPG). |
| Name | Bezeichnung des Produkts. Pflichtfeld, übersetzbar. |
| Untertitel | Kurzer Hinweis unter dem Namen, z. B. "Nach jedem Kurs gereinigt". |
| Gruppe | Optionale Produktgruppe. Tippe einen neuen Namen ein, um eine Gruppe anzulegen. |
| Beschreibung | Ausführliche Beschreibung mit Formatierung. |

### Produkt: Preisgestaltung

| Einstellung | Beschreibung |
| - | - |
| Preisart | **Preis pro Einheit**, **Preis pro Intervall** oder **Relativer Preis**. |
| Preis | Betrag mit Währung und Brutto oder Netto. Beim relativen Preis ein Prozentsatz. |
| UST. Rate | Umsatzsteuersatz, Standard 19 %. |
| Abrechnung pro | Nur bei **Preis pro Intervall**: das Intervall, pro angefangenem Intervall wird abgerechnet. |
| Preis ausblenden | Kund:innen sehen keinen Preis. |
| Staffelpreis | **Ab Anzahl** plus Preis. Ab dieser Anzahl gilt der Staffelpreis für die gesamte Menge. |

### Produkt: Mengen & Vorauswahl

| Einstellung | Beschreibung |
| - | - |
| Min. Anzahl | Mindestmenge, sobald das Produkt gewählt ist. Standard: 0. |
| Max. Anzahl | Höchstmenge pro Buchung. Leer bedeutet uneingeschränkt. |
| Immer anwenden | Erscheint, sobald **Min. Anzahl** größer als 0 ist. Standard: an. Wenn aktiv, wird das Produkt mit der Mindestanzahl vorausgewählt und kann nicht abgewählt werden. Wenn inaktiv, bleibt das Produkt optional und die Mindestanzahl gilt erst nach der Auswahl. Bei aktivem **Immer anwenden** entfällt die Vorlaufzeit. |

### Produkt: Buchung & Abrechnung

| Einstellung | Beschreibung |
| - | - |
| Für die Bereitstellung dieses Produkts erforderliche Vorlaufzeit | Mindestabstand zwischen Buchung und Beginn. Bei kurzfristigeren Buchungen wird das Produkt nicht angeboten. |
| Hervorgehoben | Das Produkt erscheint prominent unter der Auswahl von Datum und Uhrzeit. |
| Vollständige Rückerstattung bei Stornierung | Bei einer Stornierung wird der Produktbetrag immer voll erstattet, unabhängig von den Stornierungsbedingungen des Services. |
| Dieses Produkt wird von Dritten angeboten und in Rechnung gestellt | Das Produkt wird von Dritten abgerechnet und zählt nicht gegen das Prepaid-Guthaben der Buchung. |

### Zusätzliche Ressourcen

| Einstellung | Beschreibung |
| - | - |
| Ressource | Die Ressource, die im **Gleichen Zeitraum** mitgebucht wird. |

### Empfohlene Ressourcen

| Einstellung | Beschreibung |
| - | - |
| Ressource | Die empfohlene Ressource. |
| Vorausgewählter Service | Der Service, mit dem die Empfehlung gebucht wird. |
| Zeitraum | **Innerhalb des Zeitraums**, **Nach Buchungsende**, **Vor Buchungsbeginn** oder **Übernachtungen**. |

## Praxisbeispiele

> **Fitnessstudio mit Leihmatten und Getränken (Produkte)**
>
> Ein Studio möchte bei Kursbuchungen Yogamatten und Getränke anbieten.
>
> **1. Produkte anlegen**
>
> Öffne **Produkte**, klicke auf **Neu** und lege "Yogamatte" mit der Gruppe "Equipment" an. Setze unter **Preisgestaltung** einen **Preis pro Einheit** von 3 € und füge einen Staffelpreis ab 5 Stück hinzu. Lege auf dieselbe Weise "Protein-Shake" mit der Gruppe "Getränke" an.
>
> **2. Dem Kurs zuordnen**
>
> Öffne unter **Services** den Kurs, wechsle zum Tab **Zusatzoptionen** und füge beide Produkte aus **Alle Produkte** hinzu. Die Produkte stehen nun links in der Liste.
>
> **3. Testen**
>
> Öffne die Buchungsseite und buche den Kurs. Die Produkte werden im Buchungsprozess angezeigt.

> **Tagungszentrum mit Zusatzraum (Zusätzliche Ressource)**
>
> Ein Tagungszentrum bietet einen Besprechungsraum an, der im selben Zeitraum wie der Hauptraum gebucht wird.
>
> **1. Service öffnen**
>
> Öffne unter **Services** den Service des Hauptraums und wechsle zum Tab **Zusatzoptionen**.
>
> **2. Zusätzliche Ressource hinzufügen**
>
> Füge im Abschnitt **Zusätzliche Ressourcen** den Besprechungsraum aus **Alle Ressourcen** hinzu und speichere. Der Raum trägt das Label **Gleicher Zeitraum**.
>
> **3. Testen**
>
> Erstelle eine Testbuchung. Nach der Datumsauswahl erscheint der Besprechungsraum als Option. Wählst du ihn, entsteht eine Sub-Buchung im Zeitraum der Hauptbuchung.

> **Coworking Space mit Parkplatz-Empfehlung (Empfohlene Ressource)**
>
> Ein Coworking Space empfiehlt Parkplätze als separate Buchung für denselben Zeitraum.
>
> **1. Service öffnen**
>
> Öffne unter **Services** den Service des Arbeitsplatzes und wechsle zum Tab **Zusatzoptionen**.
>
> **2. Empfohlene Ressource hinzufügen**
>
> Füge im Abschnitt **Empfohlene Ressourcen** die Parkplatz-Ressource hinzu. Wähle den **Vorausgewählten Service** und setze den **Zeitraum** auf **Innerhalb des Zeitraums**. Speichere die Änderungen.
>
> **3. Testen**
>
> Erstelle eine Testbuchung. Beim Checkout erscheint der Parkplatz als Empfehlung und lässt sich als separate Buchung in den Warenkorb legen.

## FAQ

> **Was ist der Unterschied zwischen Produkten, zusätzlichen und empfohlenen Ressourcen?**
>
> Produkte sind Extras ohne eigene Buchung (z. B. Getränke). Zusätzliche Ressourcen erzeugen eine Sub-Buchung, die immer den Zeitraum der Hauptbuchung übernimmt. Empfohlene Ressourcen werden beim Checkout vorgeschlagen und als eigene, separate Buchung in den Warenkorb gelegt.

> **Sind Produkte dasselbe wie Add-Ons?**
>
> Ja. Im Admin heißen die früheren Add-Ons jetzt **Produkte**. Du findest sie in der Seitenleiste unter **Produkte** und im Tab **Zusatzoptionen** eines Services im Abschnitt **Produkte**.

> **Was ist der Unterschied zwischen Zusatzoptionen und Smart Availability?**
>
> Zusatzoptionen sind für Kund:innen sichtbar und wählbar. Smart Availability blockiert Ressourcen unsichtbar im Hintergrund (z. B. einen abhängigen Raum).

> **Können Kund:innen Produkte nach der Buchung ändern?**
>
> Ja, wenn im Tab **Änderung & Stornierung** des Services **Nachträgliche Bearbeitung von Serviceoptionen erlauben** aktiv ist.

> **Kann ich den Preis eines Produkts ausblenden?**
>
> Ja. Aktiviere **Preis ausblenden**, wenn der finale Preis erst später feststeht, z. B. bei verbrauchsabhängiger Abrechnung. Kund:innen sehen dann keinen Preis.

> **Was bewirkt Immer anwenden?**
>
> **Immer anwenden** erscheint, sobald **Min. Anzahl** größer als 0 ist, und ist standardmäßig aktiv. Dann wird das Produkt mit der Mindestanzahl vorausgewählt und kann nicht abgewählt werden. Schaltest du es aus, bleibt das Produkt optional: Kund:innen wählen es selbst, und erst danach gilt die Mindestanzahl. Bei Serien gilt dieselbe Regel pro Termin.

> **Wie wirkt ein Staffelpreis?**
>
> Ab der unter **Ab Anzahl** eingetragenen Menge gilt der Staffelpreis für alle Einheiten, nicht nur für die zusätzlichen. Bei mehreren Staffeln greift die höchste erreichte Stufe.

## Troubleshooting

> **Der Tab Zusatzoptionen fehlt am Service**
>
> Das Feature ist nicht aktiv. Aktiviere unter **Apps & Integrationen** in der Kategorie **anny Apps** die App **Service Zusatzoptionen**.

> **Das Produkt erscheint nicht im Buchungsprozess**
>
> Prüfe, ob das Produkt dem richtigen Service zugeordnet ist. Es muss im Tab **Zusatzoptionen** des Services links stehen oder am Produkt im Abschnitt **Services** aufgeführt sein. Produkte, die nur unter **Alle Produkte** stehen, sind noch keinem Service zugeordnet.

> **Kund:innen können das Produkt nicht auswählen**
>
> Die Vorlaufzeit des Produkts ist wahrscheinlich nicht eingehalten. Prüfe unter **Buchung & Abrechnung** die erforderliche Vorlaufzeit: Ist die Buchung zu kurzfristig, wird das Produkt nicht angeboten.

> **Die empfohlene Ressource wird beim Checkout nicht angezeigt**
>
> Prüfe Ressource, **Vorausgewählter Service** und **Zeitraum** der Empfehlung. Stelle sicher, dass die Ressource im gewählten Zeitraum verfügbar ist.

> Wichtige Informationen für Agenten:
>
> * Admin-UI-Name: **Produkte** (früher Add-Ons; API-Typ `add-ons`, Berechtigung `add-ons`). Seitenleiste **Produkte** im Katalog, sichtbar mit Berechtigung zum Anzeigen von Produkten.
> * Feature aktivieren: **Apps & Integrationen** → Kategorie **anny Apps** → **Service Zusatzoptionen** → **Für deine Organisation aktivieren** (Feature-Key `additional-service-options`). Ohne Feature fehlt der Service-Tab **Zusatzoptionen**.
> * Service-Tab **Zusatzoptionen** hat drei Abschnitte: **Produkte**, **Zusätzliche Ressourcen**, **Empfohlene Ressourcen**.
> * Produkt anlegen: **Produkte** → **Neu** (Name, Gruppe) → Detailseite mit **Allgemeine Informationen** und **Services**. Detailbereiche: **Preisgestaltung**, **Mengen & Vorauswahl**, **Buchung & Abrechnung**.
> * Zuordnung in beide Richtungen: am Produkt (Abschnitt **Services**, rechts **Alle Services**) oder am Service (rechts **Alle Produkte**). Reihenfolge (`order_index` auf `service-add-ons`) nur am Service per Drag & Drop.
> * Preisarten: `unit` (Preis pro Einheit), `interval` (Preis pro Intervall, **Abrechnung pro** = `calculation_interval` + `calculation_unit`, pro angefangenem Intervall), `relative` (Prozent der Zwischensumme ohne relative Produkte und ohne Sub-Buchungen).
> * Staffelpreise (`staggered_pricing`, **Ab Anzahl** = `min_quantity`): höchste erreichte Stufe ersetzt den Stückpreis für die gesamte Menge.
> * **Immer anwenden** (`always_apply`, Default `true`): nur sichtbar bei Min. Anzahl > 0. An = vorausgewählt und nicht abwählbar; Aus = optional, Min. gilt erst nach Auswahl. Vorlaufzeit wird bei aktivem Immer anwenden auf 0 gesetzt.
> * Weitere Felder: **Preis ausblenden** (`is_price_hidden`), **Hervorgehoben** (`featured`), **Vollständige Rückerstattung bei Stornierung** (`full_refund`), Drittanbieter (`is_third_party`, zählt nicht gegen Prepaid-Guthaben), Vorlaufzeit (`lead_time`, Minuten).
> * Produktgruppen: im Feld **Gruppe** per Eintippen anlegen oder unter **Einstellungen** → Reiter **Gruppen** → **Produktgruppen** verwalten.
> * Zusätzliche Ressourcen: `booking_type` `sub_booking`, Label **Gleicher Zeitraum**, Sub-Buchung übernimmt immer den Zeitraum der Hauptbuchung, Auswahl nach dem Datum.
> * Empfohlene Ressourcen: separate Buchung beim Checkout; **Vorausgewählter Service** und **Zeitraum** (innerhalb, nach Buchungsende, vor Buchungsbeginn, Übernachtungen).
> * Nachträgliche Änderung durch Kund:innen: Service-Tab **Änderung & Stornierung** → **Nachträgliche Bearbeitung von Serviceoptionen erlauben**.
> * Zusatzoptionen ≠ Smart Availability: Zusatzoptionen sichtbar und wählbar, Smart Availability blockiert unsichtbar im Hintergrund.
> * Verwandte Artikel: /smart-availability, /configure-booking-option, /modify-bookings, /dynamic-pricing, /recurring-bookings


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