HotelDetailsRsp (HotelReqRsp.xsd)

Name Type Enumeration Values R/O Default Description
HotelDetailsRsp element Response showing details of a given hotel property
CommandHistory string simple type Optional HTTP link to download command history and debugging information of the request that generated this response. Must be enabled on the system.
ResponseTime decimal simple type Optional The time (in ms) the system spent processing this request, not including transmission times.
TraceId string simple type Optional Unique identifier for this atomic transaction traced by the user. Use is optional.
TransactionId string simple type Optional System generated unique identifier for this atomic transaction.
ResponseMessage element A simple textual fare note. Used within several other objects.
Code decimal simple type Required
Type string simple type Warning , Error , Info Optional Indicates the type of message (Warning, Error, Info)
ProviderCode string simple type Optional
SupplierCode string simple type Optional
NextResultReference element Container to return/send additional retrieve/request additional search results
ProviderCode string simple type Optional The code of the Provider (e.g 1G,1S)
HostToken element This is a host token. It contains some kind of payload we got from a hostthat must be passed in on successive calls they know who you are as our systemdoes not maintain state. The format of this string isn't important as long as itis not altered in any way between calls. Since a host token is only valid onthe host it is assocated with, there is also an attribute called Host so we knowhow to route the command(s). You can have multiple active sessions betweenone or more hosts
Host string simple type Optional The host associated with this token
Key anySimpleType simple type Optional Unique identifier for this token - use this key when a single HostToken is shared by multiple elements.
ElStat string simple type A , M , C Optional This attribute is used to show the action results of an element. Possible values are "A" (when elements have been added to the UR) and "M" (when existing elements have been modified). Response only.
KeyOverride boolean simple type Optional If a duplicate key is found where we are adding elements in some cases like URAdd, then instead of erroring out set this attribute to true.
RequestedHotelDetails element If a duplicate key is found where we are adding elements in some cases like URAdd, then instead of erroring out set this attribute to true.
HotelProperty element The hotel property
Availability string simple type Available , NotAvailable , AvailableForOtherRates , OnRequest , Unknown Optional
HotelChain string simple type Required
HotelCode string simple type Required
HotelLocation string simple type Optional The location code for this entity. IATA code.
HotelTransportation positiveInteger simple type Optional OTA Transporation code. Transportation available to hotel.
Key string simple type Optional
MoreRates boolean simple type Optional When true, more rates are available for this hotel property.Applicable only for HotelDetails and HotelSuperShopper. Supported Providers: 1G, 1V.
MoreRatesToken string simple type Optional HS3 Token to identify the Rates for a property. Supported Providers 1G,1V.
Name string simple type Optional
NetTransCommissionInd string simple type A , B , C , P , X Optional This attribute indicates whether hotel property is tracking through net trans commission indicator.
NumOfRatePlans nonNegativeInteger simple type Optional The specific number of RatePlanTypes for each property responded on the message, integer 1 - 999. Supported provider: HotelSuperShopper message only.
ParticipationLevel string simple type Optional 2=Best Available Rate 1G, 1V, 4=Lowest Possible Rate 1G, 1V, 1P
PreferredOption boolean simple type Optional This attribute is used to indicate if the vendors responsible for the fare or rate being returned have been determined to be ‘preferred’ based on the associated policy settings.
ReserveRequirement string simple type Deposit , Guarantee , Prepayment , Other Optional
VendorLocationKey string simple type Optional The VendorLocationKey for this HotelProperty.
PropertyAddress typeUnstructuredAddress complex type The VendorLocationKey for this HotelProperty.
Address anonymous simple type The VendorLocationKey for this HotelProperty.
PhoneNumber element Consists of type (office, home, fax), location (city code), the country code, the number, and an extension.
AreaCode string simple type Optional
CountryCode string simple type Optional Hosts/providers will expect this to be international dialing digits
Extension string simple type Optional
Key string simple type Optional
Location string simple type Optional IATA code for airport or city
Number string simple type Required The local phone number
Text string simple type Optional
Type string simple type Agency , Business , Mobile , Home , Fax , Hotel , Other , None , Email , Reservations Optional
ElStat string simple type A , M , C Optional This attribute is used to show the action results of an element. Possible values are "A" (when elements have been added to the UR) and "M" (when existing elements have been modified). Response only.
KeyOverride boolean simple type Optional If a duplicate key is found where we are adding elements in some cases like URAdd, then instead of erroring out set this attribute to true.
ProviderReservationInfoRef element Container for Provider reservation reference key.
Key string simple type Required
CoordinateLocation element Specific lat/long location, usually associated with a Distance
latitude double simple type Required
longitude double simple type Required
Distance element Container to encapsulate the a distance value with its unit of measure.
Direction string simple type Optional Directions: S, N, E, W, SE, NW, ...
Units string simple type MI , KM Optional MI
Value decimal simple type Required
HotelRating element Hotel rating information
RatingProvider string simple type Required Rating providers, ie AAA, NTM
Rating typeSimpleHotelRating simple type Hotel rating value
RatingRange element Hotel rating value
MaximumRating integer simple type Optional
MinimumRating integer simple type Optional
Amenities element Amenity information
Amenity element Amenity information
AmenityType string simple type Optional Amenity type code. “HA” (Hotel Property Amenity) or “RA” (Room Amenity). Defaults to “HA” if no value is sent.
Code positiveInteger simple type Required
MarketingMessage element Marketing information provided by the supplier
Text string simple type Marketing information provided by the supplier
HotelDetailItem element Textual information about the hotel
Name string simple type Required
Text string simple type
HotelRateDetail element Returns hotel rate details during the stay if rates are available for requested property.
ApproximateBase string simple type Optional Hotel base rate expressed in another currency
ApproximateRateGuaranteed boolean simple type Optional If true, approximate rate is guaranteed by vendor. Supported Providers: 1G,1V
ApproximateSurcharge string simple type Optional Surcharge associated with the room expressed in another currency.
ApproximateTax string simple type Optional Taxes expressed in another currency
ApproximateTotal string simple type Optional Hotel total rate expressed in another currency.
BookableQuantity nonNegativeInteger simple type Optional The number of rooms which can be booked on the rate returned in HotelRateDetails. When the aggregator responds ‘IsPackage’= true (pricing for all rooms together), the BookableQuantity value will be ‘1’.
ExtraFeesIncluded string simple type true , false , unknown Optional When true, total amounts includes additional fees or charges." Enumerated values are true, false, and unknown
InPolicy boolean simple type Optional This attribute will be used to indicate if a fare or rate has been determined to be ‘in policy’ based on the associated policy settings.
Key string simple type Optional
RateCategory positiveInteger simple type Optional An enumerated type that allows the query to specify a rate category type, and provides major categories for comparison across brands. Refer to OpenTravel Code List Rate Plan Type (RPT). Encode/decode data in Util ReferenceDataRetrieveReq TypeCode=“HotelRateCategory".
RateChangeIndicator string simple type true , false , unknown Optional Determines if the rate changes during the length of stay. Enumerated values are true, false, and unknown.
RateGuaranteed boolean simple type Optional
RateOfferId string simple type Optional Offer Identifier. Maybe required for hotels provided by aggregators.
RatePlanType string simple type Required
RateSupplier string simple type Optional Indicates the source of the rate.
Base string simple type Optional This attribute is used to describe the Hotel Supplier Base Rate
Surcharge string simple type Optional This attribute used to describe Surcharge associated with the room
Tax string simple type Optional This attribute used to describe Tax associated with the room
Total string simple type Optional This attribute used to describe Hotel Supplier Total Rate
PolicyCodesList typePolicyCodesList complex type A list of codes that indicate why an item was determined to be ‘out of policy’.
PolicyCode anonymous simple type A code that indicates why an item was determined to be ‘out of policy’.
MinPolicyCode anonymous simple type A code that indicates why the minimum fare or rate was determined to be ‘out of policy’.
MaxPolicyCode anonymous simple type A code that indicates why the maximum fare or rate was determined to be ‘out of policy’.
RoomRateDescription typeHotelRateDescription complex type A code that indicates why the maximum fare or rate was determined to be ‘out of policy’.
Name string simple type Optional Optional context name of the text block being returned i.e. Room details
Text anonymous simple type Optional context name of the text block being returned i.e. Room details
HotelRateByDate element The daily rate details
ApproximateBase string simple type Optional Hotel base rate expressed in another currency
ApproximateTotal string simple type Optional Hotel total rate expressed in another currency. Supported Providers: 1P
Contents string simple type Optional Contents will be representing all unformatted data returned by HOST, those are not uAPI supported. Support provider 1P.
EffectiveDate string simple type Optional
ExpireDate string simple type Optional
Base string simple type Optional This attribute is used to describe the Hotel Supplier Base Rate
Surcharge string simple type Optional This attribute used to describe Surcharge associated with the room
Tax string simple type Optional This attribute used to describe Tax associated with the room
Total string simple type Optional This attribute used to describe Hotel Supplier Total Rate
CorporateDiscountID element These are zero or more negotiated rate codes
NegotiatedRateCode boolean simple type Optional When set to true, the data in the CorporateDiscountID is a negotiated rate code. Otherwise, this data is a Corporate Discount ID rate.
AcceptedPayment element When set to true, the data in the CorporateDiscountID is a negotiated rate code. Otherwise, this data is a Corporate Discount ID rate.
PaymentCode string simple type Optional The issuer of the form of payment, such as the credit card bank.
Commission element The issuer of the form of payment, such as the credit card bank.
ApproxCommissionAmount string simple type Optional The approximate commission amount in the agency’s provisioned or requested currency.
ApproxCommissionOnSurcharges string simple type Optional The approximate commission on surcharges in the agency’s provisioned or requested currency.
CommissionAmount string simple type Optional The commission amount in the aggregator’s or supplier’s currency.
CommissionOnSurcharges string simple type Optional Commission on surcharges in the aggregator’s or supplier’s currency.
Indicator string simple type true , false , unknown Optional Indicates if the Rate Plan is commissionable.True: Rate is commissionable.False: Rate is not commissionable.Unknown: Commission indicator is not returned by the hotel supplier (chain or property).
Percent string simple type Optional The percentage applied to the commissionable amount to determine the payable commission amount.
RateMatchIndicator element "Match" Indicators for certain request parameters, e.g. Child Count, Extra Adults etc.
Status string simple type Available , NotAvailable , SubstituteOffered , MaximumExceeded Required
Type string simple type RateCategory , RoomCount , AdultCount , ChildCount , AdultRollaway , ChildRollaway , Crib Required
Value string simple type Optional
TaxDetails element
Tax element
Code positiveInteger simple type Required Code identifying fee (e.g. agency fee, bed tax etc.). Refer to OPEN Travel Code List for Fee Tax Type. Possible values are OTA Code against FTT.
CollectionFreq string simple type Optional Indicates how often the tax is collected. Values can be Once or Daily
EffectiveDate date simple type Optional
ExpirationDate date simple type Optional
Term string simple type Optional Indicates how the tax is applied. Values can be PerPerson, PerNight and PerStay
Amount typeMoney simple type Indicates how the tax is applied. Values can be PerPerson, PerNight and PerStay
Percentage float simple type Indicates how the tax is applied. Values can be PerPerson, PerNight and PerStay
CancelInfo element Returns cancellation information for certain hotel returned in response. This information is available through GDS transactions
CancelDeadline dateTime simple type Optional Last date/time the reservation can be canceled without penalty.
CancelPenaltyAmount string simple type Optional This will contain the cancellation penalty amount.
CancelPenaltyPercent float simple type Optional This will contain the cancellation penalty expressed as a percentage.
CancelPenaltyPercentAppliesTo string simple type Optional This will contain the cost qualifier that explains what the percentage is applied to in order to calculate the cancel penalty.
FeeInclusive boolean simple type Optional Indicates whether or not the Penalty amount includes fees.
Method string simple type Optional Cancellation method, either "API", "URL", "INFO", or "NONE".
NonRefundableStayIndicator string simple type true , false , unknown Optional True if Deposit or Payment is non-refundable
NumberOfNights integer simple type Optional This will contain the number of nights that will be assessed as the cancelation penalty.
Supported boolean simple type Optional If true, the booking can be canceled. If false, the booking cannot be canceled.
TaxInclusive boolean simple type Optional Indicates whether or not the Penalty amount includes taxes.
URL string simple type Optional The URL provided by the supplier to cancel the booking, if @Method="URL". For all other values of @Method, @URL is not returned.
OffsetDropTime string simple type Optional An enumerated type indicating when the deadline drop time goes into effect. Enumerated values are “AfterBooking” and “BeforeArrival”.
OffsetTimeUnit string simple type Optional The units of time, e.g: days, hours, etc that apply to the deadline. Enumerated values are “Year”, “Month”, “Day”, and “Hour”.
OffsetUnitMultiplier integer simple type Optional The number of units of DeadlineTimeUnit.
CancellationPolicy string simple type Return cancellation policy text by the aggregator.
Text string simple type The informational text provided by the supplier to cancel the booking, if @Method="INFO". For all other values of @Method, Text is not returned.
GuaranteeInfo element The informational text provided by the supplier to cancel the booking, if @Method="INFO". For all other values of @Method, Text is not returned.
AbsoluteDeadline dateTime simple type Optional Latest date/time when deposit/payment/guarantee is required.
CredentialsRequired boolean simple type Optional Identification required at booking/checkin. Not supported by 1P.
GuaranteeType string simple type Deposit , Guarantee , Prepayment Optional Deposit, Guarantee, or Prepayment required to hold/book the room. Applicable only for HotelSupershopper, Hotel Details and Hotel rules.
HoldTime string simple type Optional Expiration time for room reservation held without deposit/guarantee.
OffsetDropTime string simple type Optional An enumerated type indicating when the deadline drop time goes into effect. Enumerated values are “AfterBooking” and “BeforeArrival”.
OffsetTimeUnit string simple type Optional The units of time, e.g: days, hours, etc that apply to the deadline. Enumerated values are “Year”, “Month”, “Day”, and “Hour”.
OffsetUnitMultiplier integer simple type Optional The number of units of DeadlineTimeUnit.
DepositAmount element Amount required for deposit/prepayment
Amount string simple type Optional Supplier deposit amount required for deposit/prepayment.Supported by all Providers when supported by supplier
ApproximateAmount string simple type Optional Approximate deposit amount required for deposit/prepayment.
DepositNights integer simple type Number of Nights required for deposit/prepayment
DepositPercent integer simple type Percentage of stay required for deposit/prepayment
GuaranteePaymentType element Accepted payment types. Applicable only for HotelSupershopper, Hotel Details and Hotel rules.
Description string simple type Optional
Type string simple type Required Accepted payment types: CreditCard, AgencyIATA/ARC, FrequentGuest, SpecialIndustry, CDNumber, HomeAddress, CompanyAddress, Override, Other, or None
SupplementalRateInfo string simple type Supplemental rate information provided by the aggregator.
RoomCapacity element The maximum number of guests for a room or for each room in a package.
IsPackage boolean simple type Optional If true, the rooms are offered as a package by the aggregator.
Capacity positiveInteger simple type The maximum number of guests per room.
ExtraCharges element Additional charges applied to the hotel rate.
AdultRollawayCharge string simple type Optional Additional charge for an extra rollaway bed provided for an adult guest.
ChildRollawayCharge string simple type Optional Additional charge for an extra rollaway bed provided for a child guest.
CribAmount string simple type Optional Additional charge for a crib.
ExtraAdultAmount string simple type Optional Additional charge for an extra guest.
ExtraChildAmount string simple type Optional dditional charge for an extra child guest.
Inclusions element Additional items included in the hotel rate plan.
SmokingRoomIndicator string simple type true , false , unknown Optional Indicates if the room is designated as nonsmoking or smoking. true = Smoking false = NonSmoking unknown = Information is not returned by the hotel supplier (chain or property).
BedTypes element Bed types in the rate plan.
Code positiveInteger simple type Optional Bed Type Code. Uses Open Travel Code List Room Amenity Type (RMA). Encode/decode data in Util ReferenceDataRetrieveReq TypeCode=“HotelAmenities”.
Quantity integer simple type Optional Bed Quantity.
MealPlans element Meal options available for the rate plan.
Breakfast string simple type true , false , unknown Optional Indicates whether a daily breakfast is included in the meal plan. true = Breakfast is included false = Breakfast is not included unknown = Information is not returned by the hotel supplier (chain or property).
Dinner string simple type true , false , unknown Optional Indicates whether a daily dinner is included in the meal plan. true = Dinner is included false = Dinner is not included unknown = Information is not returned by the hotel supplier (chain or property).
Lunch string simple type true , false , unknown Optional Indicates whether a daily lunch is included in the meal plan. true = Lunch is included false = Lunch is not included unknown = Information is not returned by the hotel supplier (chain or property).
MealPlan element Meal plan.
Code positiveInteger simple type Optional Meal plan code. Uses Open Travel Code List Meal Plan Type (MPT). Encode/decode data in Util ReferenceDataRetrieveReq TypeCode=“HotelMealPlans”.
RoomView element Meal plan code. Uses Open Travel Code List Meal Plan Type (MPT). Encode/decode data in Util ReferenceDataRetrieveReq TypeCode=“HotelMealPlans”.
Code positiveInteger simple type Optional OTA code represents different hotel room views.
MediaItem element Photos and other media urls for the property referenced above.
caption string simple type Optional
height integer simple type Optional
icon anyURI simple type Optional
sizeCode string simple type Optional
type string simple type Optional
url anyURI simple type Optional
width integer simple type Optional
HotelType element
SourceLink boolean simple type Optional Indicates whether results are returned from the vendor or from the database. If true, vendor results were returned. Supported providers:1G, 1V
HotelAlternateProperties element Alternate Properties returned by some Vendors if the requested property is not available
HotelProperty element The hotel property
Availability string simple type Available , NotAvailable , AvailableForOtherRates , OnRequest , Unknown Optional
HotelChain string simple type Required
HotelCode string simple type Required
HotelLocation string simple type Optional The location code for this entity. IATA code.
HotelTransportation positiveInteger simple type Optional OTA Transporation code. Transportation available to hotel.
Key string simple type Optional
MoreRates boolean simple type Optional When true, more rates are available for this hotel property.Applicable only for HotelDetails and HotelSuperShopper. Supported Providers: 1G, 1V.
MoreRatesToken string simple type Optional HS3 Token to identify the Rates for a property. Supported Providers 1G,1V.
Name string simple type Optional
NetTransCommissionInd string simple type A , B , C , P , X Optional This attribute indicates whether hotel property is tracking through net trans commission indicator.
NumOfRatePlans nonNegativeInteger simple type Optional The specific number of RatePlanTypes for each property responded on the message, integer 1 - 999. Supported provider: HotelSuperShopper message only.
ParticipationLevel string simple type Optional 2=Best Available Rate 1G, 1V, 4=Lowest Possible Rate 1G, 1V, 1P
PreferredOption boolean simple type Optional This attribute is used to indicate if the vendors responsible for the fare or rate being returned have been determined to be ‘preferred’ based on the associated policy settings.
ReserveRequirement string simple type Deposit , Guarantee , Prepayment , Other Optional
VendorLocationKey string simple type Optional The VendorLocationKey for this HotelProperty.
PropertyAddress typeUnstructuredAddress complex type The VendorLocationKey for this HotelProperty.
Address anonymous simple type The VendorLocationKey for this HotelProperty.
PhoneNumber element Consists of type (office, home, fax), location (city code), the country code, the number, and an extension.
AreaCode string simple type Optional
CountryCode string simple type Optional Hosts/providers will expect this to be international dialing digits
Extension string simple type Optional
Key string simple type Optional
Location string simple type Optional IATA code for airport or city
Number string simple type Required The local phone number
Text string simple type Optional
Type string simple type Agency , Business , Mobile , Home , Fax , Hotel , Other , None , Email , Reservations Optional
ElStat string simple type A , M , C Optional This attribute is used to show the action results of an element. Possible values are "A" (when elements have been added to the UR) and "M" (when existing elements have been modified). Response only.
KeyOverride boolean simple type Optional If a duplicate key is found where we are adding elements in some cases like URAdd, then instead of erroring out set this attribute to true.
ProviderReservationInfoRef element Container for Provider reservation reference key.
Key string simple type Required
CoordinateLocation element Specific lat/long location, usually associated with a Distance
latitude double simple type Required
longitude double simple type Required
Distance element Container to encapsulate the a distance value with its unit of measure.
Direction string simple type Optional Directions: S, N, E, W, SE, NW, ...
Units string simple type MI , KM Optional MI
Value decimal simple type Required
HotelRating element Hotel rating information
RatingProvider string simple type Required Rating providers, ie AAA, NTM
Rating typeSimpleHotelRating simple type Hotel rating value
RatingRange element Hotel rating value
MaximumRating integer simple type Optional
MinimumRating integer simple type Optional
Amenities element Amenity information
Amenity element Amenity information
AmenityType string simple type Optional Amenity type code. “HA” (Hotel Property Amenity) or “RA” (Room Amenity). Defaults to “HA” if no value is sent.
Code positiveInteger simple type Required
MarketingMessage element Marketing information provided by the supplier
Text string simple type Marketing information provided by the supplier
GuestReviews element Comments and Reviews from hotel guests
Comments element Comments and Reviews from hotel guests
CommentId string simple type Optional Unique comment identifier. For internal Travelport use only.
CommentSourceName string simple type Optional Name of the source for the comment.
Commenter string simple type Optional Name of the comment's poster.
CommenterLanguage string simple type Optional Language of the commenter.
Date date simple type Optional date that the comment was entered.
Source string simple type Optional Source code of the comment entry. Example: 'NB' for Nightsbridge, ‘RG’, ‘AG’ for Agrialla,‘TO’.