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

<Info>
  Verfügbar ab **Professional**.
</Info>

## 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 in den **Account-Einstellungen** unter **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>

## 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 Globale Blocker (**Account-Einstellungen** → **Globale 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.
* **Globale Blocker**: Während Buchungsregeln die Anzahl limitieren, sperren Globale 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 | 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 lässt sich mehrsprachig hinterlegen. Nutze das Sprachmenü im Textfeld, um Fehlermeldungen in weiteren Sprachen zu pflegen.
</Tip>

## Praxisbeispiele

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

    <Steps>
      <Step title="Regel hinzufügen">
        Öffne **Account-Einstellungen** → **Buchungsregeln** → **+ Regel hinzufügen**.
      </Step>

      <Step title="Limit und Zeitraum konfigurieren">
        Setze **Maximale Buchungen** auf **1** und wähle als **Zeitraum** den Wert **Täglich**.
      </Step>

      <Step title="Geltungsbereich einschränken">
        Wähle **Mit Einschränkung** → **Kategorie** und wähle die Kategorie deiner Lernplätze aus.
      </Step>

      <Step title="Fehlermeldung hinterlegen">
        Trage unter **Hinweis bei Überschreitung** ein: "Du hast für heute bereits einen Lernplatz gebucht."
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Die Regel gilt sofort für alle Nutzer:innen.
      </Step>
    </Steps>
  </Accordion>

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

    <Steps>
      <Step title="Regel hinzufügen">
        Öffne **Account-Einstellungen** → **Buchungsregeln** → **+ Regel hinzufügen**.
      </Step>

      <Step title="Limit auf 0 setzen">
        Setze **Maximale Buchungen** auf **0** und wähle als **Zeitraum** den Wert **In der Zukunft**.
      </Step>

      <Step title="Geltungsbereich festlegen">
        Wähle **Alle Buchungen**, damit die Sperre für den gesamten Account gilt.
      </Step>

      <Step title="Nutzer:innen zuweisen">
        Wähle **Nutzer einbeziehen** und füge die E-Mail-Adressen der betroffenen Personen hinzu.
      </Step>

      <Step title="Fehlermeldung hinterlegen und speichern">
        Trage unter **Hinweis bei Überschreitung** ein: "Bitte wende dich an das Team." Klicke auf **Speichern**.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

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

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

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

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

## Troubleshooting

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

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

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

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Avatar** → **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.
> * 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 ≠ Globale Blocker. Buchungsregeln limitieren die Anzahl der Buchungen pro Zeitraum. Globale 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.