Special Fares

Published:

Introduction

We allow asking for special fares like Tour Operator or Corporate fares with different airlines.

Each of these fares require a different number of parameters depending on the airline, the fare, the agency and/or the corporate, so there’s no silver bullet and you’ll need to implement each case.

In BookingPad, we have solved this with Presets. Check our BookingPad help to understand how it works. Remember that you can use this in Sandbox with your tracer so you can mimic the behavior in your own tools, you have all this explained in our first steps page. Anyway, we’ve included some examples in this article too.

Since each airline will accept a different set of PTCs, preferences and qualifiers, remember to select which airline you want to retrieve when calling AirShopping using the Ag-Providers header.

Here is the list of supported types for qualifiers:

account_id
contract_id
promo_code

Copa Airlines

See an example in BookingPad in our help docs.

You can get Negociated fares with Copa by sending:

PTC = PFA
Preference = (749) Negociated Fares
Qualifier = Contract ID from the airline

British Airways

See an example in BookingPad in our help docs.

You can get many different fares with with British Airways. Please bear in mind that most of these fares depend on the agency and the route.

Tour Operator Fares

PTC = ITX
Preference = (758) Tour Operator Deferred

Tour Operator Semi-Deferred

PTC = TIM
Preference = (758) Tour Operator Semi-Deferred

Contract Bulk - Visiting Friends and Relatives

PTC = JCB
Preference = (758) Contract Bulk

Private Fare Adult

PTC = PFA
Preference = (758) Private Fare Adult

Humanitarian

PTC = MIS
Preference = (758) Private Fare Adult

Marine

PTC = SEA
Preference = (759) Lowest Fares, (758) Marine

Air France - KLM

See an example in BookingPad in our help docs.

Different fares can be retrieved for AF and KLM.

Tour Operator

PTC = IIT
Preference = (758) Tour Operator Deferred
Account ID = Account Id from the agency

{
  "metadata": {
    "country": "DE",
    "currency": "EUR",
    "locale": "de_DE"
  },
  "originDestinations": [
    {
      "arrival": {
        "airportCode": "PAR",
        "time": ""
      },
      "departure": {
        "airportCode": "LIS",
        "date": "2023-10-20",
        "time": ""
      }
    },
    {
      "arrival": {
        "airportCode": "LIS",
        "time": ""
      },
      "departure": {
        "airportCode": "PAR",
        "date": "2023-10-29",
        "time": ""
      }
    }
  ],
  "passengers": [
    {
      "passengerType": "ADT",
      "travelerReference": "ADT0"
    }
  ],
  "preferences": {
    "cabin": [
      "7"
    ],
    "fareList": [
      {
        "Code": "758",
        "Definition": "TOD"
      }
    ],
    "nonStop": false
  },
  "qualifier": {
    "airline": "AF",
    "code": "XXXXXX",
    "type": "account_id"
  }
}

Disney fares

Preference = Disney
Account ID = Account Id from the agency

{
  "metadata": {
    "country": "DE",
    "currency": "EUR",
    "locale": "de_DE"
  },
  "originDestinations": [
    {
      "arrival": {
        "airportCode": "PAR",
        "time": ""
      },
      "departure": {
        "airportCode": "MAD",
        "date": "2023-10-08",
        "time": ""
      }
    },
    {
      "arrival": {
        "airportCode": "MAD",
        "time": ""
      },
      "departure": {
        "airportCode": "PAR",
        "date": "2023-10-15",
        "time": ""
      }
    }
  ],
  "passengers": [
    {
      "passengerType": "ADT",
      "travelerReference": "ADT0"
    }
  ],
  "preferences": {
    "cabin": [
      "7"
    ],
    "fareList": [
      {
        "Definition": "TD"
      }
    ],
    "nonStop": false
  },
  "qualifier": {
    "airline": "AF",
    "code": "XXXXXX",
    "type": "account_id"
  }
}

Lufthansa

See an example in BookingPad in our help docs.

Different fares can be retrieved for Lufthansa.

Seaman / Marine Fares