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

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

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

Xplorie liest Ihre vollständige Produktliste etwa einmal täglich.

octo/content-Capability – wenn Xplorie sie in den Octo-Capabilities-Header aufnimmt, liefern Get Products (GET /products) und Get Product (GET /products/{productId}) auch Ihre Produktinhalte, etwa Beschreibungen, Highlights, enthaltene Leistungen und Bilder.

Inhaltsänderungen in Ventrata erreichen Xplorie bei der nächsten Produktaktualisierung.

Xplorie fordert octo/content an.

Availability Check (POST /availability) – Xplorie 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 Xplorie zum Buchen dieses Zeitfensters benötigt.

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

Availability Check: Xplorie prüft Ihre Produkte über den Tag verteilt, in der Regel ab etwa 3 Monaten im Voraus und mit 30 Tagen pro Anfrage, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa alle 19 Stunden erneut.

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

octo/pricing-Capability – Xplorie 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 Xplorie in Rechnung stellen, beide aus der Preisgestaltung des Wiederverkäufers in Ventrata (Verkaufspreis und Großhandel/Provision).

Gruppenpreise – wenn Xplorie 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.

Xplorie fordert octo/pricing nur bei einem Teil der Verfügbarkeitsabfragen an, daher verwendet möglicherweise nicht jedes Angebot Ihre Ventrata-Preise.

Xplorie übermittelt nicht die Anzahl der Personen je Einheitentyp, daher werden Preise pro Person zurückgegeben, und Gruppenpreise wie Tarife nach Buchungsgröße werden auf Xplorie möglicherweise nicht korrekt angezeigt.

octo/offers-Capability – damit wendet Ventrata Ihre berechtigten Werbeaktionen auf Verfügbarkeitspreise und Buchungen an, und Xplorie kann zudem einen Aktionscode senden (offerCode).

Werbeaktionen funktionieren zusammen mit der Preisgestaltung und benötigen daher zusätzlich octo/pricing.

Dies umfasst Werbeaktionen, die Sie in Ventrata erstellen (vom Anbieter initiierte Werbeaktionen).

Xplorie fordert octo/offers an.

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

Eine typische Buchung über Xplorie umfasst etwa 4 Personen.

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