Skip to Content

Wiki source code of 7. GetReservations

Version 5.1 by Giorgi Mdivnishvili on 2024/08/16 18:18
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2
3
4 {{toc/}}
5 {{/box}}
6
7 = Method Description =
8
9
10 **Objective:** The GetReservations method is designed to retrieve a comprehensive list of past reservations along with detailed information associated with each reservation. This method is particularly useful for users who need to perform targeted data retrieval by applying specific filters. By enabling the use of parameters such as date ranges, reservation IDs, tourist information, and more, the GetReservations method allows for precise and efficient querying of reservation data. This capability streamlines the process of accessing relevant information, ensuring that users can quickly and accurately retrieve the exact data they need without sifting through unnecessary records.
11
12
13 == Endpoint URL - [POST] ==
14
15 {{info}}
16 [[https:~~/~~/integration.kazunion.com/api/Reservations/GetReservations>>https://integration.kazunion.com/api/Reservations/GetReservations]]
17 {{/info}}
18
19
20 == Request Parameters ==
21
22 (% class="box infomessage" %)
23 (((
24 None
25 )))
26
27
28 == Request Body ==
29
30 {{code language="Json"}}
31 {
32 "reservationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
33 "number": "string",
34 "checkInStart": "2024-08-16T14:13:00.686Z",
35 "checkInEnd": "2024-08-16T14:13:00.686Z",
36 "checkOutStart": "2024-08-16T14:13:00.686Z",
37 "checkOutEnd": "2024-08-16T14:13:00.686Z",
38 "registrationDateStart": "2024-08-16T14:13:00.686Z",
39 "registrationDateEnd": "2024-08-16T14:13:00.686Z",
40 "statusForAgent": "New",
41 "countryCode": "string",
42 "touristLastName": "string"
43 }
44 {{/code}}
45
46 (% class="wikigeneratedid" id="HRequestBodyexample" %)
47 (% id="cke_bm_10575S" style="display:none" %)
48
49
50
51 == Request Body example ==
52
53 {{code language="Json"}}
54 {
55
56 "registrationDateStart": "2024-06-16",
57 "registrationDateEnd": "2024-09-16"
58
59 }
60 {{/code}}
61
62
63 == Response ==
64
65 {{code language="JSON"}}
66 {
67 "pageId": 0,
68 "pagesCount": 0,
69 "reservations": [
70 {
71 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
72 "number": "string",
73 "agentConfirmationNumber": "string",
74 "registrationDate": "2024-08-16T14:13:00.703Z",
75 "packageType": "Package",
76 "status": "NotConfirmed",
77 "statusForAgent": "New",
78 "departureToCityName": "string",
79 "departureToAirlineName": "string",
80 "arrivalTime": "2024-08-16T14:13:00.703Z",
81 "arrivalCountryName": "string",
82 "departureTime": "2024-08-16T14:13:00.703Z",
83 "pickupPeriods": [
84 "string"
85 ],
86 "driverMobile": "string",
87 "paymentInOutInvCurrency": {
88 "currencyCode": "string",
89 "price": 0,
90 "netPrice": 0,
91 "paid": 0,
92 "unpaid": 0,
93 "comission": 0,
94 "comissionPercent": 0
95 },
96 "paymentInSellCurrency": {
97 "currencyCode": "string",
98 "price": 0,
99 "netPrice": 0,
100 "paid": 0,
101 "unpaid": 0,
102 "comission": 0,
103 "comissionPercent": 0
104 },
105 "showDownloadDocuments": true,
106 "guideMeetings": [
107 {
108 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
109 "meetingStartTime": "2024-08-16T14:13:00.703Z",
110 "meetingEndTime": "2024-08-16T14:13:00.703Z",
111 "hotelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
112 "hotelName": "string",
113 "guides": [
114 {
115 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
116 "name": "string",
117 "mobile": "string"
118 }
119 ]
120 }
121 ],
122 "services": [
123 {
124 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
125 "serviceDate": "2024-08-16T14:13:00.703Z",
126 "type": "Arrival",
127 "description": "string",
128 "touristIds": [
129 "string"
130 ],
131 "serviceDetails": [
132 {
133 "flightCode": "string",
134 "airlineName": "string",
135 "departureTime": "2024-08-16T14:13:00.703Z",
136 "departureCityName": "string",
137 "departureAirportCode": "string",
138 "departureTerminalCode": "string",
139 "arrivalTime": "2024-08-16T14:13:00.703Z",
140 "arrivalCityName": "string",
141 "arrivalAirportCode": "string",
142 "arrivalTerminalCode": "string",
143 "isArrivalFlight": true
144 }
145 ]
146 }
147 ],
148 "tourists": [
149 {
150 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
151 "gender": "None",
152 "ageCategory": "Adult",
153 "title": "string",
154 "firstName": "string",
155 "lastName": "string",
156 "birthDate": "2024-08-16",
157 "passportNumber": "string",
158 "passportExpiryDate": "2024-08-16",
159 "tin": "string",
160 "citizenshipCountryCode": "string",
161 "canEdit": true
162 }
163 ],
164 "documents": [
165 {
166 "type": "None",
167 "descriptions": [
168 "string"
169 ],
170 "url": "string"
171 }
172 ],
173 "invoiceUrl": "string"
174 }
175 ]
176 }
177 No links
178
179 POST
180 /api/Reservations/GetReser
181 {{/code}}
182
183
184 === Response example ===
185
186 {{code language="Json"}}
187 {
188 "pageId": 0,
189 "pagesCount": 0,
190 "reservations": [
191 {
192 "id": "07fff3fd-7ae9-409f-b50b-2cc7a948b8d0",
193 "number": "110576",
194 "agentConfirmationNumber": "",
195 "registrationDate": "2024-07-11T10:09:52.243",
196 "packageType": "Package",
197 "status": "Canceled",
198 "statusForAgent": "Canceled",
199 "departureToAirlineName": "N/A",
200 "arrivalTime": "2024-09-23T07:15:00.000",
201 "arrivalCountryName": "United Arab Emirates",
202 "departureTime": "2024-09-29T21:30:00.000",
203 "pickupPeriods": [],
204 "driverMobile": "N/A",
205 "paymentInOutInvCurrency": {
206 "price": 952.90,
207 "netPrice": 952.90,
208 "paid": 0.00,
209 "unpaid": 952.90,
210 "comission": 0.00,
211 "comissionPercent": 0
212 },
213 "paymentInSellCurrency": {
214 "currencyCode": "USD",
215 "price": 952.90,
216 "netPrice": 952.90,
217 "paid": 0.00,
218 "unpaid": 952.90,
219 "comission": 0.00,
220 "comissionPercent": 0
221 },
222 "showDownloadDocuments": false,
223 "guideMeetings": [],
224 "services": [
225 {
226 "id": "00000000-0000-0000-0000-000000000000",
227 "serviceDate": "0001-01-01T00:00:00.000",
228 "type": "Hotel",
229 "description": "N/A (N/A*) 23.09.2024 - 29.09.2024 / N/A N/A DBL",
230 "touristIds": [
231 "29236304-d23c-4999-88ec-76ac4b99b614",
232 "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c"
233 ]
234 },
235 {
236 "id": "00000000-0000-0000-0000-000000000000",
237 "serviceDate": "0001-01-01T00:00:00.000",
238 "type": "AviaTicket",
239 "touristIds": [
240 "29236304-d23c-4999-88ec-76ac4b99b614",
241 "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c"
242 ],
243 "serviceDetails": [
244 {
245 "flightCode": "FZ1721",
246 "airlineName": "N/A",
247 "departureTime": "2024-09-29T21:30:00.000",
248 "departureCityName": "Almaty",
249 "departureAirportCode": "ALA",
250 "departureTerminalCode": "DXB3",
251 "arrivalTime": "2024-09-23T07:15:00.000",
252 "arrivalCityName": "Dubai",
253 "arrivalAirportCode": "DXB",
254 "isArrivalFlight": false
255 }
256 ]
257 },
258 {
259 "id": "00000000-0000-0000-0000-000000000000",
260 "serviceDate": "0001-01-01T00:00:00.000",
261 "type": "AviaTicket",
262 "touristIds": [
263 "29236304-d23c-4999-88ec-76ac4b99b614",
264 "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c"
265 ],
266 "serviceDetails": [
267 {
268 "flightCode": "FZ1721",
269 "airlineName": "N/A",
270 "departureTime": "2024-09-29T21:30:00.000",
271 "departureCityName": "Dubai",
272 "departureAirportCode": "DXB",
273 "departureTerminalCode": "DXB3",
274 "arrivalTime": "2024-09-30T02:40:00.000",
275 "arrivalCityName": "Almaty",
276 "arrivalAirportCode": "ALA",
277 "isArrivalFlight": false
278 }
279 ]
280 },
281 {
282 "id": "97ba44e6-9158-40fe-8ec5-49626d786446",
283 "serviceDate": "0001-01-01T00:00:00.000",
284 "type": "Transfer",
285 "description": "Трансфер: Прилет Индивидуальный 23.09.2024 Dubai DXB -> Concorde Inn Hotel, Bur Dubai, United Arab Emirates",
286 "touristIds": [
287 "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c",
288 "29236304-d23c-4999-88ec-76ac4b99b614"
289 ]
290 },
291 {
292 "id": "c404e59c-6cab-491c-a3ff-f712cf74103c",
293 "serviceDate": "0001-01-01T00:00:00.000",
294 "type": "Transfer",
295 "description": "Трансфер: Вылет Индивидуальный 29.09.2024 с Concorde Inn Hotel -> DXB, Dubai United Arab Emirates",
296 "touristIds": [
297 "29236304-d23c-4999-88ec-76ac4b99b614",
298 "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c"
299 ]
300 },
301 {
302 "id": "fb8c4e42-03e8-4bb7-8fc9-2783ae664510",
303 "serviceDate": "0001-01-01T00:00:00.000",
304 "type": "Insurance",
305 "description": "Страхование: N/A (10000 USD) 23.09.2024 - 29.09.2024",
306 "touristIds": [
307 "29236304-d23c-4999-88ec-76ac4b99b614"
308 ]
309 },
310 {
311 "id": "97c32399-66b5-414b-bd88-d9c4584b22b1",
312 "serviceDate": "0001-01-01T00:00:00.000",
313 "type": "Insurance",
314 "description": "Страхование: N/A (10000 USD) 23.09.2024 - 29.09.2024",
315 "touristIds": [
316 "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c"
317 ]
318 }
319 ],
320 "tourists": [
321 {
322 "id": "29236304-d23c-4999-88ec-76ac4b99b614",
323 "gender": "Male",
324 "ageCategory": "Adult",
325 "title": "MR.",
326 "firstName": "Teeeeest",
327 "lastName": "Teeeest",
328 "birthDate": "1990-09-23T00:00:00",
329 "passportNumber": "1231233",
330 "passportExpiryDate": "2029-12-23T00:00:00",
331 "citizenshipCountryCode": "N/A",
332 "canEdit": false
333 },
334 {
335 "id": "a2e833cf-cdcd-4ff9-9c43-b63066da1f7c",
336 "gender": "Male",
337 "ageCategory": "Adult",
338 "title": "MR.",
339 "firstName": "Test",
340 "lastName": "Teeeest",
341 "birthDate": "1990-09-23T00:00:00",
342 "passportNumber": "123123",
343 "passportExpiryDate": "2029-12-23T00:00:00",
344 "citizenshipCountryCode": "N/A",
345 "canEdit": false
346 }
347 ],
348 "documents": []
349 }
350 ]
351 }
352 {{/code}}
353
354
355 === Schema ===
356
357 {{success}}
358 GetReservationDetailsResponse{
359
360 |reservation|ReservationDetails{(((
361 |id|string($uuid)
362 |rfNumber|string
363 nullable: true
364 |contactNumber|string
365 nullable: true
366 |agentName|string
367 nullable: true
368 |totalPrice|number($double)
369 |agentCommission|number($double)
370 |netPrice|number($double)
371 nullable: true
372 |currency|string
373 nullable: true
374 |tourists|[
375 nullable: trueResDetailsTourist{(((
376 |id|string($uuid)
377 |gender|GenderEnumstringEnum:
378 [ None, Male, Female ]
379 |ageCategory|AgeCategorystringEnum:
380 [ Adult, Infant, Child ]
381 |firstName|string
382 nullable: true
383 |lastName|string
384 nullable: true
385 |birthDate|string($date-time)
386 nullable: true
387 |passportNumber|string
388 nullable: true
389 |passportExpiryDate|string($date-time)
390 nullable: true
391 |tin|string
392 nullable: true
393 |citizenshipCountryCode|string
394 nullable: true
395 |citizenshipCountryName|string
396 nullable: true
397 |mobile|string
398 nullable: true
399 |email|string
400 nullable: true
401 |arrivalDate|string($date-time)
402 nullable: true
403 |arrivalFlightNumber|string
404 nullable: true
405 |arrivalTerminalCode|string
406 nullable: true
407 |returnDate|string($date-time)
408 nullable: true
409 |returnFlightNumber|string
410 nullable: true
411 |returnTerminalCode|string
412 nullable: true
413 |showReturn|boolean
414
415 }]
416 )))
417 |hotels|[
418 nullable: trueResDetailsHotel{(((
419 |id|string($uuid)
420 |hotelName|string
421 nullable: true
422 |cityName|string
423 nullable: true
424 |hotelClass|string
425 nullable: true
426 |checkInDate|string($date-time)
427 |checkOutDate|string($date-time)
428 |roomCategoryName|string
429 nullable: true
430 |placementName|string
431 nullable: true
432 |mealPlan|string
433 nullable: true
434 |agentConfirmationNumber|string
435 nullable: true
436
437 }]
438 )))
439 |flights|[
440 nullable: trueResDetailsFlight{(((
441 |id|string($uuid)
442 |isArrival|boolean
443 |touristId|string($uuid)
444 |touristName|string
445 nullable: true
446 |date|string($date-time)
447 |departureAirport|string
448 nullable: true
449 |departureTerminal|string
450 nullable: true
451 |arrivalAirport|string
452 nullable: true
453 |arrivalTerminal|string
454 nullable: true
455 |agentConfirmationNumber|string
456 nullable: true
457 |bookingConfirmationNumber|string
458 nullable: true
459 |note|string
460 nullable: true
461
462 }]
463 )))
464 |transfers|[
465 nullable: trueResDetailsTransfer{(((
466 |id|string($uuid)
467 |transferType|string
468 nullable: true
469 |vehicleName|string
470 nullable: true
471 |touristId|string($uuid)
472 |touristName|string
473 nullable: true
474 |date|string($date-time)
475 |fromTerminal|string
476 nullable: true
477 |fromCityName|string
478 nullable: true
479 |fromHotelName|string
480 nullable: true
481 |toHotelName|string
482 nullable: true
483 |toTerminal|string
484 nullable: true
485 |toCityName|string
486 nullable: true
487 |agentConfirmationNumber|string
488 nullable: true
489 |note|string
490 nullable: true
491
492 }]
493 )))
494 |services|[
495 nullable: trueResDetailsService{(((
496 |id|string($uuid)
497 |serviceDate|string($date-time)
498 |serviceName|string
499 nullable: true
500 |touristId|string($uuid)
501 |touristName|string
502 nullable: true
503 |note|string
504 nullable: true
505
506 }]
507 )))
508
509 }
510 )))
511
512 }
513 {{/success}}
514
515
516 == Description ==
517
518
519 (% class="table-bordered" %)
520 |=Parameter|=Value Type|=Description
521 |id|String|The unique identifier for the reservation, typically a UUID or similar.
522 |rfNumber|String|The reference number for the reservation, usually generated by the system.
523 |contactNumber|String|The contact number associated with the reservation, used for communication purposes.
524 |agentName|String|The name of the agent who made the reservation, useful for tracking and accountability.
525 |totalPrice|Number|The total price of the reservation, calculated based on the services and products included.
526 |agentCommission|Number|The commission earned by the agent for this reservation, calculated as a percentage of the total price.
527 |currency|String|The currency in which the price and commission are denominated, typically in ISO 4217 format (e.g., USD, EUR).
528 |tourists[].id|String|The unique identifier for each tourist, typically a UUID.
529 |tourists[].gender|String|The gender of the tourist, usually : [ None, Male, Female ]
530 |tourists[].ageCategory|String|The age category of the tourist, such as 'Adult', 'Child', or 'Infant'.
531 |tourists[].firstName|String|The first name of the tourist, as it appears on their passport.
532 |tourists[].lastName|String|The last name of the tourist, as it appears on their passport.
533 |tourists[].birthDate|String (Date)|The birth date of the tourist, typically in ISO 8601 format (YYYY-MM-DD).
534 |tourists[].passportNumber|String|The passport number of the tourist, as it appears on their passport.
535 |tourists[].passportExpiryDate|String (Date)|The expiry date of the tourist's passport, typically in ISO 8601 format (YYYY-MM-DD).
536 |tourists[].citizenshipCountryCode|String|The ISO 3166-1 alpha-2 code of the tourist's country of citizenship (e.g., US, GB).
537 |tourists[].citizenshipCountryName|String|The full name of the tourist's country of citizenship.
538 |tourists[].arrivalDate|String (Date)|The date of the tourist's arrival, typically in ISO 8601 format (YYYY-MM-DD).
539 |tourists[].arrivalFlightNumber|String|The flight number for the tourist's arrival, as provided by the airline.
540 |tourists[].arrivalTerminalCode|String|The terminal code for the tourist's arrival, as provided by the airport.
541 |tourists[].returnDate|String (Date)|The date of the tourist's return, typically in ISO 8601 format (YYYY-MM-DD).
542 |tourists[].returnFlightNumber|String|The flight number for the tourist's return, as provided by the airline.
543 |tourists[].returnTerminalCode|String|The terminal code for the tourist's return, as provided by the airport.
544 |tourists[].showReturn|Boolean|A boolean indicating whether the return information should be displayed, useful for one-way trips.
545 |hotels[].id|String|The unique identifier for each hotel booking, typically a UUID or similar.
546 |hotels[].hotelName|String|The name of the hotel where the booking is made.
547 |hotels[].cityName|String|The city where the hotel is located.
548 |hotels[].hotelClass|String|The class or rating of the hotel, such as '3-star', '4-star', '5-star', etc.
549 |hotels[].checkInDate|String (Date)|The check-in date for the hotel booking, typically in ISO 8601 format (YYYY-MM-DD).
550 |hotels[].checkOutDate|String (Date)|The check-out date for the hotel booking, typically in ISO 8601 format (YYYY-MM-DD).
551 |hotels[].roomCategoryName|String|The category of the room booked, such as 'Standard', 'Deluxe', 'Suite', etc.
552 |hotels[].placementName|String|The type of placement, such as 'DBL' for double room, 'SGL' for single room, etc.
553 |hotels[].mealPlan|String|The meal plan for the hotel booking, such as 'RO' for Room Only, 'BB' for Bed and Breakfast, etc.
554 |flights[].id|String|The unique identifier for each flight, typically a UUID or similar.
555 |flights[].isArrival|Boolean|A boolean indicating whether this flight is an arrival flight, useful for distinguishing between arrival and departure flights.
556 |flights[].touristId|String|The id of the tourist taking this flight, linking the flight to a specific tourist.
557 |flights[].touristName|String|The name of the tourist taking this flight, useful for passenger lists.
558 |flights[].date|String (Date)|The date and time of the flight, typically in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
559 |flights[].departureAirport|String|The IATA code of the airport from which the flight departs (e.g., JFK, LHR).
560 |flights[].departureTerminal|String|The terminal from which the flight departs, as provided by the airport.
561 |flights[].arrivalAirport|String|The IATA code of the airport at which the flight arrives (e.g., JFK, LHR).
562 |flights[].arrivalTerminal|String|The terminal at which the flight arrives, as provided by the airport.
563 |flights[].note|String|Any additional notes about the flight, such as 'Overnight flight', 'Meal included', etc.
564 |transfers[].id|String|The unique identifier for each transfer, typically a UUID or similar.
565 |transfers[].transferType|String|The type of transfer, such as 'ARRIVAL' for airport to hotel transfers, 'DEPARTURE' for hotel to airport transfers.
566 |transfers[].vehicleName|String|The name of the vehicle used for the transfer, such as 'Private Car', 'Shared Shuttle', etc.
567 |transfers[].touristId|String|The id of the tourist using this transfer, linking the transfer to a specific tourist.
568 |transfers[].touristName|String|The name of the tourist using this transfer, useful for passenger lists.
569 |transfers[].date|String (Date)|The date and time of the transfer, typically in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
570 |transfers[].fromTerminal|String|The terminal from which the transfer starts, as provided by the airport or hotel.
571 |transfers[].fromCityName|String|The city from which the transfer starts.
572 |transfers[].toHotelName|String|The hotel to which the transfer goes.
573 |transfers[].toCityName|String|The city to which the transfer goes.
574 |transfers[].note|String|Any additional notes about the transfer, such as 'Private transfer', 'Shared transfer', etc.
575 |services[].id|String|The unique identifier for each service, typically a UUID or similar.
576 |services[].serviceDate|String (Date)|The date and time of the service, typically in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
577 |services[].serviceName|String|The name of the service, such as insurance in this example.
578 |services[].touristId|String|The id of the tourist using this service, linking the service to a specific tourist.
579 |services[].touristName|String|The name of the tourist using this service, useful for booking confirmations.