Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: HUB-10508 New Departure type Location PickUp was added to PickUp Use Cases
Table of Contents

...

11.1. BOOKING WITH SERVICES

...

Services that can be booked are contained in <Services> elements on Excursion Availability response.
There is <Services> element in <ExcursionRate> for the specific offer with the unique identifier of the service ServiceRPH:

...

Expand
titleExcursion Reservation Confirmation Response
Code Block
languagexml
<GP_ExcursionResRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2">
  <Success/>
  <ExcursionReservations>
    <ExcursionReservation ResStatus="Reserved">
      <Excursions>
        <Excursion>
          <ExcursionRates>
            <ExcursionRate BookingCode="1340471075" Language="Unescorted" NumberOfUnits="1" RPH="1" RateCode="338000" RateName="Category 3">
              <Rates>
                <Rate AgeQualifyingCode="10" RateSource="Calculated">
                  <Total AmountAfterTax="300.00" CurrencyCode="EUR"/>
                </Rate>
              </Rates>
              <Total AmountAfterTax="300.00" CurrencyCode="EUR"/>
              <Services>
                <Service Inclusive="true" RequiredInd="true" ServiceRPH="2"/>
              </Services>
              <CancelPenalties>
                <CancelPenalty End="2021-03-23T18:00:00+00:00" Start="2020-08-25T12:30:42+01:00">
                  <AmountPercent Amount="300.00" CurrencyCode="EUR"/>
                  <PenaltyDescription>
                    <Text>Please note, service cancellation is not available from the supplier.</Text>
                  </PenaltyDescription>
                </CancelPenalty>
              </CancelPenalties>
            </ExcursionRate>
          </ExcursionRates>
          <ExcursionDate End="2021-03-23" Start="2021-03-23"/>
          <Services>
            <Service ServiceRPH="2" SpecialServiceType="E-Delivery">
              <Price>
                <Base AmountAfterTax="5.00" CurrencyCode="EUR"/>
              </Price>
              <ServiceDetails ShortName="E-Ticket">
                <ServiceDescription>
                  <Text>E-Tickets: Print your eTickets and take them with you to the venue.</Text>
                </ServiceDescription>
              </ServiceDetails>
            </Service>
          </Services>
          <Departure RPH="1">
            <DeparturePoint Type="MeetingPoint">Paris La Defense Arena</DeparturePoint>
            <StartTime>18:00:00</StartTime>
          </Departure>
          <Total AmountAfterTax="300.00" CurrencyCode="EUR"/>
          <BasicExcursionInfo ExcursionCityCode="1070" ExcursionCode="289603" ExcursionCodeContext="supplierCode" ExcursionCountryCode="1004" ExcursionName="Celine Dion-Paris, France">
            <Competitors>
              <Competitor Code="3580" Name="Celine Dion"/>
            </Competitors>
            <Tournament Code="179" Name="Concerts (Entertainment)"/>
            <Categories>
              <Category Code="SHOW">
                <Text Language="en">Concerts</Text>
                <SubCategory Text=" theatre"/>
              </Category>
            </Categories>
          </BasicExcursionInfo>
        </Excursion>
      </Excursions>
      <ResGuests>
        <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
          <Profiles>
            <ProfileInfo>
              <UniqueID ID="1" Type="1"/>
              <Profile>
                <Customer BirthDate="1980-06-12">
                  <PersonName>
                    <NamePrefix>MR</NamePrefix>
                    <GivenName>Dan</GivenName>
                    <Surname>Milloy</Surname>
                  </PersonName>
                  <Telephone PhoneNumber="375-5555555"/>
                  <Email>test@gpsolutions.com</Email>
                  <CitizenCountryName Code="UA"/>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <ResGlobalInfo>
        <DepositPayments>
          <GuaranteePayment Type="AcceptedPaymentForms">
            <AcceptedPayments>
              <AcceptedPayment CostCenterID="supplierCode"/>
            </AcceptedPayments>
          </GuaranteePayment>
        </DepositPayments>
        <ExcursionReservationIDs>
          <ExcursionReservationID ResID_Source="agent" ResID_Value="1329a10973"/>
          <ExcursionReservationID ResID_Source="client" ResID_Value="1329a10973"/>
          <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="203002"/>
        </ExcursionReservationIDs>
      </ResGlobalInfo>
    </ExcursionReservation>
  </ExcursionReservations>
</GP_ExcursionResRS>

...

11.2. ADDITIONAL QUESTIONS

...

AdditionalQuestions element contains remarks in the form of questions which are important to the supplier.

...

Possible AnswerValues for different TypeDescription you can see at Remarks Type in Glossary.

...

11.3. BOOKING WITH DEPARTURE ELEMENT

...

If Departure elements were returned in Availability response, then you must specify the departure point in booking requests. Information about possible Departure points should be taken from Excursion Availability response. Departure point is identified by RPH attribute that corresponds to Departure/@RPH value from Availability response.

...

11.3.1. MEETING POINT

MeetingPoint that can be booked are contained in <Departures> elements on Excursion Availability response:

...

Expand
titleExcursion Reservation Confirmation response with MeetingPoint Sample XML
Code Block
languagexml
<GP_ExcursionResRS EchoToken="EchoToken" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <ExcursionReservations>
      <ExcursionReservation ResStatus="Waitlisted">
         <Excursions>
            <Excursion>
               <ExcursionRates>
                  <ExcursionRate BookingCode="134ae3dc75" NumberOfUnits="2" RPH="1" Language="Unescorted" RateCode="365431" RateName="Block A1 - Hospitality Seats">
                     <Rates>
                        <Rate RateSource="Calculated" AgeQualifyingCode="10">
                           <Total AmountAfterTax="661.00" CurrencyCode="EUR"/>
                        </Rate>
                        <Rate RateSource="Calculated" AgeQualifyingCode="10">
                           <Total AmountAfterTax="661.00" CurrencyCode="EUR"/>
                        </Rate>
                     </Rates>
                     <Total AmountAfterTax="1322.00" CurrencyCode="EUR"/>
                     <Services>
                        <Service Inclusive="true" RequiredInd="true" ServiceRPH="1"/>
                     </Services>
                     <CancelPenalties>
                        <CancelPenalty End="2020-10-16T20:00:00+00:00" Start="2020-09-17T11:28:03+01:00">
                           <AmountPercent Amount="1322.00" CurrencyCode="EUR"/>
                           <PenaltyDescription>
                              <Text>Please note, service cancellation is not available from the supplier.</Text>
                           </PenaltyDescription>
                        </CancelPenalty>
                     </CancelPenalties>
                  </ExcursionRate>
               </ExcursionRates>
               <ExcursionDate End="2020-10-16" Start="2020-10-16"/>
               <Services>
                  <Service ServiceRPH="1" SpecialServiceType="SelfPickUp">
                     <Price>
                        <Base AmountAfterTax="12.00" CurrencyCode="EUR"/>
                     </Price>
                     <ServiceDetails ShortName="Hotel Delivery (might change to E-Ticket / Collection point)">
                        <ServiceDescription>
                           <Text>Usually, the tickets will arrive on the night prior to the event at the address you have provided. However there may be a change in the delivery method to E-delivery / Self pick up - we will update the end customer by email if needed.</Text>
                        </ServiceDescription>
                     </ServiceDetails>
                  </Service>
               </Services>
               <Departure RPH="1">
                  <DeparturePoint Type="MeetingPoint">The O2</DeparturePoint>
                  <StartTime>20:00:00</StartTime>
               </Departure>
               <Total AmountAfterTax="1322.00" CurrencyCode="EUR"/>
               <BasicExcursionInfo ExcursionCityCode="1006" ExcursionCode="290169" ExcursionCodeContext="supplierCode" ExcursionCountryCode="1003" ExcursionName="Andrea Bocelli-London, England">
                  <Competitors>
                     <Competitor Code="5537" Name="Andrea Bocelli"/>
                  </Competitors>
                  <Tournament Code="179" Name="Concerts (Entertainment)"/>
                  <Categories>
                     <Category Code="SHOW">
                        <Text Language="en">Concerts</Text>
                        <SubCategory Text=" theatre"/>
                     </Category>
                  </Categories>
                  <VendorMessages>
                     <VendorMessage InfoType="5">
                        <SubSection>
                           <Paragraph>
                              <Text Language="en">Date and time are subject to change</Text>
                           </Paragraph>
                        </SubSection>
                     </VendorMessage>
                  </VendorMessages>
               </BasicExcursionInfo>
            </Excursion>
         </Excursions>
         <ResGuests>
            <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
               <Profiles>
                  <ProfileInfo>
                     <UniqueID Type="1" ID="1"/>
                     <Profile>
                        <Customer BirthDate="1980-06-12">
                           <PersonName>
                              <NamePrefix>Mr</NamePrefix>
                              <GivenName>John</GivenName>
                              <Surname>Black</Surname>
                           </PersonName>
                           <Telephone PhoneNumber="342342343"/>
                           <Email>test@gpsolutions.com</Email>
                           <CitizenCountryName Code="UA"/>
                        </Customer>
                     </Profile>
                  </ProfileInfo>
               </Profiles>
            </ResGuest>
            <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
               <Profiles>
                  <ProfileInfo>
                     <UniqueID Type="1" ID="2"/>
                     <Profile>
                        <Customer BirthDate="1942-06-12">
                           <PersonName>
                              <NamePrefix>Mr</NamePrefix>
                              <GivenName>Inna</GivenName>
                              <Surname>Black</Surname>
                           </PersonName>
                           <Telephone PhoneNumber="342342343"/>
                           <Email>test@gpsolutions.com</Email>
                        </Customer>
                     </Profile>
                  </ProfileInfo>
               </Profiles>
            </ResGuest>
         </ResGuests>
         <ResGlobalInfo>
            <DepositPayments>
               <GuaranteePayment Type="AcceptedPaymentForms">
                  <AcceptedPayments>
                     <AcceptedPayment CostCenterID="sportevent"/>
                  </AcceptedPayments>
               </GuaranteePayment>
            </DepositPayments>
            <ExcursionReservationIDs>
               <ExcursionReservationID ResID_Source="agent" ResID_Value="f56fdgds"/>
               <ExcursionReservationID ResID_Source="client" ResID_Value="f56fdgds"/>
               <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="203576"/>
            </ExcursionReservationIDs>
         </ResGlobalInfo>
      </ExcursionReservation>
   </ExcursionReservations>
</GP_ExcursionResRS>

...

11.3.2. PICKUP

PickUp point that can be booked are contained in <Departures> elements on Excursion Availability response:

...

Expand
Code Block
languagexml
<Departure RPH="2">
   <DeparturePoint Type="PickUp" HotelCodeSupported="true" AddressSupported="false">Hotel Pick Up</DeparturePoint>
   <Hotels>
      <Hotel HotelName="Citadines Barbican Apartments" HotelCode="LON.ADA" HotelCodeContext="gta"/>
      <Hotel HotelName="Hilton London" HotelCode="LON.HIL" HotelCodeContext="gta"/>
   </Hotels>
   <StartTimes>
      <StartTime>16:00:00</StartTime>
   </StartTimes>
</Departure>
  • If there was a list of locations with their addresses specified as pick-up points in Availability response, then one of the location must be specified in the reservation request.

Expand
Code Block
languagexml
<Departure RPH="3">
    <DeparturePoint Type="PickUp">G! Boutique Hotel</DeparturePoint>
    <Address>
        <AddressLine>71 Festing Road, Southsea</AddressLine>
        <CityName>Portsmouth</CityName>
        <PostalCode>PO4 0NQ</PostalCode>
        <CountryName>United Kingdom</CountryName>
    </Address>
    <Position Latitude="50.782917" Longitude="-1.070141"/>
</Departure>

In order to book a PickUp point, it have to be specified on Reservation Initiate Request and Reservation Confirmation request in <Departure> element:

...

Code Block
languagexml
<Departure RPH="2">
   <Hotel HotelCodeContext="supplierCode" HotelCode="LON.ADA" HotelCityCode="LON"/>
</Departure>
  • PickUp location:

Code Block
languagexml
<Departure RPH="3"/>

Flow with PickUpAddress:

Expand
titleExcursion Availablity response with PickUpAddress Sample XML
Code Block
languagexml
<GP_ExcursionAvailRS EchoToken="EchoToken" Version="2.0" xmlns="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <Excursions>
      <Excursion>
         <ExcursionRates>
            <ExcursionRate AvailabilityStatus="OnRequest" BookingCode="3ecc0" Language="Undefined" NonRefundable="true" RateCode="Default" RateName="Standard">
               <Rates>
                  <Rate AgeQualifyingCode="10" RateSource="Calculated">
                     <Total AmountAfterTax="2000.00" CurrencyCode="ZAR"/>
                  </Rate>
                  <Rate AgeQualifyingCode="8" RateSource="Calculated">
                     <Total AmountAfterTax="2000.00" CurrencyCode="ZAR"/>
                  </Rate>
               </Rates>
               <RateDescription Name="Standard">
                  <Text Language="en">Standard</Text>
               </RateDescription>
               <Total AmountAfterTax="4000.00" CurrencyCode="ZAR"/>
               <PersonName OnlyLead="No"/>
               <ExcursionDate End="2021-04-06" Start="2021-04-06"/>
            </ExcursionRate>
         </ExcursionRates>
         <BasicExcursionInfo ExcursionCityCode="CPT" ExcursionCode="CPTDTEAT0012PLA21" ExcursionCodeContext="supplierCode" ExcursionName="Flavours of Cape Town Private Tour" OperatedBy="Eat Like A Local">
            <Categories>
               <Category Code="OTHR">
                  <Text Language="en">Private</Text>
               </Category>
            </Categories>
            <Departures>
               <Departure RPH="1">
                  <DeparturePoint AddressSupported="true" HotelCodeSupported="false" Type="PickUp">Address Pick Up</DeparturePoint>
               </Departure>
            </Departures>
            <MultimediaDescriptions>
               <MultimediaDescription>
                  <TextItems>
                     <TextItem Category="GEN" Title="General">
                        <Description Language="en">Meeting point: The 2 Eves, Corner Kloof &amp;, Buitensingel Street (located across the road from a McDonald’s)
Days : Tuesday to Friday
Starting time : 10:00
Duration : Approximately 4.5 hours

Notes:
•    Walking is not strenuous but it is recommended that guests have a moderate level of fitness
•    Wear comfortable shoes, sunblock and we suggest having a light breakfast only

Private Tour is a walking food tour in  central  Cape Town which are curated to the guests’ specifications and programme. Due  to  the partner restaurants’   operating times, tours can start any time from 09:00, but no later than 15:00. Expect to visit at least 8 food and drink establishments and learn more about local culture, history and food trends.</Description>
                     </TextItem>
                     <TextItem Category="EXC" Title="Exclude">
                        <Description Language="en">​Transfers</Description>
                     </TextItem>
                     <TextItem Category="INC" Title="Includes">
                        <Description Language="en">​Eight food and drink tastings around central Cape Town</Description>
                     </TextItem>
                  </TextItems>
               </MultimediaDescription>
            </MultimediaDescriptions>
         </BasicExcursionInfo>
      </Excursion>
   </Excursions>
</GP_ExcursionAvailRS>

...

Expand
titleExcursion Reservation Confirmation response with Hotel PickUp Sample XML
Code Block
languagexml
<GP_ExcursionResRS EchoToken="EchoToken" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <ExcursionReservations>
      <ExcursionReservation ResStatus="Waitlisted">
         <Excursions>
            <Excursion>
               <ExcursionRates>
                  <ExcursionRate AvailabilityStatus="OnRequest" BookingCode="3ecrc0" Language="Undefined" NonRefundable="true" RateCode="Default" RateName="Standard">
                     <Rates>
                        <Rate AgeQualifyingCode="10" RateSource="Calculated">
                           <Total AmountAfterTax="2000.00" CurrencyCode="ZAR"/>
                        </Rate>
                        <Rate AgeQualifyingCode="8" RateSource="Calculated">
                           <Total AmountAfterTax="2000.00" CurrencyCode="ZAR"/>
                        </Rate>
                     </Rates>
                     <RateDescription Name="Standard">
                        <Text Language="en">Standard</Text>
                     </RateDescription>
                     <Total AmountAfterTax="4000.00" CurrencyCode="ZAR"/>
                     <PersonName OnlyLead="No"/>
                     <ExcursionDate End="2021-04-06" Start="2021-04-06"/>
                  </ExcursionRate>
               </ExcursionRates>
               <ExcursionDate Start="2021-05-20"/>
               <Departure RPH="1">
		  <StartTime>16:00:00</StartTime>
                  <Hotel HotelCodeContext="supplierCode" HotelCode="LON.ADA" HotelCityCode="LON"/>
               </Departure>
               <Total AmountAfterTax="4000.00" CurrencyCode="ZAR"/>
               <BasicExcursionInfo ExcursionCityCode="CPT" ExcursionCode="CPTDTEAT0012PLA21" ExcursionCodeContext="supplierCode" ExcursionName="Flavours of Cape Town Private Tour" OperatedBy="Eat Like A Local">
                  <Categories>
                     <Category Code="OTHR">
                        <Text Language="en">Private</Text>
                     </Category>
                  </Categories>
               </BasicExcursionInfo>
            </Excursion>
         </Excursions>
         <ResGuests>
            <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
               <Profiles>
                  <ProfileInfo>
                     <UniqueID ID="1" Type="1"/>
                     <Profile>
                        <Customer BirthDate="1980-06-12">
                           <PersonName>
                              <NamePrefix>Mr</NamePrefix>
                              <GivenName>John</GivenName>
                              <Surname>Black</Surname>
                           </PersonName>
                           <Telephone PhoneNumber="342342343"/>
                           <Email>test@gpsolutions.com</Email>
                           <CitizenCountryName Code="UA"/>
                        </Customer>
                     </Profile>
                  </ProfileInfo>
               </Profiles>
            </ResGuest>
            <ResGuest AgeQualifyingCode="8" ResGuestRPH="1">
               <Profiles>
                  <ProfileInfo>
                     <UniqueID ID="2" Type="1"/>
                     <Profile>
                        <Customer BirthDate="2015-06-12">
                           <PersonName>
                              <NamePrefix>Mr</NamePrefix>
                              <GivenName>Inna</GivenName>
                              <Surname>Black</Surname>
                           </PersonName>
                           <Telephone PhoneNumber="342342343"/>
                           <Email>test@gpsolutions.com</Email>
                        </Customer>
                     </Profile>
                  </ProfileInfo>
               </Profiles>
            </ResGuest>
         </ResGuests>
         <ResGlobalInfo>
            <DepositPayments>
               <GuaranteePayment Type="AcceptedPaymentForms">
                  <AcceptedPayments>
                     <AcceptedPayment CostCenterID="supplierCode"/>
                  </AcceptedPayments>
               </GuaranteePayment>
            </DepositPayments>
            <ExcursionReservationIDs>
               <ExcursionReservationID ResID_Source="agent" ResID_Value="agentnf"/>
               <ExcursionReservationID ResID_Source="client" ResID_Value="nfexc01"/>
               <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="203576"/>
            </ExcursionReservationIDs>
         </ResGlobalInfo>
      </ExcursionReservation>
   </ExcursionReservations>
</GP_ExcursionResRS>

9.4. SEE PRICE FOR CANCELLATION ON RETRIEVE

On Retrieve after Cancellation you can see the total price of the booking and the total price of the cancellation.

ExcursionRates/ExcursionRate/Rates/Rate/Total/@AmountAfterTax - is the total price of the booking (even if the reservation has already been cancelled for free). This Amount has the same value that we show on Reservation.

Excursion/Total/@AmountAfterTax - is the actual total price for the booking. This Amount is the price of the cancellation.

Expand
titleReservation Confirmation Response
Code Block

Flow with PickUp location:

Expand
titleExcursion Availablity Response with Location PickUp Sample XML
Code Block
languagexml
<GP_ExcursionResRSExcursionAvailRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2.0">
    <Success/>
  <ExcursionReservations>  <Excursions>
  <ExcursionReservation ResStatus="Waitlisted">     <Excursion>
 <Excursions>         <Excursion>  <ExcursionRates>
        <ExcursionRates>             <ExcursionRate<ExcursionRate AvailabilityStatus="AvailableForSale" BookingCode="49d4c93ea78" Language="Undefined" RPHNonRefundable="1false" RateCode="14005TG1" RateName="Direct"FLY>
 'N DINE TO BOWEN ISLAND">               <Rates>
                        <Rate AgeQualifyingCodePaxTypeCode="10TRAVELER" RateSource="CalculatedProvided">
                            <Total AmountAfterTax="244175.0073" CurrencyCode="CADUSD"/>
                        </Rate>
                  </Rates>      <Rate PaxTypeCode="TRAVELER" RateSource="Provided">
      <RateDescription Name="FLY 'N DINE TO BOWEN ISLAND">                 <Text Language<Total AmountAfterTax="175.74" CurrencyCode="en">FLY 'N DINE TO BOWEN ISLAND - HARBOUR AIR</Text>USD"/>
                        </RateDescription>Rate>
                    </Rates>
   <AdditionalQuestions>                 <AdditionalQuestion<RateDescription IDName="40-257Direct" IsMandatory="true" IsPerPerson="false" QuestionText="Departure Time" RegExpValue="(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]" TypeDescription="RegExpText" TypeID="5">>
                        <Text>Car / Sedan: Up to 3 passengers, Maximum <AnswerValues>2 Large cases + 2 Small cabin bags OR space for 3 Medium (18" Width) cases + 2 Small cabin  <Value>12:00</Value>bags.&lt;br/&gt;Pickup included</Text>
                    </AnswerValues>RateDescription>
                    <PaxTypes MaxCount="4" MinCount="1">
      </AdditionalQuestion>                 <AdditionalQuestion ID="40-509" IsMandatory <PaxType Code="trueTRAVELER" IsPerPersonMaxAge="false120" QuestionTextMaxCount="Dietary Restrictions4" RegExpValueMinAge="^.{1,60}$0" TypeDescriptionMinCount="RegExpText0" TypeIDName="5TRAVELER"/>
                    </PaxTypes>
  <AnswerValues>                  <Total AmountAfterTax="377.83"  <Value>lala</Value>CurrencyCode="USD">
                   </AnswerValues>     <Taxes>
           </AdditionalQuestion>                 <AdditionalQuestion<Tax IDAmount="40-25226.36" IsMandatoryCode="true17" IsPerPersonCurrencyCode="falseUSD" QuestionTextTaxInclusiveInd="true"Drop/>
off  Location" RegExpValue="^.{1,100}$" TypeDescription="RegExpText" TypeID="5">                   <AnswerValues></Taxes>
                    <Value>Airport<</Value>Total>
                  </AnswerValues>    <CitizenCountryName OnlyLead="Mixed"/>
            </AdditionalQuestion>        <PersonName OnlyLead="No"/>
     </AdditionalQuestions>               <Total<ExcursionDate AmountAfterTaxStart="244.00" CurrencyCode="CAD2023-11-29"/>
              <CancelPenalties>  </ExcursionRate>
            </ExcursionRates>
 <CancelPenalty End="2021-07-14T23:59:59-07:00" Start="2021-07-12T00:00:00-07:00">         <BasicExcursionInfo ExcursionCityCode="22563" ExcursionCode="173497P32" ExcursionCodeContext="supplierCode" ExcursionName="Southampton to London Private Transfer"  <AmountPercent Amount="244.00" CurrencyCode="CAD"/>OperatedBy="T &amp; T Southampton">
                <Categories>
   <PenaltyDescription Language="en">                <Category Code="OTHR">
   <Text>Standard Cancellation Policy ( 100 % of Total )</Text>             <Text Language="en">Transportation Services</Text>
   </PenaltyDescription>                 </CancelPenalty>Category>
                   <CancelPenalty End="2021-07-15T23:59:59-07:00" Start="2021-07-15T00:00:00-07:00 <Category Code="OTHR">
                  <AmountPercent Amount="244.00" CurrencyCode="CAD"/>      <Text Language="en">Port       Transfers </Text>
     </CancelPenalty>               </CancelPenalties>Category>
            </ExcursionRate>        <Category Code="OTHR">
 </ExcursionRates>           <ExcursionDate Start="2021-07-15"/>           <Total<Text AmountAfterTaxLanguage="244.00" CurrencyCode="CAD"/>en">Private Drivers </Text>
          <BasicExcursionInfo ExcursionCityCode="YVR" ExcursionCode="14005" ExcursionCodeContext="supplierCode" ExcursionName="FLY 'N DINE TO BOWEN ISLAND" OperatedBy="Harbour Air / West Coast Air / Whistler Air (A/C # 149062)"> </Category>
                </Categories>
    <Categories>            <Departures>
  <Category Code="OTHR">                 <Text<Departure LanguageRPH="en1">Day>
Tours</Text>               </Category>         <DeparturePoint Type="PickUp">Albert Cottage - </Categories>Hotel - Restaurant - Bar</DeparturePoint>
      </BasicExcursionInfo>         </Excursion>       </Excursions>  <Address>
    <ResGuests>         <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">           <Profiles>  <AddressLine>York Avenue, </AddressLine>
        <ProfileInfo>               <UniqueID ID="1" Type="1"/>   <CityName>Cowes</CityName>
           <Profile>                 <Customer BirthDate="2000-06-12"><PostalCode>PO32 6BD</PostalCode>
                  <PersonName>          <CountryName>United Kingdom</CountryName>
         <NamePrefix>Mr</NamePrefix>               </Address>
     <GivenName>Ivan</GivenName>                     <Surname>Ivanov</Surname><Position Latitude="50.753468" Longitude="-1.277507"/>
                    </PersonName>Departure>
                </Departures>
      <Telephone PhoneNumber="+2324234234"/>         <MultimediaDescriptions>
         <Email>test@gpsolutions.com</Email>           <MultimediaDescription>
       <CitizenCountryName Code="KW"/>                <ImageItems>
</Customer>               </Profile>             </ProfileInfo><ImageItem>
          </Profiles>         </ResGuest>       </ResGuests>      <ImageFormat>
<ResGlobalInfo>         <Comments>           <Comment>             <Text>Please, arrange vegetarian meal.</Text> <URL>https://hare-media-cdn.tripadvisor.com/media/attractions-splice-spp-720x480/07/b3/68/ae.jpg</URL>
                       </Comment>         </Comments>ImageFormat>
            <DepositPayments>           <GuaranteePayment Type="AcceptedPaymentForms">    </ImageItem>
        <AcceptedPayments>               <AcceptedPayment CostCenterID="supplierCode"/></ImageItems>
                    </AcceptedPayments>MultimediaDescription>
                  </GuaranteePayment>  <MultimediaDescription>
      </DepositPayments>         <ExcursionReservationIDs>         <TextItems>
 <ExcursionReservationID ResID_Source="client" ResID_Value="tfdghdsff11"/>           <ExcursionReservationID ResID_Source="agent" ResID_Value="tfdghdsff11"/>           <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="XXX4888"/> <TextItem Category="GEN" Title="General">
         </ExcursionReservationIDs>       </ResGlobalInfo>     </ExcursionReservation>   </ExcursionReservations>
</GP_ExcursionResRS>
Expand
titleExcursion Cancellation Response
Code Block
languagexml
<OTA_CancelRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Status="Cancelled" Version="2.0">
  <Success/>
  <UniqueID ID="tfdghdsff11" ID_Context="client" Type="10"/>
  <UniqueID ID="tfdghdsff11" ID_Context="agent" Type="10"/>
  <UniqueID ID="XXX4888" ID_Context="supplier" Type="10"/>
  <CancelInfoRS>
    <CancelRules>
      <CancelRule Amount="0.00" CurrencyCode="CAD"/>
    </CancelRules>
  </CancelInfoRS>
</OTA_CancelRS>
Expand
titleExcursion Booking Retrieval Quote Response
Code Block
languagexml
<GP_ExcursionResRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2.0">
  <Success/>
  <ExcursionReservations>
    <ExcursionReservation ResStatus="Cancelled">
      <Excursions>        <Description Language="en">With 14 years experience we can offer the best in service, with a relaxed and reliable service and great knowledge of the roads and airports. Our main vehicle is a Mercedes E350 but larger vehicles may be available on request. We always supply air conditioned vehicles with bottled water for your comfort and generally supply WiFi where available. We hope to see you soon.</Description>
                            </TextItem>
            <Excursion>           <ExcursionRates> </TextItems>
           <ExcursionRate BookingCode="49d4c9" Language="Undefined" RPH="1" RateCode="14005" RateName="FLY 'N DINE TO BOWEN ISLAND"></MultimediaDescription>
               <Rates> </MultimediaDescriptions>
               <Rate AgeQualifyingCode="10" RateSource="Calculated"><VendorMessages>
                   <Total AmountAfterTax="244.00" CurrencyCode <VendorMessage InfoType="CAD4"/>>
                        <SubSection>
        </Rate>               </Rates>     <Paragraph>
         <RateDescription Name="FLY 'N DINE TO BOWEN ISLAND">                 <Text Language="en">FLY 'N DINE TO BOWEN ISLAND - HARBOUR AIR</Text>
              </RateDescription>>No redemption point - this is a direct entry ticket;Passengers will have to purchase entry tickets to Stonehenge or Salisbury Cathedral if this option has been selected</Text>
                 <AdditionalQuestions>           </Paragraph>
     <AdditionalQuestion ID="40-257" IsMandatory="true" IsPerPerson="false" QuestionText="Departure Time" RegExpValue="(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]" TypeDescription="RegExpText" TypeID="5">
               </SubSection>
                <AnswerValues>    </VendorMessage>
                <Value>12:00</Value></VendorMessages>
            </BasicExcursionInfo>
        </AnswerValues>Excursion>
    </Excursions>
</GP_ExcursionAvailRS>
Expand
titleExcursion Reservation Initiate Request with Location PickUp Sample XML
Code Block
languagexml
<GP_ExcursionResRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" PrimaryLangID="en" ResStatus="Initiate" Version="2.0">
    <POS>
    </AdditionalQuestion>    <Source>
            <AdditionalQuestion<RequestorID ID="40-509client" IsMandatoryMessagePassword="truepwd" IsPerPersonType="false" QuestionText="Dietary Restrictions" RegExpValue="^.{1,60}$" TypeDescription="RegExpText" TypeID="5">22"/>
            <BookingChannel Type="7"/>
        </Source>
    </POS>
    <ExcursionReservations>
  <AnswerValues>      <ExcursionReservation>
            <Excursions>
         <Value>lala</Value>       <Excursion>
           </AnswerValues>         <ExcursionRates>
       </AdditionalQuestion>                 <AdditionalQuestion<ExcursionRate IDBookingCode="40-2523e878" IsMandatoryRPH="true" IsPerPerson="false" QuestionText="Drop off Location" RegExpValue="^.{1,100}$" TypeDescription="RegExpText" TypeID="5">1"/>
                    </ExcursionRates>
<AnswerValues>                    <Departure <Value>Airport</Value>
 RPH="1"/>
                </AnswerValues>
 Excursion>
              </AdditionalQuestion>Excursions>
            <ResGuests>
 </AdditionalQuestions>               <Total<ResGuest AmountAfterTaxPaxTypeCode="244.00TRAVELER" CurrencyCodeResGuestRPH="CAD1"/>
                <CancelPenalties>    <Profiles>
            <CancelPenalty End="2021-07-14T23:59:59-07:00" Start="2021-07-12T00:00:00-07:00">          <ProfileInfo>
        <AmountPercent Amount="244.00" CurrencyCode="CAD"/>                  <UniqueID <PenaltyDescription LanguageID="1" Type="en1"/>
                        <Text>Standard Cancellation Policy ( 100<Profile>
% of Total )</Text>                   </PenaltyDescription>          <Customer BirthDate="1980-06-12">
     </CancelPenalty>                 <CancelPenalty End="2021-07-15T23:59:59-07:00" Start="2021-07-15T00:00:00-07:00">            <PersonName>
      <AmountPercent Amount="244.00" CurrencyCode="CAD"/>                 </CancelPenalty>               <<NamePrefix>Mr</CancelPenalties>NamePrefix>
             </ExcursionRate>           </ExcursionRates>           <ExcursionDate Start="2021-07-15"/>     <GivenName>John</GivenName>
               <Total AmountAfterTax="0.00" CurrencyCode="CAD"/>           <BasicExcursionInfo ExcursionCityCode="YVR" ExcursionCode="14005" ExcursionCodeContext="supplierCode" ExcursionName="FLY 'N DINE TO BOWEN ISLAND" OperatedBy="Harbour Air <Surname>Black</ West Coast Air / Whistler Air (A/C # 149062)">Surname>
                                    </PersonName>
   <Categories>               <Category Code="OTHR">                 <Text<Telephone LanguagePhoneNumber="en342342343">Day Tours</Text>/>
                </Category>             </Categories>       <Email>test@gpsolutions.com</Email>
   </BasicExcursionInfo>         </Excursion>       </Excursions>       <ResGuests>         <ResGuest AgeQualifyingCode="10" ResGuestRPH<CitizenCountryName Code="1UA"/>
                               <Profiles> </Customer>
           <ProfileInfo>               <UniqueID ID="1" Type="1"/> </Profile>
                        </ProfileInfo>
     <Profile>               </Profiles>
 <Customer BirthDate="2000-06-12">              </ResGuest>
    <PersonName>            <ResGuest PaxTypeCode="TRAVELER" ResGuestRPH="1">
      <NamePrefix>Mr</NamePrefix>              <Profiles>
                        <ProfileInfo>
                            <UniqueID ID="2" Type="1"/>
                            <Profile>
                                <Customer BirthDate="2015-06-12">
                                    <PersonName>
                                        <NamePrefix>Mr</NamePrefix>
                                        <GivenName>Inna</GivenName>
                                        <Surname>Black</Surname>
                                    </PersonName>
                                    <Telephone PhoneNumber="342342343"/>
                                    <Email>test@gpsolutions.com</Email>
                                </Customer>
                            </Profile>
                        </ProfileInfo>
                    </Profiles>
                </ResGuest>
            </ResGuests>
            <ResGlobalInfo>
                <ExcursionReservationIDs>
                    <ExcursionReservationID ResID_Source="client" ResID_Value="456"/>
                </ExcursionReservationIDs>
            </ResGlobalInfo>
        </ExcursionReservation>
    </ExcursionReservations>
</GP_ExcursionResRQ>
Expand
titleExcursion Reservation Confitmation Request with Location PickUp Sample XML
Code Block
languagexml
<GP_ExcursionResRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" PrimaryLangID="en" ResStatus="Book" TransactionIdentifier="0" Version="2.0">
    <POS>
        <Source>
            <RequestorID ID="client" MessagePassword="pwd" Type="22"/>
            <BookingChannel Type="7"/>
        </Source>
    </POS>
    <ExcursionReservations>
        <ExcursionReservation>
            <Excursions>
                <Excursion>
                    <ExcursionRates>
                        <ExcursionRate BookingCode="3e878" RPH="1"/>
                    </ExcursionRates>
                    <Departure RPH="1"/>
                </Excursion>
            </Excursions>
            <ResGuests>
                <ResGuest PaxTypeCode="TRAVELER" ResGuestRPH="1">
                    <Profiles>
                        <ProfileInfo>
                            <UniqueID ID="1" Type="1"/>
                            <Profile>
                                <Customer BirthDate="1980-06-12">
                                    <PersonName>
                                        <NamePrefix>Mr</NamePrefix>
                                        <GivenName>John</GivenName>
                                        <Surname>Black</Surname>
                                    </PersonName>
                                    <Telephone PhoneNumber="342342343"/>
                                    <Email>test@gpsolutions.com</Email>
                                    <CitizenCountryName Code="UA"/>
                                </Customer>
                            </Profile>
                        </ProfileInfo>
                    </Profiles>
                </ResGuest>
                <ResGuest PaxTypeCode="TRAVELER" ResGuestRPH="1">
                    <Profiles>
                        <ProfileInfo>
                            <UniqueID ID="2" Type="1"/>
                            <Profile>
                                <Customer BirthDate="2015-06-12">
                                    <PersonName>
                                        <NamePrefix>Mr</NamePrefix>
                                        <GivenName>Inna</GivenName>
                                        <Surname>Black</Surname>
                                    </PersonName>
                                    <Telephone PhoneNumber="342342343"/>
                                    <Email>test@gpsolutions.com</Email>
                                </Customer>
                            </Profile>
                        </ProfileInfo>
                    </Profiles>
                </ResGuest>
            </ResGuests>
            <ResGlobalInfo>
                <ExcursionReservationIDs>
                    <ExcursionReservationID ResID_Source="client" ResID_Value="456"/>
                </ExcursionReservationIDs>
            </ResGlobalInfo>
        </ExcursionReservation>
    </ExcursionReservations>
</GP_ExcursionResRQ>
Expand
titleExcursion Reservation Confitmation Response with Location PickUp Sample XML
Code Block
languagexml
<GP_ExcursionResRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2.0">
    <Success/>
    <ExcursionReservations>
        <ExcursionReservation ResStatus="Reserved">
            <Excursions>
                <Excursion>
                    <ExcursionRates>
                        <ExcursionRate BookingCode="3e878" FreeCancellationDeadline="2023-11-27T23:59:59Z" Language="Undefined" RPH="1" RateCode="TG4" RateName="Via Salisbury &amp; Stonehenge">
                            <Rates>
                                <Rate PaxTypeCode="TRAVELER" RateSource="Provided">
                                    <Total AmountAfterTax="236.06" CurrencyCode="USD"/>
                                </Rate>
                                <Rate PaxTypeCode="TRAVELER" RateSource="Provided">
                                    <Total AmountAfterTax="236.06" CurrencyCode="USD"/>
                                </Rate>
                            </Rates>
                            <RateDescription Name="Via Salisbury &amp; Stonehenge">
                                <Text>Via Salisbury &amp; Stonehenge: Hours can be added, charged at £40 per hour. Includes 1.5 stop hours at Stonehenge and 1 hour stop at Salisbury Cathedral&lt;br/&gt;Pickup included</Text>
                            </RateDescription>
                            <PaxTypes MaxCount="4" MinCount="1">
                                <PaxType Code="TRAVELER" MaxAge="120" MaxCount="4" MinAge="0" MinCount="0" Name="TRAVELER"/>
                            </PaxTypes>
                            <Total AmountAfterTax="507.53" CurrencyCode="USD">
                                <Taxes>
                                    <Tax Amount="35.41" Code="17" CurrencyCode="USD" TaxInclusiveInd="true"/>
                                </Taxes>
                            </Total>
                            <CancelPenalties>
                                <CancelPenalty End="2023-11-29T23:59:59" Start="2023-11-28T00:00:00Z">
                                    <AmountPercent Amount="507.53" CurrencyCode="USD"/>
                                    <PenaltyDescription>
                                        <Text>For a full refund, cancel at least 24 hours before the scheduled departure time.</Text>
                                    </PenaltyDescription>
                                </CancelPenalty>
                            </CancelPenalties>
                        </ExcursionRate>
                    </ExcursionRates>
                    <ExcursionDate Start="2023-11-29"/>
                    <Departure RPH="1">
                        <DeparturePoint Type="PickUp">Albert Cottage - Hotel - Restaurant - Bar</DeparturePoint>
                    </Departure>
                    <Total AmountAfterTax="507.53" CurrencyCode="USD">
                        <Taxes>
                            <Tax Amount="35.41" Code="17" CurrencyCode="USD" TaxInclusiveInd="true"/>
                        </Taxes>
                    </Total>
                    <BasicExcursionInfo ExcursionCityCode="22563" ExcursionCode="173497P32" ExcursionCodeContext="supplierCode" ExcursionName="Southampton to London Private Transfer" OperatedBy="T &amp; T Southampton">
                        <Categories>
                            <Category Code="OTHR">
                                <Text Language="en">Transportation Services</Text>
                            </Category>
                            <Category Code="OTHR">
                                <Text Language="en">Port Transfers </Text>
                            </Category>
                            <Category Code="OTHR">
                                <Text Language="en">Private Drivers </Text>
                            </Category>
                        </Categories>
                        <VendorMessages>
                            <VendorMessage InfoType="4">
                                <SubSection>
                                    <Paragraph>
                                        <Text Language="en">No redemption point - this is a direct entry ticket;Passengers will have to purchase entry tickets to Stonehenge or Salisbury Cathedral if this option has been selected</Text>
                                    </Paragraph>
                                </SubSection>
                            </VendorMessage>
                        </VendorMessages>
                    </BasicExcursionInfo>
                </Excursion>
            </Excursions>
            <ResGuests>
                <ResGuest PaxTypeCode="TRAVELER" ResGuestRPH="1">
                    <Profiles>
                        <ProfileInfo>
                            <UniqueID ID="1" Type="1"/>
                            <Profile>
                                <Customer BirthDate="1980-06-12">
                                    <PersonName>
                                        <NamePrefix>Mr</NamePrefix>
                                        <GivenName>John</GivenName>
                                        <Surname>Black</Surname>
                                    </PersonName>
                                    <Telephone PhoneNumber="342342343"/>
                                    <Email>test@gpsolutions.com</Email>
                                    <CitizenCountryName Code="UA"/>
                                </Customer>
                            </Profile>
                        </ProfileInfo>
                    </Profiles>
                </ResGuest>
                <ResGuest PaxTypeCode="TRAVELER" ResGuestRPH="1">
                    <Profiles>
                        <ProfileInfo>
                            <UniqueID ID="2" Type="1"/>
                            <Profile>
                                <Customer BirthDate="2015-06-12">
                                    <PersonName>
                                        <NamePrefix>Mr</NamePrefix>
                                        <GivenName>Inna</GivenName>
                                        <Surname>Black</Surname>
                                    </PersonName>
                                    <Telephone PhoneNumber="342342343"/>
                                    <Email>test@gpsolutions.com</Email>
                                </Customer>
                            </Profile>
                        </ProfileInfo>
                    </Profiles>
                </ResGuest>
            </ResGuests>
            <ResGlobalInfo>
                <DepositPayments>
                    <GuaranteePayment Type="AcceptedPaymentForms">
                        <AcceptedPayments>
                            <AcceptedPayment CostCenterID="supplierCode"/>
                        </AcceptedPayments>
                    </GuaranteePayment>
                </DepositPayments>
                <ExcursionReservationIDs>
                    <ExcursionReservationID ResID_Source="client" ResID_Value="456"/>
                    <ExcursionReservationID ResID_Source="agent" ResID_Value="456"/>
                    <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="BR-593513935"/>
                </ExcursionReservationIDs>
            </ResGlobalInfo>
            <TPA_Extensions>
                <VoucherProperties>
                    <Property Name="url" Value="https://shop.live.rc.viator.com/ticket?code=1017696891:b5a12224e4d2d2482fcf68c0619b0c5b05e764593734f960c844c704c9163211:593513935"/>
                </VoucherProperties>
            </TPA_Extensions>
        </ExcursionReservation>
    </ExcursionReservations>
</GP_ExcursionResRS>

11.4. SEE PRICE FOR CANCELLATION ON RETRIEVE

On Retrieve after Cancellation you can see the total price of the booking and the total price of the cancellation.

ExcursionRates/ExcursionRate/Rates/Rate/Total/@AmountAfterTax - is the total price of the booking (even if the reservation has already been cancelled for free). This Amount has the same value that we show on Reservation.

Excursion/Total/@AmountAfterTax - is the actual total price for the booking. This Amount is the price of the cancellation.

Expand
titleReservation Confirmation Response
Code Block
languagexml
<GP_ExcursionResRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2.0">
  <Success/>
  <ExcursionReservations>
    <ExcursionReservation ResStatus="Waitlisted">
      <Excursions>
        <Excursion>
          <ExcursionRates>
            <ExcursionRate BookingCode="49d4c9" Language="Undefined" RPH="1" RateCode="14005" RateName="FLY 'N DINE TO BOWEN ISLAND">
              <Rates>
                <Rate AgeQualifyingCode="10" RateSource="Calculated">
                  <Total AmountAfterTax="244.00" CurrencyCode="CAD"/>
                </Rate>
              </Rates>
              <RateDescription Name="FLY 'N DINE TO BOWEN ISLAND">
                <Text Language="en">FLY 'N DINE TO BOWEN ISLAND - HARBOUR AIR</Text>
              </RateDescription>
              <AdditionalQuestions>
                <AdditionalQuestion ID="40-257" IsMandatory="true" IsPerPerson="false" QuestionText="Departure Time" RegExpValue="(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]" TypeDescription="RegExpText" TypeID="5">
                  <AnswerValues>
                    <Value>12:00</Value>
                  </AnswerValues>
                </AdditionalQuestion>
                <AdditionalQuestion ID="40-509" IsMandatory="true" IsPerPerson="false" QuestionText="Dietary Restrictions" RegExpValue="^.{1,60}$" TypeDescription="RegExpText" TypeID="5">
                  <AnswerValues>
                    <Value>lala</Value>
                  </AnswerValues>
                </AdditionalQuestion>
                <AdditionalQuestion ID="40-252" IsMandatory="true" IsPerPerson="false" QuestionText="Drop off Location" RegExpValue="^.{1,100}$" TypeDescription="RegExpText" TypeID="5">
                  <AnswerValues>
                    <Value>Airport</Value>
                  </AnswerValues>
                </AdditionalQuestion>
              </AdditionalQuestions>
              <Total AmountAfterTax="244.00" CurrencyCode="CAD"/>
              <CancelPenalties>
                <CancelPenalty End="2021-07-14T23:59:59-07:00" Start="2021-07-12T00:00:00-07:00">
                  <AmountPercent Amount="244.00" CurrencyCode="CAD"/>
                  <PenaltyDescription Language="en">
                    <Text>Standard Cancellation Policy ( 100 % of Total )</Text>
                  </PenaltyDescription>
                </CancelPenalty>
                <CancelPenalty End="2021-07-15T23:59:59-07:00" Start="2021-07-15T00:00:00-07:00">
                  <AmountPercent Amount="244.00" CurrencyCode="CAD"/>
                </CancelPenalty>
              </CancelPenalties>
            </ExcursionRate>
          </ExcursionRates>
          <ExcursionDate Start="2021-07-15"/>
          <Total AmountAfterTax="244.00" CurrencyCode="CAD"/>
          <BasicExcursionInfo ExcursionCityCode="YVR" ExcursionCode="14005" ExcursionCodeContext="supplierCode" ExcursionName="FLY 'N DINE TO BOWEN ISLAND" OperatedBy="Harbour Air / West Coast Air / Whistler Air (A/C # 149062)">
            <Categories>
              <Category Code="OTHR">
                <Text Language="en">Day Tours</Text>
              </Category>
            </Categories>
          </BasicExcursionInfo>
        </Excursion>
      </Excursions>
      <ResGuests>
        <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
          <Profiles>
            <ProfileInfo>
              <UniqueID ID="1" Type="1"/>
              <Profile>
                <Customer BirthDate="2000-06-12">
                  <PersonName>
                    <NamePrefix>Mr</NamePrefix>
                    <GivenName>Ivan</GivenName>
                    <Surname>Ivanov</Surname>
                  </PersonName>
                  <Telephone PhoneNumber="+2324234234"/>
                  <Email>test@gpsolutions.com</Email>
                  <CitizenCountryName Code="KW"/>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <ResGlobalInfo>
        <Comments>
          <Comment>
            <Text>Please, arrange vegetarian meal.</Text>
          </Comment>
        </Comments>
        <DepositPayments>
          <GuaranteePayment Type="AcceptedPaymentForms">
            <AcceptedPayments>
              <AcceptedPayment CostCenterID="supplierCode"/>
            </AcceptedPayments>
          </GuaranteePayment>
        </DepositPayments>
        <ExcursionReservationIDs>
          <ExcursionReservationID ResID_Source="client" ResID_Value="tfdghdsff11"/>
          <ExcursionReservationID ResID_Source="agent" ResID_Value="tfdghdsff11"/>
          <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="XXX4888"/>
        </ExcursionReservationIDs>
      </ResGlobalInfo>
    </ExcursionReservation>
  </ExcursionReservations>
</GP_ExcursionResRS>
Expand
titleExcursion Cancellation Response
Code Block
languagexml
<OTA_CancelRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Status="Cancelled" Version="2.0">
  <Success/>
  <UniqueID ID="tfdghdsff11" ID_Context="client" Type="10"/>
  <UniqueID ID="tfdghdsff11" ID_Context="agent" Type="10"/>
  <UniqueID ID="XXX4888" ID_Context="supplier" Type="10"/>
  <CancelInfoRS>
    <CancelRules>
      <CancelRule Amount="0.00" CurrencyCode="CAD"/>
    </CancelRules>
  </CancelInfoRS>
</OTA_CancelRS>
Expand
titleExcursion Booking Retrieval Quote Response
Code Block
languagexml
<GP_ExcursionResRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="EchoToken" Version="2.0">
  <Success/>
  <ExcursionReservations>
    <ExcursionReservation ResStatus="Cancelled">
      <Excursions>
        <Excursion>
          <ExcursionRates>
            <ExcursionRate BookingCode="49d4c9" Language="Undefined" RPH="1" RateCode="14005" RateName="FLY 'N DINE TO BOWEN ISLAND">
              <Rates>
                <Rate AgeQualifyingCode="10" RateSource="Calculated">
                  <Total AmountAfterTax="244.00" CurrencyCode="CAD"/>
                </Rate>
              </Rates>
              <RateDescription Name="FLY 'N DINE TO BOWEN ISLAND">
                <Text Language="en">FLY 'N DINE TO BOWEN ISLAND - HARBOUR AIR</Text>
              </RateDescription>
              <AdditionalQuestions>
                <AdditionalQuestion ID="40-257" IsMandatory="true" IsPerPerson="false" QuestionText="Departure Time" RegExpValue="(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]" TypeDescription="RegExpText" TypeID="5">
                  <AnswerValues>
                    <Value>12:00</Value>
                  </AnswerValues>
                </AdditionalQuestion>
                <AdditionalQuestion ID="40-509" IsMandatory="true" IsPerPerson="false" QuestionText="Dietary Restrictions" RegExpValue="^.{1,60}$" TypeDescription="RegExpText" TypeID="5">
                  <AnswerValues>
                    <Value>lala</Value>
                  </AnswerValues>
                </AdditionalQuestion>
                <AdditionalQuestion ID="40-252" IsMandatory="true" IsPerPerson="false" QuestionText="Drop off Location" RegExpValue="^.{1,100}$" TypeDescription="RegExpText" TypeID="5">
                  <AnswerValues>
                    <Value>Airport</Value>
                  </AnswerValues>
                </AdditionalQuestion>
              </AdditionalQuestions>
              <Total AmountAfterTax="244.00" CurrencyCode="CAD"/>
              <CancelPenalties>
                <CancelPenalty End="2021-07-14T23:59:59-07:00" Start="2021-07-12T00:00:00-07:00">
                  <AmountPercent Amount="244.00" CurrencyCode="CAD"/>
                  <PenaltyDescription Language="en">
                    <Text>Standard Cancellation Policy ( 100 % of Total )</Text>
                  </PenaltyDescription>
                </CancelPenalty>
                <CancelPenalty End="2021-07-15T23:59:59-07:00" Start="2021-07-15T00:00:00-07:00">
                  <AmountPercent Amount="244.00" CurrencyCode="CAD"/>
                </CancelPenalty>
              </CancelPenalties>
            </ExcursionRate>
          </ExcursionRates>
          <ExcursionDate Start="2021-07-15"/>
          <Total AmountAfterTax="0.00" CurrencyCode="CAD"/>
          <BasicExcursionInfo ExcursionCityCode="YVR" ExcursionCode="14005" ExcursionCodeContext="supplierCode" ExcursionName="FLY 'N DINE TO BOWEN ISLAND" OperatedBy="Harbour Air / West Coast Air / Whistler Air (A/C # 149062)">
            <Categories>
              <Category Code="OTHR">
                <Text Language="en">Day Tours</Text>
              </Category>
            </Categories>
          </BasicExcursionInfo>
        </Excursion>
      </Excursions>
      <ResGuests>
        <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
          <Profiles>
            <ProfileInfo>
              <UniqueID ID="1" Type="1"/>
              <Profile>
                <Customer BirthDate="2000-06-12">
                  <PersonName>
                    <NamePrefix>Mr</NamePrefix>
                    <GivenName>Ivan</GivenName>
                    <Surname>Ivanov</Surname>
                  </PersonName>
                  <Telephone PhoneNumber="+2324234234"/>
                  <Email>test@gpsolutions.com</Email>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <ResGlobalInfo>
        <Comments>
          <Comment>
            <Text>Please, arrange vegetarian meal.</Text>
          </Comment>
        </Comments>
        <DepositPayments>
          <GuaranteePayment Type="AcceptedPaymentForms">
            <AcceptedPayments>
              <AcceptedPayment CostCenterID="supplierCode"/>
            </AcceptedPayments>
          </GuaranteePayment>
        </DepositPayments>
        <ExcursionReservationIDs>
          <ExcursionReservationID ResID_Source="client" ResID_Value="tfdghdsff11"/>
          <ExcursionReservationID ResID_Source="agent" ResID_Value="tfdghdsff11"/>
          <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="XXX4888"/>
        </ExcursionReservationIDs>
      </ResGlobalInfo>
    </ExcursionReservation>
  </ExcursionReservations>
</GP_ExcursionResRS>

11.5. BOOKING WITH SPECIFIC PAX TYPES

...

2. EXCURSION SEARCH

This step provides you with the opportunity to search for excursions in the requested city. In the response we don’t show any availability and prices information, we just return a list of excursions in the specified city and basic information about them (pax types are also returned).
The main purpose of this message is to get excursion codes that can be used in further steps and their pax types.

Here is how pax types will look like in our response:

Code Block
languagexml
<PaxTypes MaxCount="14" MinCount="1">
    <PaxType Code="INFANT" MaxAge="7" MaxCount="14" MinAge="5" MinCount="0" Name="INFANT"/>
    <PaxType Code="CHILD" MaxAge="11" MaxCount="14" MinAge="8" MinCount="0" Name="CHILD"/>
    <PaxType Code="ADULT" MaxAge="59" MaxCount="14" MinAge="20" MinCount="0" Name="ADULT"/>
</PaxTypes>

To get the pax types for the excursion before the availability step you can also use our Excursion Descriptive Info message https://gp-team.atlassian.net/wiki/spaces/GTHEUG/pages/789315585/3.+EXCURSION+DESCRIPTIVE+INFO

(specifying city code + excursion code). In our response along with the pax types you’ll receive full information about the excursion provided by the supplier.

Then you can proceed to the Excursion Availability step specifying pax types you received in the Excursion Search response.

4. EXCURSION AVAILABILITY

Here is how pax type need to be specified in the availability request https://gp-team.atlassian.net/wiki/spaces/GTHEUG/pages/779223332/2.2.+EXCURSION+AVAILABILITY+REQUEST:

Code Block
languagexml
<GuestCounts>
     <GuestCount 
<GivenName>Ivan</GivenName>
Count="1" PaxTypeCode="ADULT"/>
     <GuestCount Count="1" PaxTypeCode="CHILD"/>
</GuestCounts>

If the supplier doesn’t support Availability request by date interval, you can use our Excursion Schedule message 3. EXCURSION SCHEDULE. You need to specify a date interval and excursion code in the request 3.1. EXCURSION SCHEDULE REQUEST and you’ll receive a list of dates that are available for this excursion with prices for each pax type, for example:

Code Block
languagexml
<Rate>
    
<Surname>Ivanov</Surname>
<ExcursionDate Start="2023-12-21"/>
    <PaxTypes>
        <PaxType Code="CHILD" MinCount="0" Name="CHILD">
 
</PersonName>
           <Total 
<Telephone PhoneNumber="+2324234234"/
AmountAfterTax="122.52" CurrencyCode="USD">
                <Taxes>
 
<Email>test@gpsolutions.com</Email>
                 
</Customer>
  <Tax Amount="8.55" Code="17" 
</Profile>
CurrencyCode="USD" TaxInclusiveInd="true"/>
            
</ProfileInfo>
    </
Profiles>
Taxes>
       
</ResGuest>
     
</
ResGuests>
Total>
      
<ResGlobalInfo>
  
<Comments>
</PaxType>
        <PaxType Code="ADULT" 
<Comment>
MinCount="1" Name="ADULT">
            
<Text>Please, arrange vegetarian meal.</Text>
<Total AmountAfterTax="128.48" CurrencyCode="USD">
           
</Comment>
     <Taxes>
   
</Comments>
         
<DepositPayments>
        <Tax Amount="8.96" 
<GuaranteePayment Type="AcceptedPaymentForms">
Code="17" CurrencyCode="USD" TaxInclusiveInd="true"/>
             
<AcceptedPayments>
   </Taxes>
           
<AcceptedPayment
 
CostCenterID="supplierCode"/>
</Total>
        </PaxType>
    </
AcceptedPayments>
PaxTypes>
</Rate>

After the Excursion Availability step you can proceed to the Excursion Reservation step. In 7.1. RESERVATION INITIATE REQUEST and 7.5. RESERVATION CONFIRMATION REQUEST you’ll need to specify pax types for each guest:

Code Block
languagexml
<ResGuests>
    <ResGuest 
</GuaranteePayment>
PaxTypeCode="ADULT" ResGuestRPH="1">
        <Profiles>
</DepositPayments>
         
<ExcursionReservationIDs>
   ...
       
<ExcursionReservationID ResID_Source="client" ResID_Value="tfdghdsff11"/>
 </Profiles>
    </ResGuest>
    <ResGuest 
<ExcursionReservationID ResID_Source
PaxTypeCode="
agent
YOUTH" 
ResID_Value
ResGuestRPH="
tfdghdsff11
1"
/
>
        <Profiles>
  
<ExcursionReservationID
 
ResID_Source="supplier"
 
ResID_SourceContext="supplierCode"
 
ResID_Value="XXX4888"/>
       ...
 
</ExcursionReservationIDs>
       </
ResGlobalInfo>
Profiles>
    </
ExcursionReservation>
ResGuest>
</
ExcursionReservations> </GP_ExcursionResRS>
ResGuests>