Changes for page 4. Hotel Search
Last modified by Giorgi Mdivnishvili on 2024/09/04 09:58
From version 19.1
edited by Giorgi Mdivnishvili
on 2024/02/29 11:02
on 2024/02/29 11:02
Change comment:
There is no comment for this version
To version 6.1
edited by Giorgi Mdivnishvili
on 2024/02/27 16:41
on 2024/02/27 16:41
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,12 +2,5 @@ 1 -{{box cssClass="floatinginfobox" title="**Contents**"}} 2 2 3 3 4 -{{toc/}} 5 -{{/box}} 6 - 7 -= Method Description = 8 - 9 - 10 10 With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search. 11 11 12 12 ... ... @@ -14,232 +14,29 @@ 14 14 15 15 Method POST 16 16 10 +**Request example:** 17 17 18 - 19 -== **Request example:** == 20 - 21 21 {{code language="Json"}} 22 22 { 23 - "MaxResultCount": 2,24 - "MaxHotelCount": 2,25 - " contragentContactUID":"55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",26 - "c ountryMask":"TR",27 - "Check InDate":"2024-05-06",28 - " CheckOutDate":"2024-05-07",29 - " Adults":1,30 - "Children": 0,31 - "C hildrenAges":"",32 - 14 + "MaxResultCount":50, 15 + "MaxHotelCount":10, 16 + "ContragentContactUID":"55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e", 17 + "CheckInDate":"2023-12-25T00:00:00", 18 + "CheckOutDate":"2024-01-02T00:00:00", 19 + "Adults":1, 20 + "Children":2, 21 + "ChildrenAges":"5,10", 22 + "CountryMask":"AE", 23 + 33 33 "arrivalCities": [ 34 34 { 35 - "cityUID": " e1344ba0-5273-4fc1-b6c4-72446260f430"26 + "cityUID": "f5185fa3-3f56-44ed-bf6b-80386a33caa2" 36 36 37 37 } 38 38 ] 39 -} 40 40 41 -{{/code}} 42 - 43 - 44 -(% class="table-bordered" %) 45 -(% class="info" %)|**Parameter**|**Value**|**Description** 46 -|** "MaxResultCount"**|2,|Maximum number of results to display 47 -|** "MaxHotelCount"**|2,|Maximum number of hotels to display results 48 -|** "contragentContactUID"**| "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",|A unique code assigned to each application user 49 -|** "countryMask"**| "TR",|Country code, which can be retrieved in [[Get Cities>>Get Cities]] method, in parameter [countrycode] 50 -|** "CheckInDate"**| "2024-05-06",|Check in date "YY-MM-DD" 51 -|** "CheckOutDate"**| "2024-05-07",|Check out date "YY-MM-DD" 52 -|** "Adults"**| 1,|number of Adults 53 -|** "Children"**| 0,|Number of children 54 -|** "ChildrenAges"**| "",|children ages, the must be separated with "," 55 -|** "cityUID"**| "e1344ba0-5273-4fc1-b6c4-72446260f430"|Code of the city, which is available in method [[Get Cities>>Get Cities]] in parameter [cityid] 56 - 57 -== == 58 - 59 -(% class="wikigeneratedid" %) 60 -In case there is need to display hotels in whole country, no mater cities, it's possible to remove "arrivalCities" parameter. 61 - 62 - 63 -== Response Example == 64 - 65 - 66 -{{code language="json"}} 67 -{ 68 - "result": [ 69 - { 70 - "resultID": 1656436810005000001, 71 - "hotelID": 871186, 72 - "providerID": 5, 73 - "roomCategoryCode": "ECO", 74 - "roomCategoryName": "Economic Room", 75 - "mealPlanName": "BB", 76 - "placementType": 1, 77 - "placementTypeName": "1 Adult", 78 - "priceCode": "BASERATE BB ECO", 79 - "priceCurrency": "EUR", 80 - "priceCurrencySrc": "EUR", 81 - "availability": 3, 82 - "availableRoomsCount": 1, 83 - "totalSellPriceSrc": 40.70, 84 - "totalSellPrice": 40.70, 85 - "totalPriceSurcharge": 0.00, 86 - "cancellationPolicyDescription": "Cancellation Policy: Non refundable", 87 - "cancellationPolicy": { 88 - "noShowChargeValue": 100.00, 89 - "noShowChargeValueType": "%", 90 - "earlyDepartureChargeValue": 100.00, 91 - "earlyDepartureChargeValueType": "%", 92 - "conditions": [ 93 - { 94 - "timeunits": 365, 95 - "timeunitType": "Day", 96 - "timeOffsetTypeName": "Before Arrival", 97 - "chargeValue": 100.00, 98 - "chargeValueType": "%" 99 - } 100 - ] 101 - }, 102 - "searchId": 1656436810, 103 - "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7", 104 - "id": 1656436810005000001, 105 - "hotel": { 106 - "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7", 107 - "hotelName": "Istanbul Holiday Hotel", 108 - "hotelClass": "***", 109 - "cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430", 110 - "cityName": "Istanbul", 111 - "countryCode": "TR", 112 - "districtId": "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62", 113 - "districtName": "Fatih", 114 - "note": "" 115 - }, 116 - "adults": 1, 117 - "children": 0, 118 - "childrenAges": "", 119 - "childrenExeptInfants": 0, 120 - "checkInDate": "2024-05-06T00:00:00", 121 - "checkOutDate": "2024-05-07T00:00:00", 122 - "includedExtrasAmount": 0, 123 - "extraServices": [] 124 - }, 125 - { 126 - "resultID": 1656436810005000003, 127 - "hotelID": 871186, 128 - "providerID": 5, 129 - "roomCategoryCode": "STANDART-2", 130 - "roomCategoryName": "Standart Double or Twin Room", 131 - "mealPlanName": "BB", 132 - "placementType": 1, 133 - "placementTypeName": "1 Adult", 134 - "priceCode": "BASERATE BB STANDART", 135 - "priceCurrency": "EUR", 136 - "priceCurrencySrc": "EUR", 137 - "availability": 3, 138 - "availableRoomsCount": 1, 139 - "totalSellPriceSrc": 53.90, 140 - "totalSellPrice": 53.90, 141 - "totalPriceSurcharge": 0.00, 142 - "cancellationPolicyDescription": "Cancellation Policy: Non refundable", 143 - "cancellationPolicy": { 144 - "noShowChargeValue": 100.00, 145 - "noShowChargeValueType": "%", 146 - "earlyDepartureChargeValue": 100.00, 147 - "earlyDepartureChargeValueType": "%", 148 - "conditions": [ 149 - { 150 - "timeunits": 365, 151 - "timeunitType": "Day", 152 - "timeOffsetTypeName": "Before Arrival", 153 - "chargeValue": 100.00, 154 - "chargeValueType": "%" 155 - } 156 - ] 157 - }, 158 - "searchId": 1656436810, 159 - "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7", 160 - "id": 1656436810005000003, 161 - "hotel": { 162 - "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7", 163 - "hotelName": "Istanbul Holiday Hotel", 164 - "hotelClass": "***", 165 - "cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430", 166 - "cityName": "Istanbul", 167 - "countryCode": "TR", 168 - "districtId": "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62", 169 - "districtName": "Fatih", 170 - "note": "" 171 - }, 172 - "adults": 1, 173 - "children": 0, 174 - "childrenAges": "", 175 - "childrenExeptInfants": 0, 176 - "checkInDate": "2024-05-06T00:00:00", 177 - "checkOutDate": "2024-05-07T00:00:00", 178 - "includedExtrasAmount": 0, 179 - "extraServices": [] 180 - } 181 - ], 182 - "error": false 183 183 } 184 184 {{/code}} 185 185 186 186 187 - 188 -(% class="table-bordered" %) 189 -(% class="info" %)|**Parameter**|**value**|**Description** 190 -|**{**| | 191 -|** "resultID"**| 1656436810005000001,|Unique ID of the Result 192 -|** "hotelID"**| 871186,|Unique ID of the hotel 193 -|** "providerID"**| 5,|provider id - (system internal) 194 -|** "roomCategoryCode"**| "ECO",|Special code for Room Category type 195 -|** "roomCategoryName"**| "Economic Room",|Name of the Room Category Type - definition of the ** "roomCategoryCode"** 196 -|** "mealPlanName"**| "BB",|Meal Plan code 197 -|** "placementType"**| 1,|Placement type code - in this case 1 means single 198 -|** "placementTypeName"**| "1 Adult",|Placement type name - definition of the ** "placementType"** 199 -|** "priceCode"**| "BASERATE BB ECO",|price code for the current option 200 -|** "priceCurrency"**| "EUR",| 201 -|** "priceCurrencySrc"**| "EUR",| 202 -|** "availability"**| 3,|Availability 203 -|** "availableRoomsCount"**| 1,|Number of available rooms for the current type of options 204 -|** "totalSellPriceSrc"**| 40.70,| 205 -|** "totalSellPrice"**| 40.70,| 206 -|** "totalPriceSurcharge"**| 0.00,| 207 -|** "cancellationPolicyDescription"**| "Cancellation Policy Non refundable",|TEXT DESCRIPTION OF THE CANCELLATION POLICY 208 -|** "cancellationPolicy"**| {| 209 -|** "noShowChargeValue"**| 100.00,| 210 -|** "noShowChargeValueType"**| "%",| 211 -|** "earlyDepartureChargeValue"**| 100.00,| 212 -|** "earlyDepartureChargeValueType"**| "%",| 213 -|** "conditions"**| [| 214 -|** {**| | 215 -|** "timeunits"**| 365,| 216 -|** "timeunitType"**| "Day",| 217 -|** "timeOffsetTypeName"**| "Before Arrival",| 218 -|** "chargeValue"**| 100.00,| 219 -|** "chargeValueType"**| "%"| 220 -|** }**| | 221 -|** ]**| | 222 -|** },**| | 223 -|** "searchId"**| 1656436810,|search id of the hotel 224 -|** "hotelCode"**| "10b7bc34-2a03-495e-94bc-1092b07823f7",|Unique ID of the Hotel. Full List of the hotels is available in [[Get Hotels>>Get Hotels]] method 225 -|** "id"**| 1656436810005000001,| 226 -|** "hotel"**| {| 227 -|** "hotelCode"**| "10b7bc34-2a03-495e-94bc-1092b07823f7",| 228 -|** "hotelName"**| "Istanbul Holiday Hotel",| 229 -|** "hotelClass"**| "~*~**",| 230 -|** "cityId"**| "e1344ba0-5273-4fc1-b6c4-72446260f430",| 231 -|** "cityName"**| "Istanbul",| 232 -|** "countryCode"**| "TR",| 233 -|** "districtId"**| "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",| 234 -|** "districtName"**| "Fatih",| 235 -|** "note"**| ""| 236 -|** },**| | 237 -|** "adults"**| 1,| 238 -|** "children"**| 0,| 239 -|** "childrenAges"**| "",| 240 -|** "childrenExeptInfants"**| 0,| 241 -|** "checkInDate"**| "2024-05-06T00000",| 242 -|** "checkOutDate"**| "2024-05-07T00000",| 243 -|** "includedExtrasAmount"**| 0,| 244 -|** "extraServices"**| []| 245 -|** },**| | 35 +