Versions Compared

Version Old Version 6 New Version 7
Changes made by

Yana Brilevskaya

Yana Brilevskaya

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added Use case BOOKING WITH SPECIFIC PAX TYPES

...

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 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>
    <ExcursionDate Start="2023-12-21"/>
    <PaxTypes>
        <PaxType Code="CHILD" MinCount="0" Name="CHILD">
            <Total AmountAfterTax="122.52" CurrencyCode="USD">
                <Taxes>
                    <Tax Amount="8.55" Code="17" CurrencyCode="USD" TaxInclusiveInd="true"/>
                </Taxes>
            </Total>
        </PaxType>
        <PaxType Code="ADULT" MinCount="1" Name="ADULT">
            <Total AmountAfterTax="128.48" CurrencyCode="USD">
                <Taxes>
                    <Tax Amount="8.96" Code="17" CurrencyCode="USD" TaxInclusiveInd="true"/>
                </Taxes>
            </Total>
        </PaxType>
    </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 PaxTypeCode="ADULT" ResGuestRPH="1">
        <Profiles>
            ...
        </Profiles>
    </ResGuest>
    <ResGuest PaxTypeCode="YOUTH" ResGuestRPH="1">
        <Profiles>
            ...
        </Profiles>
    </ResGuest>
</ResGuests>