Skip to Content

Changes for page 1. SearchTourPackages

Last modified by Giorgi Mdivnishvili on 2025/10/22 15:30
From version 52.1
edited by Giorgi Mdivnishvili
on 2025/10/22 13:08
Change comment: There is no comment for this version
To version 55.1
edited by Giorgi Mdivnishvili
on 2025/10/22 15:30
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -19,8 +19,20 @@
19 19  
20 20  * **Parameter Usage**: To query package data, the system utilizes the following parameters within the request payload:
21 21  ** nights: Defines the minimum duration of stay (in days) as part of the tour package. The value is set to 0 by default, indicating no minimum duration constraint.
22 -** nightsTo: Specifies the maximum duration of stay (in nights) allowable within the package offerings. A default value of 0 implies no maximum limit; however, the system enforces a maximum duration difference of 7 days between nights and nightsTo.
22 +** nightsTo: Specifies the maximum duration of stay (in nights) allowable within the package offerings. A default value of 0 implies no maximum limit; however, the system enforces a maximum duration difference of 7 days between nights and nightsTo.(((
23 +=== ===
24 +)))
23 23  
26 +**Date Parameters**
27 +
28 +* **checkInDate** — the date when the guest checks into the hotel.
29 +* **checkOutDate** — the date of departure from the hotel (the last day of stay).
30 +* (((
31 +If only these two parameters are specified during the search, the system will automatically select flight options that correspond to the hotel stay dates.
32 +
33 +In cases where a user wants a longer trip — for example, a **10-day tour** with only **5 days at the hotel** — they can specify flight dates (**departureDate** and **returnDate**) separately from hotel stay dates (**checkInDate** and **checkOutDate**).
34 +)))
35 +
24 24  **Constraints:**
25 25  
26 26  * The system imposes a constraint wherein the difference between nights and nightsTo cannot exceed 7 days. This limit is designed to refine search results and maintain query performance.
... ... @@ -781,12 +781,12 @@
781 781  
782 782  (% class="table-bordered" %)
783 783  |=Field|=Type|=Description
784 -|departureCountryCode|string|The ISO 3166-1 alpha-2 country code for the departure country. For example, "KZ" for Kazakhstan.
785 -|departureCityUID|string|The unique identifier for the departure city.
786 -|arrivalCountryCode|string|The ISO 3166-1 alpha-2 country code for the arrival country. For example, "AE" for United Arab Emirates.
796 +|departureCountryCode|string|The ISO 3166-1 alpha-2 country code for the departure country. For example, "KZ" for Kazakhstan.  **Mandatory**
797 +|departureCityUID|string|The unique identifier for the departure city. **Mandatory**
798 +|arrivalCountryCode|string|The ISO 3166-1 alpha-2 country code for the arrival country. For example, "AE" for United Arab Emirates. **Mandatory**
787 787  |arrivalLocations|array|An array of objects, each representing an arrival location. Each object contains: type (string) - The type of the location. This can be "city". label (string) - The name of the location. value (string) - The unique identifier for the location. tag (string) - A tag for the location.
788 -|checkInDate|string|The check-in date in ISO 8601 format.
789 -|checkInDateTo|string|The latest possible check-in date in ISO 8601 format.
800 +|checkInDate|string|The check-in date in ISO 8601 format. - **Mandatory**
801 +|checkInDateTo|string|The latest possible check-in date in ISO 8601 format. **Mandatory**
790 790  |nights|integer|The minimum number of days to stay.
791 791  |nightsTo|integer|The maximum number of days to stay.
792 792  |airlineCode|string|The code of the airline. This field can be empty.
... ... @@ -793,9 +793,9 @@
793 793  |ticketType|string|The type of the ticket. This field can be empty. definition of avia tickets classes. enum: F - First, B - Business, P = Premium, C - Coach
794 794  |directFlightsOnly|boolean|Indicates whether to search for direct flights only.
795 795  |longConnectTime|boolean|Indicates whether to include flights with long connection times.
796 -|adults|integer|The number of adults.
797 -|children|integer|The number of children.
798 -|childrenAges|array|An array of integers, each representing the age of a child.
808 +|adults|integer|The number of adults. **Mandatory**
809 +|children|integer|The number of children. **Mandatory**
810 +|childrenAges|array|An array of integers, each representing the age of a child.
799 799  |extendedSearch|boolean|Indicates whether to perform an extended search.
800 800  |totalPriceFrom|float|The minimum total price.
801 801  |totalPriceTo|float|The maximum total price.