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

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

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

Headout liest Ihre vollständige Produktliste alle paar Tage ein.

Jedes Produkt wird etwa stündlich erneut eingelesen.

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

Headout fordert octo/content an.

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

Availability Check: Headout prüft Ihre Produkte rund um die Uhr, beginnt in der Regel mit dem heutigen Tag, deckt pro Anfrage 31 Tage ab, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa stündlich 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 – Headout 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 Headout in Rechnung stellen, beide aus der Preisgestaltung des Wiederverkäufers in Ventrata (Verkaufspreis und Großhandel/Provision).

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

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

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

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

Headout fordert octo/offers an.

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

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

Headout prüft außerdem alle paar Minuten mit List Bookings (GET /bookings) die selbst erstellten Buchungen, zum Beispiel um den eigenen Datenbestand abzugleichen.

octo/pickups-Capability – Headout 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.

Headout übermittelt Abholdetails mit den Buchungen.

octo/questions-Capability – Headout liest die für Ihre Produkte hinterlegten Fragen und übermittelt die Antworten des Kunden mit der Buchung; Sie sehen sie in Ventrata.

Headout übermittelt die Antworten auf Ihre Buchungsfragen.