> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axisdata.net/llms.txt
> Use this file to discover all available pages before exploring further.

# OTA_TourActivityAvailRS

The OTA\_TourActivityAvailRS (Tour & Activity Availability **Response**) returns available excursion services and pricing, corresponding to the search parameters sent in `OTA_TourActivityAvailRQ`. A `<Success/>` element indicates the request was processed; otherwise errors are returned. Results may be aggregated as one **price-from per service** (MF002) or expanded **per product/subservice** (MF001).

## Structure – Root Element

```xml theme={null}
<OTA_TourActivityAvailRS>
```

**Key Attributes:**

* `xmlns`: `http://www.opentravel.org/OTA/2003/05`.
* `Version`: `2016.b` (OTA Tour Activity messaging pack).
* `TransactionIdentifier`: Correlates the transaction across systems (optional).

## Structure – Core Elements

### TourActivityInfo

Container for one available service result.

#### BasicInfo

Service identification and labeling for the product/subservice.

* `SupplierProductCode`: Specifies which product(unit) of a stock is being described.
* `Name`: Full name of the tour.
* `ShortName`: Name of the product.
* `TourActivityID`: MTS activity code.
* `SupplierServiceCode`: Type of service.

```xml theme={null}
<BasicInfo SupplierProductCode="FK000000" Name="Fuerteventura Leisure" ShortName="Ferry Ticket - ticket only" TourActivityID="XESPMI5L4U" SupplierServiceCode="TIC"/>
```

#### Schedule

Availability summary for the specific departure/slot.

* `Summary/@Start`: Start datetime (ISO 8601).
* `Summary/@End`: End datetime (ISO 8601).
* `Summary/@Duration`: ISO 8601 duration (e.g., `PT8H`).

```xml theme={null}
<Schedule>
    <Summary Start="2026-07-17T09:30:00" Duration="PT8H" End="2026-07-17T17:30:00"/>
</Schedule>
```

#### CategoryAndType

Classification of the service.

* `Category/@Code`: Category (e.g., Excursion vs Ticket).
* `Type/@Code`: Activity type code (implementation-defined).

```xml theme={null}
<CategoryAndType>
    <Category Code="XA"/>
    <Type Code="BT"/>
</CategoryAndType>
```

#### Description

Short text describing the service.

* `ShortDescription`

```xml theme={null}
<Description>
    <ShortDescription>Fuerteventura Leisure</ShortDescription>
</Description>
```

#### Location

Where the service operates; includes postal address, regions, and geo position.

* `Address`: `AddressLine`, `CityName`, `PostalCode`, `Country`, `StateProv`.
* `Region`: `@RegionCode` values such as `Country`, `Destination`, `Region`, `Resort`, `TravelDestination`.
* `Position`: `@Latitude`, `@Longitude`.

```xml theme={null}
<Location>
    <Address>
    <AddressLine>Corralejo</AddressLine>
    <CityName>Playa Blanca</CityName>
    <PostalCode>35660</PostalCode>
    <Country>ES</Country>
    <StateProv>Lanzarote</StateProv>
    </Address>
    <Region RegionCode="Country">ES</Region>
    <Region RegionCode="Destination">Canarian Islands</Region>
    <Region RegionCode="Region">Lanzarote</Region>
    <Region RegionCode="Resort">Playa Blanca</Region>
    <Region RegionCode="TravelDestination">ACE</Region>
    <Position Latitude="28.86275" Longitude="-13.82973"/>
</Location>
```

#### Pricing

Price container. Returned format depends on MF mode:

* **MF002 (price-from per service)** — `Summary/@MinCharge` with `CurrencyCode`; `PricingType` = `PerPerson`.
* **MF001 (detailed per product/subservice)** — `Summary/@Amount` with `CurrencyCode`; `PricingType` = `PerGroup`.

```xml theme={null}
<Pricing>
    <Summary MinCharge="40.00" CurrencyCode="EUR">
    <PricingType>PerPerson</PricingType>
    </Summary>
</Pricing>
```

#### PickupDropoff (MF001 results with transfer service)

Operational pickup/dropoff information and indicators.

* `@PickupInd`: `true` for pickup records; `false` for dropoff.
* `@DateTime`: Pickup/dropoff local datetime.
* `@LocationName`, `@Code`, `@MeetingLocation`: Operational details (as provided).

## Complete Examples

<CodeGroup>
  ```xml Basic Response (MF002) expandable theme={null}
  <OTA_TourActivityAvailRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2016.b" TransactionIdentifier="1-2/2">
    <Success/>
    <TourActivityInfo>
      <BasicInfo SupplierProductCode="FK000000" Name="Fuerteventura Leisure" ShortName="Ferry Ticket - ticket only" TourActivityID="XESPMI5L4U" SupplierServiceCode="TIC"/>
      <Schedule>
        <Summary Start="2026-07-17T09:30:00" Duration="PT8H" End="2026-07-17T17:30:00"/>
      </Schedule>
      <CategoryAndType>
        <Category Code="XA"/>
        <Type Code="BT"/>
      </CategoryAndType>
      <Description>
        <ShortDescription>Fuerteventura Leisure</ShortDescription>
      </Description>
      <Location>
        <Address>
          <AddressLine>Corralejo</AddressLine>
          <CityName>Playa Blanca</CityName>
          <PostalCode>35660</PostalCode>
          <Country>ES</Country>
          <StateProv>Lanzarote</StateProv>
        </Address>
        <Region RegionCode="Country">ES</Region>
        <Region RegionCode="Destination">Canarian Islands</Region>
        <Region RegionCode="Region">Lanzarote</Region>
        <Region RegionCode="Resort">Playa Blanca</Region>
        <Region RegionCode="TravelDestination">ACE</Region>
        <Position Latitude="25.86275" Longitude="-15.82973"/>
      </Location>
      <Pricing>
        <Summary MinCharge="40.00" CurrencyCode="EUR">
          <PricingType>PerPerson</PricingType>
        </Summary>
      </Pricing>
    </TourActivityInfo>
  </OTA_TourActivityAvailRS>
  ```

  ```xml Detailed Response TRP (MF001) expandable theme={null}
  <OTA_TourActivityAvailRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2016.b" TransactionIdentifier="1-2/2">
    <Success/>
    <TourActivityInfo>
      <BasicInfo SupplierProductCode="TB000000" Name="Fuerteventura Leisure" ShortName="Boat Trip - incl. transfer by provider" TourActivityID="XESPMI5L4U" SupplierServiceCode="TRP"/>
      <Schedule>
        <Summary Start="2026-07-17T09:30:00" Duration="PT8H" End="2026-07-17T17:30:00"/>
      </Schedule>
      <CategoryAndType>
        <Category Code="XA"/>
        <Type Code="BT"/>
      </CategoryAndType>
      <Description>
        <ShortDescription>Fuerteventura Leisure</ShortDescription>
      </Description>
      <Location>
        <Address>
          <AddressLine>Corralejo</AddressLine>
          <CityName>Playa Blanca</CityName>
          <PostalCode>35660</PostalCode>
          <Country>ES</Country>
          <StateProv>Lanzarote</StateProv>
        </Address>
        <Region RegionCode="Country">ES</Region>
        <Region RegionCode="Destination">Canarian Islands</Region>
        <Region RegionCode="Region">Lanzarote</Region>
        <Region RegionCode="Resort">Playa Blanca</Region>
        <Region RegionCode="TravelDestination">ACE</Region>
        <Position Latitude="28.86275" Longitude="-13.82973"/>
      </Location>
      <Pricing>
        <Summary Amount="50.00" CurrencyCode="EUR">
          <PricingType>PerGroup</PricingType>
        </Summary>
      </Pricing>
      <PickupDropoff DateTime="2026-07-17T08:25:00" Code="AESPMI5L46" LocationName="Caserio Lanzarote" MeetingLocation="San Antonio BUS STOP [Others]" PickupInd="true"/>
    </TourActivityInfo>
  </OTA_TourActivityAvailRS>
  ```
</CodeGroup>

## Notes & Constraints

* **MF modes:** MF002 returns a single price-from (per person) per service; MF001 returns detailed products/subservices priced per group with operational details like pickups.
* **Pickup/dropoff in Ticket-only services:** Not included when the service is a pure ticket (no transfer).
* **Region usage:** When regions are provided, `Country` is required; other levels (Destination/Region/Resort/TravelDestination) are optional as applicable.
