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

# Buchungskontingente

> Vergib Mengen, Zeitbudgets oder Geldbeträge als wiederverwendbare Kontingente an Kund:innen und steuere so den Zugang zu deinen Ressourcen.

Mit Buchungskontingenten steuerst du, wie viel eine Person buchen darf: als Menge (z. B. 10 Buchungen), als Dauer (z. B. 8 Stunden pro Monat) oder als monetäres Budget (z. B. 200 Euro). Kontingente werden Kund:innen zugewiesen und bei jeder Buchung automatisch verrechnet.

> [!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 Buchungskontingent ist ein Guthaben, das einer Person zugeordnet wird. Bei jeder passenden Buchung wird das Guthaben automatisch reduziert. Kontingente können auf verschiedene Weisen an Kund:innen gelangen:

* **Manuell**: Du weist ein Kontingent direkt in der Kundendetailansicht zu.
* **Über ein Abo**: Das Kontingent wird automatisch erteilt, sobald eine Person einen Abo-Plan abonniert. Endet oder wird das Abo gekündigt, stellt anny keine weiteren Kontingente aus und zieht übrige zum Ablauf ein.
* **Über eine Community**: Alle Mitglieder einer Community erhalten das verknüpfte Kontingent.
* **Über ein Buchungspaket**: Kund:innen kaufen ein Paket (z. B. 10er-Karte) und erhalten einen Buchungscode mit verknüpftem Kontingent.

Kontingente legst du dort an, wo sie vergeben werden: im Abschnitt **Buchungskontingente** eines Buchungspakets (**Katalog** → **Buchungspakete**), eines Abo-Plans (**Katalog** → **Abo-Pläne**) oder einer Community (**CRM** → **Communities**). Klicke dort auf **Hinzufügen oder hierher ziehen** und wähle ein bestehendes Kontingent aus oder lege über **Neu** ein neues an.

Beim Buchen sehen Kund:innen ihre verfügbaren Kontingente nach Auswahl von Datum und Zeitraum. Ein visueller Kreis zeigt verbrauchtes und verbleibendes Guthaben. Sind mehrere Kontingente vorhanden, können Kund:innen wählen, welches genutzt wird.

> [!TIP]
>
> Bei einer Bestellung wird immer das Kontingent verwendet, dessen Gültigkeitszeitraum das Datum der Buchung beinhaltet, nicht das Datum der Bestellung.

## Wann nutze ich das?

* **Du möchtest deinen Mitgliedern ein begrenztes Nutzungsrecht geben** (z. B. 5 Meetingraum-Stunden pro Monat im Coworking-Abo): Erstelle ein wiederkehrendes Dauer-Kontingent und verknüpfe es mit dem Abo-Plan.
* **Du verkaufst Mehrfachkarten** (z. B. 10er-Karte für Yoga): Erstelle ein einmaliges Mengen-Kontingent und verknüpfe es mit einem Buchungspaket.
* **Du willst ein Catering-Budget für Abteilungen begrenzen**: Erstelle ein wiederkehrendes Budget-Kontingent und verknüpfe es mit einer Community.
* **Nicht geeignet für**: Reine Rabatte ohne Guthabenlogik. Nutze dafür Rabattcodes.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Abos & Mitgliedschaften | Kontingente können direkt an einen Abo-Plan geknüpft und bei Verlängerung automatisch erneuert werden. Nach Ablauf oder Kündigung enden die Kontingente; Checkout wendet sie danach nicht mehr an. |
| Communities | Kontingente werden allen Community-Mitgliedern automatisch zugewiesen. |
| Buchungspakete & Codes | Ein Buchungspaket verknüpft ein Kontingent mit einem käuflichen Code (z. B. 10er-Karte). |
| Wiederkehrende Buchungen | Jeder Termin einer Serie verbraucht das Kontingent separat. Stornierte Serientermine werden nicht mehr gegen das Kontingent gezählt. |
| Zusatzoptionen | Ein Mengen-Kontingent deckt Add-ons nur mit **Add-Ons inklusive** ab. Ein Budget-Kontingent kann Add-ons bezahlen. Add-ons von Drittanbietern zählen nicht gegen das Prepaid-Guthaben der Buchung. |

> [!WARNING]
>
> Wenn Ressourcen als zusätzliche Ressource einer Buchungsoption hinzugefügt sind und ein Kontingent angewendet wird, greift dieses nur für die ursprüngliche Ressource. Die zusätzlichen Ressourcen werden nicht gegen das Kontingent verrechnet, es sei denn, es handelt sich um ein geldwertes Kontingent (Typ Budget).

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Typ: Menge | Anzahl Buchungen, unabhängig von Dauer/Preis |
| Add-Ons inklusive | Nur beim Typ Menge, standardmäßig aus. Add-ons einer Buchung, die das Kontingent vollständig abdeckt, kosten nichts. Ist die Nutzung auf Produkte eingeschränkt, gilt das nur für diese. Gilt für Buchungen ab dem Einschalten. |
| Typ: Dauer | Gesamtdauer in Minuten oder Tagen |
| Typ: Budget | Monetärer Gesamtwert |
| Automatische Erneuerung: Einmalig | Wird einmal zugeteilt und nicht erneuert |
| Automatische Erneuerung: Wiederkehrend | Wird automatisch pro Zeitraum erneuert (nur bei Abo-Plänen und Communities; in Buchungspaketen sind Kontingente immer einmalig) |
| Zeitraum | Erneuerungsintervall in Tagen, Wochen, Monaten oder Jahren |
| Nutzung begrenzen | Nutzung einschränkbar auf Ressource, Gruppe, Kategorie oder Service. Produkt und Produktgruppe nur beim Typ Budget oder bei einem Mengen-Kontingent mit **Add-Ons inklusive**. |

Auf der Buchungsseite sehen Kund:innen nach der Datumsauswahl ihre verfügbaren Kontingente und können bei mehreren Kontingenten das gewünschte auswählen.

> [!WARNING]
>
> Ein Kontingent kann nach dem Speichern nicht von einmalig auf wiederkehrend (oder umgekehrt) geändert werden. Erstelle in diesem Fall ein neues Kontingent.

> [!TIP]
>
> Wiederkehrende Kontingente werden für die nächsten 12 Monate ausgestellt.

## Kontingente in der Kundenübersicht

Alle Kontingente eines Kunden findest du unter **CRM** → **Kunden** → Kunde auswählen → Abschnitt **Buchungskontingente**. Dort siehst du Gültigkeitsdaten, Ausschöpfung und Erteilung (für wiederkehrende Kontingente gibt es für jeden Zeitraum bis in 12 Monaten einen Eintrag).

Mit **Neu** kannst du individuelle Kontingente direkt für einen Kunden erstellen. Bestehende Kontingente lassen sich über die **drei Punkte** **widerrufen** oder im Wert **bearbeiten**.

## Kontingente als Zugangsbeschränkung

Mit der Option **Buchungskontingente voraussetzen** konfigurierst du Ressourcen und Services so, dass sie ausschließlich mit Kontingent buchbar sind. Du findest sie an der **Ressource** im Reiter **Allgemeine Informationen** → **Einstellungen** → Gruppe **Verifizierung & Zugang** und an der **Buchungsoption** (**Katalog** → **Services**) im Reiter **Allgemeine Informationen** → **Einstellungen** → Gruppe **Zugang**.

## Praxisbeispiele

> **Yoga-Studio verkauft eine 10er-Karte**
>
> Ein Studio bietet einen Yoga-Kurs an. Kund:innen sollen flexibel 10 Teilnahmen nutzen können.
>
> **1. Buchungspaket erstellen**
>
> Öffne **Katalog** → **Buchungspakete** und klicke auf **Neu**. Lege ein Paket mit Name und Beschreibung an und hinterlege auf der Detailseite den Preis.
>
> **2. Kontingent erstellen**
>
> Klicke im Abschnitt **Buchungskontingente** des Pakets auf **Hinzufügen oder hierher ziehen** → **Neu**. Wähle Typ **Menge** und Wert **10**. Kontingente in Buchungspaketen sind immer einmalig.
>
> **3. Begrenzung setzen**
>
> Füge unter **Nutzung begrenzen** über **Hinzufügen** die Ressource oder den Service deines Yoga-Kurses hinzu und speichere.
>
> **4. Aktivieren**
>
> Aktiviere das Buchungspaket in der Tabelle unter **Katalog** → **Buchungspakete** über die drei Punkte → **Aktivieren**. Kund:innen können die 10er-Karte jetzt auf deiner Buchungsseite kaufen und den Code bei Buchungen einlösen.

> **Coworking-Space mit monatlichem Meetingraum-Budget**
>
> Premium-Mitglieder erhalten 8 Stunden Meetingraum-Nutzung pro Monat, automatisch über ihr Abo.
>
> **1. Kontingent erstellen**
>
> Öffne deinen Abo-Plan (z. B. Premium Membership) unter **Katalog** → **Abo-Pläne**. Klicke im Abschnitt **Buchungskontingente** auf **Hinzufügen oder hierher ziehen** → **Neu**. Wähle Typ **Dauer**, Wert **480 Minuten** und unter **Automatische Erneuerung** **Wiederkehrend** mit **Zeitraum** **1 Monat**.
>
> **2. Begrenzung setzen**
>
> Begrenze die Nutzung unter **Nutzung begrenzen** auf die Gruppe oder Ressource deiner Meetingräume.
>
> **3. Mit Abo-Plan verknüpfen**
>
> Speichere das Kontingent und den Abo-Plan. Das Kontingent ist jetzt im Abschnitt **Buchungskontingente** verknüpft. Änderungen gelten standardmäßig nur für neue Abonnent:innen; mit **Vorhandene Kontingente aktualisieren** überträgst du sie auf bestehende.
>
> **4. Ergebnis prüfen**
>
> Sobald ein Mitglied das Abo abschliesst, wird das Kontingent automatisch zugeteilt und monatlich erneuert. In der Kundendetailansicht siehst du die Auslastung.

## FAQ

> **Wo sehe ich als Admin die Restguthaben?**
>
> Auf der Rechnung, in der Kundendetailansicht, im Abo und im Buchungscode (jeweils auf der Detailseite).

> **Was passiert mit nicht genutztem Kontingent am Ende des Zeitraums?**
>
> Bei wiederkehrenden Kontingenten verfällt der Restbetrag am Ende des Zeitraums. Er wird nicht in den nächsten Zeitraum übertragen.

> **Kann ich ein Kontingent auf mehrere Ressourcen begrenzen?**
>
> Ja. Unter **Nutzung begrenzen** kannst du über **Hinzufügen** mehrere Begrenzungen auf Ressource, Gruppe, Kategorie oder Service kombinieren. Produkt und Produktgruppe stehen beim Typ Budget und bei einem Mengen-Kontingent mit **Add-Ons inklusive**.

> **Werden stornierte Buchungen wieder gutgeschrieben?**
>
> Ja, bei regulärer Stornierung wird das Kontingent zurückgegeben. Ausnahme: Wenn Stornierungsbedingungen greifen, die keine Rückgabe vorsehen, wird das Kontingent nicht zurückerstattet.

> **Kann ein Kontingent nachträglich von einmalig auf wiederkehrend geändert werden?**
>
> Nein. Du musst ein neues Kontingent erstellen und das alte widerrufen.

## Troubleshooting

> **Mein Kunde hat kein Kontingent, obwohl er in der Community ist**
>
> Bei Multi-Organisations-Setups kann es vorkommen, dass Kontingente nicht automatisch aktualisiert werden. Öffne die Community unter **CRM** → **Communities** und klicke im Abschnitt **Buchungskontingente** auf **Vorhandene Kontingente aktualisieren**.

> **Wiederkehrendes Kontingent zeigt im ersten Zeitraum den Wert 0**
>
> Dieser Bug wurde behoben. Prüfe, ob die Änderung bereits in deiner Umgebung aktiv ist. Falls das Problem weiterhin auftritt, wende dich an den Support.

> **Dauer-Kontingent lässt sich nicht auf einen Service anwenden**
>
> Ein Dauer-Kontingent in Stunden gilt auch für eine Buchungsoption in Minuten, und umgekehrt. Angerechnet wird die gebuchte Zeit in der Einheit des Kontingents. Stunden und Minuten funktionieren nicht bei einer Buchungsoption, die in Tagen rechnet. Passe dann die Einheit des Kontingents an.

> Wichtige Informationen für Agenten:
>
> * Feature: Buchungskontingente. Plan: Professional. Aktivierung via Account → Apps & Integrationen → anny Apps → Buchungspakete.
> * UI-Pfad Kontingente verwalten: Keine eigene Übersichtsseite. Abschnitt "Buchungskontingente" auf der Detailseite von Buchungspaket (Katalog → Buchungspakete, /booking-bundles/{id}), Abo-Plan (Katalog → Abo-Pläne, /plans/{id}) und Community (CRM → Communities, /communities/{id}); "Hinzufügen oder hierher ziehen" → bestehendes Kontingent wählen oder "Neu". Formular: Name, Typ Menge/Dauer/Budget, Wert, "Automatische Erneuerung" Einmalig/Wiederkehrend + Zeitraum (nur Abo-Plan und Community), "Nutzung begrenzen" (Ressource, Gruppe, Kategorie, Service, Produkt, Produktgruppe). Abo-Plan und Community: Button "Vorhandene Kontingente aktualisieren" überträgt Änderungen auf bestehende Mitglieder. Gutschein-Buchungspakete tragen ein Wertkontingent, dort nur "Nutzung begrenzen".
> * UI-Pfad Kundenkontingente: CRM → Kunden → Kunde → Abschnitt Buchungskontingente (Button "Neu"; Zeilenmenü: Widerrufen, Bearbeiten, Löschen).
> * UI-Pfad Zugang beschränken: Option "Buchungskontingente voraussetzen" an der Ressource (Reiter Allgemeine Informationen → Einstellungen → Gruppe Verifizierung & Zugang) ODER am Service (Katalog → Services → Reiter Allgemeine Informationen → Einstellungen → Gruppe Zugang).
> * Buchungspaket aktivieren: Katalog → Buchungspakete → drei Punkte in der Zeile → Aktivieren/Deaktivieren.
> * Einmalig vs. Wiederkehrend kann NICHT nachträglich geändert werden.
> * Einheitenkompatibilität: Stunden und Minuten gelten beide (Verbrauch in der Einheit des Kontingents). Tage passen nicht zu Stunden oder Minuten.
> * Wiederkehrende Kontingente werden für 12 Monate im Voraus ausgestellt.
> * Bei Stornierung nach Frist (Stornierungsbedingungen aktiv): Kontingent wird NICHT zurückgegeben.
> * Wiederkehrende Buchungen: Jeder Serientermin verbraucht Kontingent. Stornierte Termine innerhalb einer Serie werden seit 29.07.2026 korrekt zurückerstattet.
> * Quota-based Add-ons (seit 06.07.2026): Budget-Kontingente können Add-on-Kosten abdecken. Third-party add-ons (`is_third_party`) zählen nicht gegen das Prepaid-Booking-Cap.
> * **Add-Ons inklusive** (Okt 2026, Admin 3.0, Attribut `include_add_ons`, Standard false, nur `value_type` quantity): Add-ons einer vollständig gedeckten Buchung kosten nichts; Produkt-Einschränkungen grenzen die Menge ein. Gilt für Buchungen ab dem Einschalten (Snapshot `includes_add_ons` an der Nutzung). Produkt/Produktgruppe unter **Nutzung begrenzen** nur bei Budget oder bei Menge mit diesem Schalter. Schalter aus bei bestehenden Add-on-Einschränkungen: 422 `booking_quota_addon_restriction_not_allowed`.
> * Abgrenzung Zeitplan-Kontingente (eigenes Feature): Steuert max. gleichzeitige Buchungen pro Slot, NICHT Kundenguthaben.
> * Abgrenzung Kontingente für Buchungsoptionen (eigenes Feature): Begrenzt parallele Buchungen pro Service, NICHT Kundenguthaben.
> * Zusätzliche Ressourcen: Kontingent wird NUR auf die Hauptressource angewendet, nicht auf zusätzliche Ressourcen der Buchungsoption. Ausnahme: Budget-Kontingent (geldwert) greift auch auf zusätzliche Ressourcen.
> * Abo-Grants (seit Sep 2026, #282): `BookingQuotaGrantsService` clamped an `ends_at` / `cancels_at`. `SubscriptionEnded` widerruft Rest-Grants. Checkout wendet Grants nach Abo-Ende nicht mehr an.


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