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

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

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

Civitatis liest Ihre vollständige Produktliste etwa einmal täglich.

Jedes Produkt wird etwa alle 30 Minuten erneut eingelesen.

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

Civitatis fordert octo/content an.

Availability Check (POST /availability) – Civitatis 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 Civitatis 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 Batch (POST /availability/batch) – Verfügbarkeit für viele Produkte in einer 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 Civitatis ein gerade ausverkauftes Zeitfenster nicht überbuchen, selbst wenn die gespeicherte Verfügbarkeit leicht veraltet ist.

Availability Check: Civitatis prüft Ihre Produkte über den Tag verteilt, beginnt in der Regel 44 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 4 Stunden erneut.

Availability Calendar: Civitatis prüft jedes Produkt etwa alle 12 Stunden.

Availability Batch: Civitatis prüft Ihre Produkte rund um die Uhr, in der Regel ab heute und mit etwa einem Jahr pro Anfrage, schaut bis zu etwa ein Jahr voraus und prüft dasselbe Produkt und dieselben Daten alle paar 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 – Civitatis 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 Civitatis in Rechnung stellen, beide aus der Preisgestaltung des Wiederverkäufers in Ventrata (Verkaufspreis und Großhandel/Provision).

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

Civitatis fordert octo/pricing nur bei einem Teil der Verfügbarkeitsabfragen an, daher verwendet möglicherweise nicht jedes Angebot Ihre Ventrata-Preise.

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

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

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

Civitatis prüft außerdem etwa alle 9 Stunden mit Get Booking (GET /bookings/{uuid}) die selbst erstellten Buchungen, zum Beispiel um den eigenen Datenbestand abzugleichen.

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

Civitatis übermittelt Abholdetails mit den Buchungen.

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

Civitatis sendet normalerweise keine Antworten auf Buchungsfragen. Wenn Sie darauf angewiesen sind, etwa für Namen oder Ernährungsbedürfnisse, klären Sie mit Civitatis, wie diese erfasst werden.