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

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

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

visitBerlin liest Ihre vollständige Produktliste etwa alle 7 Stunden ein.

Availability Check (POST /availability) – visitBerlin 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 visitBerlin 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 visitBerlin ein gerade ausverkauftes Zeitfenster nicht überbuchen, selbst wenn die gespeicherte Verfügbarkeit leicht veraltet ist.

Availability Check: visitBerlin prüft Ihre Produkte rund um die Uhr, beginnt in der Regel mit dem heutigen Tag und deckt pro Anfrage etwa 6 Monate ab, schaut bis zu etwa 6 Monate voraus und prüft dasselbe Produkt und dieselben Daten alle paar Minuten erneut.

Die Prüfungen verteilen sich gleichmäßig über den ganzen Tag. Das deutet auf eine geplante Hintergrundsynchronisierung statt auf Live-Suchen von Kunden hin.

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

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

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

visitBerlin übermittelt die Anzahl der Personen pro Einheitentyp, sodass Gruppenpreise für die tatsächliche Buchung berechnet werden.

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

Eine typische Buchung über visitBerlin 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.

visitBerlin prüft außerdem die selbst erstellten Buchungen: etwa alle 8 Stunden mit List Bookings (GET /bookings) und alle paar Minuten mit Get Booking (GET /bookings/{uuid}), zum Beispiel um den eigenen Datenbestand abzugleichen.