Entwicklerhandbuch - Raten Push API
Was ist die Raten Push API?
Kurzurlaub.de verwendet die OTA Nachrichten OTA_HotelRateAmountNotifRQ/RS und OTA_HotelRatePlanNotifRQ/RS,
um Raten und Verkaufs-Flags (Restriktionen) für ein Hotel zu empfangen.
Die vom OTA-Partner gesendeten Daten werden nur für Zimmer und Angebote akzeptiert, die aktiv und online sind, alternativ werden Warnungen als Antwort gesendet.
Generell werden Zeilen mit Verfügbarkeiten einzeln betrachtet, d.h. ein Fehler im RoomTypeCode oder im Datumsformat, Datumsbreich wird nur für diese eine Zeile als Warnung gesendet. Alle weiteren Zeilen werden unabhängig davon bearbeitet.
Jede Nachricht enthält bspw. ein einzelnes RateAmountMessages-Element, das das zu aktualisierende Hotel mithilfe des RateAmountMessages/@HotelCode-Attributs angibt. Die RateAmountMessages/RateAmountMessage-Elemente enthalten die Aktualisierungen, die über einen Datumsbereich verarbeitet werden sollen.
Beispiel: <StatusApplicationControl InvTypeCode="1234" RatePlanCode="TEST-RATE-CHRISTMAS" Start="2024-12-26" End="2024-12-27"/>
Hinweis:
Es können mehrere RateAmountMessage-Aktualisierungen pro Anfrage erfolgen, jedoch ist jede Anfrage auf ein Hotel (HotelCode) und dessen Zimmer und/oder Angebote beschränkt.
Arten von Raten
Die erste Frage sollte immer lauten:
Verwenden wir nur Raten auf
- Zimmerebene (RoomType only) / bspw. Zimmer-Tagesraten
- Zimmerebene und/oder Angebotsebene (RoomType/RatePlan Kombination)
Dies bildet auch die Basis der gesamten Kommunikation und wird für jedes Hotel und jeden OTA Partner zu Beginn individuell festgelegt.
1. Raten auf Zimmerebene
Wenn Ihr Backend nur Raten auf Zimmerebene (Tagesraten) unterstützt - also nur Zimmertypen (RoomType) und keine Ratenpläne in Kombination mit Zimmern, verwenden Sie bitte diese Variante.
Hiermit sind Tagesraten für Zimmer gemeint.
2. Raten auf Zimmer-/Angebotsebene
Wenn Ihr Backend Raten auf Zimmer-/Angebotsebene unterstützt - also Zimmertypen und Ratenpläne (sog. RoomType/RatePlan Kombinationen), verwenden Sie bitte diese Variante.
Hiermit sind Tagesraten für Spezielle Angebot in einem Zimmer gemeint.
Raten auf der Basis von Zimmer-Tagesraten
Die Frage: Sollen wir Paketpreise der Angebote für alle Nächte übertragen oder ist es besser, immer einen Preis pro Tag- die Tagesrate des Zimmers zu senden?
Der bessere Weg wäre, die Tagesrate pro Zimmertyp und ggf. Angebot zu senden.
Beispiel:
Angebot: 3 Übernachtungen im Doppelzimmer mit 2 Personen für 170 Euro pro Person.
Wir verwenden eine zimmerbasierten Preis pro Tag (Tagesrate), um die Angebots-/Paketpreise pro Person zu berechnen – das bedeutet:
bei 3 Tagesraten:
90 Euro + 100 Euro + 110 Euro Tagesrate pro Zimmer = Summe 300 Euro / 2 Personen = 150 Euro pro Person für die Zimmerkosten
zzgl. 20 Euro für zusätzliche Serviceleistungen im Arrangemnte (bspw. 1 Abendessen) verwendet.
Der errechnete Angebotspreis beträgt dann also 170 Euro pro Person.
Wenn Sie eine andere Methode bevorzugen, z. B. den gesamten Paketpreis pro Person, lassen Sie es uns wissen.
Übersicht der verfügbaren Nachrichten
Übersicht verfügbarer Nachrichten - offizielle OTA Messages - zum Abrufen/Senden von Raten auf
Raten lesen von Kurzurlaub.de
- OTA_HotelRatePlanRQ
: mit Angabe von
RatePlanCodeoderRatePlanIDwerden die Tagesraten für ausgewählte Ratenpläne / Angebote und zugeordnete Zimmer (mit RatePlanCode) geliefert
Raten senden an Kurzurlaub.de
-
OTA_HotelRateAmountNotifRQ : Raten und Restriktionen mit RoomType/RatePlan Kombinationen
-
OTA_HotelRatePlanNotifRQ : Raten und Restriktionen (beta) - Methode wird aktuell nicht global unterstützt. Sofern Sie Raten oder Restriktionen über diesen Endpunkt senden wollen, wenden Sie sich bitte an den Connectivity Support von Kurzurlaub.de