Ressourcen
Verfügbarkeit und Konflikte verstehen
Bevor eine Buchung angelegt oder bestätigt werden kann, prüft Sportcloud zentral, ob die Ressource im gewünschten Zeitraum verfügbar ist. Dieselbe Prüfung liegt der Verfügbarkeitsanzeige, dem Belegungsplan und der öffentlichen Verfügbarkeitsabfrage zugrunde. Dieser Artikel erklärt, in welcher Reihenfolge geprüft wird und welche Gründe eine Buchung verhindern.
Voraussetzung: Sie benötigen die Berechtigung resources.read, um die Verfügbarkeit einer Ressource einzusehen.
Die Prüfung in Schritten
Die Verfügbarkeitsprüfung läuft als feste Abfolge ab. Sobald ein Schritt ein Hindernis findet, gilt die Ressource als nicht verfügbar und es wird der entsprechende Grund zurückgegeben.
| Schritt | Was geprüft wird |
|---|---|
| 1. Ressource und Tarif laden | Existiert die Ressource und ist sie buchbar? Wird ein Tarif angegeben, muss dieser zur Ressource gehören und aktiv sein. |
| 2. Buchungsmodus prüfen | Passt der gewünschte Zeitraum zum gewählten Tarif und dessen Modus (z. B. ganze Nächte, ganze Tage, ganze Wochen)? |
| 3. Öffnungszeiten prüfen | Liegt der Zeitraum innerhalb der hinterlegten Öffnungszeiten? |
| 4. Sperren prüfen | Liegt im Zeitraum eine Sperre auf der Ressource oder einer über- bzw. untergeordneten Ressource? |
| 5. Belegung und Puffer prüfen | Überschneidet sich der Zeitraum mit bestehenden Buchungen in der Hierarchie? Reicht die freie Menge? Wird ein Puffer zu anderen Mietern eingehalten? |
| 6. Verfügbar | Sind alle Schritte bestanden, ist die Ressource verfügbar. |
Die Schritte 2 und 3 (Buchungsmodus und Öffnungszeiten) werden nur geprüft, wenn ein Tarif angegeben wird. Die Schritte 4 und 5 (Sperren, Belegung) gelten immer.
Die Gründe für eine nicht verfügbare Ressource
Wenn eine Ressource nicht verfügbar ist, nennt Sportcloud genau einen Grund. Die folgende Tabelle listet alle möglichen Gründe:
| Grund | Bedeutung |
|---|---|
| Nicht buchbar | Die Ressource ist nicht als buchbar markiert. |
| Ungültiger Tarif | Der angegebene Tarif gehört nicht zur Ressource, ist nicht aktiv oder existiert nicht. |
| Passt nicht zum Tarif | Der gewünschte Zeitraum entspricht nicht den Regeln des Tarifs bzw. seines Buchungsmodus (z. B. keine ganze Nacht, keine ganze Woche, oder außerhalb der erlaubten Mindest-/Höchstdauer). |
| Außerhalb der Öffnungszeiten | Der Zeitraum liegt ganz oder teilweise außerhalb der Öffnungszeiten der Ressource. |
| Gesperrt | Im Zeitraum liegt eine Sperre auf der Ressource oder auf einer über- bzw. untergeordneten Ressource. |
| Hierarchiekonflikt | Im Zeitraum ist eine über- oder untergeordnete Ressource bereits belegt. |
| Kapazitätskonflikt | Es sind nicht genügend Einheiten der Ressource frei (die angefragte Menge übersteigt die freie Menge). |
| Pufferkonflikt | Zwischen dieser und einer benachbarten Buchung eines anderen Mieters wird der vorgesehene Pufferabstand nicht eingehalten. |
Eine Buchung erzeugt nur dann einen Konflikt mit bestehenden Buchungen, wenn diese angefragt oder bestätigt sind. Stornierte oder abgeschlossene Buchungen blockieren keine neuen Zeiträume.
Buchbarkeit und Tarif (Schritte 1–2)
Eine Ressource muss als buchbar markiert sein. Andernfalls ist sie nicht verfügbar (Grund: Nicht buchbar). Wie Sie die Nutzungsart festlegen, lesen Sie unter Ressource anlegen.
Wird ein Tarif angegeben, muss er zur Ressource gehören und aktiv sein. Anschließend prüft Sportcloud, ob der gewünschte Zeitraum zum Buchungsmodus des Tarifs passt:
| Buchungsmodus | Erwarteter Zeitraum |
|---|---|
| Slot | Vielfaches der konfigurierten Slot-Länge |
| Nacht | Ganze Nächte zwischen Check-in- und Check-out-Zeit |
| Tag | Ganze Tage, Rückgabe bis zur konfigurierten Uhrzeit |
| Woche | Ganze Wochen (Vielfache von sieben Tagen) |
| Freizeit | Freie Dauer innerhalb der erlaubten Grenzen |
Passt der Zeitraum nicht, lautet der Grund Passt nicht zum Tarif. Die Konfiguration der Tarife beschreibt Tarife und Buchungsoptionen verwalten.
Wird kein Tarif angegeben, entfallen die Modus- und Öffnungszeitenprüfung. Welcher Tarif greift, wenn Sie keinen ausdrücklich wählen, lesen Sie unter Tarife und Buchungsoptionen verwalten.
Öffnungszeiten (Schritt 3)
Sind für die Ressource Öffnungszeiten hinterlegt, muss der Buchungszeitraum innerhalb der geöffneten Fenster liegen, sonst lautet der Grund Außerhalb der Öffnungszeiten. Öffnungszeiten werden in der Zeitzone Europe/Berlin ausgewertet. Sind keine Öffnungszeiten hinterlegt, gilt die Ressource als durchgehend geöffnet. Details unter Öffnungszeiten verwalten.
Sperren (Schritt 4)
Liegt im Buchungszeitraum eine Sperre, ist die Ressource nicht verfügbar (Grund: Gesperrt). Geprüft werden Sperren auf der Ressource selbst sowie auf allen über- und untergeordneten Ressourcen entlang der Hierarchie. Die Sperrtypen und der Unterschied zwischen interner und externer Notiz sind unter Sperren verwalten beschrieben.
Hierarchie, Kapazität und Puffer (Schritt 5)
Im letzten Schritt prüft Sportcloud die bestehende Belegung. Die Prüfung berücksichtigt nicht nur die Ressource selbst, sondern den gesamten Hierarchiepfad — also über- und untergeordnete Ressourcen.
Hierarchiekonflikt
Ist im Zeitraum eine über- oder untergeordnete Ressource belegt, lautet der Grund Hierarchiekonflikt. Beispiel: Ist eine ganze Halle gebucht, sind auch die einzelnen Felder dieser Halle nicht mehr frei — und umgekehrt belegt die Buchung eines Feldes die übergeordnete Halle. Mehr dazu unter Ressourcen-Hierarchie verstehen.
Kapazität und Menge
Jede Ressource hat eine konfigurierte Menge (Anzahl gleichzeitig verfügbarer Einheiten). Sportcloud ermittelt die im angefragten Zeitraum maximal gleichzeitig belegte Menge und zieht sie von der konfigurierten Menge ab. Reicht die verbleibende freie Menge für die angefragte Menge nicht aus, lautet der Grund Kapazitätskonflikt. So lassen sich z. B. zehn gleichartige Leihgeräte parallel buchen, solange genügend Einheiten frei sind.
Puffer zwischen verschiedenen Mietern
Ein Tarif kann eine Pufferzeit vorsehen — eine zeitliche Mindestlücke zwischen zwei Buchungen (z. B. für Reinigung oder Umbau). Der Puffer gilt nur gegenüber Buchungen anderer Mieter; aufeinanderfolgende Buchungen desselben Mieters benötigen keinen Puffer. Wird der Pufferabstand zu einer benachbarten Buchung eines anderen Mieters nicht eingehalten, lautet der Grund Pufferkonflikt. Die Pufferzeit wird über den Tarif konfiguriert (siehe Tarife und Buchungsoptionen verwalten).
Gleichzeitige Buchungen
Wenn zwei Personen denselben Zeitraum gleichzeitig buchen möchten, werden gleichzeitige Buchungen serverseitig zuverlässig verhindert. Es kann immer nur eine der konkurrierenden Buchungen erfolgreich angelegt werden; die andere erhält einen Konflikt-Grund.
Wo Sie die Verfügbarkeit sehen
- Im Belegungsplan — belegte, gesperrte und geschlossene Zeiten auf einen Blick.
- Beim Anlegen einer Buchung — die Prüfung läuft automatisch und meldet einen passenden Grund, falls der Zeitraum nicht verfügbar ist (siehe Ressource buchen).
- In der öffentlichen Verfügbarkeitsabfrage — anonym und nur lesend; dort werden ausschließlich die Verfügbarkeit, der Grund und die externe Sperrnotiz angezeigt, niemals interne Notizen oder Konfliktlisten.
Zuletzt geprüft: 2026-06-25