HotelAvailability response message

Tabular overview of all nodes, which may occur in this message. See legend below for description of table columns.
Note: Some sibling elements or complete sub-trees of the hierarchy may be defined as mutually exclusive alternative choices. This information cannot be expressed in this tabular overview. Please refer to schema diagram for a graphical representation of the message schema.

NodeDescriptionValuesOccursExample
<HotelAvailabilityRS>
Hotel availability response root element1
@version
Version number. 0..1 1.0
@Lang
ISO language code. A two letter code as defined by ISO-639-1. This code specifies the requested language for text content. Default value is 'en'.0..1
<InfoGroup>
Error and information group0..1
<ForInfo>
Information group0..N
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
@SourceRef
PNR Record Locator associated to Source attribute.0..1
<Text/>
Information text or error text. 1..N Free flow text. Example: Invalid flight number
</ForInfo>
<Error>
Error group0..N
@ErrorType
Type of error. 1 Air
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
@SourceRef
PNR Record Locator associated to Source attribute.0..1
<Code/>
Error code or equipment type code. 1 0104 (error code), 747 (equipment code)
<Text/>
Information text or error text. 1..N Free flow text. Example: Invalid flight number
<UnderlyingError>
Errors of the backend system can be returned here.0..N
@Code
error code of the backend system.0..1
<Text/>
Information text or error text. 0..N Free flow text. Example: Invalid flight number
</UnderlyingError>
</Error>
<BackOffice>
Generic back office response container. Serves as a placeholder for any context specific content.0..1
</BackOffice>
</InfoGroup>
<Hotel>
Hotel information group1
@LinkType
Type of GDS link that the hotel participates in.
Possibles values are:
ASA = Amadeus standard access
ACA = Amadeus complete access
ACP = Amadeus complete access plus
ADY = Amadeus dynamic access
AIA = Amadeus independent access

GIA = Galileo inside availability link
GIP = Galileo inside shopper participant
GRM = Galileo roommaster only participant
GLP = Galileo link partner
GBP = Galileo Best Available Rate participant

SDC = Sabre direct connect sell
SOL = Sabre other link type

WSV = Worldspan hotel source vendor
WAP = Worldspan hotel select vendor access plus
WNP = Worldspan hotel select vendor non-access plus

HRS = HRS internal hotels
HRSEXT = HRS external hotels

HBC = Booking.com direct access hotels

[ASA] [ACA] [ACP] [ADY] [AIA] [GIA] [GIP] [GRM] [GLP] [GBP] [SDC] [SOL] [WSV] [WAP] [WNP] [HRS] [HRSEXT] [HBC] 1 GRM
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
<CheckInDate/>
Check in date in ISO 8601 format (yyyy-mm-dd). This is the date the customer will arrive (check in) at the hotel.
0..1 2001-12-25
<CheckOutDate/>
Check out date in ISO 8601 format (yyyy-mm-dd). This is the date the customer will depart(check out) the hotel.
0..1 2001-12-31
<NumberOfNights/>
Number of nights. 0..1 5
<NumberOfPersons/>
Number of adults. Will be 1 or 2. [1] to [2]0..1 1
<ChainCode/>
Chain code. 0..1 MC
<ChainName/>
Chain name. 0..1 Marriott
<PropertyCode/>
Property code. 0..1 MIA345
<PropertyName/>
Property name. 0..1 Marriott on the sea
<Address/>
Address. 0..1 1101 NW 57th AVE, Miami FL 33121, USA
<CityCode/>
City code. 0..1 MIA
<CityName/>
City name. 0..1 Miami
<StateCode/>
State code. 0..1 FL
<CountryCode/>
Country code. 0..1 US (United States)
<Location>
Location of the hotel.
Values are:
A = Airport
B = Beach
C = City Centre
D = Downtown
E = East of city
F = Freetext location description
N = North of city
O = Ouside Airport
R = Resort
S = South of city
T = Airport Terminal
U = Suburb
W = West of city
Y = Country

[A] [B] [C] [D] [E] [F] [N] [O] [R] [S] [T] [U] [W] [Y] 0..1 B
@Description
Freetext location description.0..1
</Location>
<Transportation/>
Transportation type. One of the legal transportation types associated with the property. Values are:
A = Rail
B = Bus
C = Courtesy car
F = Free transportation provided by the hotel
L = Limo
N = Any transportation
O = Check with hotel
P = Public transportation
R = Rental car
T = Taxi
U = Courtesy bus
W = Walking distance
[A] [B] [C] [F] [L] [N] [O] [P] [R] [T] [U] [W] 0..1 B
<TaxIndicator/>
Indicates if tax is included in the rate returned. Values are: Y = tax is included, N = tax is not included. [Y] [N] 0..1 N
<SafetyCompliance/>
Safety compliance indicating if hotel meets F.E.M.A fire-compliance regulations, as required by American government officials. Valid values: Y = hotel is compliant
N = hotel is not compliant
[Y] [N] 0..1 Y
<CurrencyCode>
Currency code of the currency, in which all curreny amount values are returned. This will either be a default currency or the alternate currency specified in the request (if any).

1 USD
@NumberOfDecimals
Decimal position in fare amount. 1 2
</CurrencyCode>
<VendorMessage/>
Vendor marketing message. 0..1 THIS IS A QUALITY PERFORMER HOTEL
<AAARating/>
DEPRECATED. DO NOT USE. WILL BE REMOVED FROM SCHEMA JAN 2010.
USE HotelRating INSTEAD.

AAA Rating. Blank if no rating exists. Value from 1 to 5.
0..1 5
<Media>
Holds reference to multi media content such as pictures, videos, etc. for this hotel property.0..N
<Url/>
Hyperlink defining the location of the referenced media (e.g. location of a JPG file).1
<Width>
Width of media content in specified units.1
@Unit
Unit used to specify dimensions of media content.

[px] [mm] 1 mm (millimeter) px (pixel)
</Width>
<Height>
Height of media content in specified units.1
@Unit
Unit used to specify dimensions of media content.

[px] [mm] 1 mm (millimeter) px (pixel)
</Height>
<Type>
Type of media content.
For value 'OTA' the attributes @Type and @Code contain the media type information.
Values other than 'OTA' are deprecated.

Values:
OTA
image
webcam
video
logo
gallery
360 (panorama view)

[OTA] [image] [webcam] [360] [video] [logo] [map] [gallery] 1 OTA
@Type
OTA code type.

CTT .. Content Code
PIC .. Picture Category Code
[CTT] [PIC] 0..1
@Code
OTA code.
0..1 16
@Description
Free text description. If none available the OTA code name is used.
0..1 Streaming video
</Type>
<Preview>
Preview of the referenced media content (e.g. thumbnail of the picture).0..N
<Url/>
Hyperlink defining the location of the referenced media (e.g. location of a JPG file).1
<Width>
Width of media content in specified units.1
@Unit
Unit used to specify dimensions of media content.

[px] [mm] 1 mm (millimeter) px (pixel)
</Width>
<Height>
Height of media content in specified units.1
@Unit
Unit used to specify dimensions of media content.

[px] [mm] 1 mm (millimeter) px (pixel)
</Height>
<Type>
Type of media content.
For value 'OTA' the attributes @Type and @Code contain the media type information.
Values other than 'OTA' are deprecated.

Values:
OTA
image
webcam
video
logo
gallery
360 (panorama view)

[OTA] [image] [webcam] [360] [video] [logo] [map] [gallery] 1 OTA
@Type
OTA code type.

CTT .. Content Code
PIC .. Picture Category Code
[CTT] [PIC] 0..1
@Code
OTA code.
0..1 16
@Description
Free text description. If none available the OTA code name is used.
0..1 Streaming video
</Type>
</Preview>
<Description>
Media content description (e.g. exterior view).0..1
@Type
OTA code type.

PIC .. Content Code
[PIC] 0..1
@Code
OTA code.
0..1 3
@Description
OTA code name.
0..1 Pool view
</Description>
<Caption/>
Title for the media.
0..1 Exterior
</Media>
<HotelRating>
Rating of this hotel. Note that this element will eventually supercede the AAARating element definition. The latter will be deprecated soon.
0..N NTM3 CROWN
@RatingSystem
Identifies the rating system used to rate the hotel.
Values are:
AAA .. AAA in US
AMA .. Amadeus
C24 .. check24
CRC .. CorporateRatesClub
EHB .. eHotelBar
EHS .. eHotelStars
EHT .. eHotel
GUESTS .. Guest rating
HBC .. Booking.com rating
HRS .. Hotel Reservation System 'stars' rating
JVW .. Jonview rating
LSR .. Local Star Rating
MIC .. Michelin
MOB .. Mobil Hotel Star
NTM .. North Star Media 'crown' rating
OHG .. Official Hotel Guide
TPA .. Tripadvisor
UNK .. unknown
[AAA] [AMA] [C24] [CRC] [EHB] [EHS] [EHT] [GUESTS] [HBC] [HRS] [JVW] [LSR] [MIC] [MOB] [NTM] [OHG] [TPA] [UNK] 0..1
@RatingType
The category type, the rating applies to.

AVG ... average
UNK ... unknown
COF ... comfort factor
ATM ... hotel atmosphere
FOR ... friendliness of reception
SOE ... service of hotel employees
HFA ... hotel facilities
RFA ... room facilities
RSI ... room size
SAN ... sanitary equipment
CLE ... cleanliness
BFQ ... breakfast quality
REQ ... restaurant quality
WEL ... wellness
PKG ... package
VAL ... price value
[AVG] [UNK] [COF] [ATM] [FOR] [SOE] [HFA] [RFA] [RSI] [SAN] [CLE] [BFQ] [REQ] [WEL] [PKG] [VAL] 0..1
@RatingPersonType
The person type this rating is based on.

AVG ... average
UNK ... unknown
PRI ... private
BUS ... business
GRP ... group
CON ... conference
YCP ... young couple
ECP ... elder couple
FSC ... family with small children
FOC ... family with older children
[AVG] [UNK] [PRI] [BUS] [GRP] [CON] [YCP] [ECP] [FSC] [FOC] 0..1
</HotelRating>
<Latitude/>
Degree of latitude. Values range from -90 to +90
Positive values refer to latitudes north, negative values to latitudes south of the equator.

[-90] to [90]0..1 -49.9856
<Longitude/>
Degree of longitude. Values range from -180 to +180
Positive values refer to longitudes east, negative values to longitudes west of the zero (Greenwich) meridian.

[-180] to [180]0..1 -123.87611
</Hotel>
<Rooms>
Rooms information group1..N
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
<BookingCode/>
The booking code for this rate which is used at sell time. 1 A1SRA8
<AvailabilityStatus/>
Availbility status indicator. Values are: A = Available
R = on request
C = closed
[A] [R] [C] 1 A
<RateCategory>
Rate category.

Possible values:
ASN = Association
CCO = Customer Contract
CLB = Club
CON = Convention
COR = Corporate
DAY = Day room
EXC = Exclusive
FAM = Family
GOV = Government
MIL = Military
NEG = Negotiated
PKG = Package
PRO = Promotional
RAC = Standard RAC
SPE = Special
SRS = Senior citizen
STP = Stopover
TUR = Tour
TVL = Travel industry
WKD = Weekend

[ASN] [CCO] [CLB] [CON] [COR] [DAY] [EXC] [FAM] [GOV] [MIL] [NEG] [PKG] [PRO] [RAC] [SPE] [SRS] [STP] [TUR] [TVL] [WKD] 0..N GOV If RateCategory PKG package attributes can specify further details on the package. For other RateCategories rebates can apply which are further detailed by rebate attributes.
@RebateAmount
Amount for the rebate, depending on the rebate type.
Examples:
500 for A
7.5 for P
2 for N
0..1
@RebateAmountType
Type of the price.

P - percentage
A - amount
N - number of free nights
[A] [N] [P] 0..1
@RebateType
Name of the rebate.

0..1 corporate
@PackageName
Name of the package.

0..1 Business FLAT II
@PackageType
Type of the package.

0..1 season
@PackageDescription
freetext description of the package.

0..1 Business FLAT II: inclusive of full breakfast buffet, wireless internet, free non-alcoholic drinks from the minibar, upon availability: upgrade and early check-in / late check-out
</RateCategory>
<RoomTypeCode/>
Room type. 1 A1S
<RoomTypeDescription/>
Room type description. 0..1 Deluxe single
<RateCode/>
Display rate code. 1 STD
<RateDescription/>
Rate code description. 0..1 Standard
<Amount>
The amount of the daily rate.
1 5900
</Amount>
<Deposit/>
Deposit requirements.

Deposit is a more restrictive type of guarantee, where a certain amount can be taken from credit card by the vendor.
- Advantage: offers with deposit requirement are cheaper in most cases.
- Disadvantage: In case of a cancellation this deposit amount can not be refunded, but this depends on cancellation policy.

If a deposit is required, you need to specify a PNRCreateRQ/CompletePNRElements/Itinerary/Hotel/SupplementalInformation/PaymentGuarantee with attribute Type='D'.

Values are:
Y = deposit required
N = deposit not required

[Y] [N] 0..1 N
<Guarantee/>
Guarantee requirements.

To guarantee a reservation. Credit cards specified for guarantee are only validated but not used for any payment.

If a guarantee is required, you need to specify a PNRCreateRQ/CompletePNRElements/Itinerary/Hotel/SupplementalInformation/PaymentGuarantee with attribute Type='G'.

Values are:
Y = guarantee required
N = guarantee not required

[Y] [N] 0..1 N
<Hold/>
Hold requirements. Indicated the hold time which is the late check in time not requireing a guarantee. Valid values from 12 to 24. [12] to [24]0..1 18
<RateChange/>
Rate change indicator determines if the rate changes during the length of stay. Values are: Y = Rate changes
N = No change over the period
[Y] [N] 0..1 N
<CommissionIndicator/>
Indicates of rate is commissionable or not. Values are: Y = rate is commissionable
N = rate is not commissionable
[Y] [N] 0..1 Y
<SellRestriction/>
Indicates that the rate has certain restrictions ay sell time. Values are: Y = sell restrictions apply
N = no sell restriction
[Y] [N] 0..1 N
<Meal>
Specifies if rate includes a meal or a breakfast.
Values are:
M = meal
B = breakfast
H = halfboard
F = fullboard
A = all inclusive
U = unknown

[M] [B] [H] [F] [A] [U] 0..1 M
@PriceAmount
Amount for the meal.
0..1 500
@PriceType
Type of the price.

I - inclusive
E - exclusive
U - unknown
[I] [E] 0..1
@VendorCode
Vendor Code0..1
@Description
Freetext description. The returned language is determined based on the following priority on available data:
1. requested language
2. english
3. any available
0..1
</Meal>
<CancelPolicy/>
Specifies if a cancel policy exist. Values are: Y = Policy exist
N = no cancellatioon policy
Note that if value is set to Y then some additional information can be provided in the CancelPolicyInfo section. However, more detailed description is available via HotelInformationRQ/RS.
[Y] [N] 0..1 N
<CancelPolicyInfo>
This section contains information about cancellation "deadlines" - how many day s in advance PRIOR to arrival or what time on the day of arrival a reservation must be cancelled to avoid penalties.
Note that this section is supported by Sabre only at this time.

Note also that HotelInformationRQ/RS can be used to retrieve detailed information about a room rate.
0..1
<CancelBefore>
This option shows how many days PRIOR to arrival date or hours prior to hotel defined check-in time limit on the desired date of arrival the reservation must be cancelled in order to avoid penalties.
1 5
@Unit
1
</CancelBefore>
<CancelByTime/>
This option shows the time of the arrival date (check-in) by which the reservation must be cancelled in order to avoid penalties.
1 16:00
<NoCancel/>
Value set to 'Y' shows that the rate cannot be cancelled. Applies usually to certain rates with deposit requirement where full payment is required in advance and the reservation cannot be cancelled. Usually means that the amounts paid are non-refundable. In such cases it is recommended to see results of HotelInformationRQ/RS.
1 Y
<Text/>
Information text or error text. 0..N Free flow text. Example: Invalid flight number
</CancelPolicyInfo>
<RateAccess>
Rate access code. This is a special code corresponding to a negotiated rate. 0..N IBM
@CDNumber
Corporate discount number. 0..1 23124
</RateAccess>
<TotalAmount/>
Total amount for booked rate for the complete booking period (may include taxes, fees, surcharges).
0..1 25000
</Rooms>
<MoreRoomsToken/>
Token used to request more rooms following a hotel availability response. This token number can be sent back to Galileo in a subsequent hotel availability request. 0..1 RTDBSGRT
</HotelAvailabilityRS>

Legend

ColumnDescription
NodeName of message node (element or attribute). Nodes in bold type are mandatory, if their parent element occurs in the message. Point mouse cursor at table cell to view complete XPath.
DescriptionDescription of meaning and usage of the node.
ValuesList of predefined values (each in square brackets) or range of values ("[a] to [z]") allowed for the node, if formally defined in the schema.
OccursMinimum and maximum number of times the node must/may occur, if its parent element occurs in the message. Examples:
0..3 Node is optional and may occur up to 3 times.
1..N Node must occur at least one (mandatory) and may occur any number of times.
2 Node must occur exactly twice.
ExampleExample value for the node.

XML Schema documentation generated with XX/1 server