Get Products (GET /products) – wenn Priohub Ihre Verbindung einrichtet und immer dann, wenn Priohub seine Angebote aktualisiert, liest Priohub jedes für die Verbindung aktivierte Produkt mit seinen Optionen und Einheiten (Tickettypen wie Erwachsener oder Kind).

Get Product (GET /products/{productId}) – Priohub liest ein einzelnes Produkt erneut, um Änderungen an Optionen, Einheiten, Buchungsfristen und Einstellungen zu übernehmen.

Zuordnung auf der Seite von Priohub – Priohub verknüpft jede Ventrata-Option und -Einheit mit dem eigenen Angebot und den eigenen Tickettypen. Ihr Account Manager bei Priohub erledigt das für Sie, oder Sie tun es selbst im Portal von Priohub, sofern eines angeboten wird. Sie teilen nur den API-Schlüssel der Verbindung.

Priohub liest Ihre vollständige Produktliste etwa alle 12 Stunden ein.

Availability Check (POST /availability) – Priohub sendet ein Produkt, eine Option und ein Datum oder einen Zeitraum. Ventrata antwortet mit jedem buchbaren Tag oder Zeitfenster, dessen Status (AVAILABLE, LIMITED, SOLD_OUT, CLOSED oder FREESALE), den verbleibenden freien Plätzen, der Buchungsfrist und einer availabilityId, die Priohub zum Buchen dieses Zeitfensters benötigt.

Availability Calendar (POST /availability/calendar) – liefert eine Zusammenfassung pro Tag statt jedes einzelnen Zeitfensters, typischerweise um in einer Datumsauswahl anzuzeigen, welche Termine offen sind.

Prüfung bei der Buchung – wenn ein Kunde bucht, prüft Ventrata die Kapazität erneut, bevor die Buchung angelegt wird. So kann Priohub ein gerade ausverkauftes Zeitfenster nicht überbuchen, selbst wenn die gespeicherte Verfügbarkeit leicht veraltet ist.

Availability Check: Priohub prüft Ihre Produkte über den Tag verteilt, in der Regel ab 15 Tagen im Voraus und mit einem einzelnen Tag pro Anfrage, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa alle 9 Stunden erneut.

Die meisten Prüfungen finden zwischen 15:00 und 21:00 UTC statt. Das deutet darauf hin, dass die meisten Prüfungen live erfolgen, während Kunden auf Priohub stöbern.

octo/pricing-Capability – Priohub fordert Preise an, indem octo/pricing in den Octo-Capabilities-Header der Anfragen aufgenommen wird. Ohne diese Angabe sendet Ventrata die Verfügbarkeit ganz ohne Preise.

Availability Check (POST /availability) – bei aktivierten Preisen wird jeder Tag bzw. jedes Zeitfenster mit Ihrem Preis pro Einheit (Tickettyp) zurückgegeben: dem retail-Preis, den der Kunde zahlt, und dem net-Preis, den Sie Priohub in Rechnung stellen, beide aus der Preisgestaltung des Wiederverkäufers in Ventrata (Verkaufspreis und Großhandel/Provision).

Gruppenpreise – wenn Priohub zusätzlich mitteilt, wie viele Personen je Einheitentyp buchen, berechnet Ventrata den Preis genau für diese Gruppe. Das ist wichtig für Tarife nach Buchungsgröße und andere Gruppenpreise.

Booking Reservation (POST /bookings) und Booking Confirmation (POST /bookings/{uuid}/confirm) – die Buchung wird mit ihrem endgültigen Verkaufs- und Nettopreis zurückgegeben, sodass die Buchung in Ventrata immer den Preis enthält, zu dem sie verkauft wurde.

Priohub fordert octo/pricing in der Regel nicht an und verwendet daher höchstwahrscheinlich auf der eigenen Seite gespeicherte Preise, die Sie manuell mit Priohub aktuell halten müssen.

Priohub reserviert Plätze für etwa 15 Minuten, während der Kunde bezahlt (expirationMinutes).

Eine typische Buchung über Priohub umfasst etwa 2 Personen.

Es ist normal, mehr Reservierungen als bestätigte Buchungen zu sehen: Reservierungen von Kunden, die die Zahlung nicht abschließen, laufen einfach ab.