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

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

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

AlliedTPro liest Ihre vollständige Produktliste etwa alle 14 Stunden ein.

Jedes Produkt wird etwa einmal täglich erneut gelesen.

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

AlliedTPro fordert octo/content an.

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

Availability Check: AlliedTPro prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel etwa 6 Monate im Voraus, deckt pro Anfrage einen einzelnen Tag ab, schaut bis zu etwa 10 Monate voraus und prüft dasselbe Produkt und dieselben Daten etwa alle 12 Stunden erneut.

Availability Calendar: AlliedTPro prüft jedes Produkt etwa alle 3 Stunden, beginnt in der Regel etwa 6 Monate im Voraus, deckt pro Anfrage etwa 2 Monate ab und schaut bis zu etwa ein Jahr voraus.

Die meisten Prüfungen erfolgen zwischen 21:00 und 03:00 UTC. Das deutet darauf hin, dass es sich überwiegend um Live-Prüfungen handelt, während Kunden auf AlliedTPro stöbern.

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

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

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

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

octo/offers-Capability – damit wendet Ventrata Ihre berechtigten Werbeaktionen auf Verfügbarkeitspreise und Buchungen an, und AlliedTPro 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).

AlliedTPro fordert octo/offers an.

AlliedTPro legt keine Reservierungsdauer fest, daher gilt die Standard-Reservierungsdauer.

Eine typische Buchung über AlliedTPro umfasst etwa 3 Personen.

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

octo/pickups-Capability – AlliedTPro sieht, welche Optionen eine Abholung anbieten und welche Abholpunkte es gibt, und übermittelt mit der Buchung den Abholpunkt oder das Hotel des Kunden.

Wenn ein Hotel keinem Ihrer Abholpunkte entspricht, speichert Ventrata es mit der Buchung, damit Sie die Abholung organisieren können.

AlliedTPro übermittelt Abholdetails mit den Buchungen.