2. GetOtherFlights

Last modified by Giorgi Mdivnishvili on 2024/04/11 17:06

Contents

Method Description

Method Description

After searching available tour packages according to your preferences, it's possible to choose alternate flight options. with this method it's possible to in same dates find alternative flights options.

The system enables users to initiate a detailed evaluation workflow for the selected package. This evaluation includes:

Data Retrieval: Automated fetching of extensive details related to the selected package, ensuring a complete dataset is available for user review.
Price Recalculation: Implementation of dynamic pricing algorithms to recalculate the cost of the package in real-time, considering current availability, user preferences, and potential discounts.
Variant Exploration: Activation of mechanisms to navigate and assess alternative package variations, offering users a breadth of options based on predefined criteria such as duration, included amenities, and price points.
Condition Assessment: Provision of a detailed parsing and presentation layer for the terms and conditions associated with the package, enabling users to programmatically understand obligations, benefits, and limitations.

This functionality is designed to support an informed decision-making process by providing a comprehensive, algorithm-driven analysis of each package from a technical and user-centric standpoint.

Endpoint URL - [POST]

https://integration.kazunion.com/api/TourPackages/GetOtherFlights

Request Parameters

None

Request Body

{
"package": {
   "id": "string",
   "priceCurrency": "string",
   "totalPrice": 0,
   "agentCommissionPercent": 0,
   "agentCommissionAmount": 0,
   "includedExtrasAmount": 0,
   "priceDifference": 0,
   "hotel": {
     "hotelPriceId": "string",
     "providerId": 0,
     "hotelName": "string",
     "hotelCode": "string",
     "nigths": 0,
     "mealPlan": "string",
     "hotelClass": "string",
     "availabilityType": "OnRequest",
     "availableRoomsCount": 0,
     "fewRooms": true,
     "roomCategoryCode": "string",
     "roomCategoryName": "string",
     "placementTypeName": "string",
     "placementDescription": "string",
     "checkInDate": "2023-12-18T14:03:07.553Z",
     "checkOutDate": "2023-12-18T14:03:07.553Z",
     "adults": 0,
     "children": 0,
     "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "districtName": "string",
     "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "cityName": "string",
     "countryCode": "string",
     "countryName": "string",
     "hasAlcohol": true,
     "hasFreeWifi": true,
     "hasMetro": true,
     "hasPool": true,
     "hasMall": true,
     "cancellationPolicyDescription": "string",
     "cancellationPolicy": {
       "cancellationPolicyCode": "string",
       "noShowChargeValue": 0,
       "noShowChargeValueType": "string",
       "earlyDepartureChargeValue": 0,
       "earlyDepartureChargeValueType": "string",
       "conditions": [
          {
           "timeunits": 0,
           "timeunitType": "string",
           "timeOffsetTypeName": "string",
           "chargeValue": 0,
           "chargeValueType": "string"
          }
        ]
      }
    },
   "flight": {
     "id": "string",
     "departureDate": "2023-12-18T14:03:07.553Z",
     "returnDate": "2023-12-18T14:03:07.553Z",
     "departureTicketsLeft": 0,
     "returnTicketsLeft": 0,
     "departureAvailabilityType": "OnRequest",
     "returnAvailabilityType": "OnRequest",
     "isTwoWay": true,
     "departureSegments": [
        {
         "airlineCode": "string",
         "airlineName": "string",
         "flightCode": "string",
         "class": "string",
         "lugageWeight": 0,
         "handLugageWeight": 0,
         "departureFlightDate": "2023-12-18T14:03:07.553Z",
         "departureCountryName": "string",
         "departureCityName": "string",
         "departureAirportCode": "string",
         "departureAirportName": "string",
         "departureTerminalCode": "string",
         "arrivalFlightDate": "2023-12-18T14:03:07.553Z",
         "arrivalCountryName": "string",
         "arrivalCityName": "string",
         "arrivalAirportCode": "string",
         "arrivalAirportName": "string",
         "arrivalTerminalCode": "string",
         "flightDuration": "string",
         "baggages": [
            {
             "baggageCode": "string",
             "description": "string",
             "price": 0,
             "currency": "string",
             "included": true
            }
          ]
        }
      ],
     "returnSegments": [
        {
         "airlineCode": "string",
         "airlineName": "string",
         "flightCode": "string",
         "class": "string",
         "lugageWeight": 0,
         "handLugageWeight": 0,
         "departureFlightDate": "2023-12-18T14:03:07.553Z",
         "departureCountryName": "string",
         "departureCityName": "string",
         "departureAirportCode": "string",
         "departureAirportName": "string",
         "departureTerminalCode": "string",
         "arrivalFlightDate": "2023-12-18T14:03:07.553Z",
         "arrivalCountryName": "string",
         "arrivalCityName": "string",
         "arrivalAirportCode": "string",
         "arrivalAirportName": "string",
         "arrivalTerminalCode": "string",
         "flightDuration": "string",
         "baggages": [
            {
             "baggageCode": "string",
             "description": "string",
             "price": 0,
             "currency": "string",
             "included": true
            }
          ]
        }
      ]
    },
   "extraServices": [
      {
       "extraServiceCode": "string",
       "extraServiceTypeCode": "string",
       "isMandatory": 0,
       "extraServiceName": "string",
       "minimalServiceAmount": 0,
       "includedPriceCode": "string",
       "prices": [
          {
           "extraServicePriceCode": "string",
           "displayName": "string",
           "restrictionInfo": "string",
           "additionalInfo": "string",
           "price": 0,
           "extraPrice": 0,
           "currency": "string"
          }
        ]
      }
    ],
   "insurancePrice": {
     "name": "string",
     "price": 0,
     "priceSurcarge": 0,
     "actualStartDate": "2023-12-18T14:03:07.553Z",
     "actualEndDate": "2023-12-18T14:03:07.553Z",
     "optional": true,
     "includedInPackagePrice": true
    },
   "cacheKey": "string"
  }
}

Response Body

{
"packages": [
    {
     "id": "string",
     "priceCurrency": "string",
     "totalPrice": 0,
     "agentCommissionPercent": 0,
     "agentCommissionAmount": 0,
     "includedExtrasAmount": 0,
     "priceDifference": 0,
     "hotel": {
       "hotelPriceId": "string",
       "providerId": 0,
       "hotelName": "string",
       "hotelCode": "string",
       "nigths": 0,
       "mealPlan": "string",
       "hotelClass": "string",
       "availabilityType": "OnRequest",
       "availableRoomsCount": 0,
       "fewRooms": true,
       "roomCategoryCode": "string",
       "roomCategoryName": "string",
       "placementTypeName": "string",
       "placementDescription": "string",
       "checkInDate": "2023-12-18T14:03:10.148Z",
       "checkOutDate": "2023-12-18T14:03:10.148Z",
       "adults": 0,
       "children": 0,
       "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "districtName": "string",
       "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
       "cityName": "string",
       "countryCode": "string",
       "countryName": "string",
       "hasAlcohol": true,
       "hasFreeWifi": true,
       "hasMetro": true,
       "hasPool": true,
       "hasMall": true,
       "cancellationPolicyDescription": "string",
       "cancellationPolicy": {
         "cancellationPolicyCode": "string",
         "noShowChargeValue": 0,
         "noShowChargeValueType": "string",
         "earlyDepartureChargeValue": 0,
         "earlyDepartureChargeValueType": "string",
         "conditions": [
            {
             "timeunits": 0,
             "timeunitType": "string",
             "timeOffsetTypeName": "string",
             "chargeValue": 0,
             "chargeValueType": "string"
            }
          ]
        }
      },
     "flight": {
       "id": "string",
       "departureDate": "2023-12-18T14:03:10.148Z",
       "returnDate": "2023-12-18T14:03:10.148Z",
       "departureTicketsLeft": 0,
       "returnTicketsLeft": 0,
       "departureAvailabilityType": "OnRequest",
       "returnAvailabilityType": "OnRequest",
       "isTwoWay": true,
       "departureSegments": [
          {
           "airlineCode": "string",
           "airlineName": "string",
           "flightCode": "string",
           "class": "string",
           "lugageWeight": 0,
           "handLugageWeight": 0,
           "departureFlightDate": "2023-12-18T14:03:10.148Z",
           "departureCountryName": "string",
           "departureCityName": "string",
           "departureAirportCode": "string",
           "departureAirportName": "string",
           "departureTerminalCode": "string",
           "arrivalFlightDate": "2023-12-18T14:03:10.148Z",
           "arrivalCountryName": "string",
           "arrivalCityName": "string",
           "arrivalAirportCode": "string",
           "arrivalAirportName": "string",
           "arrivalTerminalCode": "string",
           "flightDuration": "string",
           "baggages": [
              {
               "baggageCode": "string",
               "description": "string",
               "price": 0,
               "currency": "string",
               "included": true
              }
            ]
          }
        ],
       "returnSegments": [
          {
           "airlineCode": "string",
           "airlineName": "string",
           "flightCode": "string",
           "class": "string",
           "lugageWeight": 0,
           "handLugageWeight": 0,
           "departureFlightDate": "2023-12-18T14:03:10.148Z",
           "departureCountryName": "string",
           "departureCityName": "string",
           "departureAirportCode": "string",
           "departureAirportName": "string",
           "departureTerminalCode": "string",
           "arrivalFlightDate": "2023-12-18T14:03:10.148Z",
           "arrivalCountryName": "string",
           "arrivalCityName": "string",
           "arrivalAirportCode": "string",
           "arrivalAirportName": "string",
           "arrivalTerminalCode": "string",
           "flightDuration": "string",
           "baggages": [
              {
               "baggageCode": "string",
               "description": "string",
               "price": 0,
               "currency": "string",
               "included": true
              }
            ]
          }
        ]
      },
     "extraServices": [
        {
         "extraServiceCode": "string",
         "extraServiceTypeCode": "string",
         "isMandatory": 0,
         "extraServiceName": "string",
         "minimalServiceAmount": 0,
         "includedPriceCode": "string",
         "prices": [
            {
             "extraServicePriceCode": "string",
             "displayName": "string",
             "restrictionInfo": "string",
             "additionalInfo": "string",
             "price": 0,
             "extraPrice": 0,
             "currency": "string"
            }
          ]
        }
      ],
     "insurancePrice": {
       "name": "string",
       "price": 0,
       "priceSurcarge": 0,
       "actualStartDate": "2023-12-18T14:03:10.148Z",
       "actualEndDate": "2023-12-18T14:03:10.148Z",
       "optional": true,
       "includedInPackagePrice": true
      },
     "cacheKey": "string"
    }
  ]
}

example

Schema

GetOtherFlightsResponse{

packages

[
nullable: trueTourPackage{

string
nullable: true

priceCurrency

string
nullable: true

totalPrice

number($double)

agentCommissionPercent

number($double)

agentCommissionAmount

number($double)

includedExtrasAmount

number($double)

priceDifference

number($double)

hotel

PackageHotel{

hotelPriceId

string
nullable: true

providerId

integer($int32)

hotelName

string
nullable: true

hotelCode

string
nullable: true

nigths

integer($int32)

mealPlan

string
nullable: true

hotelClass

string
nullable: true

availabilityType

RoomAvailabilityTypeEnumstringEnum:
[ OnRequest, FreeSale, StopSale ]

availableRoomsCount

integer($int32)

fewRooms

boolean

roomCategoryCode

string
nullable: true

roomCategoryName

string
nullable: true

placementTypeName

string
nullable: true

placementDescription

string
nullable: true

checkInDate

string($date-time)

checkOutDate

string($date-time)

adults

integer($int32)

children

integer($int32)

districtUID

string($uuid)
nullable: true

districtName

string
nullable: true

cityUID

string($uuid)
nullable: true

cityName

string
nullable: true

countryCode

string
nullable: true

countryName

string
nullable: true

hasAlcohol

boolean

hasFreeWifi

boolean

hasMetro

boolean

hasPool

boolean

hasMall

boolean

cancellationPolicyDescription

string
nullable: true

cancellationPolicy

CancellationPolicyExchange{

cancellationPolicyCode

string
nullable: true

noShowChargeValue

number($double)
nullable: true

noShowChargeValueType

string
nullable: true

earlyDepartureChargeValue

number($double)
nullable: true

earlyDepartureChargeValueType

string
nullable: true

conditions

[
nullable: trueCancellationPolicyConditionExchange{

timeunits	integer($int32)
timeunitType	string nullable: true
timeOffsetTypeName	string nullable: true
chargeValue	number($double) nullable: true
chargeValueType	string nullable: true

}]

}

flight

PackageFlight{

string
nullable: true

departureDate

string($date-time)

returnDate

string($date-time)
nullable: true

departureTicketsLeft

integer($int32)

returnTicketsLeft

integer($int32)

departureAvailabilityType

FlightAvailabilityTypestringEnum:
[ OnRequest, FreeSale, FewPlaces, StopSale ]

returnAvailabilityType

FlightAvailabilityTypestringEnum:
[ OnRequest, FreeSale, FewPlaces, StopSale ]

isTwoWay

boolean

departureSegments

[
nullable: trueFlightSegment{

airlineCode

string
nullable: true

airlineName

string
nullable: true

flightCode

string
nullable: true

class

string
nullable: true

lugageWeight

number($double)

handLugageWeight

number($double)

departureFlightDate

string($date-time)

departureCountryName

string
nullable: true

departureCityName

string
nullable: true

departureAirportCode

string
nullable: true

departureAirportName

string
nullable: true

departureTerminalCode

string
nullable: true

arrivalFlightDate

string($date-time)

arrivalCountryName

string
nullable: true

arrivalCityName

string
nullable: true

arrivalAirportCode

string
nullable: true

arrivalAirportName

string
nullable: true

arrivalTerminalCode

string
nullable: true

flightDuration

string
nullable: true

baggages

[
nullable: trueBaggage{

baggageCode	string nullable: true
description	string nullable: true
price	number($double)
currency	string nullable: true
included	boolean

}]

returnSegments

[
nullable: trueFlightSegment{

airlineCode

string
nullable: true

airlineName

string
nullable: true

flightCode

string
nullable: true

class

string
nullable: true

lugageWeight

number($double)

handLugageWeight

number($double)

departureFlightDate

string($date-time)

departureCountryName

string
nullable: true

departureCityName

string
nullable: true

departureAirportCode

string
nullable: true

departureAirportName

string
nullable: true

departureTerminalCode

string
nullable: true

arrivalFlightDate

string($date-time)

arrivalCountryName

string
nullable: true

arrivalCityName

string
nullable: true

arrivalAirportCode

string
nullable: true

arrivalAirportName

string
nullable: true

arrivalTerminalCode

string
nullable: true

flightDuration

string
nullable: true

baggages

[
nullable: trueBaggage{

baggageCode	string nullable: true
description	string nullable: true
price	number($double)
currency	string nullable: true
included	boolean

}]

}

extraServices

[
nullable: trueHotelExtraServiceBase{

extraServiceCode

string
nullable: true

extraServiceTypeCode

string
nullable: true

isMandatory

integer($int32)

extraServiceName

string
nullable: true

minimalServiceAmount

number($double)

includedPriceCode

string
nullable: true

prices

[
nullable: trueHotelExtraServicePriceBase{

extraServicePriceCode	string nullable: true
displayName	string nullable: true
restrictionInfo	string nullable: true
additionalInfo	string nullable: true
price	number($double)
extraPrice	number($double)
currency	string nullable: true

}]

insurancePrice

InsurancePrice{

name	string nullable: true
price	number($double)
priceSurcarge	number($double)
actualStartDate	string($date-time)
actualEndDate	string($date-time)
optional	boolean
includedInPackagePrice	boolean

}

cacheKey

string
nullable: true

}]

}