Skip to main content
The OTA_TourActivityBookRS (Excursion Book Response) confirms a quote or a committed booking for a tour/activity service. It returns confirmation details such as service identifiers, participant data, pricing, partner/internal references, cancellation rules, and (optionally) QR codes.

​
Purpose

  • Quote: Confirms availability and final price without creating a reservation (no commitment).
  • Commit: Creates a binding booking in the reservation system; penalties may apply to changes/cancellations.
  • If the booking cannot be processed, the response omits <Success/> and returns error details under <Errors/>. Error Scenarios

​
Structure – Root Element

<OTA_TourActivityBookRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2008.1">
  ...
</OTA_TourActivityBookRS>
Key attributes
  • Version: OTA spec version (e.g., 2008.1).
  • xmlns: http://www.opentravel.org/OTA/2003/05.

​
Structure – Core Elements

​
BasicInfo

Confirms the booked service identifiers returned from search/detail. 
<BasicInfo TourActivityID="XESPMIAZ9U" SupplierProductCode="TE0CC00A" SupplierServiceCode="TRF"/>

​
Location

Optional region/location context for the service. 
<Location Context="Service">
  <Region RegionCode="Region">Mallorca</Region>
</Location>

​
ParticipantInfo

Echoes each participant’s age at the time of service, a unique ParticipantID, and the age qualifier code (QualifierInfo) following OTA AQC conventions (e.g., 10 adult, 8 child). 
<ParticipantInfo>
  <Category QualifierInfo="10"/>
  <Individual Age="36" ParticipantID="1">
    <NamePrefix>Mr</NamePrefix>
    <GivenName>Bender</GivenName>
    <Surname>Bending</Surname>
  </Individual>
</ParticipantInfo>

​
Pricing

Final confirmed amounts appear under Pricing. Values in Summary are final for accountancy. Group size (when relevant) is returned as KnownGroupsize. 
<Pricing>
  <Summary Amount="130.00" CurrencyCode="EUR"/>
  <Group KnownGroupsize="3"/>
</Pricing>

​
Extras

Extras confirmed in the booking appear in the response; their amounts are already included in the total charge. 
<Extra SupplierCode="EXFOOD" Description="Extra Food" quantity="1"/>

​
TPA_Extensions

Includes general information returned by the provider.

​
References

Partner and AxisData internal references are returned as UniqueID entries. Use client references for vouchers and communications; both client and internal references support cancellation. Master (Type=36) and child (Type=37) references are provided. 
<TPA_Extensions>
  <UniqueID Type="36" ID_Context="Client"   ID="1234567890"/>
  <UniqueID Type="36" ID_Context="Internal" ID="121212121212"/>
  <UniqueID Type="37" ID_Context="Client"   ID="1234567890_1"/>
  <UniqueID Type="37" ID_Context="Internal" ID="1"/>
</TPA_Extensions>

​
CancelPenalties

Cancellation policy is returned for both Quote and Commit responses. Use child references for partial cancellations. 
<TPA_Extensions>
  <CancelPenalties>
    <CancelPenalty>
      <Deadline OffsetUnitMultiplier="24" OffsetTimeUnit="Hour" OffsetDropTime="BeforeArrival"/>
      <AmountPercent Percent="50" BasisType="FullStay"/>
    </CancelPenalty>
    <CancelPenalty>
      <Deadline OffsetUnitMultiplier="72" OffsetTimeUnit="Hour" OffsetDropTime="BeforeArrival"/>
      <AmountPercent Percent="5" BasisType="FullStay"/>
    </CancelPenalty>
  </CancelPenalties>
</TPA_Extensions>

​
QR Codes

Some providers return tickets/QR codes via UniqueID Type="30" under TPA_Extensions:
  • Direct QR value: ID contains the QR string to render as a code.
  • QR URL: ID contains a URL to download the QR/ticket.
<TPA_Extensions>
  <!-- Direct QR value -->
  <UniqueID Type="30" ID_Context="Client" ID="/OI/P1437/I0/AN002137/E176/N001/B003/J1/F210605/H1600/G51/R1:Y2-B3F210605-H1600"/>
  <!-- QR download URL -->
  <UniqueID Type="30" ID_Context="Client" ID="https://pre-portaventuraworld.api.experticket.com/TransactionDownload/SalesDocument?SaleId=5603191358506446612"/>
</TPA_Extensions>

​
BookingStatus

When present, booking status may also be returned as a TPA element: 
<ns1:BookingStatus
  xmlns:ns1="http://www.opentravel.org/OTA/2003/05/tpa"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:type="ns1:BookingStatusType"
  ReservationStatusType="Reserved"/>

​
Complete Examples

<OTA_TourActivityBookRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2008.1">
  <Success/>
  <BasicInfo TourActivityID="XESPMIAZ9U" SupplierProductCode="TE0CC00A" SupplierServiceCode="TRF"/>
  <Location Context="Service">
    <Region RegionCode="Region">Mallorca</Region>
  </Location>
  <ParticipantInfo>
    <Category QualifierInfo="10"/>
    <Individual Age="36" ParticipantID="1">
      <NamePrefix>Mr</NamePrefix>
      <GivenName>Bender</GivenName>
      <Surname>Bending</Surname>
    </Individual>
  </ParticipantInfo>
  <Pricing>
    <Summary Amount="130.00" CurrencyCode="EUR"/>
    <Group KnownGroupsize="3"/>
  </Pricing>
  <TPA_Extensions>
    <CancelPenalties>
      <CancelPenalty>
        <Deadline OffsetUnitMultiplier="24" OffsetTimeUnit="Hour" OffsetDropTime="BeforeArrival"/>
        <AmountPercent Percent="50" BasisType="FullStay"/>
      </CancelPenalty>
      <CancelPenalty>
        <Deadline OffsetUnitMultiplier="72" OffsetTimeUnit="Hour" OffsetDropTime="BeforeArrival"/>
        <AmountPercent Percent="5" BasisType="FullStay"/>
      </CancelPenalty>
    </CancelPenalties>
    <UniqueID Type="36" ID_Context="Client"   ID="1234567890"/>
    <UniqueID Type="36" ID_Context="Internal" ID="121212121212"/>
    <UniqueID Type="37" ID_Context="Client"   ID="1234567890_1"/>
    <UniqueID Type="37" ID_Context="Internal" ID="1"/>
    <!-- Example QR representations -->
    <UniqueID Type="30" ID_Context="Client" ID="/OI/P1437/I0/AN002137/E176/N001/B003/J1/F210605/H1600/G51/R1:Y2-B3F210605-H1600"/>
    <UniqueID Type="30" ID_Context="Client" ID="https://pre-portaventuraworld.api.experticket.com/TransactionDownload/SalesDocument?SaleId=5603191358506446612"/>
    <ns1:BookingStatus xmlns:ns1="http://www.opentravel.org/OTA/2003/05/tpa" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns1:BookingStatusType" ReservationStatusType="Reserved"/>
  </TPA_Extensions>
  <Extra SupplierCode="EXFOOD" Description="Extra Food" quantity="1"/>
</OTA_TourActivityBookRS>

​
Best Practices

  1. Use client references for external communications (voucher/finance), but retain internal references for support and cancellations.
  2. Provide accurate ages at service date with correct OTA AQC codes in ParticipantInfo.
  3. Read CancelPenalties for both quotes and commits; use child references to scope partial cancellations.