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

# Buchungsregeln

> Begrenze accountweit die Anzahl erlaubter Buchungen pro Zeitraum und steuere Ausnahmen.

Mit Buchungsregeln steuerst du zentral und accountweit, wie oft deine Kund:innen in einem bestimmten Zeitraum buchen dürfen. Die Regeln gelten global für deinen gesamten Account und können auf bestimmte Ressourcen, Services oder Nutzer:innen eingegrenzt werden.

> [!NOTE]
>
> Verfügbar ab **Professional**.

## Wie funktionieren Buchungsregeln?

Buchungsregeln definieren ein maximales Buchungslimit pro Zeitraum. Sobald eine Kund:in das Limit erreicht, wird die nächste Buchung im definierten Geltungsbereich blockiert. Optional wird dabei eine individuelle Fehlermeldung angezeigt.

Das Grundprinzip:

1. Du legst eine Regel mit einem Namen, einem Limit und einem Zeitraum an.
2. Du bestimmst den Geltungsbereich: alle Buchungen oder nur bestimmte Ressourcen/Services.
3. Du entscheidest, ob die Regel für alle Nutzer:innen gilt oder nur für bestimmte (Sperrliste) bzw. bestimmte ausgenommen werden (White-List).

Alle Regeln werden zentral unter **Account** → **Einstellungen** → **Buchungsregeln** verwaltet. Damit hast du einen vollständigen Überblick über sämtliche Buchungslimits deines Accounts.

> [!TIP]
>
> Bei Buchungsoptionen mit mehrfacher Gewichtung zählt jede Gewichtungseinheit als separate Buchung gegen das Limit. Beispiel: Eine Buchungsoption mit Gewichtung 4 verbraucht bei einem Limit von 3 bereits mehr als erlaubt. Schließe solche Buchungsoptionen gegebenenfalls vom Geltungsbereich der Regel aus.

> [!TIP]
>
> Jeder einzelne Termin einer [wiederkehrenden Buchung](https://docs.anny.co/recurring-bookings.md) zählt gegen das Limit. Eine zweite Serie am selben Tag wird blockiert, wenn das Tageslimit durch die erste Serie bereits ausgeschöpft ist.

## Wann nutze ich das?

* **Du möchtest faire Nutzung sicherstellen**: Begrenze Buchungen pro Zeitraum, damit alle Kund:innen gleichmäßig Zugang erhalten (z. B. max. 1 Lernplatz pro Tag an einer Uni).
* **Du brauchst eine Sperrliste**: Setze das Limit auf 0 und weise die Regel bestimmten Nutzer:innen zu, um diese komplett von Buchungen auszuschließen.
* **Du willst VIP-Ausnahmen schaffen**: Erstelle eine Regel mit engem Limit und nimm bestimmte Nutzer:innen (z. B. Premium-Mitglieder) über die White-List aus.
* **Nicht geeignet für**: Das Sperren ganzer Zeiträume. Dafür nutze stattdessen Blocker (**Buchungen** → **Blocker**).

## Zusammenhang mit anderen Features

* **Communities**: Über Buchungsregeln kannst du Nutzer:innen sperren, die trotz SSO/Auto-Join in einer Community landen, aber bestimmte Ressourcen nicht buchen sollen.
* **Blocker**: Während Buchungsregeln die Anzahl limitieren, sperren Blocker (**Buchungen** → **Blocker**) komplette Zeiträume für Ressourcen oder Services.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Regelname | Frei wählbarer Name zur Identifikation |
| Regel-Typ | Art der Regel (Anzahl der Buchungen) |
| Maximale Buchungen | Erlaubte Buchungsanzahl im Zeitraum |
| Zeitraum | Täglich, Pro Woche, Pro 2 Wochen, Pro Monat, Pro Jahr, Pro verfügbarem Termin, In der Zukunft |
| Hinweis bei Überschreitung des Limits | Individuelle Fehlermeldung (max. 255 Zeichen, mehrsprachig) |
| Geltungsbereich | Alle Buchungen oder Mit Einschränkung |
| Einschränkung auf | Ressource, Gruppe, Kategorie, Service, Service Gruppe |
| Nutzer | Alle Nutzer, Nutzer einbeziehen (Sperrliste), Nutzer ausschließen (White-List) |

> [!TIP]
>
> Der Hinweis bei Überschreitung des Limits lässt sich mehrsprachig hinterlegen. Nutze das Sprachmenü im Textfeld, um Fehlermeldungen in weiteren Sprachen zu pflegen.

## Praxisbeispiele

> **Eine Universität begrenzt Lernplatz-Buchungen auf 1 pro Tag**
>
> Eine Uni möchte sicherstellen, dass alle Studierenden fair Zugang zu den Lernplätzen erhalten. Pro Person soll nur eine Buchung am Tag möglich sein.
>
> **1. Regel hinzufügen**
>
> Öffne **Account** → **Einstellungen** → **Buchungsregeln** → **+ Regel hinzufügen**.
>
> **2. Limit und Zeitraum konfigurieren**
>
> Setze **Maximale Buchungen** auf **1** und wähle als **Zeitraum** den Wert **Täglich**.
>
> **3. Geltungsbereich einschränken**
>
> Wähle **Mit Einschränkung** → **Kategorie** und wähle die Kategorie deiner Lernplätze aus.
>
> **4. Fehlermeldung hinterlegen**
>
> Trage unter **Hinweis bei Überschreitung des Limits** ein: "Du hast für heute bereits einen Lernplatz gebucht."
>
> **5. Speichern**
>
> Klicke auf **Speichern**. Die Regel gilt sofort für alle Nutzer:innen.

> **Ein Coworking-Space erstellt eine Sperrliste für zahlungssäumige Mitglieder**
>
> Ein Coworking-Betreiber möchte bestimmte Nutzer:innen komplett von allen Buchungen ausschließen, ohne sie aus der Community zu entfernen.
>
> **1. Regel hinzufügen**
>
> Öffne **Account** → **Einstellungen** → **Buchungsregeln** → **+ Regel hinzufügen**.
>
> **2. Limit auf 0 setzen**
>
> Setze **Maximale Buchungen** auf **0** und wähle als **Zeitraum** den Wert **In der Zukunft**.
>
> **3. Geltungsbereich festlegen**
>
> Wähle **Alle Buchungen**, damit die Sperre für den gesamten Account gilt.
>
> **4. Nutzer:innen zuweisen**
>
> Wähle **Nutzer einbeziehen** und füge die E-Mail-Adressen der betroffenen Personen hinzu.
>
> **5. Fehlermeldung hinterlegen und speichern**
>
> Trage unter **Hinweis bei Überschreitung des Limits** ein: "Bitte wende dich an das Team." Klicke auf **Speichern**.

## FAQ

> **Kann ich mehrere Regeln gleichzeitig anlegen?**
>
> Ja. Du kannst beliebig viele Regeln erstellen. Alle aktiven Regeln werden parallel geprüft. Sobald eine Regel greift, wird die Buchung blockiert.

> **Was ist der Unterschied zwischen 'Nutzer einbeziehen' und 'Nutzer ausschließen'?**
>
> **Nutzer einbeziehen** bedeutet: Die Regel gilt NUR für die angegebenen Personen (Sperrliste). **Nutzer ausschließen** bedeutet: Die Regel gilt für alle AUSSER die angegebenen Personen (White-List).

> **Was passiert, wenn ich den Zeitraum 'In der Zukunft' wähle?**
>
> Das Limit gilt ab dem Zeitpunkt der Regelerstellung kumulativ. Alle zukünftigen Buchungen werden gegen das Limit gezählt, ohne dass es sich zu einem bestimmten Zeitpunkt zurücksetzt.

> **Kann ich die Fehlermeldung in mehreren Sprachen hinterlegen?**
>
> Ja. Nutze das Sprachmenü im Feld **Hinweis bei Überschreitung des Limits**, um Meldungen in beliebig vielen Sprachen zu pflegen. Kund:innen sehen die Meldung in ihrer eingestellten Sprache.

## Troubleshooting

> **Meine Regel greift nicht bei einer bestimmten Buchungsoption**
>
> Prüfe, ob die Buchungsoption eine mehrfache Gewichtung hat. Bei einer Gewichtung von z. B. 4 werden 4 Buchungen gegen das Limit gezählt. Schließe die betroffene Buchungsoption gegebenenfalls aus dem Geltungsbereich der Regel aus.

> **Eine gesperrte Person kann trotzdem buchen**
>
> Stelle sicher, dass du **Nutzer einbeziehen** (nicht "ausschließen") gewählt hast und die korrekte E-Mail-Adresse eingetragen ist. Prüfe außerdem, ob der Geltungsbereich die betroffene Ressource oder den Service abdeckt.

> **Der Hinweis wird Kund:innen nicht angezeigt**
>
> Der Hinweis erscheint nur beim Checkout, wenn das Limit tatsächlich überschritten wird. Prüfe, ob das Textfeld ausgefüllt und gespeichert wurde. Ohne hinterlegten Hinweis erscheint eine generische Fehlermeldung.

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Account** → **Einstellungen** → **Buchungsregeln**
> * Gewichtungsregel: Bei mehrfacher Gewichtung einer Buchungsoption zählt jede Gewichtungseinheit als separate Buchung gegen das Limit. Beispiel: Gewichtung 4 bei Limit 3 = Buchung nicht möglich.
> * Wiederkehrende Buchungen: Jedes Child-Vorkommen zählt (auch wenn `customer_id` auf dem Child leer ist). Eine zweite Serie am selben Tag trifft dasselbe Tageslimit.
> * Geltungsbereich-Filter: Ressource (einzeln), Gruppe, Kategorie, Service (einzeln), Service Gruppe
> * White-List = Nutzer:innen von einer Regel ausnehmen ("Nutzer ausschließen"). Sperrliste = Regel gilt NUR für diese Nutzer:innen ("Nutzer einbeziehen").
> * Abgrenzung: Buchungsregeln ≠ Blocker (Buchungen → Blocker). Buchungsregeln limitieren die Anzahl der Buchungen pro Zeitraum. Blocker sperren Zeiträume komplett.
> * Buchungsregeln sind accountweit/global. Sie gelten für den gesamten Account, nicht pro Ressource.
> * Verfügbar ab Professional. Basis-Buchungsregeln (z. B. 1x pro Tag pro Ressource) waren früher in den Ressourceneinstellungen konfigurierbar, sind jetzt zentral zusammengeführt.


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