6. Register Reservation

Version 4.1 by Giorgi Mdivnishvili on 2024/03/01 12:05

Contents

Method Description

Method Description

With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search.

endpoint : https://testapi.rustaronline.com/api/Reservations/RegisterReservation?agentid=test.test&agentpassword=TestP@ssw0rd

Method POST

Request example:

{
   "reservationcode":"test_2",
     "customers": [
      {
       "customercode": "1",
       "title": "Mr",
       "gender": "M",
       "firstname": "TEEEST",
       "lastname": "TEEEST",
       "birthdate": "1981-01-01T00:00:00",
       "citizenship": "RU",
       "visarequired": false,

       "phonenumber": "+70000000000",
       "email": null,
       "passportnumber": "",
       "passporttype": null,
       "issuedate": null,
       "expirydate": null,
       "issuecity": null,
       "note": null
      }
    ],
   "hotels":[
      {
       "hotelid":"da9b081d-b963-4fb7-ad19-8c375ce60da1",
       "hotelname":"Delta Hotels Istanbul Halic",
       "checkInDate": "2024-05-06T00:00:00",
         "checkOutDate": "2024-05-07T00:00:00",
       "placement":"SNGL",
       "roomcategory":"TWTW",
       "roomcategoryname":"Deluxe Guest room, 2 Twins",
       "priceid":"CVNP",
       "price": 109.44,
       "promotioncodes":null,
       "mealplan":"RO",
       "adults":1,
       "children":0,
       "infants":0,
       "hotelnote":"Deluxe, 2 Twins, Mini fridge, 23sqm/247sqft-25sqm/269sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 43in/109cm LED TV Cancellation Policy: penalty for cancellation 0-24 hours before checkin is EUR 108.37, penalty for cancellation after 12AM is EUR 108.37, penalty for NoShow is EUR 108.37",
       "customercodes":[
         "1"]
      }],
   "transfers":null,
   "hotelextras":null
  }

Definition of Request Parameters

Parameter	Value	Description
"contragentContactUID"	"55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",	A unique code assigned to each application user
"countryMask"	"TR",	Country code, which can be retrieved in Get Cities method, in parameter [countrycode]
"CheckInDate"	"2024-05-06",	Check in date "YY-MM-DD"
"CheckOutDate"	"2024-05-07",	Check out date "YY-MM-DD"
"Adults"	1,	number of Adults
"Children"	0,	Number of children
"ChildrenAges"	"",	children ages, the must be separated with ","
"priceCode"	"CVNP",
"roomCategoryCode"	"TWTW",
"hotelCode"	"da9b081d-b963-4fb7-ad19-8c375ce60da1"

In case there is need to display hotels in whole country, no mater cities, it's possible to remove "arrivalCities" parameter.

Response Example

{
   "Code": "00",
   "Message": "",
   "Timestamp": "2024-02-29T17:24:32.2398363+04:00",
   "Version": "r1",
   "ResponseID": "4a75b8da-5b95-4d97-a580-dbb837670a05",
   "Data": {
       "ReservationNumber": "18571",
       "ReservationDate": "2024-02-29T17:24:28.7",
       "ReservationStatusName": "DraftOverLimit",
       "ReservationTourists": [
            {
               "FirstName": "Teeest",
               "LastName": "Teeest",
               "ChildFlag": 0,
               "BirthDate": "1981-01-01T00:00:00",
               "CountryCode": null,
               "CountryAccessCode": null,
               "AreaCityCode": null,
               "PhoneNumber": "+70000000000",
               "Gender": "Male",
               "ArrivalDate": "2024-05-06T00:00:00",
               "ArrivalFlightNumber": "",
               "ArrivalTerminalName": null,
               "DepartureDate": "2024-05-07T00:00:00",
               "DepartureFlightNumber": "",
               "DepartureTerminalName": null,
               "Email": null,
               "PassportNumber": "",
               "PassportType": null,
               "IssueCity": null,
               "IssueDate": null,
               "ExpiryDate": null,
               "Note": null
            }
        ],
       "ReservationHotels": [
            {
               "AgentConfirmationNumber": "testGM20240229_tccapi_2",
               "CheckInDate": "2024-05-06T00:00:00",
               "CheckOutDate": "2024-05-07T00:00:00",
               "HotelName": null,
               "PriceID": "a5e45e73-eccd-43e1-b41b-e8f29a8c1dba",
               "MealPlanName": null,
               "PlacementTypeName": "SNGL",
               "Note": "Deluxe, 2 Twins, Mini fridge, 23sqm/247sqft-25sqm/269sqft, Wireless internet, complimentary, Wired internet, complimentary, Coffee/tea maker, 43in/109cm LED TV Cancellation Policy: penalty for cancellation 0-24 hours before checkin is EUR 108.37, penalty for cancellation after 12AM is EUR 108.37, penalty for NoShow is EUR 108.37"
            }
        ],
       "ReservationTransferServices": [
            {
               "TransferDate": "2024-05-06T00:00:00",
               "ServiceName": "WITHOUT",
               "FromTerminalName": "ADB",
               "ToTerminalName": null,
               "FromHotelName": null,
               "ToHotelName": "Delta Hotels Istanbul Halic",
               "VehicleTypeName": "WITHOUT"
            },
            {
               "TransferDate": "2024-05-07T00:00:00",
               "ServiceName": "WITHOUT",
               "FromTerminalName": null,
               "ToTerminalName": "ADB",
               "FromHotelName": "Delta Hotels Istanbul Halic",
               "ToHotelName": null,
               "VehicleTypeName": "WITHOUT"
            }
        ],
       "ReservationServices": []
    }
}

Definition of Response Parameters

Parameter	value	Description
{
"resultID"	1656436810005000001,	Unique ID of the Result
"hotelID"	871186,	Unique ID of the hotel
"providerID"	5,	provider id - (system internal)
"roomCategoryCode"	"ECO",	Special code for Room Category type
"roomCategoryName"	"Economic Room",	Name of the Room Category Type - definition of the "roomCategoryCode"
"mealPlanName"	"BB",	Meal Plan code
"placementType"	1,	Placement type code - in this case 1 means single
"placementTypeName"	"1 Adult",	Placement type name - definition of the "placementType"
"priceCode"	"BASERATE BB ECO",	price code for the current option
"priceCurrency"	"EUR",
"priceCurrencySrc"	"EUR",
"availability"	3,	Availability
"availableRoomsCount"	1,	Number of available rooms for the current type of options
"totalSellPriceSrc"	40.70,
"totalSellPrice"	40.70,
"totalPriceSurcharge"	0.00,
"cancellationPolicyDescription"	"Cancellation Policy Non refundable",	TEXT DESCRIPTION OF THE CANCELLATION POLICY
"cancellationPolicy"	{
"noShowChargeValue"	100.00,
"noShowChargeValueType"	"%",
"earlyDepartureChargeValue"	100.00,
"earlyDepartureChargeValueType"	"%",
"conditions"	[
{
"timeunits"	365,
"timeunitType"	"Day",
"timeOffsetTypeName"	"Before Arrival",
"chargeValue"	100.00,
"chargeValueType"	"%"
}
]
},
"searchId"	1656436810,	search id of the hotel
"hotelCode"	"10b7bc34-2a03-495e-94bc-1092b07823f7",	Unique ID of the Hotel. Full List of the hotels is available in Get Hotels method
"id"	1656436810005000001,
"hotel"	{
"hotelCode"	"10b7bc34-2a03-495e-94bc-1092b07823f7",	Unique ID of the Hotel. Full List of the hotels is available in Get Hotels method
"hotelName"	"Istanbul Holiday Hotel",	Full name of the Hotel
"hotelClass"	"***",	Hotel Class in Stars
"cityId"	"e1344ba0-5273-4fc1-b6c4-72446260f430",	Code of the city where hotel is located, which is available in method Get Cities in parameter [cityid]
"cityName"	"Istanbul",	Full Name of the City
"countryCode"	"TR",	Country code, which can be retrieved in Get Cities method, in parameter [countrycode]
"districtId"	"6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",	District unique code, where hotel is located.
"districtName"	"Fatih",	Full name of the District
"note"	""	Hotel note - this is optional
},
"adults"	1,	Number of the adults
"children"	0,	Number of the children
"childrenAges"	"",	in case of children, here will be their ages
"childrenExeptInfants"	0,
"checkInDate"	"2024-05-06T00000",	date of the check in
"checkOutDate"	"2024-05-07T00000",	date of the check out
"includedExtrasAmount"	0,
"extraServices"	[]
},