Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

A property descriptive information request must include the following elements:

  • CRS Hotel Code

A property descriptive information request may optionally specify the following elements:

  • Language Code

    • If the Language Code is not specified, then the response will default to English, regardless of hotel default language.

OTA_HotelDescriptiveInfoRQ Elements & Attributes

...

Level

Occurrence

Type

Element Name/Attribute Name

Mandatory (M)

Optional (O)

Data Type

“Sample Value” Usage

0

1

E

OTA_HotelDescriptiveInfoRS

 

 

 

 

 

A

Success

O

 

The presence of the empty Success element explicitly indicates that the OTA versioned message succeeded.

 

 

A

Warnings

O

 

The presence of the empty Success element explicitly indicates that the OTA versioned message succeeded.

 

 

A

Warning

O

 

Standard way to indicate successful processing of an OTA message, but one in which warnings are generated

1

1

E

HotelDescriptiveContents

M

 

A collection of hotel descriptive contents

 

 

A

Chain Code

M

String

Hotel brand chain code

 

 

A

HotelCode

M

String

The CRS code that uniquely identifies a single hotel property.

 

 

A

HotelName

M

String

Hotel name

2

1

E

HotelDescriptiveContent

O

 

Hotel Descriptive content

 

 

A

CurrencyCode

M

String(3)

The 3-character alpha code specifying a monetary unit based on ISO 4217.

 

 

A

LanguageCode

M

String(3)

Identification of the requested language to be used for the hotel descriptive information. ISO standard for human-readable languages. If no Language Code is specified, the default response will be English, regardless of the hotel’s default language.

 

 

A

UnitOfMeasure

M

String

The unit of measure in a code format. Refer to OTA Code List Unit of Measure Code (UOM).

 

 

A

TimeZone

M

String

Describes the local time zone in which the hotel is located. This could include additional information regarding time zones (e.g., Daylight Saving Time observed), a proprietary code, the difference between the local time and GMT.

 

 

A

ChainCode

O

String

Hotel brand chain code

 

 

A

ChainName

O

string

Hotel brand chain name

3

1

E

HotelInfo

M

 

Hotel descriptive info

 

 

A

WhenBuilt

O

Integer

The year hotel was built

 

 

A

HotelStatus

M

String

This is a description of the operating status of the Hotel.

4

 

E

HotelStatusCode

M

String

This indicates the operating status (e.g. Open, Closed, Deflagged, Pre-opening) of the hotels to be returned in the response. Refer to OTA Code List HotelStatusCode.

4

 

E

CategoryCodes

M

String

Collection of descriptive details about a hotel.

 

 

A

HotelName

M

 

Hotel name

4

 

E

LocationCategory

O

 

Defines the general location of the hotel such as airport, suburban, downtown.

 

 

A

Code

O

String

This defines the location of the hotel (e.g. downtown, airport or suburban, etc.). Refer to OTA Code List Location Category Codes (LOC).

 

 

A

CodeDetail

O

String

Give further detail on the code.

4

1

E

SegmentCategory

O

String

Defines the type of hotel such as luxury, extended stay, and economy. Refer to OTA Code List Segment Category Code (SEG).

4

1

E

HotelCategory

O

String

Defines the particular type of hotel (e.g., golf, ski, bed and breakfast).

4

1

E

GuestRoomInfo

M

 

The types and quantities of guest rooms at a hotel.

 

 

A

Code

M

String

Refer to OTA Code List Guest Room Info (GRI).

 

 

A

CodeDetail

O

String

Further detail on the code.

 

 

A

Quantity

M

String

Total number of rooms

4

1

E

Position

O

 

Describes the geocoded location of the hotel.

 

 

A

Latitude

O

String

The measure of the angular distance on a meridian north or south of the equator.

 

 

A

Longitude

O

String

The measure of the angular distance on a meridian east or west of the prime meridian.

4

1

E

Services

M

 

Collection of hotel services and/or amenities available to the guest.

5

1..n

E

Service

O

 

A hotel service or amenity available to the guest such as a business center, concierge, valet parking, massage, newspapers, etc.

 

 

A

Code

M

String

OTA Code List Hotel Amenity Code (HAC).

 

 

A

ExistsCode

M

String

This attribute is used to explicitly define whether an amenity or service is free.

 

 

A

CodeDetail

M

String

Detail of the amenity

 

 

A

ProximityCode

O

String

Denotes whether a service is onsite, offsite or information is not available.

6

1

E

DescriptiveText

O

String

Descriptive text that describes the service.

3

1

E

FacilityInfo

M

 

Describes the facilities provided at the hotel, including meeting rooms restaurants.

4

1

E

GuestRooms

M

 

Collection of guest room types that are comprised within the hotel.

5

1..n

E

GuestRoom

 

 

The accommodation occupied by a guest.

 

 

A

RoomTypeName

M

String

The room type name

 

 

A

MaxOccupancy

M

Integer

Maximum number of guests allowed in a room type.

 

 

A

MaxAdultOccupancy

M

Integer

Maximum number of adults allowed in a room type.

 

 

A

MaxChildOccupancy

M

Integer

Maximum number of children allowed in a room type.

6

1

E

TypeRoom

 

 

Describes the guest room type; in composite types there can be multiple occurrences.

 

 

A

StandardNumBeds

M

Integer

Indicates the usual number of beds for this room type.

 

 

A

StandardOccupancy

M

Interger

Indicates the usual number of guests that occupy this room.

 

 

A

Size

O

Decimal

Number of square units (feet or meters) that defines the size of a room type.

 

 

A

Name

M

String

Text name of the type of room such as "Two Bedroom Villas".

 

 

A

RoomTypeCode

M

String

Specific system room type code, ex: A1K, A1Q etc.

6

0..n

E

MultimediaDescriptions

O

 

Multimedia information about the guest room.

 

0..n

E

MultimediaDescription

O

 

A multimedia item.

 

0..n

E

ImageItems

O

 

Collection of image items.

 

0..n

E

ImageItem

O

 

Image of a given category.

 

0..n

E

ImageFormat

O

 

A set of images for a given category which may be provided in multiple formats.

 

 

A

Width

O

Integer(2)

The width of the image item (unit specified by unit of measure).

 

 

A

Height

O

Integer(2)

The height of the image item (unit specified by unit of measure).

 

 

A

Format

O

Codes

Identifies the format of an image. Refer to OTA Code List Content Format Code (CFC).

 

 

 

URL

O

String

URL of the multimedia item for a specific format.

4

1

E

Policies

M

 

A collection of policy information as it applies to the hotel.

5

1..n

E

Policy

M

 

Describes the policies of the hotel, such as the type of payments, or whether children or pets are accepted.

6

1

E

CancelPolicy

M

 

Defines the cancellation policy of the hotel facility. A collection of CancelPenalty.

 

 

A

CancelPolicyIndicator

M

Bool

When true, indicates a cancel policy exits. When false, no cancel policy exists. Typically this indicator is used when details are not being sent.

7

1

E

CancelPenalty

 

 

Defines the cancellation penalty of the hotel facility.

8

1

E

Deadline

 

 

Cancellation deadline, absolute or relative.

 

 

A

AbsoluteDeadline

M

Datetime

Defines the absolute deadline.

 

 

A

OffsetDropTime

M

Codes

An enumerated type indicating when the deadline drop time goes into effect.

AfterArrival: The deadline applies after the scheduled arrival time.

AfterDeparture: The deadline applies after the scheduled departure time.

BeforeArrival: The deadline applies befpr the scheduled arrival time.

 

 

E

AmountPercent

M

 

Cancellation fee expressed as a fixed amount, or percentage of/or room nights.Defines the percentage basis for calculating the fee amount or the amount

 

 

A

NmbrOfNights

O

Integer(2)

The number of nights of the hotel stay that are used to calculate the fee amount.

 

 

A

Percent

O

Decimal

The percentage used to calculate the amount.

8

1

E

PenaltyDescription

O

 

Text description of the Penalty in a given language. An indication of a new paragraph for a sub-section of a formatted text message.

 

 

A

Text

O

String

Indicates the format of text used in the description e.g. unformatted or html.

6

1

E

GuaranteePaymentPolicy

M

 

A collection of deposit policies, guarantees policy, and/or accepted forms of payment.

7

1

E

GuaranteePayment

M

 

Used to define the deposit policy, guarantees policy, and/or accepted forms of payment.

 

 

A

PaymentCode

M

Codes

This defines the form of payment.

 

 

A

GuaranteeCode

M

Codes

Guarantee Code

 

 

A

GuaranteeType

M

Codes

Defines the guarantee to be applied to this reservation.

 

 

A

Start

M

Datetime

The starting value of the time span.

 

 

A

End

M

Datetime

The ending value of the time span.

8

1

E

Deadline

M

 

Payment deadline, absolute or relative.

 

 

A

AbsoluteDeadline

O

Datetime

Defines the absolute deadline.

 

 

E

Description

O

 

Text description of the Payment in a given language..

 

 

A

Text

O

String

Formatted text content.

6

0..1

E

PetsPolicies

O

 

Property pet policies.

 

 

A

PetsAllowedCode

M

Codes

Specifies at a high level the pet policy.

7

0..9

 

PetPolicy

O

 

Pet policy

 

 

A

MaxPetQuantity

O

Integer

Maximum Number of Pets allowed in the accommodation provided.Used for Numeric values, from 0 to 99 inclusive.

 

 

 

RefundableDeposit

M

Money

Specifies the charge associated with a pet staying in the room.

8

0..1

E

Description

O

 

Text description of the pet policy in a given language..

 

 

 

Text

O

String

Formatted text content.

6

0..1

E

CommissionPolicy

O

 

Used to define the property's high-level commission policy.

 

 

A

Percent

M

Decimal

Fee percentage

 

 

A

CommissionApplicability

M

Codes

Specifies whether commissions apply to all, none, or some rates.

7

0..1

E

Description

O

 

Text description of the pet policy in a given language..

 

 

A

Text

O

String

Formatted text content.

4

0..n

E

AreaInfo

O

 

Defines well-known locations and attractions of local interest in the geographical area of the hotel facility as well as other area hotels.

5

 

E

RefPoints

O

 

A collection of reference points.

6

 

E

RefPoint

O

 

Provides information on the location of an area attraction.

 

 

A

Direction

O

String

Defines the cardinal direction (e.g., north, south, southwest).

 

 

A

Distance

O

String

Defines the distance between two points.

 

 

A

DistanceUnitName

O

String

Measure unit

 

 

A

PrimaryIndicator

O

String

indicates whether the reference point is considered the main reference point

 

 

A

RefPointCategoryCode

O

String

he code for the type of reference point

 

 

A

Proximity

O

String

Indicates the proximity (e.g., closest, second closest) between the reference point and the hotel.

 

 

A

RefPointName

O

String

The name of the reference point.

 

 

A

Latitude

O

String

The measure of the angular distance on a meridian north or south of the equator.

 

 

A

Longitud

O

String

The measure of the angular distance on a meridian east or west of the prime meridian.

 

 

A

ExistsCode

O

String

Defines whether the reference point applies.

 

 

A

ID

M

Integer

A unique identifying in CRS

 

 

E

DescriptiveText

O

String

Text description of the reference point

4

 

E

AffiliationInfo

O

 

Identifies the brand or franchise affiliations of the hotel.

 

 

E

Awards

O

 

A collection of Award elements.

 

 

E

Award

O

 

Provides detailed information regarding each award for this hotel

 

 

A

Rating

O

String

The actual award or rating received by the hotel facility

 

 

A

Provider

O

String

The name of the award or ratings provider

4

 

E

ContactInfo

M

 

Defines the contacts for consumers and technical people at the hotel facility, including various telephone numbers and e-mail addresses, or any respective attribute or affiliation for the hotel.

5

 

 

Names

M

 

Provides detailed name information.

6

 

E

Name

M

 

Used to pass detailed name information regarding a contact.

 

 

A

GivenName

M

String

Given name, first name or names.

 

 

A

Surname

M

String

Family name, last name.

 

 

A

JobTitle

O

String

Job title

5

 

E

Addresses

M

 

A collection of Address elements.

6

 

E

Address

M

 

 

 

 

A

UseType

O

Codes

The type of address

 

 

A

AddressLine

M

String

Street number and street name

 

 

A

CityName

M

String

City (e.g., Dublin), town, or postal station – i.e., a postal service territory, often used in a military address.

 

 

A

PostalCode

M

String

Postal/Zip Code number.

 

 

A

StateProv

M

String

State or Province name – i.e., Texas, Alberta

 

 

A

CountryName

M

String

Country name – i.e., Ireland.

5

 

E

Phones

M

 

A collection of Phone elements.

6

 

E

Phone

M

 

Provides detailed phone information.

 

 

A

PhoneLocationType

M

Codes

Describes the location of the phone

 

 

A

PhoneTechType

M

Codes

Indicates type of technology associated with this phone

 

 

A

PhoneUseType

M

Codes

Describes the type of telephone number

 

 

A

CountryAccessCode

M

String

Code assigned by telecommunications authorities for international country access identifier.

 

 

A

AreaCityCode

M

String

Code assigned for telephones in a specific region, city, or area.

 

 

A

PhoneNumber

M

String

Telephone number assigned to a single location.

5

 

E

Emails

M

 

The email addresses

6

 

E

Email

M

 

Provide the email address

 

 

A

EmailType

M

Codes

Defines the purpose of the email address

5

 

E

URLs

M

 

The URLs class identifies URI information.

 

 

A

URL

M

String

Provides a Website address.

 

 

A

Type

M

String

Defines the purpose of the URL address

...