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

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

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

Ticmate liest Ihre vollständige Produktliste etwa alle 4 Stunden ein.

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

Ticmate fordert octo/content an.

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

Availability Check: Ticmate prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel 23 Tage 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 7 Stunden 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 – Ticmate 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 Ticmate in Rechnung stellen, beide aus der Preisgestaltung des Wiederverkäufers in Ventrata (Verkaufspreis und Großhandel/Provision).

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

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

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

Ticmate hält Plätze etwa 5 Minuten lang zurück, während der Kunde bezahlt (expirationMinutes).

Eine typische Buchung über Ticmate umfasst etwa 4 Personen.

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

Ticmate übermittelt Abholdetails mit den Buchungen.