Content Comparison

Hotel Descriptive Info Response returns you descriptive information about the hotel including a hotel's address, hotel’s text description, images, contact information, amenities, etc. provided by supplier.

OTA_HotelDescriptiveInfoRS*:

*mandatory

Element	Description	Min…Max occurs
Success	For more information see Common Data Description section in Glossary.
Warnings/Warning
HotelDescriptiveContents/ HotelDescriptiveContent	Contains information about Hotel.	0...*

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent:

Element

Attribute

Type

Description

Min…Max occurs

AreaID

string

Hotel Country Code.

0...1

HotelCityCode*

string

Contain information about hotel and include supplier-specific codes, and code of supplier (HotelCodeContext) from whom this offer was obtained.

1...1

HotelCode*

string

1...1

HotelCodeContext*

string

1...1

HotelName*

string

1...1

ChainCode

string

Contain information about hotel chain and brand.

0...1

BrandCode

string

0...1

ChainName

string

0...1

BrandName

string

0...1

HotelDistrictCode

string

Define the district, to which the hotel belongs.

0...1

HotelDistrictName

string

0...1

HotelInfo

Descriptive details about the hotel.

0...1

FacilityInfo/GuestRooms

Contains information about services in all rooms.

0...1

MaxOccupancy

integer

Contains max number of people for room.

0...1

Count

integer

Number of rooms.

0...1

FacilityInfo/ GuestRooms/ GuestRoom

Contains information about services, number of people and rooms quantity.

0...*

Policies/Policy

Specifies an array of policy information applies for a hotel.

Info
Note: This functionality supported for limited suppliers. Please check with GP Travel HUB development if you are interested in specific supplier.

0…*

AffiliationInfo/ Awards/ Award

Describes the hotel rating.

1...2

Rating*

string

Number of stars.

1...1

Provider*

string

Describes the provider of hotel rating. Can be “Hotel“ or “Supplier“.

1...2

ContactInfos/ ContactInfo

Includes hotel contact details.

0...*

Reviews/Review

Contains information about hotel reviews.

0...*

CodeContext*

string (1 - 32)

Provider of review (for example, TrustYou).

1...1

ReviewsCount

integer

Number of reviews.

0...1

ReviewRating

string (1 - 64)

Rating of the hotel, which is tendered by provider of reviews.

0...1

URL

URI

Url that could be used to redirect to the site with the full ratings.

0...1

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo:

Element	Attribute	Type	Description	Min…Max occurs
	WhenBuilt	string	The year of build.	0...1
	BuildingArea	string	The square of building.	0...1
	TerritoryArea	string	The square of common building territory.	0...1
	Floors	integer (1 - 999)	Number of hotel floors.	0...1
RelativePositions/ RelativePosition			Contains information about where the hotel is located.	0...*
CategoryCodes/ HotelCategory			Defines the particular type of hotel (e.g., golf, ski, bed and breakfast).	0...*
	GroupCode	string ("Type", "Location", "Architecture", "Budget", "Target", "Category", "Other")	Identifies a described object in HotelCategory.	0...1
	Code	string (1 - 64)	Refers to OTA Code List ‘Property Class Type’ (PCT).	0...1
	CodeDetail	string (1 - 64)	Contains the category description as provided by supplier.	0...1
Descriptions/ MultimediaDescriptions/ MultimediaDescription			Contains detailed multimedia descriptions of hotel.	0...*
Position			Specifies hotel geographical coordinates.	0...1
	Latitude	string (1 - 32)	Specifies the north–south position of a point on the Earth's surface.	0...1
	Longitude	string (1 - 32)	Specifies the east–west position of a point on the Earth's surface.	0...1
Services/Service			Contains information about services that are available in the hotel.	0...*

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/RelativePositions/RelativePosition:

Element	Attribute	Type	Description	Min…Max occurs
	Name*	string	Possible values described in Relative positions.	1...1
	Text	string	Describes relative position more precisely, but in some cases can be the same value as Name.	0...1
	Nearest*	boolean	Contains "true" in case the position is nearest to the property.	1...1
	UnitOfMeasureCode	string	Unit of measure in a code format. Refer to OTA Code List Unit of Measure Code (UOM).	0...1
	Distance	string	Contains distance from hotel to the airport, attractions, etc.	0...1
Transportations/ Transportation			Contains description of distance to the nearest important places.	0...*
Transportations/ Transportation/ DescriptiveText			Short description.	0...1

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/Descriptions/MultimediaDescriptions/MultimediaDescription:

Element	Attribute	Type	Description	Min…Max occurs
ImageItems/ ImageItem			A link to hotel images.	0...*
ImageItems/ ImageItem	Category	integer	Refers to OTA List "Picture Category Code (PIC)".	0...1
ImageItems/ ImageItem/ ImageFormat/ URL*		URI	Image URL.	1...1
ImageItems/ ImageItem/ Description*			Short description of the image.	1...1
ImageItems/ ImageItem/ Description*	Caption*	string	Short description of the image.	1...1
TextItems/TextItem			A description of the hotel location, interior, exterior, facilities, rooms, etc.	0...*
	Category	integer (1 - 23)	Refers to GP Travel HUB list "Text Category Code".	0...1
	Title	string (1 - 255)	The title of the multimedia object.	0...1
TextItems/ TextItem/ Description*		string	Hotel description text.	1...1

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/Services/Service:

Element

Attribute

Type

Description

Min…Max occurs

Code

integer (1 - 1266)

The standard OTA service code. If the ServiceType is "Hotel", then the Code refers to OTA List "Hotel Amenity Code (HAC)". If the ServiceType is "Room", then the Code refers to OTA List "Room Amenity Code (RMA)".

Info
Note: If supplier does not provide OTA Code, then GP Travel HUB match the service to a standard code. If the Code attribute is missed, then it means GP Travel HUB is unable to match the service to any standard OTA code.

0...1

Included

boolean

Identifies if the service is included in the rate (true"), or it is extra charged ("false"). If supplier does not provide service information then the flag is missed in the response.

0...1

ServiceType

string ("Hotel", "Room")

Identifies what the service is applicable to. This can be "Hotel" (for hotel service) or "Room" (in case the service provided for rooms).

0...1

Quantity

string

Contains numeric information about service. For example: amount of swimming pools; year of most recent renovation; room size (sqm), etc.

0...1

SupplierCode

string

Service code provided by supplier.

0...1

ExistsCode

string (2)

Defines whether a service is offered. If the attribute is not presented, that means service exists. If supplier returns information, that service doesn't exist, GP Travel HUB shows ExistsCode="2".

0...1

MinAge

integer (0 - 999)

Defines minimal age for using service.

0...1

MaxAge

integer (0 - 999)

Defines maximum age for using service.

0...1

Start

yy-mm-dd or yy-mm-dd T hh-MM-ss or hh:MM:ss

Defines service start date and time.

0...1

End

yy-mm-dd or yy-mm-dd T hh-MM-ss or hh:MM:ss

Defines service end date and time.

0...1

Info
Note: Start/End, MinAge/MaxAge attributes do not have to be in pairs all the time. It's possible to show only one of them.

CodeDetail

string(1-64)

Used to combine services into groups. Returned by the supplier.

Info
Note: This functionality supported for limited suppliers. Please check with GP Travel HUB development if you are interested in specific supplier.

0…1

OperationSchedules/ OperationSchedule

Contains information about service if the service is extra charged.

0...*

DescriptiveText

string

Short service description as provided by supplier.

0...5

Language

For more information see Common Data Description section in Glossary.

0...1

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/Descriptions/Services/Service/OperationSchedules/OperationSchedule:

Element	Attribute	Type	Description	Min…Max occurs
Charge			Represents charge details.	0...5
	Amount	decimal	Defines the price of extra charge.	0...1
	CurrencyCode		For more information see Common Data Description section in Glossary.	0...1
	ChargeUnit	string	Defines the unit for which the charge applies (e.g. room, person, seat). Refer to OTA Code List Charge Type (CHG).	0...1
	ChargeFrequency	string	Defines the timeframe used to apply the charge during the course of the reservation (e.g. Daily, Weekly, Stay). Refer to OTA Code List Charge Type (CHG).	0...1
	TaxableIndicator*	boolean	Indicates if the service is extra charged. Possible value is "true".	1...1
Charge/ Description/ Text		string	Charge short description.	0...5

Info
NOTE: Amount, CurrencyCode, ChargeUnit, ChargeFrequency attributes can be shown together only or not shown at all.

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/FacilityInfo/GuestRooms/GuestRoom:

Element

Attribute

Type

Description

Min…Max occurs

Code

string

Contains supplier's room code.

0…1

MaxOccupancy

integer

Contains max number of people for room.

0...1

RoomTypeName

string (1 - 512)

Contains name of room type.

0...1

TypeRoom

Contains information about quantity of different room types.

0...5

StandardOccupancy

integer

Indicates the usual number of guests that occupy this room.

0...1

Count

integer

Number of rooms of this room type.

0...1

Amenities/Amenity

Info
Note: For some suppliers GuestRoom element may content detailed information about amenities. Please check with GP Travel HUB development if you are interested in specific supplier.

0...*

RoomAmenityCode

string

Refers to OTA List "Room Amenity Code (RMA)".

0...1

SupplierCode

string

Amenity code provided by supplier.

0...1

Quantity

integer

Contains numeric information about service. For example: amount of swimming pools; year of most recent renovation; room size (sqm), etc.

0...1

MinAge

integer (1 - 999)

Defines minimum age for using service.

0...1

MaxAge

integer (1 - 999)

Defines maximum age for using service.

0...1

Start

yy-mm-dd or yy-mm-dd T hh-MM-ss or hh:MM:ss

Defines service start date and time.

0...1

End

yy-mm-dd or yy-mm-dd T hh-MM-ss or hh:MM:ss

Defines service end date and time.

0...1

Info
Note: Start/End, MinAge/MaxAge attributes do not have to be in pairs all the time. It's possible to show only one of them.

CodeDetail

string(1-64)

Used to combine services into groups. Returned by the supplier.

Info
Note: This functionality supported for limited suppliers. Please check with GP Travel HUB development if you are interested in specific supplier.

0…1

Amenities/Amenity/ DescriptiveText

string

Short description of the amenity.

0...1

MultimediaDescriptions/ MultimediaDescription/ ImageItems/ ImageItem

Contains detailed descriptions of room.

0...*

DescriptiveText

string

General room description.

0...1

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/Policies/Policy:

Element	Attribute	Type	Description	Min…Max occurs
PolicyInfo			Describes the policies of the hotel.	0…*
	CheckInTime	string (HH:MM:SS)	Usual check-in time for the hotel.	0...1
	CheckOutTime	string (HH:MM:SS)	Usual check-out time for the hotel.	0...1
	KidsStayFree	boolean	If attribute is true there is no charge for children.	0...1
PetsPolicies			Detailed policy information when pets are allowed.	0...*
PetsPolicies	PetsAllowedCode	string ("Pets Allowed", "Pets Not Allowed")	Defines if pets allowed or not.	0...1
PetsPolicies/PetsPolicy			Contains hotel’s pets policy.	0...*
	MaxPetQuantity	integer 0 - 99	Maximum number of Pets allowed in the accommodation provided.	0...1
	MinUnitOfMeasureQuantity	decimal	Minimum pet weight allowed.	0...1

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/ContactInfos/ContactInfo:

Element	Attribute	Type	Description	Min…Max occurs
Addresses/Address			Contains hotel address.	0...*
Addresses/Address/ AddressLine		string (1 - 255)	Mandatory elements if the Address element is requested.	0...5
Addresses/Address/ CityName		string (1 - 64)		0...1
Addresses/Address/ PostalCode		string (1 - 16)		0...1
Addresses/Address/ CountryName		string (0 - 64)		0...1
Phones/ Phone			Contains information about hotel phone number.	0...*
	PhoneNumber*	string (1 - 100)	Passenger's phone number.	1...1
	PhoneTechType	integer (1, 2, 3, 4, 5)	Indicates type of technology associated with this telephone number.	0...1
	PhoneLocationType	integer (1 - 9)	Indicates location type for passenger's phone number.	0...1
Emails/Email		string (1-128)	Contains information about passenger's email. It is enough to submit Email only for the tour lead.	0...*
URLs/URL		URI	URL to hotel site if provided.	0...*

Expand

title	Hotel Descriptive Info Response Sample XML

Code Block

language	xml

<OTA_HotelDescriptiveInfoRS EchoToken="tok1" Version="2.0" xmlns="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <HotelDescriptiveContents>
      <HotelDescriptiveContent HotelCityCode="DAN" HotelCode="DAN114" HotelCodeContext="novasol" HotelName="Reiterhof Pilger - Pansfelde">
         <HotelInfo WhenBuilt="1995" BuildingArea="500" TerritoryArea="45" Floors="2">
            <!--BUILD_YEAR HOUSE_AREA TERRITORY_AREA QUANTITY_FLOORS-->
            <RelativePositions>
               <RelativePosition Distance="3" Name="CityCenter" Nearest="false" Text="City centre" UnitOfMeasureCode="2">
                  <Transportations>
                     <Transportation>
                        <DescriptiveText>City centre. Distance is 3 kilometers</DescriptiveText>
                     </Transportation>
                  </Transportations>
               </RelativePosition>
               <RelativePosition Distance="25" Name="CityLimits" Nearest="false" Text="Airport" UnitOfMeasureCode="2">
                  <Transportations>
                     <Transportation>
                        <DescriptiveText>Airport. Distance is 25 kilometers</DescriptiveText>
                     </Transportation>
                  </Transportations>
               </RelativePosition>
               <RelativePosition Distance="300" Name="CityLimits" Nearest="true" Text="Church of St. Mitrophan of Voronezh" UnitOfMeasureCode="3">
                  <Transportations>
                     <Transportation>
                        <DescriptiveText>Church of St. Mitrophan of Voronezh. Distance is 300 meters</DescriptiveText>
                     </Transportation>
                  </Transportations>
               </RelativePosition>
            </RelativePositions>
            <CategoryCodes>
               <HotelCategory Code="H3" CodeDetail="Holiday house"/>
            </CategoryCodes>
            <Descriptions>
               <Renovation RenovationCompletionDate="2005" AreaText="wood"/>
               <!--MODERNIZED_YEAR material-->
               <MultimediaDescriptions>
                  <MultimediaDescription>
                     <ImageItems>
                        <ImageItem Category="6">
                           <ImageFormat>
                              <URL>http://sdc.novasol.com/pic/dan/dan114_4.gif</URL>
                           </ImageFormat>
                           <Description Caption="Rooms"/>
                        </ImageItem>
                        <ImageItem Category="20">
                           <ImageFormat>
                              <URL>http://sdc.novasol.com/pic/dan/dan114_41.jpg</URL>
                           </ImageFormat>
                           <Description Caption="Miscellaneous"/>
                        </ImageItem>
                        <ImageItem Category="20">
                           <ImageFormat>
                              <URL>http://sdc.novasol.com/pic/dan/dan114_42.jpg</URL>
                           </ImageFormat>
                           <Description Caption="Miscellaneous"/>
                        </ImageItem>
                     </ImageItems>
                  </MultimediaDescription>
                  <MultimediaDescription>
                     <TextItems>
                        <TextItem Title="pleasenote" Category="8">
                           <Description>Renovations in the Holiday house until October</Description>
                        </TextItem>
                        <TextItem Title="checkIn" Category="19">
                           <Description>12:00:00</Description>
                        </TextItem>
                        <TextItem Title="checkOut" Category="19">
                           <Description>14:00:00</Description>
                        </TextItem>
                        <TextItem Title="General" Category="20">
                           <Description>Location This Holiday house is situated close to the Gare St. Lazare station, 1 km from the Opéra Garnier and the Grands Magasins, where guests may enjoy shopping. It is just 200 m from the closest metro station.</Description>
                        </TextItem>
                        <TextItem Title="Location" Category="17">
                           <Description>This Holiday house is situated close to the Gare St. Lazare station, 1 km from the Opéra Garnier and the Grands Magasins, where guests may enjoy shopping. It is just 200 m from the closest metro station.</Description>
                        </TextItem>
                     </TextItems>
                  </MultimediaDescription>
               </MultimediaDescriptions>
            </Descriptions>
            <Services>
               <Service Code="179" Included="false" ServiceType="Hotel" SupplierCode="320-70">
                  <OperationSchedules>
                     <OperationSchedule>
                        <Charge TaxableIndicator="true" Amount="20" CurrencyCode="EUR" ChargeUnit="7" ChargeFrequency="31"/>
                     </OperationSchedule>
                  </OperationSchedules>
                  <DescriptiveText>Car park</DescriptiveText>
               </Service>
               <Service Code="24" ServiceType="Hotel" SupplierCode="250-60" Start="08:00:00" End="10:00:00">
                  <DescriptiveText>Spa centre</DescriptiveText>
               </Service>
               <Service Code="50" ServiceType="Hotel" SupplierCode="220-60" Start="2019-05-01" End="2019-09-30">
                  <DescriptiveText>Air conditioning in Restaurant.</DescriptiveText>
               </Service>
               <Service Code="50" ServiceType="Hotel" SupplierCode="200-60" MinAge="5" MaxAge="12">
                  <DescriptiveText>Entertainment programme for children</DescriptiveText>
               </Service>
               <Service Code="76" ServiceType="Room" SupplierCode="200-71" Quantity="1">
                  <DescriptiveText>Toater</DescriptiveText>
               </Service>
            </Services>
         </HotelInfo>
         <FacilityInfo>
            <GuestRooms>
               <GuestRoom RoomTypeName="STANDARD" MaxOccupancy="2" Code="TPL.ST-2">
                  <Amenities>
                     <Amenity IncludedInRateIndicator="true" RoomAmenityCode="172" SupplierCode="5">
                        <DescriptiveText>taxi service</DescriptiveText>
                     </Amenity>
                     <Amenity IncludedInRateIndicator="true" RoomAmenityCode="24" SupplierCode="6">
                        <DescriptiveText>Conference Hall</DescriptiveText>
                     </Amenity>
                     <Amenity IncludedInRateIndicator="true" RoomAmenityCode="76" SupplierCode="7">
                        <DescriptiveText>Restaurant</DescriptiveText>
                     </Amenity>
                  </Amenities>
                  <MultimediaDescriptions>
                     <MultimediaDescription>
                        <ImageItems>
                           <ImageItem Category="6">
                              <ImageFormat>
                                 <URL>http://photos.hotelbeds.com/giata/bigger/05/059580/059580a_hb_ro_012.jpg</URL>
                              </ImageFormat>
                              <Description Caption="Room"/>
                           </ImageItem>
                           <ImageItem Category="6">
                              <ImageFormat>
                                 <URL>http://photos.hotelbeds.com/giata/bigger/05/059580/059580a_hb_ro_013.jpg</URL>
                              </ImageFormat>
                              <Description Caption="Room"/>
                           </ImageItem>
                        </ImageItems>
                     </MultimediaDescription>
                  </MultimediaDescriptions>
                  <DescriptiveText>TRIPLE STANDARD</DescriptiveText>
               </GuestRoom>
            </GuestRooms>
         </FacilityInfo>
         <Policies>
            <Policy>
               <PolicyInfo CheckInTime="12:00" CheckOutTime="14:00" KidsStayFree="true" UsualStayFreeChildPerAdult="2"/>
               <!--KIDS_FREE-->
               <PetsPolicies PetsAllowedCode="Pets Allowed">
                  <PetsPolicy MaxPetQuantity="2" MinUnitOfMeasureQuantity="3"/>
                  <!--PET_COUNT PET_SIZE_LIMIT-->
               </PetsPolicies>
            </Policy>
         </Policies>
         <AffiliationInfo>
            <Awards>
               <Award Provider="Supplier" Rating="3" RatingSymbol="Star"/>
               <Award Provider="Hotel" Rating="3" RatingSymbol="Star"/>
            </Awards>
         </AffiliationInfo>
         <ContactInfos>
            <ContactInfo>
               <Addresses>
                  <Address>
                     <CityName>The Harz &amp; region</CityName>
                     <CountryName>Germany</CountryName>
                  </Address>
               </Addresses>
            </ContactInfo>
         </ContactInfos>
      </HotelDescriptiveContent>
   </HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS>

...

Version	Old Version 8	New Version Current
Changes made by	Yana Brilevskaya	HUB Team
Saved on	Dec 09, 2020	Sept 14, 2023

Versions Compared

Key

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/RelativePositions/RelativePosition:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/Descriptions/MultimediaDescriptions/MultimediaDescription:

ImageItems/ ImageItem

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/Services/Service:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/HotelInfo/Descriptions/Services/Service/OperationSchedules/OperationSchedule:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/FacilityInfo/GuestRooms/GuestRoom:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/Policies/Policy:

OTA_HotelDescriptiveInfoRS/HotelDescriptiveContents/HotelDescriptiveContent/ContactInfos/ContactInfo: