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

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

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

Jedes Produkt wird etwa alle 20 Stunden erneut eingelesen.

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

Pass4Fun fordert octo/content an.

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

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

Availability Calendar: Pass4Fun prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel 14 Tage im Voraus, deckt pro Anfrage 31 Tage ab, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten etwa alle 16 Stunden erneut.

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

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

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

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

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

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

Eine typische Buchung über Pass4Fun umfasst etwa 3 Personen.

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

Pass4Fun prüft außerdem die selbst erstellten Buchungen: etwa einmal täglich mit List Bookings (GET /bookings) und etwa alle 12 Stunden mit Get Booking (GET /bookings/{uuid}), zum Beispiel um den eigenen Datenbestand abzugleichen.

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

Pass4Fun übermittelt Abholdetails mit den Buchungen.

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

Pass4Fun übermittelt die Antworten auf Ihre Buchungsfragen.