3.3. EXCURSION PICKUP LOCATIONS LIST

Hub also supports lightweight version of Excursion Descriptive Info message (e.g. Excursion PickUp Locations List), which returns only hotels available as PickUp points for Excursion reservation. This message is based on Excursion Descriptive Info Request, but is designated by LocationsListOnly="true" in GP_ExcursionDescriptiveInfoRQ element:

Excursion PickUp Locations List Request Sample XML

<GP_ExcursionDescriptiveInfoRQ LocationsListOnly="true" PrimaryLangID="en" EchoToken="EchoToken" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22"/>
         <BookingChannel Type="7" PriceDomain="1"/>
      </Source>
   </POS>
   <ExcursionDescriptiveInfos>
      <ExcursionDescriptiveInfo BookingCode="12b4"/>
   </ExcursionDescriptiveInfos>
</GP_ExcursionDescriptiveInfoRQ>

HUB takes the hotel list from database, no communication with supplier occurs. If supplier accepts only limited number of hotels for the Excursion PickUp, and these hotels are known for GP HUB, then GP HUB returns only these hotels. If supplier accepts any hotel, then GP HUB returns full list of hotels operated by the supplier in the city. All elements in Excursion PickUp Locations List Response are the same as in normal Excursion Descriptive Info Response. MultimediaDescriptions and VendorMessages are skipped:

Excursion PickUp Locations List Response Sample XML

<GP_ExcursionDescriptiveInfoRS Version="2" EchoToken="EchoToken" xmlns="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <ExcursionDescriptiveContents>
      <ExcursionDescriptiveContent ExcursionCode="1002" ExcursionName="London Cruise" ExcursionCityCode="LON" ExcursionCodeContext="supplierCode" ExcursionDuration="3.5">
         <Categories>
            <Category Code="SIGHT">
               <Text Language="en">Tours Sightseeing</Text>
            </Category>
         </Categories>
         <Departures>
            <Departure RPH="1">
               <DeparturePoint Type="PickUp" HotelCodeSupported="true" AddressSupported="false">Hotel Pick Up</DeparturePoint>
               <Hotels>
                  <Hotel HotelName="ABCONE" HotelCodeContext="supplierCode" HotelCode="LON.ABC" HotelCityCode="LON">
                     <Position Longitude="-0.1859" Latitude="51.494"/>
                     <Address>
                        <AddressLine>10 Ashburn Gardens London SW7 4DG United Kingdom</AddressLine>
                        <CityName>London</CityName>
                        <PostalCode>08950</PostalCode>
                        <CountryName>United Kingdom</CountryName>
                     </Address>
                  </Hotel>
                  <Hotel HotelName="ADMIRAL" HotelCodeContext="supplierCode" HotelCode="LON.ADM" HotelCityCode="LON">
                     <Position Longitude="-0.172" Latitude="51.5152"/>
                     <Address>
                        <AddressLine>143 Sussex Gardens Hyde Park London W2 2RY United Kingdom</AddressLine>
                        <CityName>London</CityName>
                        <PostalCode>08950</PostalCode>
                        <CountryName>United Kingdom</CountryName>
                     </Address>
                  </Hotel>
               </Hotels>
            </Departure>
         </Departures>
      </ExcursionDescriptiveContent>
   </ExcursionDescriptiveContents>
</GP_ExcursionDescriptiveInfoRS>

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

In case of Excursion Pick Up locations list is not supported by supplier, GP HUB returns an error:

<GP_ExcursionDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2.0">
    <Errors>
        <Error Code="172" Language="en" RecordID="supplierCode" ShortText="Requested action not possible" Status="NOT_SENT" Tag="NORMAL" Type="3">Supplier does not support operation LocationsList.</Error>
    </Errors>
</GP_ExcursionDescriptiveInfoRS>