4.3. EXCURSION AVAILABILITY RESPONSE

Success

For more information see Common Data Description section in Glossary.

0...1

Warnings/Warning

For more information see Common Data Description section in Glossary.

0...99

Excursions

Represents excursions from supplier.

0...1

MoreDataEchoToken

string (1 - 128)

The availability response returns the attribute if there is additional data that could not fit within the availability response. The text value should be echoed in the availability request to indicate where to begin the next block of availability data (only if the AllowPartialAvail=true in request). 

0...1

MoreIndicator

boolean

Indicate that there are additional rates that cannot fit in the availability response (only if the AllowPartialAvail=true in request).

0...1

Excursions/Excursion

Represents one excursion from supplier.

0...*

ExcursionRates/ExcursionRate*

Describes excursion offer.

1...*

Services/Service

Indicates price and currency for the service.

0...99

BasicExcursionInfo*

General information about excursion.

1...1

AvailabilityStatus*

string ("AvailableForSale", "OnRequest")

Contains offer availability status, whether it is immediately available (AvailableForSale) or on request (OnRequest).

1...1

NonRefundable

boolean (default - “false“)

If it is set to "true", then the offer is non-refundable, and supplier notifies about this explicitly. If the attribute is missed - there is no clear meaning whether the offer is refundable or not.

0...1

NumberOfUnits

integer

Indicates how many tickets are left for this rate.

0...1

RateCode*

string

Contains offer code as returned by supplier.

1...1

RateName*

string

Contains offer name as returned by supplier.

1...1

Language*

For more information see Common Data Description section in Glossary.

1...1

ExcursionDuration

double

Represents excursion duration in hours. ExcursionDuration=”3.5” means that the excursion takes 3 hours and 30 minutes. Here also possible to have value greater than “24” in case excursion takes more than one full day. The element is skiped in case supplier does not provide that information.

0...1

BookingCode*

string

A specific identifier generated by GP Hub for further referencing to this offer. The <BookingCode> value should be used as unique offer identifier for further excursion reservation step.

1...1

Rates/Rate*

Specifies price breakdown per passenger type (adults, children, infants).

1...*

AgeQualifyingCode

For more information see Common Data Description section in Glossary.

0...1

RateSource*

string ("Calculated", "Provided")

Identifies whether this rate has been provided by supplier (“Provided”) or calculated by GP Hub (“Calculated”).

1...1

PaxTypeCode

string

Contains information about guest type.

0...1

Rates/Rate/Total*

The total price of the offer per passenger type (after discount, if any has been applied).

1...1

AmountAfterTax*

For more information see Common Data Description section in Glossary.

1...1

CurrencyCode*

1...1

Rates/Rate/TotalRetail

The retail price of the offer per passenger type recommended by supplier (if applicable).

0...1

AmountAfterTax*

For more information see Common Data Description section in Glossary.

1...1

CurrencyCode*

1...1

RateDescription

Rate name and description as returned by supplier. Can be empty.

0...1

Name*

string

Name of the rate.

1...1

RateDescription/Text

string

Description of the rate.

0...1

PaxTypes

Contains details about possible pax types.

0…1

MinCount

int

Minimum allowed number of paxes.

0...1

MaxCount

int

Maximum allowed number of paxes.

0...1

PaxTypes/PaxType

Contains details about possible pax types.

1...*

Code*

string

Pax type Code.

1...1

Name*

string

Pax type Name.

1...1

MinAge

int

Minimum age for the type of pax.

0...1

MaxAge

int

Maximum age for the type of pax.

0...1

MinCount

int

Minimum allowed number of paxes of the type.

0...1

MaxCount

int

Maximum allowed number of paxes of the type.

0...1

Total*

Total offer price for all requested travelers.

1...1

AmountAfterTax*

For more information see Common Data Description section in Glossary.

1...1

CurrencyCode*

1...1

Total/Taxes/Tax

Provides information about taxes applied or defines taxes applied.

0...100

Code

integer

Tax code value, according to Сodes of taxes (FTT).

0...1

Amount

decimal

Amount of tax.

0...1

CurrencyCode

For more information see Common Data Description section in Glossary.

0...1

TaxInclusiveInd

boolean (default - false)

Defines inclusion of a particular tax into the total price.

0...1

CitizenCountryName

Shows if it is enough to provide information about citizenship only for tour lead. Missing attribute means that there is no clear meaning whether the citizenship should be provided or not.

0...1

OnlyLead*

string ("Yes", "No", "Mixed")

Shows if it is enough to provide information only for tour leader (Yes), or it is necessary to provide for all passengers (No), or both options are possible (Mixed). By default it is necessary to provide this information for all passenger (No).

1...1

PersonName

Shows if it is enough to provide name only for tour lead.

0...1

OnlyLead*

string ("Yes", "No", "Mixed")

Identifies the rule, if it's necessary to provide name of each passenger (No), or only tour leader (Yes), or both variants are possible (Mixed).

1...1

Services/Service

Contains the information about services if supplier supports delivery of tickets or other additional services that could be booked in advance for the offer. When Services received in response - it is possible to add them during booking (at Reservation stage).

0...999

ServiceRPH*

string (1 - 32)

Refers to service which is situated in full list. Full list is available in ExcursionRates/Services list, see description above.

1...1

Inclusive

boolean

Price for this service is included or not in the Total.

0...1

RequiredInd

boolean

Indicates whether this service is mandatory or not.

0...1

CancelPenalties/CancelPenalty*

For more information see Excursion Charges Response section. Occurs only when @ShowCharges “true“ on Excursion Availability Request.

0...*

ExcursionDate*

For more information see Common Data Description section in Glossary.

1...1

AvailableTicketQuantities

Contains information about tickets that can be booked in one reservation request.

0…1

AvailableTicketQuantities/AvailableTicketQuantity*

Each element shows how many tickets can be booked in one reservation request.

1…*

0...1

0...1

SpecialServiceType

string ("DeliveryToHotel", "DeliveryToAddress", "SelfPickUp", "E-Delivery", “Supplement”)

Could have the following values:

DeliveryToHotel - requires Guest Full Name, Hotel name, Check-in date, Hotel Address (Incl. zip code).

DeliveryToAddress - requires Guest Full Name, Guest home Address (Incl. zip code, City, Province, Country).

SelfPickUp - requires Mandatory data only (LeadName, Email, Phone, Country).

E-Delivery - requires Mandatory data only (LeadName, Email, Phone, Country).

Supplement - defines extras for excursion (e.g. Lunch, Guide).

0...1

ServiceRPH*

string (1 - 32)

Refers to service which is situated in full list.

1...1

Inclusive

boolean

Price for this service is included or not in the Total.

0...1

RequiredInd

boolean

Indicates whether this service is mandatory or not.

0...1

Price

Indicates price and currency for the service.

0...99

Price/Base

0...1

AmountAfterTax*

For more information see Common Data Description section in Glossary.

1...1

CurrencyCode*

1...1

ServiceDetails

Contains service details.

0...1

ShortName

string

Name of the service provided by supplier.

0...1

ServiceDetails/ServiceDescription/Text

string

Description of the service provided by supplier.

0...1

ExcursionCityCode*

string

Supplier-specific city code of where excursion is located.

1...1

ExcursionCodeContext*

string

Contains supplier code.

1...1

ExcursionCode*

string

Excursion code as returned by supplier.

1...1

ExcursionName*

string

Excursion name as returned by supplier.

1...1

OperatedBy

string

Defines the exact company which operates this excursion. Can be empty in case supplier does not provide that information.

0...1

ExcursionCountryCode

string

Contains supplier-specific country code of where excursion is located.

0...1

Competitors/Competitor

For more information see Common Data Description section in Glossary.

0...*

Tournament

0...1

Categories/Category*

Contains excursion category as returned by supplier and mapped to the predefined list. One or several categories can be returned for one excursion.

1...*

Code*

string

Contains the list of possible Excursion Categories.

1...1

Categories/Category/Text*

string

Contains excursion category full text information provided by supplier.

1...1

Categories/Category/SubCategory

Describes category in more details.

0...*

Text*

string

Contains text description of the category.

1...1

Code

string

Refers to Excursion Subcategories.

0...1

Departures/Departure

Contains information about possible departure points. There also could be cases when Departures element is absent in response. It means that for the Excursion no departure point applicable (for example, there will be no departure point for City Pass). In that case you should not specify the <Departure> element in Excursion Reservation phase. Also you can see Departure Use Cases at Use Cases section.

0...*

Venue

Contains information about the venue where excursion operates.

0...1

Code*

string

Venue code as returned by supplier.

1...1

Name*

string

Venue name as returned by supplier.

1...1

Venue/Address

Venue address.

0...1

Venue/Address/AddressLine

string

Venue address line.

0...1

Venue/Address/CityName

string

Name of the city where venue is located.

0...1

Venue/Address/PostalCode

string

Postal Code of the venue.

0...1

Venue/Address/CountryName

string

Name of the country.

0...1

MultimediaDescriptions/MultimediaDescription

Text and visual description of the excursion. In Availability and Search responses only one <TextItem> (for short description) and one <ImageItem> (thumbnail image) elements will be presented.

0...2

VendorMessages/VendorMessage

Important comments about excursion.

0...99

Title

string

Refers to OTA Сode list Information Type “INF”’.

0...1

InfoType*

string

1...1

VendorMessages/VendorMessage/SubSection/Paragraph*

Provides formatted textual information that a vendor wishes to make known. The type of information is indicated.

1...1

Language

0...1

VendorMessages/VendorMessage/SubSection/Paragraph/Text

string

0...1

Reviews/Review

Shows the review data.

0...99

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 hotel, which is tendered by provider of reviews.

1...1

URL

URI

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

0...1

RPH*

int

An unique identifier of departure point.

1...1

DeparturePoint*

string

Describes the departure point.

1...2

Type*

string ("MeetingPoint", "PickUp", "Image")

Possible values are:

MeetingPoint – means that excursion starts from particular point(s) that is specified in DeparturePoint element.

PickUp – means that passengers can be picked up at a hotel or any address.

Image – contains image that shows additional information about event. For example, venue seat maps.

1...1

HotelCodeSupported

boolean

Identifies if Hotel Code must be further submitted as a pick up point for excursion reservation. When the HotelCodeSupported="true" then normally there should be the Hotels element with the list of hotels serviced as pick up points. If the Hotels element not provided, it means any hotel provided by this supplier can be specified for pick up. HotelCodeSupported attribute will be shown only with Type=”PickUp”.

0...1

AddressSupported

boolean

Identifies if free Address can be further submitted for excursion reservation. AddressSupported attribute will be shown only with Type=”PickUp”.

0...1

StartTimes/StartTime

hh:mm:ss

Represents possible excursion start time options The only one of these start time options should be specified when booking the excursion. If there is no start time options then look for the only possible excursion start time in excursion description.

0...*

Address

Describes the meeting point. If address not specified then look for the meeting point in excursion description.

0...1

Address/AddressLine

string

Hotel Address/Meeting Point address.

0...1

Address/CityName

string

Name of the city.

0...1

Address/PostalCode

string (1- 16)

Postal Code of the Hotel/Meeting Point.

0...1

Address/CountryName

string

Name of the country.

0...1

Position

Contains venue coordinate.

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

ImageItems/ImageItem

A collection of image items.

0...*

ImageItems/ImageItem/ImageFormat/URL*

URI

Image URL.

1...1

ImageItems/ImageItem/Description

Short description of the image.

0...1

Caption

string (1 - 128)

0...1

TextItems/TextItem

A collection of text items.

0...*

Title

string (1 - 256)

The title of the multimedia object.

0...1

Category*

string

Refers to GP Travel HUB list "Text Category List".

1...1

TextItems/TextItem/Description*

Excursion description text.

1...1

Language*

For more information see Common Data Description section in Glossary.

0...1