OTA_TourActivityBookRS

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>

{
  "ParticipantInfo": {
    "Category": {
      "QualifierInfo": "10"
    },
    "Individual": {
      "Age": "36",
      "ParticipantID": "1",
      "NamePrefix": "Mr",
      "GivenName": "Bender",
      "Surname": "Bending"
    }
  }
}

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>

{
  "TPA_Extensions": {
    "UniqueID": [
      {
        "Type": "36",
        "ID_Context": "Client",
        "ID": "1234567890"
      },
      {
        "Type": "36",
        "ID_Context": "Internal",
        "ID": "121212121212"
      },
      {
        "Type": "37",
        "ID_Context": "Client",
        "ID": "1234567890_1"
      },
      {
        "Type": "37",
        "ID_Context": "Internal",
        "ID": "1"
      }
    ]
  }
}

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>

{
  "TPA_Extensions": {
    "CancelPenalties": {
      "CancelPenalty": [
        {
          "Deadline": {
            "OffsetUnitMultiplier": "24",
            "OffsetTimeUnit": "Hour",
            "OffsetDropTime": "BeforeArrival"
          },
          "AmountPercent": {
            "Percent": "50",
            "BasisType": "FullStay"
          }
        },
        {
          "Deadline": {
            "OffsetUnitMultiplier": "72",
            "OffsetTimeUnit": "Hour",
            "OffsetDropTime": "BeforeArrival"
          },
          "AmountPercent": {
            "Percent": "5",
            "BasisType": "FullStay"
          }
        }
      ]
    }
  }
}

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>

{
  "TPA_Extensions": {
    "UniqueID": [
      {
        "Type": "30",
        "ID_Context": "Client",
        "ID": "/OI/P1437/I0/AN002137/E176/N001/B003/J1/F210605/H1600/G51/R1:Y2-B3F210605-H1600"
      },
      {
        "Type": "30",
        "ID_Context": "Client",
        "ID": "https://pre-portaventuraworld.api.experticket.com/TransactionDownload/SalesDocument?SaleId=5603191358506446612"
      }
    ]
  }
}

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"/>

{
  "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

Book RS

<?xml version="1.0" encoding="UTF-8"?>
<OTA_TourActivityBookRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2011.2">
    <Success/>
    <ReservationDetails>
        <BasicInfo ShortName="Sightseeing Tour (Halfday - Incl. Boat Trip) - incl. pickUp &amp; dropOff" SupplierServiceCode="TRF" SupplierProductCode="SS0HDBT0" Name="Dolphin Sightseeing" TourActivityID="XESPMI5L4U"/>
        <ParticipantInfo>
            <Category QualifierInfo="10"/>
            <Individual Age="36" ParticipantID="1">
                <GivenName>Bender</GivenName>
                <NamePrefix>Mr</NamePrefix>
                <Surname>Bending</Surname>
            </Individual>
        </ParticipantInfo>
        <ParticipantInfo>
            <Category QualifierInfo="10"/>
            <Individual Age="32" ParticipantID="2">
                <GivenName>Angeline</GivenName>
                <NamePrefix>Ms</NamePrefix>
                <Surname>Bending</Surname>
            </Individual>
        </ParticipantInfo>
        <Schedule Start="2027-07-17T09:30:00" End="2027-07-17T17:30:00"/>
        <Location></Location>
        <PickupDropoff DateTime="2027-07-17T08:25:00" LocationName="AESPMI5L46" PickupInd="true" MeetingLocation="Hotel Overlook [Hotel entrance]">
            <Schedule Duration="4h">
                <OperationTimes>
                    <OperationTime Start="2027-07-17T09:30:00" End="2027-07-17T17:30:00"/>
                </OperationTimes>
            </Schedule>
        </PickupDropoff>
        <Extra Quantity="1" Description="Extra Food" SupplierCode="EXFOOD"/>
        <Pricing>
            <Summary Amount="110.16" CurrencyCode="EUR"/>
            <Group KnownGroupsize="2"/>
        </Pricing>
    </ReservationDetails>
    <TPA_Extensions>
        <RateDetails>
            <GuestDetails ResGuestRPH="1" TotalAmount="55.08" CurrencyCode="EUR" RateCode="Price">
                <RateComponents StayDay="1" ResGuestRPH="1" Code="XABR2" Edition="0" Rate="61.20" CurrencyCode="EUR" CodeType="STDRATE"/>
                <RateComponents StayDay="1" ResGuestRPH="1" Code="EBOLA1" Edition="0" Rate="-6.12" CurrencyCode="EUR" CodeType="OFF"/>
            </GuestDetails>
            <GuestDetails ResGuestRPH="2" TotalAmount="55.08" CurrencyCode="EUR" RateCode="Price">
                <RateComponents StayDay="1" ResGuestRPH="2" Code="XABR2" Edition="0" Rate="61.20" CurrencyCode="EUR" CodeType="STDRATE"/>
                <RateComponents StayDay="1" ResGuestRPH="2" Code="EBOLA1" Edition="0" Rate="-6.12" CurrencyCode="EUR" CodeType="OFF"/>
            </GuestDetails>
            <Totals>
                <Total TotalType="Price" CurrencyType="Price" CurrencyCode="EUR" AmountAfterTax="110.16" Override="false"/>
            </Totals>
        </RateDetails>
        <CancelPenalties/>
        <UniqueID Type="36" ID_Context="Client" ID="123456789"/>
        <UniqueID Item_RPH="1" ID="123456789_1" Type="37" ID_Context="Client"/>
        <UniqueID Item_RPH="1" ID="1" Type="37" ID_Context="Internal"/>
        <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="Available"/>
    </TPA_Extensions>
</OTA_TourActivityBookRS>

{
  "OTA_TourActivityBookRS": {
    "Success": "",
    "BasicInfo": {
      "TourActivityID": "XESPMI5L4U",
      "SupplierProductCode": "SS0HDBT0",
      "SupplierServiceCode": "TRF"
    },
    "Location": {
      "Region": {
        "RegionCode": "Region",
        "value": "Mallorca"
      },
      "Context": "Service"
    },
    "ParticipantInfo": {
      "Category": {
        "QualifierInfo": "10"
      },
      "Individual": {
        "NamePrefix": "Mr",
        "GivenName": "Bender",
        "Surname": "Bending",
        "Age": "36",
        "ParticipantID": "1"
      }
    },
    "Pricing": {
      "Summary": {
        "Amount": "130.00",
        "CurrencyCode": "EUR"
      },
      "Group": {
        "KnownGroupsize": "3"
      }
    },
    "TPA_Extensions": {
      "CancelPenalties": {
        "CancelPenalty": [
          {
            "Deadline": {
              "OffsetUnitMultiplier": "24",
              "OffsetTimeUnit": "Hour",
              "OffsetDropTime": "BeforeArrival"
            },
            "AmountPercent": {
              "Percent": "50",
              "BasisType": "FullStay"
            }
          },
          {
            "Deadline": {
              "OffsetUnitMultiplier": "72",
              "OffsetTimeUnit": "Hour",
              "OffsetDropTime": "BeforeArrival"
            },
            "AmountPercent": {
              "Percent": "5",
              "BasisType": "FullStay"
            }
          }
        ]
      },
      "UniqueID": [
        {
          "Type": "36",
          "ID_Context": "Client",
          "ID": "1234567890"
        },
        {
          "Type": "36",
          "ID_Context": "Internal",
          "ID": "121212121212"
        },
        {
          "Type": "37",
          "ID_Context": "Client",
          "ID": "1234567890_1"
        },
        {
          "Type": "37",
          "ID_Context": "Internal",
          "ID": "1"
        },
        {
          "Type": "30",
          "ID_Context": "Client",
          "ID": "/OI/P1437/I0/AN002137/E176/N001/B003/J1/F210605/H1600/G51/R1:Y2-B3F210605-H1600"
        },
        {
          "Type": "30",
          "ID_Context": "Client",
          "ID": "https://pre-portaventuraworld.api.experticket.com/TransactionDownload/SalesDocument?SaleId=5603191358506446612"
        }
      ],
      "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",
        "prefix": "ns1"
      }
    },
    "Extra": {
      "SupplierCode": "EXFOOD",
      "Description": "Extra Food",
      "quantity": "1"
    },
    "xmlns": "http://www.opentravel.org/OTA/2003/05",
    "Version": "2008.1"
  }
}

Best Practices

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

Getting started

Authentication

Accommodation

Transfer

Excursion & Activities

Other Products

Booking management

General Concepts

Glossary

Push Model

Purpose

Structure – Root Element

Structure – Core Elements

BasicInfo

Location

ParticipantInfo

Pricing

Extras

TPA_Extensions

References

CancelPenalties

QR Codes

BookingStatus

Complete Examples

Best Practices

​Purpose

​Structure – Root Element

​Structure – Core Elements

​BasicInfo

​Location

​ParticipantInfo

​Pricing

​Extras

​TPA_Extensions

​References

​CancelPenalties

​QR Codes

​BookingStatus

​Complete Examples

​Best Practices

Purpose

Structure – Root Element

Structure – Core Elements

BasicInfo

Location

ParticipantInfo

Pricing

Extras

TPA_Extensions

References

CancelPenalties

QR Codes

BookingStatus

Complete Examples

Best Practices