Zum Inhalt

Entwicklerhandbuch - Restriktionen Push API

Was ist die Restriktionen Push API?

Kurzurlaub.de verwendet die OTA Nachrichten OTA_HotelBookingRuleRQ/RS und OTA_HotelBookingRuleRQ/RS, um Restriktionen und Buchungsregeln (Verkaufs-Flags) für ein Hotel zu empfangen.

Die vom OTA-Partner gesendeten Daten werden nur für Zimmer akzeptiert, die aktiv und online sind, alternativ werden Warnungen als Antwort gesendet.

Generell werden Zeilen mit Restriktionen 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 RuleMessages-Element, das das zu aktualisierende Hotel mithilfe des @HotelCode-Attributs angibt. Die BookingRule-Elemente enthalten die Aktualisierungen, die über einen Datumsbereich verarbeitet werden sollen.

Hinweis:

Es können mehrere BookingRule-Aktualisierungen pro Anfrage erfolgen, jedoch ist jede Anfrage auf ein Hotel (HotelCode) und dessen Zimmer und/oder Angebote beschränkt.

Zwei Arten von Verfügbarkeiten

Die erste Frage sollte immer lauten:

Verwenden wir nur Verfügbarkeiten und Restriktionen auf

  1. Zimmerebene (RoomType only)
  2. 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. Restriktionen auf Zimmerebene

wird für Regeln aktuell nicht unterstützt, kontaktieren Sie den Support

2. Restriktionen Zimmer/Angebotsebene

Wenn Ihr Backend Verfügbarkeiten oder Raten auf Zimmerebene und Angebotsebene unterstützt - also Zimmertypen und Ratenpläne (sog. RoomType/RatePlan Kombinationen), verwenden Sie bitte diese Variante.

Beispiel für Kombination InvTypeCode/RatePlanCode und SetMinLOS/SetMaxLOS sowie Restriction (Arrival, Departure, Master):

        <RuleMessage>
            <StatusApplicationControl InvTypeCode="12345" RatePlanCode="TEST-BAR-2N"/>
            <BookingRules>
                <BookingRule Start="2024-05-10" End="2024-05-12">
                    <LengthsOfStay>
                        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day"/>
                        <LengthOfStay MinMaxMessageType="SetMaxLOS" Time="7" TimeUnit="Day"/>
                    </LengthsOfStay>
                    <RestrictionStatus Restriction="Arrival" Status="Open"/>
                    <RestrictionStatus Restriction="Departure" Status="Open"/>
                    <RestrictionStatus Restriction="Master" Status="Close"/>
                </BookingRule>
                <BookingRule Start="2024-02-15" End="2024-02-15">
                    <RestrictionStatus Restriction="Arrival" Status="Close"/>
                    <RestrictionStatus Restriction="Master" Status="Open"/>
                </BookingRule>
                <BookingRule Start="2024-03-30" End="2024-03-30">
                    <RestrictionStatus Restriction="Departure" Status="Close"/>
                </BookingRule>
            </BookingRules>
        </RuleMessage>

Übersicht der verfügbaren Nachrichten

Übersicht verfügbarer Nachrichten - offizielle OTA Messages - zum Abrufen/Senden von Restriktionen

Buchungsregeln / Restriktionen lesen von Kurzurlaub.de

Buchungsregeln / Restriktionen senden an Kurzurlaub.de

Siehe auch Methoden zum Senden von Raten und Verfügbarkeiten, hier können auch Restriktionen (Master Open/Close, CTA, CTD, MinLOS, MaxLOS) mitgesendet werden