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

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

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

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.
</Tip>

## 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.                               |
| 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           | Kontingente können auch für Add-ons genutzt werden (quota-based Add-on Handling).                                                    |

<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).
</Warning>

## Einstellungen & Optionen

| Einstellung (Admin)  | Beschreibung                                                        |
| -------------------- | ------------------------------------------------------------------- |
| Typ: Menge           | Anzahl Buchungen, unabhängig von Dauer/Preis                        |
| Typ: Dauer           | Gesamtdauer in Minuten oder Tagen                                   |
| Typ: Budget          | Monetärer Gesamtwert                                                |
| Einmalig             | Wird einmal zugeteilt und nicht erneuert                            |
| Wiederkehrend        | Wird automatisch pro Zeitraum erneuert                              |
| Erneuerungsintervall | Tage, Wochen, Monate oder Jahre                                     |
| Begrenzung           | Nutzung einschränkbar auf Kategorie, Gruppe, Ressource oder Service |

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.
</Warning>

<Tip>
  Wenn du den Wert eines wiederkehrenden Kontingents anpasst, kannst du bestimmen, ob alle bisher ausgestellten Kontingente von der Änderung betroffen sein sollen. Wiederkehrende Kontingente werden für die nächsten 12 Monate ausgestellt.
</Tip>

## Kontingente in der Kundenübersicht

Alle Kontingente eines Kunden findest du in der Detailansicht unter **Kunden** → Kunde auswählen → **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

Unter **Ressource** → **Einstellungen** → **Verifizierung & Zugang** oder **Buchungsoption** → **Bearbeiten** → **Zugang** kannst du Ressourcen und Services so konfigurieren, dass sie ausschließlich mit Kontingent buchbar sind.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Yoga-Studio verkauft eine 10er-Karte">
    Ein Studio bietet einen Yoga-Kurs an. Kund:innen sollen flexibel 10 Teilnahmen nutzen können.

    <Steps>
      <Step title="Kontingent erstellen">
        Öffne **Buchungspakete** in der Menüleiste → **Buchungskontingente** → **Neu+**. Wähle Typ **Menge**, Wert **10**, Modus **Einmalig**.
      </Step>

      <Step title="Begrenzung setzen">
        Begrenze die Nutzung auf die Ressource oder den Service deines Yoga-Kurses.
      </Step>

      <Step title="Buchungspaket erstellen">
        Erstelle unter **Buchungspakete** ein neues Paket mit Preis und Beschreibung. Verknüpfe das soeben erstellte Kontingent.
      </Step>

      <Step title="Live schalten">
        Setze das Buchungspaket über die drei Punkte auf **Live**. Kund:innen können die 10er-Karte jetzt auf deiner Buchungsseite kaufen und den Code bei Buchungen einlösen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Space mit monatlichem Meetingraum-Budget">
    Premium-Mitglieder erhalten 8 Stunden Meetingraum-Nutzung pro Monat, automatisch über ihr Abo.

    <Steps>
      <Step title="Kontingent erstellen">
        Öffne **Buchungspakete** → **Buchungskontingente** → **Neu+**. Wähle Typ **Dauer**, Wert **480 Minuten**, Modus **Wiederkehrend**, Intervall **1 Monat**.
      </Step>

      <Step title="Begrenzung setzen">
        Begrenze die Nutzung auf die Gruppe oder Ressource deiner Meetingräume.
      </Step>

      <Step title="Mit Abo-Plan verknüpfen">
        Öffne deinen Abo-Plan (z. B. Premium Membership) unter **Abo-Pläne** und füge das Kontingent im Bereich **Buchungskontingente** hinzu.
      </Step>

      <Step title="Ergebnis prüfen">
        Sobald ein Mitglied das Abo abschliesst, wird das Kontingent automatisch zugeteilt und monatlich erneuert. In der Kundendetailansicht siehst du die Auslastung.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wo sehe ich als Admin die Restguthaben?">
    Auf der Rechnung, in der Kundendetailansicht, im Abo und im Buchungscode (jeweils auf der Detailseite).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Kann ich ein Kontingent auf mehrere Ressourcen begrenzen?">
    Ja. Begrenzungen auf Kategorie, Gruppe, Ressource und Service lassen sich frei kombinieren.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Kann ein Kontingent nachträglich von einmalig auf wiederkehrend geändert werden?">
    Nein. Du musst ein neues Kontingent erstellen und das alte widerrufen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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 und klicke auf **Kontingente aktualisieren**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Dauer-Kontingent lässt sich nicht auf einen Service anwenden">
    Kontingente können nur auf Services mit der gleichen Zeiteinheit angewendet werden. Ein Dauer-Kontingent in Stunden funktioniert nicht bei einer Buchungsoption, die in Tagen rechnet. Passe die Einheit des Kontingents an.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Buchungskontingente. Plan: Professional. Aktivierung via Account-Einstellungen → Features → Buchungspakete.
> * UI-Pfad Kontingente verwalten: Buchungspakete (Menüleiste) → Buchungskontingente.
> * UI-Pfad Kundenkontingente: Kunden → Kunde → Tab Buchungskontingente.
> * UI-Pfad Zugang beschränken: Ressource → Einstellungen → Verifizierung & Zugang ODER Buchungsoption → Bearbeiten → Zugang.
> * Einmalig vs. Wiederkehrend kann NICHT nachträglich geändert werden.
> * Einheitenkompatibilität: Kontingent-Einheit muss zur Buchungsoption passen (Stunden ≠ Tage).
> * 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): Kontingente können auch Add-on-Kosten abdecken.
> * 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.