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

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

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

Vistra Travel liest Ihre vollständige Produktliste etwa alle 11 Stunden ein.

Jedes einzelne Produkt wird etwa alle 20 Minuten erneut eingelesen.

octo/content-Capability – wenn Vistra Travel 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 Vistra Travel bei der nächsten Produktaktualisierung.

Vistra Travel fordert octo/content an.

Availability Check (POST /availability) – Vistra Travel 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 Vistra Travel 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.

Availability Calendar Batch (POST /availability/calendar/batch) – der Kalender für viele Produkte in einer einzigen Anfrage, ausgelegt für Hintergrundsynchronisierungen.

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

Availability Check: Vistra Travel prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel 12 Tage im Voraus, deckt pro Anfrage 19 Tage ab, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa alle 5 Stunden erneut.

Availability Calendar: Vistra Travel prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel mit dem heutigen Tag, deckt pro Anfrage 8 Tage ab, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa stündlich erneut.

Availability Calendar Batch: Vistra Travel prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel mit dem heutigen Tag, deckt pro Anfrage 8 Tage ab, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa alle 20 Minuten erneut.

Die Abfragen verteilen sich ohne ausgeprägte Spitze über den Tag, was auf eine Mischung aus geplanten Synchronisierungen und Live-Suchen von Kunden hindeutet.

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

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

Vistra Travel fordert octo/pricing bei allen Verfügbarkeitsabfragen an und verkauft daher zu Ihren Ventrata-Preisen.

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

Vistra Travel reserviert Plätze für etwa 30 Minuten, während der Kunde bezahlt (expirationMinutes).

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

Vistra Travel prüft außerdem die getätigten Buchungen, und zwar mit List Bookings (GET /bookings) alle paar Minuten und mit Get Booking (GET /bookings/{uuid}) etwa alle 13 Stunden, zum Beispiel um die eigenen Datensätze abzugleichen.