Zum Inhalt

OTA_HotelDescriptiveInfoRQ

Methode zum Abrufen von Zimmerdaten von Kurzurlaub.de.

HotelDescriptiveInfo Request (RQ) und Response (RS) am Beispiel des Testhotels

Verwendete Attibute:

  • @AgentDutyCode (Agent-ID): 1
  • @HotelCode (Hotel-ID): 4

Beispiel OTA_HotelDescriptiveInfoRQ (Request)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveInfoRQ xmlns="http://www.opentravel.org/OTA/2003/05"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://opentravel.org/2010A/OTA_HotelDescriptiveInfoRQ.xsd" 
    EchoToken="1" Target="Production" Version="1.002">
    <POS>
        <Source AgentDutyCode="1">
            <RequestorID ID="4" Type="4"/>
        </Source>
    </POS>
    <HotelDescriptiveInfos>
        <HotelDescriptiveInfo HotelCode="4">
            <FacilityInfo SendGuestRooms="true"/>
        </HotelDescriptiveInfo>
    </HotelDescriptiveInfos>
</OTA_HotelDescriptiveInfoRQ>

Aufruf per REST-API

jede Methode kann per REST-API mittels GET aufgerufen werden.

Verwendete Parameter:

  • AgentDutyCode (optional, sofern IP WhiteList oder HTTP Basic Auth verwendet wird)
  • HotelCode (mandatory)

Beispiel:

GET /ota/api/HotelDescriptiveInfo?AgentDutyCode=1&HotelCode=4

Versionen der Response

OTA-V1

Alte Version der OTA_HotelDescriptiveInfoRS nur mit Zimmerdaten

Beispiel OTA_HotelDescriptiveInfoRS (Response)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05"
                            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Target="Production" Version="2.000"
                            SequenceNmbr="1" PrimaryLangID="de" AltLangID="de"
                            xsi:schemaLocation="http://opentravel.org/2010A/OTA_HotelDescriptiveInfoRS.xsd">
    <Success/>
    <HotelDescriptiveContents Overwrite="true">
        <HotelDescriptiveContent HotelCode="4">
            <FacilityInfo>
                <GuestRooms>
                    <GuestRoom Code="26808" Quantity="0" RoomTypeName="Appartement/s (12 m², ID:26808, 2E/2K)">
                        <TypeRoom StandardOccupancy="2"/>
                    </GuestRoom>
                    <GuestRoom Code="9147" Quantity="3" RoomTypeName="Doppelzimmer (24 m², ID:9147, 2E/2K)">
                        <TypeRoom StandardOccupancy="2"/>
                    </GuestRoom>
                    <GuestRoom Code="5306" Quantity="43" RoomTypeName="Doppelzimmer (20 m², ID:5306, 2E/2K)">
                        <TypeRoom StandardOccupancy="2"/>
                    </GuestRoom>
                    <GuestRoom Code="11668" Quantity="5" RoomTypeName="Dreibettzimmer (29 m², ID:11668, 3E/3K)">
                        <TypeRoom StandardOccupancy="3"/>
                    </GuestRoom>
                    <GuestRoom Code="5307" Quantity="5" RoomTypeName="Einzelzimmer (15 m², ID:5307, 1E/1K)">
                        <TypeRoom StandardOccupancy="1"/>
                    </GuestRoom>
                    <GuestRoom Code="9148" Quantity="1" RoomTypeName="Einzelzimmer Deluxe (18 m², ID:9148, 1E/1K)">
                        <TypeRoom StandardOccupancy="1"/>
                    </GuestRoom>
                </GuestRooms>
            </FacilityInfo>
        </HotelDescriptiveContent>
    </HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS>

OTA-V2 (neue Version ab 10.2021)

Die neue Version der Methode OTA_HotelDescriptiveInfoRS ist bzgl. Aufbau der Zimmerdaten identisch zu OTA-V1, aber es wird zusätzlich zum Attribut @HotelCode der @HotelName gesendet

Beispiel

<HotelDescriptiveContent HotelCode="4" HotelName="Hotel Superurlaub Schwerin">

Abrufen von buchbaren Zusatzleistungen / Services

Optional können auch alle buchbaren Zusatzleistungen / Services (bspw. 20 min Massage zum Preis von 19,50 Euro) abgerufen werden. Dies erfolgt über die Methode OTA_HotelDescriptiveInfoRQ und muss vorab beim Kurzurlaub.de Connectivity Team beantragt werden.

Dies kann hilfreich sein, wenn die gebuchten Zusatzleistungen (werden mit der Buchung übermittelt) über die ID extra ausgewertet werden sollen.

Verwendete Attribute:

  • ID - eindeutige ID des service für Zuordnung in der Buchung
  • Code - OTA Code (HAC 1-348)
  • CodeDetail - Gruppe der Services
  • ServiceName - Name / Beschreibung
  • ServicePricingType - Preis pro
  • AmountAfterTax - Preis (ohne Komma je nach DecimalPlaces)
  • CurrencyCode - Währung
  • DecimalPlaces - Dezimalstellen im Preis vorhanden (AmountAfterTax="3500" DecimalPlaces="2" = 35,00 Euro)

Werte für Gruppen der Services

Servicecodes werden abgeleitet aus den Kurzurlaub.de internen Gruppen bspw. Code="148" CodeDetail="Verleih"

Bei Kurzurlaub.de existieren aktuell 17 Gruppen von Services und diese werden übersetzt den OTA Standard OTA HAC.

OTA HAC: Hotel Amenity Code for hotel additional services

Aktuell werden folgende Codes verwendet aus HAC 1-348:

HAC Code HAC Name / Beschreibung
35 Fitness facilities
91 Tour/sightseeing desk
148 Front desk
162 Meal plan available
346 Alcoholic beverages
348 Health and beauty services

Zuordnung der Kurzurlaub.de Gruppen-ID zu HAC Codes bspw. Gruppe 9 (Verleih) wirde dem HAC Code 148 (Front desk) zugeordnet.

Gruppen-ID HAC Code Kurzurlaub.de - Name der Gruppe
1 348 Massagen - Health and beauty services
2 348 Bäder
3 348 Medizinische Leistungen
4 148 Blumen -> Front desk
5 162 Speisen -> Meal plan available
6 346 Getränke -> Alcoholic beverages
7 148 Serviceleistungen
8 348 Beauty
9 148 Verleih
10 35 Sport -> Fitness facilities
11 91 Führungen & Besichtigungen -> Tour/sightseeing desk
12 91 Karten & Tickets
13 348 Wellnesspakete
17 348 Packungen

Zuordnung der Kurzurlaub.de Werte für Preisangaben zu OTA ServicePricingType

Preis pro OTA Werte - ServicePricingType
Zimmer Per room
Zimmer/Nacht Per room per night
Aufenthalt Per stay
Person Per person
Person/Nacht Per person per night
Nacht Per night
Stück Per use
default Per use
Tag Per day
Minuten Per minute
Stunde Per hour

Beispiel mit Services

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" EchoToken="c7512460332ae2ab1a9fd1c68364f340" PrimaryLangID="de" TimeStamp="2023-06-09T11:36:30+02:00" Target="Production" Version="2.000">
  <Success/>
  <HotelDescriptiveContents Overwrite="true">
    <HotelDescriptiveContent HotelCode="4" HotelName="TestHotel">
      <FacilityInfo>
        <GuestRooms>
          <GuestRoom Code="9147" Quantity="3" RoomTypeName="Doppelzimmer (24 m², ID:9147, 2E/2K)">
            <TypeRoom StandardOccupancy="2"/>
          </GuestRoom>
          <GuestRoom Code="5306" Quantity="43" RoomTypeName="Doppelzimmer (20 m², ID:5306, 2E/2K)">
            <TypeRoom StandardOccupancy="2"/>
          </GuestRoom>
        </GuestRooms>
      </FacilityInfo>
      <HotelInfo>
        <Services>
          <Service ID="50739" Code="162" CodeDetail="Speisen" ServiceName="Abendessen im Rahmen der Halbpension" ServicePricingType="pro Person" AmountAfterTax="3500" CurrencyCode="Euro" DecimalPlaces="2">
            <DescriptiveText/>
          </Service>
          <Service ID="96513" Code="148" CodeDetail="Serviceleistungen" ServiceName="Kinderpreis 6-14 Jahre nur Arrangement &quot;Willkommen im Schweriner Zoo&quot;" ServicePricingType="pro Person" AmountAfterTax="8900" CurrencyCode="Euro" DecimalPlaces="2">
            <DescriptiveText/>
          </Service>
          <Service ID="50732" Code="162" CodeDetail="Speisen" ServiceName="Obstkorb" ServicePricingType="pro Zimmer" AmountAfterTax="1500" CurrencyCode="Euro" DecimalPlaces="2">
            <DescriptiveText/>
          </Service>
        </Services>
      </HotelInfo>
    </HotelDescriptiveContent>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS>