Room Information Search
OTA Message Pair: OTA_HotelDescriptiveInfoRQ / OTA_HotelDescriptiveInfoRS
Description
The OTA_HotelDescriptiveInfoRQ message is a request for property Room Type details.
In order to use this service, a live connection to Levart along with a valid username and password are required (HTTP Basic Authentication)
When a client application sends a correctly-formatted OTA_HotelDescriptiveInfoRQ message Levart will respond with an OTA_HotelDescriptiveInfoRS message containing the property details.
The request must specify the property HotelCode (gained from the OTA_HotelSearchRS message) and SendGuestRooms="True" in the FacilityInfo element.
The response will contain a list of Room Types, their ID's, occupancy details and bedding configuration.
XML Request
<OTA_HotelDescriptiveInfoRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" EchoToken="2dns7dnmssdXSAS" TimeStamp="2016-02-10T13:06:55+08:00">
<HotelDescriptiveInfos>
<HotelDescriptiveInfo HotelCode="www.property.com.au">
<FacilityInfo SendGuestRooms="True" />
</HotelDescriptiveInfo>
</HotelDescriptiveInfos>
</OTA_HotelDescriptiveInfoRQ>OTA_HotelDescriptiveInfoRQ Specification
| Element | Num | Description |
|---|---|---|
| OTA_HotelDescriptiveInfoRQ | 1 | Root element |
| @Version | 1 | Current Version 1.0 |
| @EchoToken | 0..1 | EchoToken text |
| @TimeStamp | 1 | Date and time of the transaction in ISO 8601 format. e.g. 2016-01-28T15:15:00+08:00 |
| HotelDescriptiveInfos/HotelDescriptiveInfo | 1 | Hotel Reference element |
| @HotelCode | 1 | HotelCode attribte gained from the OTA_HotelSearchRS message. |
| FacilityInfo | 1 | FacilityInfo element |
| @SendGuestRooms | 1 | Set to True to return the Guest Rooms contained at the property. |
Response (Success)
<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" EchoToken="2dns7dnmssdXSAS" TimeStamp="2016-02-10T13:06:55+08:00">
<Success/>
<HotelDescriptiveContents HotelCode="www.property.com.au" HotelName="TEST HOTEL">
<HotelDescriptiveContent>
<FacilityInfo>
<GuestRooms>
<GuestRoom RoomTypeName="Double Standard" MaxOccupancy="2" MaxAdultOccupancy="2" ID="170" MaxChildOccupancy="1">
<!-- Note BedTypeCode corresponse to the above OTA BED table -->
<TypeRoom StandardNumBeds="1" BedTypeCode="1" MaxRollaways="0" MaxCribs="0" />
</GuestRoom>
<GuestRoom RoomTypeName="King Standard" MaxOccupancy="3" MaxAdultOccupancy="3" ID="172" MaxChildOccupancy="2">
<TypeRoom StandardNumBeds="1" BedTypeCode="3" MaxRollaways="1" MaxCribs="0" />
</GuestRoom>
<GuestRoom RoomTypeName="Double Mountain View" MaxOccupancy="2" MaxAdultOccupancy="2" ID="177" MaxChildOccupancy="1">
<TypeRoom StandardNumBeds="1" BedTypeCode="1" MaxRollaways="0" MaxCribs="0" />
</GuestRoom>
</GuestRooms>
</FacilityInfo>
</HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS>Response (Error)
<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" EchoToken="2dns7dnmssdXSAS" TimeStamp="2016-01-28T15:15:00+08:00">
<Errors>
<Error>Could not find property</Error>
</Errors>
</OTA_HotelDescriptiveInfoRS>
OTA_HotelDescriptiveInfoRS Specification
| Element | Num | Description |
|---|---|---|
| OTA_HotelDescriptiveInfoRS | 1 | Root element |
| @Version | 1 | Current Version 1.0 |
| @EchoToken | 0..1 | EchoToken response (if provided in request) |
| @TimeStamp | 1 | Date and time of the transaction in ISO 8601 format. e.g. 2016-01-28T15:15:00+08:00 |
| Success | 0..1 | Success if request and transaction was successful. |
| Errors / Error | 0..n | Error messages if problems experienced. |
HotelDescriptiveContent / FacilityInfo / GuestRooms | 1 | GuestRooms element |
GuestRoom | 1..n | GuestRoom element. Represents a room type at the property. |
@RoomTypeName | 1 | Name of the room type |
@MaxOccupancy | 1 | Maximum allowed occupancy of the room type. |
@MaxAdultOccupancy | 1 | Maximum allowed adult occupancy of the room type |
@MaxChildOccupancy | 1 | Maximum allowed child occupancy of the room type |
| TypeRoom | 0..n | Room type bedding configuration |
| @StandardNumBeds | 1 | Standard number of beds of specified @BedTypeCode |
| @BedTypeCode | 1 | Refer to the OTA Bedding Type Code (BED) Table |
| @MaxRollaways | 1 | Maximum number of roll-away beds that can be supplied for this room type configuration. |
| @MaxCribs | 1 | Maximum number of cribs / cots. |
OTA Bedding Type Code (BED)
| Code | Description |
|---|---|
1 | Double |
2 | Futon |
3 | King |
4 | Murphy bed |
5 | Queen |
6 | Sofa bed |
7 | Tatami mats |
8 | Twin |
9 | Single |
10 | Full |
11 | Run of the house |
12 | Dorm bed |