Reservation
8 min
request this interface is used to confirm a reservation please note that rates and inventory may change between the availability response and reservation confirmation stages in such a situation the system would return an appropriate response message the table below describes the elements present in a request along with details around their implementation please take special note of required fields primary information endpoint {{endpoint reservation}} element group element name type req element description reservationrequest reservationrequest group yes reservationrequest control group yes control username element yes the user identifier assigned this is the unique id given to you by bonotel control password element yes the password assigned this is the unique password given to you by bonotel reservationrequest reservationdetails group yes reservationdetails timestamp attribute yes the current time stamp of the request (yyyymmddthh\ mm\ ss) reservationdetails confirmationtype element yes always con reservationdetails touroperatorordernumber element yes reference number of the tour operator booking maximum length 100 characters no special characters reservationdetails checkin element yes check in date reservationdetails checkout element yes check out date reservationdetails noofrooms element yes no of rooms booked reservationdetails noofnights element yes no of nights booked reservationdetails hotelcode element yes the selected hotel code reservationdetails total element yes the total value of this reservation (including taxes) total currency attribute yes the currency of the total reservation always usd reservationrequest totaltax element yes the total tax associated with the reservation always 0 00 tax is included with the rates totaltax currency element yes the currency of the tax room data element group element name type req element description reservationrequest roomdata group yes the room’s details, this should be repeated up to the no of rooms roomdata roomno element yes the room no selected roomdata roomcode element yes the room code assigned by bonotel roomdata roomtypecode element yes room type code roomdata bedtypecode element yes bed type code roomdata rateplancode element yes rate plan code roomdata noofadults element yes no of adults for this room roomdata noofchildren element yes no of children for this room roomdata occupancy group yes occupancy details are wrapped with in this group occupancy guest group yes occupancy group for this room note that the no of adults and children should be represented by this occupancy guest data element group element name type req element description guest title element yes title of the guest, applicable only for adults list of titles list of titles \["dr ", "prof ", "mstr ", "mr ", "miss ", "ms ", "mrs ", "mr/mrs "] guest firstname element yes first name of the guest number of characters should be equal or less than 100 primary guest name is required ‘tba’ and single letter names are not accepted guest lastname element yes last name of the guest number of characters should be equal or less than 100 primary guest name is required ‘tba’ and single letter names are not accepted guest age element no age of the guest applicable only for children this should not be sent in case of an adult hotels have different child age cutoffs, but all are less than 18 do not send an age for any occupant provided as an adult in the noofadults element in room data section reservationrequest comment group yes comment hotel element yes any comments for internal use do not enter special requests for the hotel leave blank when there are no comments comment customer element yes any comments/special requests to be sent to the hotel leave blank when there are no comments note some hotels do not accept special requests we recommend to send this element closed with no value response element group element name type req element description reservationresponse reservationresponse group yes reservationresponse status attribute yes status of the reservation valid values are y – reservation processed successfully n – reservation was unsuccessful reservationresponse errors group no errors code element no an internal error code provided by bonotel errors description element no a message describing the error reservationresponse referenceno element yes your booking confirmation number reservationresponse roomreferencedetails group no room wise reference details roomreferencedetails roomreferenceno element no reference no of the room roomreferenceno roomno attribute no room no of the room code example request {{endpoint reservation}} \<?xml version="1 0" encoding="utf 8" ?> \<reservationrequest> 	\<control> 	 \<username>{{username}}\</username> 	 \<password>{{password}}\</password> 	\</control> 	\<reservationdetails timestamp="20150325t13 57 46"> 	 \<confirmationtype>con\</confirmationtype> 	 \<touroperatorordernumber>123456\</touroperatorordernumber> 	 \<checkin>01 dec 2024\</checkin> 	 \<checkout>03 dec 2024\</checkout> 	 \<noofrooms>1\</noofrooms> 	 \<noofnights>2\</noofnights> 	 \<hotelcode>1\</hotelcode> 	 \<total currency="usd">1262 01\</total> 	 \<totaltax currency="usd">0 0\</totaltax> 	 \<roomdata> 	 \<roomno>1\</roomno> 	 \<roomcode>1385\</roomcode> 	 \<roomtypecode>246\</roomtypecode> 	 \<bedtypecode>10\</bedtypecode> 	 \<rateplancode>1\</rateplancode> 	 \<noofadults>2\</noofadults> 	 \<noofchildren>0\</noofchildren> 	 \<occupancy> 	 \<guest> 	 \<title>mr \</title> 	 \<firstname>testfirst1n\</firstname> 	 \<lastname>testlast1n\</lastname> 	 \</guest> 	 \<guest> 	 \<title>mrs \</title> 	 \<firstname>testfirst2n\</firstname> 	 \<lastname>testlast2n\</lastname> 	 \</guest> 	 \</occupancy> 	 \</roomdata> 	 \<comment> 	 \<hotel> \</hotel> 	 \<customer> ground floor, non smoking \</customer> 	 \</comment> 	\</reservationdetails> \</reservationrequest> response \<?xml version="1 0" encoding="utf 8" ?> \<reservationresponse status="y"> 	\<referenceno>prgfouscg\</referenceno> 	\<roomreferencedetails> 	 \<roomreferenceno roomno="1"> prgfouscg 1\</roomreferenceno> 	\</roomreferencedetails> \</reservationresponse> response codes code description r1 unspecified error please contact customer support r2 user id not supplied or not valid r3 inventory has expired you will need to retry the reservation r4 wrong rates or rates have changed you will need to retry the reservation r5 inventory has expired and the rates have changed you will need to retry the reservation r6 arrival or departure date format incorrect r7 erroneous or incomplete data in reservation request r8 incorrect hotel id / room type id/ bed type id/ rate plan id combination r9 occupancy details do not match with the number of rooms r10 mandatory customer details field is missing or having an incorrect format r11 you are attempting to book more than the maximum number of bookings per day for the same booking criteria the maximum number of bookings allowed is 10 per day for the same booking criteria please contact us for further clarification r12 error code no longer in use r13 no xml input detected r14 this booking cannot be confirmed due to restrictions r15 the number of nights does not match the check in date and the checkout date r16 (deprecated) r17 no of child is not matching the child age details provided in the guest occupancy details r18 room no (#) cannot be occupied with the given number of adults and children r19 tour operator order number element is exceeded the characters limit r20 reservations require a minimum of one adult per room r21 (deprecated) r22 the xml request has not been completed within your timeout period please try again r23 character limit for the guest name has exceeded first name or last name should be less than or equal to 100 characters r24 error while saving reservation please try again later r25 multiple rate type or multiple inventory type information are not present in the request r26 children count is not matching with child age details provided r27 please check, rate must be more than zero r28 hotel does not have a valid contract for checkin and check out date r29 room net rate is less than the threshold value r31 this booking has failed, please try your booking again later, or contact bonotel reservations directly r32 this booking cannot be made due to different roomtypes or rateplans combinations