General hotel information
Request
XSD File : OTA_HotelDescriptiveInfoRQ.xsd
Request
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelDescriptiveInfoRQ xmlns="http://www.opentravel.org/OTA/2003/05" PrimaryLangID="fr" AltLangID="de" RetransmissionIndicator="0" TimeStamp="2014-12-15T14:30:00+01:00" Target="Test" Version="1.000"> <POS> <Source> <RequestorID ID="YOURUSERNAME" MessagePassword="YOURPASSWORD" /> </Source> </POS> <HotelDescriptiveInfos> <HotelDescriptiveInfo HotelCode="YOURHOTELCODE"> <HotelInfo SendData="true" /> </HotelDescriptiveInfo> </HotelDescriptiveInfos> </OTA_HotelDescriptiveInfoRQ>
Response
XSD File : OTA_HotelDescriptiveInfoRS.xsd
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" PrimaryLangID="fr" AltLangID="de" RetransmissionIndicator="0" TimeStamp="2015-09-07T16:44:26+02:00" Target="Test" Version="1.0" CorrelationID="1">
<Success></Success>
<HotelDescriptiveContents>
<HotelDescriptiveContent HotelName="YOURHOTELNAME" AreaUnitOfMeasureCode="14" DistanceUnitOfMeasureCode="1" TimeZone="+01:00" WeightUnitOfMeasureCode="16" CurrencyCode="CHF">
<HotelInfo TaxID="3" WhenBuilt="1900-01-01" HotelStatusCode="1">
<Descriptions>
<MultimediaDescriptions> ... </MultimediaDescriptions>
</Descriptions>
<Position Altitude="150" Latitude="47.444546" Longitude="4.161718" PositionAccuracyCode="12"/>
<CategoryCodes>
<LocationCategory Code="4"/>
<SegmentCategory Code="4"/>
<HotelCategory Code="20"/>
<ArchitecturalStyle Code="6"/>
</CategoryCodes>
<Services>
<Service Code="005.OTA" CodeDetail="Refer to OpenTravel Code List Hotel Amenity Code (HAC)."/>
<Service Code="001.BKB" CodeDetail="Refer to BookBedder.com Code Table (BKB)."/>
<Service MealPlanCode="1.MPT" ID="00L55debf730d53e" Removal="1" Included="1" ProximityCode="3" Quantity="3">
<OperationSchedules>
<OperationSchedule>
<OperationTimes>
<OperationTime Start="2015-08-09" End="2015-09-15" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="On the hour"/>
</OperationTimes>
</OperationSchedule>
</OperationSchedules>
<MultimediaDescriptions> ... </MultimediaDescriptions>
</Service>
</Services>
</HotelInfo>
</HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS>
Details
| Node | Attribute | Documentation | Value type | Always present | Repetitive |
|---|---|---|---|---|---|
| HotelInfo | Contains descriptive information about a hotel. | no | no | ||
| TaxID | The tax ID code for the property. | StringLength1to16 | |||
| WhenBuilt | The date that the hotel facility was built, usually just the year. | StringLength1to16 | |||
| HotelStatusCode | This indicates the operating status (e.g. Open, Closed, Deflagged, Pre-opening) of the hotels to be returned in the response. Refer to OpenTravel Code List HotelStatusCode (HST). | OTA_CodeType | |||
| Descriptions | Collection of hotel information. | no | no | ||
| MultimediaDescriptions | Multimedia information about the hotel. Refer to page "MultimediaDescriptions" | no | no | ||
| Position | Describes the geocoded location of the hotel. | no | no | ||
| Altitude | The height of an item, typically above sea level. | StringLength1to16 | |||
| Latitude | The measure of the angular distance on a meridian north or south of the equator. | StringLength1to16 | |||
| Longitude | The measure of the angular distance on a meridian east or west of the prime meridian. | StringLength1to16 | |||
| PositionAccuracyCode | Indicates the accuracy of the property's geo-coding, since the property's longitude and latitude may not always be exact. Refer to OpenTravel Code List Position Accuracy Code (PAC). | OTA_CodeType | |||
| CategoryCodes | Used to define specific hotel information such as the type, location and architectural style. | no | |||
| LocationCategory | Defines the general location of the hotel such as airport, suburban, downtown. | ||||
| Code | This defines the location of the hotel (e.g. downtown, airport or suburban, etc.). Refer to OpenTravel Code List Location Category Codes (LOC). | OTA_CodeType | |||
| SegmentCategory | Defines the type of hotel such as luxury, extended stay, economy. | ||||
| Code | Refer to OpenTravel Code List Segment Category Code (SEG). | OTA_CodeType | |||
| HotelCategory | Defines the particular type of hotel (e.g., golf, ski, bed and breakfast). | ||||
| Code | Refer to OpenTravel Code List Property Class Type (PCT). | OTA_CodeType | |||
| ArchitecturalStyle | Describes the appearance of the building such as art deco, modern, historic. | ||||
| Code | Refer to OpenTravel Code List Architectural Style Code (ARC). | OTA_CodeType | |||
| Services | Collection of hotel services and/or amenities available to the guest. | no | no | ||
| Service | A hotel service or amenity available to the guest such as a business center, concierge, valet parking, massage, newspapers, etc. | yes | yes | ||
| AvailableToAnyGuest | This flag indicates whether the business service is available to all guests or only to certain guests at the facility. | ||||
| BusinessServiceCode | Refer to OpenTravel Code List Business Srvc Type (BUS). | OTA_CodeType | |||
| Code | Refer to OpenTravel Code List Hotel Amenity Code (HAC). The code for a service or amenity. | OTA_CodeType | |||
| CodeDetail | May be used to give further detail on the code. Information about which list the code refers to. | StringLength1to128 | |||
| MealPlanCode | This describes available meal plans for a property. Refer to OpenTravel Code Table Meal Plan Type (MPT). | OTA_CodeType | |||
| ID | A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. | StringLength1to32 | |||
| Removal | If true, this item is obsolete and should be removed from the receiving system. | Boolean | |||
| Included | If TRUE, this recreation is included with basic room rates. | Boolean | |||
| ProximityCode | Denotes whether a recreation is onsite, offsite or information is not available. Refer to OpenTravel Code Table Proximity (PRX). | OTA_CodeType | |||
| Quantity | Denotes the total number of service items identified by the Code attribute. | NonNegativeInteger | |||
| OperationSchedules | Collection of operation schedules. | no | yes | ||
| OperationSchedule | The OperationSchedule class defines the dates and hours of operation. | yes | no | ||
| OperationTimes | A collection of OperationTimes. | yes | no | ||
| OperationTime | Provides operating times of a facility. | yes | yes | ||
| Start | The starting value of the time span. | DateOrTimeOrDateTimeType | |||
| End | The ending value of the time span. | DateOrTimeOrDateTimeType | |||
| Mon | When true, apply to Monday. | Boolean | |||
| Tue | When true, apply to Tuesday. | Boolean | |||
| Weds | When true, apply to Wednesday. | Boolean | |||
| Thur | When true, apply to Thursday. | Boolean | |||
| Fri | When true, apply to Friday. | Boolean | |||
| Sat | When true, apply to Saturday. | Boolean | |||
| Sun | When true, apply to Sunday. | Boolean | |||
| Frequency | The frequency with which this operation occurs (e.g., 'on the hour', 'on the half hour'). | StringLength1to64 | |||
| MultimediaDescriptions | Multimedia information about the service.Contains multimedia item(s). Refer to page "MultimediaDescriptions" | no | yes |
Services sources type
| Source | Suffix | Datas send |
|---|---|---|
OTA Business services | BUS | BusinessServiceCode="{CODE}.BUS" AvailableToAnyGuest="0|1" CodeDetail = "Refer to OpenTravel Code List Business Srvc Type (BUS)." |
OTA Meal plan services | MPT | MealPlanServiceCode="{CODE}.MPT" CodeDetail = "Refer to OpenTravel Code Table Meal Plan Type (MPT)." |
OTA Amenities | OTA | Code="{CODE}.OTA" CodeDetail = "Refer to OpenTravel Code List Hotel Amenity Code (HAC)." |
Booking.com predefined services | BOO | Code="{CODE}.BOO" CodeDetail = "Refer to Booking.com Code Table (BOO)." AvailableToAnyGuest="0" |
Expedia.com predefined services | EXP | Code="{CODE}.EXP" CodeDetail = "Refer to Expedia.com Code Table (EXP)." AvailableToAnyGuest="0" |
BookBedder amenities | BKB | Code="{CODE}.BKB" CodeDetail = "Refer to BookBedder.com Code Table (BKB)." AvailableToAnyGuest="0" |
| CRS defined service | NULL | ID="{ID}" CodeDetail = "Hotel-Spider CRS Defined service." |
Use cases
Use case #1: a hotel without any service
<HotelDescriptiveContent HotelName="Mövenpick" AreaUnitOfMeasureCode="14" DistanceUnitOfMeasureCode="1" TimeZone=" " WeightUnitOfMeasureCode="16" CurrencyCode="CHF">
<HotelInfo TaxID="3" WhenBuilt="1900-01-01" HotelStatusCode="1">
<Position Altitude="150" Latitude="47.444546" Longitude="4.161718" PositionAccuracyCode="12"/>
</HotelInfo>
</HotelDescriptiveContent>
Use case #2: a hotel with a business service
<Service BusinessServiceCode="003.BUS" AvailableToAnyGuest="1" CodeDetail="Refer to OpenTravel Code List Business Srvc Type (BUS)." ID="00L55e46400a623d" Removal="1" Included="1" ProximityCode="3" Quantity="6">
<OperationSchedules>
<OperationSchedule>
<OperationTimes>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="1"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="1"/>
</OperationTimes>
</OperationSchedule>
</OperationSchedules>
</Service>
Use case #3: a hotel with a meal plan
<Service MealPlanCode="001.MPT" ID="00L55df0c885b9bb" Removal="1" Included="0" ProximityCode="3" Quantity="1">
<OperationSchedules>
<OperationSchedule>
<OperationTimes>
<OperationTime Start="2015-08-09" End="2015-09-15" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
</OperationTimes>
</OperationSchedule>
</OperationSchedules>
<MultimediaDescriptions>
<MultimediaDescription AdditionalDetailCode="72">
<TextItems>
<TextItem Language="fr" CreateDateTime="2015-09-07T17:40:45+02:00" LastModifyDateTime="2015-09-07T17:40:45+02:00">
<Description>Breakfast</Description>
</TextItem>
</TextItems>
</MultimediaDescription>
</MultimediaDescriptions>
</Service>
Use case #4: a hotel with various amenities
<Services> <Service Code="005.OTA" CodeDetail="Refer to OpenTravel Code List Hotel Amenity Code (HAC)."/> <Service Code="224.OTA" CodeDetail="Refer to OpenTravel Code List Hotel Amenity Code (HAC)."/> <Service Code="001.BKB" CodeDetail="Refer to BookBedder.com Code Table (BKB)."/> <Service Code="003.OTA" CodeDetail="Refer to OpenTravel Code List Hotel Amenity Code (HAC)."/> </Service>
Use case #5: a hotel with predefined services
<Service AvailableToAnyGuest="0" Code="001.BOO" CodeDetail="Refer to Booking.com Code Table (BOO)." ID="00L55e463db9067e" Removal="0" Included="0" ProximityCode="4" Quantity="10">
<OperationSchedules>
<OperationSchedule>
<OperationTimes>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="1"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="1"/>
</OperationTimes>
</OperationSchedule>
</OperationSchedules>
</Service>
Use case #6: a hotel with a CRS defined service
<Service CodeDetail="Hotel-Spider CRS Defined service" ID="00L55e463b55d980" Removal="0" Included="1" ProximityCode="1" Quantity="19">
<OperationSchedules>
<OperationSchedule>
<OperationTimes>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="1"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="2"/>
<OperationTime Start="2015-08-27" End="2019-08-27" Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Frequency="1"/>
</OperationTimes>
</OperationSchedule>
</OperationSchedules>
</Service>
, multiple selections available,