Pool-Buchung

Pool-Buchung ist der Enterprise-Reservierungsmodus für Dienste, bei denen der Kunde daran interessiert ist, genug passendes Inventar zu erhalten – nicht eine bestimmte benannte Ressource. Typische Beispiele sind Bahnen, Tische, Behandlungsräume, Mietkits oder Parkplätze.

PrimeCal legt die Konfiguration im Ressourcentyp fest und weist dann beim Erstellen der Reservierung die ersten verfügbaren konkreten Ressourcen zu.

Zeitaufwand: 10–15 Minuten
Schwierigkeitsgrad: Mittel

Wann Pool-Buchung verwenden

Verwende Pool-Buchung, wenn alle folgenden Punkte zutreffen:

• Der Dienst wird als Kategorie verkauft, nicht als einzelnes benanntes Element
• Mehrere konkrete Ressourcen können dieselbe Buchung erfüllen
• Das Personal möchte eine Dienstdefinition, eine Preisregel und automatische Zuweisung
• Die öffentliche Buchungsroute soll die aggregierte Verfügbarkeit anzeigen, z. B. 2 Plätze verfügbar

Behalte die ältere Ressource-Token-Route nur für Einzelressourcen-Links. Multi-Element-Pool-Anfragen gehören auf die Organisations-Buchungsroute, zum Beispiel /book/acme-spa.

Den richtigen bookingMode wählen

PrimeCal speichert das Buchungsverhalten in resourceType.bookingMode.

Modus	Bedeutung	Am besten für
SINGLE_RESOURCE	Jede Reservierung muss auf einer konkreten Ressource bleiben.	Benannte Räume, Plätze, Schreibtische oder Personaltermine.
POOL	Der Kunde bucht den Dienst, und PrimeCal weist die ersten verfügbaren passenden Ressourcen zu.	Tische, Bahnen, Mietkits oder jedes austauschbare Inventar.
BOTH	Personal oder öffentliche Clients können entweder eine bestimmte Ressource auswählen oder eine beliebige verfügbare Ressource aus dem Pool anfordern.	Gemischte Workflows, bei denen benannte Ressourcen manchmal wichtig sind, aber nicht immer.

Für einen Pool-artigen öffentlichen Ablauf kombiniere POOL oder BOTH mit der organisationsbasierten Buchungsseite und veröffentliche mehr als eine aktive Ressource desselben Typs.

Admin-Einrichtungs-Checkliste

1. Öffne den Reservierungs-Arbeitsbereich der aktiven Organisation.
2. Erstelle oder bearbeite den Ressourcentyp.
3. Setze bookingMode auf POOL oder BOTH.
4. Füge die konkreten Ressourcen hinzu, die zu diesem Pool gehören.
5. Veröffentliche die Organisations-Buchungsseite, anstatt einzelne Ressource-Token-Links zu teilen.
6. Wenn der Dienst kostenpflichtig ist, aktiviere die Preisgestaltung für denselben Ressourcentyp.

Preisberechnung

Pool-Buchung erstellt keine separate Preistabelle. PrimeCal berechnet die Reservierung weiterhin aus dem Ressourcentyp.

Die aktuelle Angebots-Formel lautet:

quotedTotalAmount = priceAmount * assignedResourceCount * durationHours

Hinweise:

• priceAmount wird in Kleinsteinheiten der Währung gespeichert.
• assignedResourceCount ist die Anzahl der konkreten Ressourcen, die PrimeCal tatsächlich aus dem Pool zuweist.
• durationHours wird aus endTime - startTime abgeleitet.
• Die Rundung verwendet deterministische kaufmännische Halbgerundung (Half-Even) im Preisgestaltungs-Service.

Beispiel:

• priceAmount = 12500 (125,00)
• assignedResourceCount = 2
• duration = 1,5 Stunden

Ergebnis:

• quotedTotalAmount = 37500

Derselbe Angebots-Snapshot wird dann in der Reservierung gespeichert, sodass spätere UI-, Stripe- und Audit-Abläufe alle denselben Betrag lesen.

Zahlungsverhalten

Pool-Buchung und kostenpflichtige Buchung funktionieren zusammen:

• wenn pricingEnabled deaktiviert ist, speichert PrimeCal Angebote mit Nullwert
• wenn pricingEnabled aktiviert ist, speichert PrimeCal Angebotsfelder in der Reservierung
• wenn paymentRequired ebenfalls aktiviert ist, bleibt die Reservierung im Status pending_payment, bis Stripe den Erfolg über den Webhook-Ablauf bestätigt

Für den umfassenderen Zahlungsablauf lies weiter unter Kostenpflichtige Buchungen.

Screenshot-Ziele

Verwende diese genauen Platzhalterpfade, wenn du das Docs-Set aktualisierst:

Status	Datei	Zweck
Pool-Buchungsmodus im Admin-Editor	docs/assets/user-guide/enterprise-reservation-system/admin-resource-type-booking-mode-pool.png	Zeigt bookingMode, Preisgestaltung und Zahlungssteuerungen für einen Ressourcentyp.
Öffentliches Pool-Verfügbarkeitsraster	docs/assets/user-guide/enterprise-reservation-system/customer-pool-booking-availability-grid.png	Zeigt aggregierte Slot-Verfügbarkeit mit sichtbarem Mengenauswähler.
Öffentlicher Pool-Zahlungsschritt	docs/assets/user-guide/enterprise-reservation-system/customer-pool-booking-payment-step.png	Zeigt den vom Server abgeleiteten Gesamtbetrag nach einer Multi-Ressourcen-Pool-Auswahl.

Der lokale Automatisierungs-Helper für diese Platzhalter ist scripts/docs/capture-pool-booking-docs.cjs.

Platzhalter für Admin-Pool-Konfiguration

Platzhalter für öffentliche Pool-Verfügbarkeit

Platzhalter für öffentlichen Pool-Zahlungsschritt

Verwandte Ressourcen

• Enterprise-Reservierungssystem – Übersicht
• Organisations-Admin-Walkthrough
• Kostenpflichtige Buchungen
• Pool Booking API