Frequently-Asked-Questions

Certification FAQ

Certification number 02

Search to Book with private fare - User need to pass the fare preference tag under preference tag as given below.

 "preference": {

      "farePreference": [
        {
          "farePreference": "758",
          "supplierAccountCode": "A908260",
          "preferenceContext": "",
          "fareCodes": [                                 
            {
              "fareCode": "RJA20",
              "airline": "RJ"
            },
            {
              "fareCode": "VFR01",
              "airline": "LH"
            }
          ]
        }
      ]
    },

Please find below explanation ;

farePreference: "758" >> 758 stands for private fare

supplierAccountCode: "A908260" >> this value is taken from supplier master from operator portal. Client need to maintain these supplier codes at your end and send along with deal codes. Currently, use same code.

fareCodes: >> airline wise deal codes are sent in this block. Multiple deal codes can be sent by sending comma separated blocks as mentioned in above code snippet

Please find sample search request;

Private fare with code - Here response will have "fareCode": "RJA20" and "farePreference": "758" which indicates private fare with code.

Flight Private fare search request
{
  "flightSegments": [
    {
      "departureAirportCode": "DXB",
      "departureDate": "2023-05-26",
      "departureTimeFrom": "00:05",
      "departureTimeTo": "23:59",
      "arrivalAirportCode": "CDG",
      "cabinPreferences": [
        "5"
      ]
    },
    {
      "departureAirportCode": "CDG",
      "departureDate": "2023-05-31",
      "departureTimeFrom": "00:05",
      "departureTimeTo": "23:59",
      "arrivalAirportCode": "DXB",
      "cabinPreferences": [
        "5"
      ]
    }
  ],
  "passengers": [
    {
      "id": "1",
      "ptc": "ADT"
    }
  ],
  "preference": {
    "flightPreference": {
      "directPreferences": false,
      "maxConnections": 4
    },
    "airlinePreferences": [
      {
        "preferred": [],
        "allowOnly": []
      }
    ],
    "farePreference": [
      {
        "farePreference": "758",
        "supplierAccountCode": "A908260",
        "preferenceContext": "",
        "fareCodes": [
          {
            "fareCode": "RJA20",
            "airline": "RJ"
          },
          {
            "fareCode": "VFR01",
            "airline": "LH"
          }
        ]
      }
    ]
  },
  "formOfPayment": "CR",
  "travelType": "P",
  "responseParameters": {
    "shopResultPreference": "BEST"
  }
}

Certification number 04

Multi-city search to book flow with open jaw segments_

Basically open jaw segments are when the segments are not connected and is multiplicity search. Please find sample request that you can mak a search and booking.

Flight Open jaw search request
{
  "flightSegments": [
    {
      "departureAirportCode": "DXB",
      "departureDate": "2023-04-25",
      "departureTimeFrom": "00:00",
      "departureTimeTo": "23:59",
      "arrivalAirportCode": "BOM",
      "arrivalDate": "2023-01-25",
      "arrivalTimeFrom": "00:00",
      "arrivalTimeTo": "23:59",
      "cabinPreferences": [
        "5"
      ]
    },
    {
      "departureAirportCode": "DEL",
      "departureDate": "2023-04-30",
      "departureTimeFrom": "00:00",
      "departureTimeTo": "23:59",
      "arrivalAirportCode": "BAH",
      "arrivalDate": "2023-02-10",
      "arrivalTimeFrom": "00:00",
      "arrivalTimeTo": "23:59",
      "cabinPreferences": [
        "5"
      ]
    }
  ],
  "passengers": [
    {
      "id": "1",
      "ptc": "ADT"
    }
  ],
  "preference": {
    "flightPreference": {
      "directPreferences": false,
      "maxConnections": 1
    }
  },
  "formOfPayment": "CR",
  "travelType": "P",
  "responseParameters": {
    "shopResultPreference": "BEST"
  }
}

Certification number 11

Multi Fare Type - System supports SEA, ITX. For this, user need to pass the preferenceContext under farePreference tag as SEA or ITX as given below

"preference": {
         "farePreference": [
            {
                "farePreference": "758",
                "supplierAccountCode": "A908260",
                "preferenceContext": "SEA",
                "fareCodes": [

                ]
            }            
        ]
    }

Please note if we have codes for SEAMAN fare then we can pass those under fareCodes as explained in previous comment

Please find sample requests for this. Please use same airline and search criteria for booking for SEA due to test credentials limitations.

Flight SEA fare search request
{
  "flightSegments": [
    {
      "departureAirportCode": "DXB",
      "departureDate": "2023-05-26",
      "departureTimeFrom": "00:05",
      "departureTimeTo": "23:59",
      "arrivalAirportCode": "BOM",
      "cabinPreferences": [
        "5"
      ]
    },
    {
      "departureAirportCode": "BOM",
      "departureDate": "2023-05-31",
      "departureTimeFrom": "00:05",
      "departureTimeTo": "23:59",
      "arrivalAirportCode": "DXB",
      "cabinPreferences": [
        "5"
      ]
    }
  ],
  "passengers": [
    {
      "id": "1",
      "ptc": "ADT"
    }
  ],
  "preference": {
    "flightPreference": {
      "directPreferences": false,
      "maxConnections": 4
    },
    "airlinePreferences": [
      {
        "preferred": [],
        "allowOnly": []
      }
    ],
    "farePreference": [
      {
        "farePreference": "758",
        "supplierAccountCode": "A908260",
        "preferenceContext": "SEA",
        "fareCodes": []
      }
    ]
  },
  "formOfPayment": "CR",
  "travelType": "P",
  "responseParameters": {
    "shopResultPreference": "OPTIMIZED"
  }
}

Flight General FAQ

01) What is the offerId in search to book flow?
A unique offerId will be returned in the search response per each resul.This should be used all subsequent API calls for identify user selected result.The offerId is a combination of search id and result id. When calling more-fare,fare-rules and prov-booking the same offerId should be used.
Ex: offerId = AIR03019064-01.
However, for the booking request has to use prov-book response offerId.

02) What is Multi-city Flight and the format for Multiplicity?
Multiplicity flights are the one in which we by choice want to have stop during our full journey, the stops need to be defined and the time when next flight will be taken.

Format for Multiplicity:

BOM--DXB YYYY-MM-DD
DXB--LON YYYY-MM-DD
LON--BOM YYYY-MM-DD