Pre-Booking

{ "name" "pre booking api", "method" "post", "url" "https //wspull bakuun com/v2/booking/xxxxx/xxxxx", "description" "during the pre booking process, the partner must send the booking data without a reservation id, as the booking is not yet confirmed \nin response, we will generate and return a unique token code for that pre booking each token is valid for 2 minutes \n\nto confirm the booking, you must resend the same token code together with your reservation id \nif the token is missing, invalid, or expired, the reservation request will be rejected \n\nonce we receive the reservation data together with a valid token code, we will create the booking in our system and return a success response \n\nall pre bookings are initially created with the status “new ”", "tab" "examples", "examples" { "languages" \[ { "id" "lwdxjbvcq70iisuuysqtj", "language" "json", "code" "{\n \\"username\\" \\"rdkxxx\\",\n \\"password\\" \\"rdkxxx\\",\n \\"tokenid\\" \\"98f51e05fe012a890f55609886201221\\",\n \\"partnerid\\" \\"rdkxxx\\",\n \\"partnername\\" \\"vesper hotel\\",\n \\"action\\" \\"getbooking\\",\n \\"hotelreservation\\" \[\n {\n \\"hotelcode\\" \\"htlxxx xx\\", \n \\"hotelname\\" \\"vesper hotel\\",\n \\"resstatus\\" \\"new\\",\n \\"checkin\\" \\"2022 12 23t15 00\\",\n \\"checkout\\" \\"2022 12 25t15 00\\",\n \\"paymentmethod\\" \\"vcc\\",\n \\"ratetype\\" \\"bar\\",\n \\"currencycode\\" \\"rub\\",\n \\"totaladult\\" \\"2\\",\n \\"totalchild\\" \\"2\\",\n \\"childages\\" \[\n 3,\n 6\n ],\n \\"roomstays\\" \[ \n {\n \\"occupancyrefid\\" \\"2\\",\n \\"roomtypeid\\" \\"rxxx x x\\",\n \\"roomname\\" \\"budget single room\\",\n \\"rateplanid\\" \\"rxxx x x x\\",\n \\"cancelpolicy\\" \\"non refundable\\",\n \\"numberofunits\\" \\"2\\",\n \\"mealslncluded\\" \\"breakfast\\",\n \\"adultcount\\" \\"2\\",\n \\"childcount\\" \\"2\\",\n \\"childages\\" \[\n \\"3\\",\n \\"6\\"\n ], \n \\"commission\\" \\"5 00\\", \n \\"roomindex\\" \\"1\\",\n \\"resguestrph\\" \\"1\\",\n \\"bookingperdayprices\\" \[\n {\n \\"dateymd\\" \\"2022 12 23\\",\n \\"price\\" \\"110 00\\"\n },\n {\n \\"dateymd\\" \\"2022 12 24\\",\n \\"price\\" \\"190 00\\"\n }\n ],\n \\"total\\" {\n \\"amountaftertaxes\\" \\"600 00\\",\n \\"amountbeforetaxes\\" \\"600 00\\"\n },\n \\"mealsexcluded\\" {\n \\"mealsexlcudedperdayprices\\" \[\n {\n \\"dateymd\\" \\"2022 12 23\\",\n \\"excludedmeals\\" \\"breakfast,lunch,dinner\\",\n \\"breakfastchargeinfo\\" \[\n {\n \\"agequalifying\\" \\"adult\\",\n \\"mealsperunit\\" \\"100 00\\",\n \\"mealperday\\" \\"300 00\\",\n \\"adultmealcount\\" \\"3\\"\n },\n {\n \\"agequalifying\\" \\"child\\",\n \\"mealsperunit\\" \\"100 00\\",\n \\"mealperday\\" \\"300 00\\",\n \\"childmealcount\\" \\"2\\",\n \\"child ages\\" \[\n 3,\n 6\n ]\n },\n {\n \\"agequalifying\\" \\"infant\\",\n \\"mealsperunit\\" \\"null\\",\n \\"mealperday\\" \\"null\\",\n \\"infantmealcount\\" \\"2\\",\n \\"infant ages\\" \[\n 3,\n 6\n ]\n }\n ],\n \\"lunchchargeinfo\\" \[\n {\n \\"agequalifying\\" \\"adult\\",\n \\"mealsperunit\\" \\"100 00\\",\n \\"mealperday\\" \\"300 00\\",\n \\"adultmealcount\\" \\"3\\"\n },\n {\n \\"agequalifying\\" \\"child\\",\n \\"mealsperunit\\" \\"100 00\\",\n \\"mealperday\\" \\"300 00\\",\n \\"childmealcount\\" \\"2\\",\n \\"child ages\\" \[\n 3,\n 6\n ]\n },\n {\n \\"agequalifying\\" \\"infant\\",\n \\"mealsperunit\\" \\"null\\",\n \\"mealperday\\" \\"null\\",\n \\"infantmealcount\\" \\"2\\",\n \\"infant ages\\" \[\n 3,\n 6\n ]\n }\n ],\n \\"dinnerchargeinfo\\" \[\n {\n \\"agequalifying\\" \\"adult\\",\n \\"mealsperunit\\" \\"100 00\\",\n \\"mealperday\\" \\"300 00\\",\n \\"adultmealcount\\" \\"3\\"\n },\n {\n \\"agequalifying\\" \\"child\\",\n \\"mealsperunit\\" \\"100 00\\",\n \\"mealperday\\" \\"300 00\\",\n \\"childmealcount\\" \\"2\\",\n \\"child ages\\" \[\n 3,\n 6\n ]\n },\n {\n \\"agequalifying\\" \\"infant\\",\n \\"mealsperunit\\" \\"null\\",\n \\"mealperday\\" \\"null\\",\n \\"infantmealcount\\" \\"2\\",\n \\"infant ages\\" \[\n 3,\n 6\n ]\n }\n ]\n }\n ]\n },\n \\"roomincservices\\" \[\n {\n \\"serviceid\\" \\"123\\",\n \\"servicename\\" \\"servicename\\"\n },\n {\n \\"serviceid\\" \\"234\\",\n \\"servicename\\" \\"servicename\\"\n }\n ],\n \\"roomextraservices\\" \[\n {\n \\"serviceid\\" \\"123\\",\n \\"servicename\\" \\"servicefirst\\",\n \\"serviceschargeinfo\\" \[\n {\n \\"agequalifying\\" \\"adult\\",\n \\"extraadultcount\\" \\"3\\",\n \\"extrarate\\" \\"10 00\\",\n \\"totalextraamount\\" \\"30 00\\"\n },\n {\n \\"agequalifying\\" \\"child\\",\n \\"extrachildrate\\" \\"10 00\\",\n \\"totalextraamount\\" \\"30 00\\",\n \\"childextracount\\" \\"2\\",\n \\"child ages\\" \[\n 3,\n 6\n ]\n },\n {\n \\"agequalifying\\" \\"infant\\",\n \\"extrainfantrate\\" \\"10 00\\",\n \\"totalextraamount\\" \\"30 00\\",\n \\"childinfantcount\\" \\"3\\",\n \\"child ages\\" \[\n 3,\n 3,\n 6\n ]\n }\n ]\n },\n {\n \\"serviceid\\" \\"343\\",\n \\"servicename\\" \\"servicesecond\\",\n \\"serviceschargeinfo\\" \[\n {\n \\"agequalifying\\" \\"guest\\",\n \\"extracount\\" \\"3\\",\n \\"extrarate\\" \\"null\\",\n \\"totalextraamount\\" \\"null\\"\n },\n {\n \\"agequalifying\\" \\"child\\",\n \\"extrachildrate\\" \\"null\\",\n \\"totalextraamount\\" \\"null\\",\n \\"childextracount\\" \\"1\\",\n \\"child ages\\" \[\n 3\n ]\n },\n {\n \\"agequalifying\\" \\"infant\\",\n \\"extrainfantrate\\" \\"\\",\n \\"totalextraamount\\" \\"\\",\n \\"childinfantcount\\" \\"\\",\n \\"child ages\\" \[]\n }\n ]\n }\n ]\n },\n {\n \\"occupancyrefid\\" \\"3\\",\n \\"roomtypeid\\" \\"r503 1 2\\",\n \\"roomname\\" \\"budget single room\\",\n \\"rateplanid\\" \\"r503 1 2 1\\",\n \\"cancelpolicy\\" \\"non refundable\\",\n \\"numberofunits\\" \\"2\\",\n \\"mealslncluded\\" \\"breakfast\\",\n \\"adultcount\\" \\"2\\",\n \\"childcount\\" \\"0\\",\n \\"childages\\" \[],\n \\"commission\\" \\"5 00\\",\n \\"roomindex\\" \\"2\\",\n \\"resguestrph\\" \\"2\\",\n \\"bookingperdayprices\\" \[\n {\n \\"dateymd\\" \\"2022 12 23\\",\n \\"price\\" \\"110 00\\"\n },\n {\n \\"dateymd\\" \\"2022 12 24\\",\n \\"price\\" \\"190 00\\"\n }\n ],\n \\"total\\" {\n \\"amountaftertaxes\\" \\"600 00\\",\n \\"amountbeforetaxes\\" \\"600 00\\"\n },\n \\"mealsexcluded\\" {\n \\"mealsexlcudedperdayprices\\" \[\n {\n \\"dateymd\\" \\"2022 12 23\\",\n \\"excludedmeals\\" \\"no meals\\"\n },\n {\n \\"dateymd\\" \\"2022 12 24\\",\n \\"excludedmeals\\" \\"no meals\\"\n }\n ]\n },\n \\"roomincservices\\" \[],\n \\"roomextraservices\\" \[]\n }\n ],\n \\"guestdetails\\" \[\n {\n \\"resguestrph\\" \\"1\\",\n \\"firstname\\" \\"test1\\",\n \\"lastname\\" \\"booking\\",\n \\"middlename\\" \\"\\",\n \\"email\\" \\"test1\@bakuun com\\",\n \\"phone\\" \\"111111111\\",\n \\"address\\" \\"pune\\",\n \\"country\\" \\"india\\"\n },\n {\n \\"resguestrph\\" \\"2\\",\n \\"firstname\\" \\"test2\\",\n \\"lastname\\" \\"booking\\",\n \\"middlename\\" \\"\\",\n \\"email\\" \\"test2\@bakuun com\\",\n \\"phone\\" \\"909999989\\",\n \\"address\\" \\"italy\\",\n \\"country\\" \\"italy\\"\n }\n ],\n \\"comment\\" {\n \\"text\\" \\"one room\\"\n },\n \\"paymentcard\\" {\n \\"cardholdername\\" \\"ivanov ivan\\",\n \\"cardtype\\" \\"visa\\",\n \\"cardcategory\\" \\"cc\\",\n \\"cardnumber\\" \\"123213213216549687\\",\n \\"expirymonth\\" \\"04\\",\n \\"expiryyear\\" \\"2022\\",\n \\"startdaymonth\\" \\"xyz\\",\n \\"startdayyear\\" \\"xyz\\",\n \\"issuenum\\" \\"2\\",\n \\"seriescode\\" \\"123\\",\n \\"vccbalance\\" \\"200 99\\",\n \\"vcccurrencycode\\" \\"eur\\",\n \\"vccactivationdate\\" \\"2021 09 19\\",\n \\"vccdeactivationdate\\" \\"2021 09 19\\"\n },\n \\"totalcharge\\" \[\n {\n \\"taxdetails\\" {\n \\"typetax\\" \\"vat\\",\n \\"includes\\" \\"0\\",\n \\"taxprice\\" \\"10 00\\",\n \\"taxdetails\\" \\"tax 10% not included\\"\n },\n \\"pricedetails\\" \[\n {\n \\"ratetype\\" \\"bar\\",\n \\"amountaftertaxes\\" \\"490 00\\",\n \\"amountbeforetaxes\\" \\"490 00\\"\n }\n ]\n }\n ]\n }\n ]\n} ", "customlabel" "" } ], "selectedlanguageid" "lwdxjbvcq70iisuuysqtj" }, "results" { "languages" \[ { "id" "ti0q2 90um 6o2rgidhd", "language" "200", "code" "{\n \\"success\\" true,\n \\"data\\" \[\n{\n \\"hotelid\\" \\"100\\",\n \\"bookingtokencode\\" \\"t34234300330\\"\n }\n ],\n \\"warnings\\" \[],\n \\"errors\\" \[]\n}", "customlabel" "" }, { "id" "kgczrlgfb s0liekjkoo8", "language" "410", "code" "{\n \\"success\\" false,\n \\"errors\\" \[\n {\n \\"code\\" 410,\n \\"message\\" \\"unauthorized user\\"\n }\n ]", "customlabel" "" } ], "selectedlanguageid" "ti0q2 90um 6o2rgidhd" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "username", "kind" "required", "type" "string", "description" "system generated, api access secret key (unique per account) ", "" "system generated, api access secret key (unique per account) " }, { "name" "password", "kind" "required", "type" "string", "description" "system generated, api access secret key (unique per account) ", "" "system generated, api access secret key (unique per account) " }, { "name" "tokenid", "kind" "required", "type" "string", "description" "the tokenid given in the sps ( single property search) ", "" "the tokenid given in the sps ( single property search) " }, { "name" "partnerid", "kind" "required", "type" "string", "description" "partner (buyer) identifier (e g rdkxx mpbxxx) ", "" "partner (buyer) identifier (e g rdkxx mpbxxx) " }, { "name" "partnername", "kind" "required", "type" "string", "description" "partner (buyer) name", "" "partner (buyer) name" }, { "name" "action", "kind" "required", "type" "string", "description" "always set as getbooking", "" "always set as getbooking" }, { "name" "hotelreservation", "kind" "required", "type" "object", "description" "", "" "required", "children" \[ { "name" "hotelcode", "kind" "required", "type" "string", "description" "unique bakuun or partner property id " }, { "name" "hotelname", "kind" "required", "type" "string", "description" "hotel/property name " }, { "name" "resstatus", "kind" "required", "type" "string", "description" "always set as new" }, { "name" "checkin", "kind" "required", "type" "string", "description" "iso check in datetime (e g , 2025 10 05t15 00) " }, { "name" "checkout", "kind" "required", "type" "string", "description" "iso check out datetime (e g , 2025 10 05t15 00) " }, { "name" "paymentmethod", "kind" "required", "type" "string", "description" "available payment method \nvcc, cc, bank, cash, credit\nfor marketplace booking always set as bank " }, { "name" "ratetype", "kind" "required", "type" "string", "description" "used to identify the rate type , the allowed value would be bar or net" }, { "name" "currencycode", "kind" "required", "type" "string", "description" "booking currency (iso 4217) " }, { "name" "totaladult", "kind" "required", "type" "string", "description" "total adults across all rooms " }, { "name" "totalchild", "kind" "required", "type" "string", "description" "total children across all rooms " }, { "name" "childages", "kind" "required", "type" "array", "description" "ages of all children " }, { "name" "roomstays", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "occupancyrefid", "kind" "required", "type" "string", "description" "links room result to the requested occupancy " }, { "name" "roomtypeid", "kind" "required", "type" "string", "description" "bakuun room id " }, { "name" "roomname", "kind" "required", "type" "string", "description" "room name" }, { "name" "rateplanid", "kind" "required", "type" "string", "description" "bakuun rate plan id " }, { "name" "cancelpolicy", "kind" "required", "type" "string", "description" "defines the cancellation policy associated with the selected rateplanid \nsupported options are \n\nrefundable\nnon refundable" }, { "name" "numberofunits", "kind" "required", "type" "string", "description" "number of units booked 1 would be the allowed minvalue" }, { "name" "mealslncluded", "kind" "required", "type" "string", "description" "used to identify the meals included as given in the sps ( single property search)\navailable options are \n breakfast \n half bord \n full board" }, { "name" "adultcount", "kind" "required", "type" "string", "description" "number of adults in this room " }, { "name" "childcount", "kind" "required", "type" "string", "description" "number of child in this room " }, { "name" "childages", "kind" "required", "type" "array", "description" "ages of children " }, { "name" "roomindex", "kind" "required", "type" "string", "description" "room index reference " }, { "name" "resguestrph", "kind" "required", "type" "string", "description" "guest index reference " }, { "name" "bookingperdayprices", "kind" "required", "type" "object", "description" "date wise price list for the stay ", "children" \[ { "name" "dateymd", "kind" "required", "type" "string", "description" "iso date (e g , 2025 10 25) " }, { "name" "price", "kind" "required", "type" "string", "description" "date wise price" } ] }, { "name" "total", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "amountaftertaxes", "kind" "required", "type" "string", "description" "total amount for the room stay after taxes and fees " }, { "name" "amountbeforetaxes", "kind" "required", "type" "string", "description" "total amount for the room stay before taxes and fees " } ] }, { "name" "mealsexcluded", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "mealsexlcudedperdayprices", "kind" "required", "type" "object", "description" "indicates the meal types excluded by the guest in the sps (single property search) request \nthese exclusions are applied during the pricing and availability calculation \n\navailable options are \n breakfast\n half board\n full board\n", "children" \[ { "name" "dateymd", "kind" "required", "type" "string", "description" "iso date (e g , 2025 10 25) " }, { "name" "excludedmeals", "kind" "required", "type" "string", "description" "selected exclused meals for this room type by the guest ", "children" \[] }, { "name" "breakfastchargeinfo", "kind" "required", "type" "object", "description" "a list containing the meal charging rules per age category (adult, child, infant) \neach object defines how breakfast charges are applied based on age qualification ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name" "mealsperunit", "kind" "required", "type" "string", "description" "number of meals selected for this combination " }, { "name" "mealperday", "kind" "required", "type" "string", "description" "meal day wise value " }, { "name" "adultmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "childmealcount", "kind" "required", "type" "string", "description" "number of meal for child agequalifying group" }, { "name" "child ages", "kind" "required", "type" "array", "description" "child ages for this block " }, { "name" "infantmealcount", "kind" "required", "type" "string", "description" "number of meal for infant agequalifying group" }, { "name" "infant ages", "kind" "required", "type" "array", "description" "infant ages for this block" } ] }, { "name" "lunchchargeinfo", "kind" "required", "type" "object", "description" "a list containing the meal charging rules per age category (adult, child, infant) \neach object defines how breakfast charges are applied based on age qualification ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name" "mealsperunit", "kind" "required", "type" "string", "description" "number of meals selected for this combination " }, { "name" "mealperday", "kind" "required", "type" "string", "description" "meals day wise value " }, { "name" "adultmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "childmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "child ages", "kind" "required", "type" "array", "description" "child ages for this block " }, { "name" "infantmealcount", "kind" "required", "type" "string", "description" "number of meal for infant agequalifying group" }, { "name" "infant ages", "kind" "required", "type" "array", "description" "infant ages for this block" } ] }, { "name" "dinnerchargeinfo", "kind" "required", "type" "object", "description" "a list containing the meal charging rules per age category (adult, child, infant) \neach object defines how breakfast charges are applied based on age qualification ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name" "mealsperunit", "kind" "required", "type" "string", "description" "number of meals selected for this combination " }, { "name" "mealperday", "kind" "required", "type" "string", "description" "meal day wise value " }, { "name" "adultmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "childmealcount", "kind" "required", "type" "string", "description" "number of meal for child agequalifying group" }, { "name" "child ages", "kind" "required", "type" "array", "description" "child ages for this block " }, { "name" "infantmealcount", "kind" "required", "type" "string", "description" "number of meal for infant agequalifying group" }, { "name" "infant ages", "kind" "required", "type" "array", "description" "infant ages for this block" } ] } ] } ] }, { "name" "roomincservices", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "serviceid", "kind" "required", "type" "string", "description" "unique service identifier " }, { "name" "servicename", "kind" "required", "type" "string", "description" "name of the service " } ] }, { "name" "roomextraservices", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "serviceid", "kind" "required", "type" "string", "description" "unique service identifier " }, { "name" "servicename", "kind" "required", "type" "string", "description" "name of the service " }, { "name" "serviceschargeinfo", "kind" "required", "type" "object", "description" "service cost breakdown ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this service type \nadult\nchild\ninfant" }, { "name" "extraadultcount", "kind" "required", "type" "string", "description" "indicates the cost for the service for adult age qualifying" }, { "name" "extrarate", "kind" "required", "type" "string", "description" "indicates the cost for the service for adult age qualifying" }, { "name" "totalextraamount", "kind" "required", "type" "string", "description" "indicates the cost for the service for each age qualifying range" }, { "name" "extrachildrate", "kind" "required", "type" "string", "description" "indicates the cost for the service for child age qualifying" }, { "name" "childextracount", "kind" "required", "type" "string", "description" "number of children requesting this service " }, { "name" "child ages", "kind" "required", "type" "array", "description" "ages of children requesting this service " }, { "name" "extrainfantrate", "kind" "required", "type" "string", "description" "indicates the cost for the service for infant age qualifying" }, { "name" "childinfantcount", "kind" "required", "type" "string", "description" "number of infant requesting this service " } ] } ] }, { "name" "commission ", "kind" "required", "type" "string", "description" "commission value accepted between 0 and 99, or left empty if not applicable " } ] }, { "name" "guestdetails", "kind" "required", "type" "object", "description" "standard guest contact information ", "children" \[ { "name" "resguestrph", "kind" "required", "type" "string", "description" "guest index reference " }, { "name" "firstname", "kind" "required", "type" "string", "description" "guest first name " }, { "name" "lastname", "kind" "required", "type" "string", "description" "guest surname " }, { "name" "middlename", "kind" "required", "type" "string", "description" "optional" }, { "name" "email", "kind" "required", "type" "string", "description" "guest email " }, { "name" "phone", "kind" "required", "type" "string", "description" "guest phone number " }, { "name" "address", "kind" "required", "type" "string", "description" "guest address " }, { "name" "country", "kind" "required", "type" "string", "description" "guest country " } ] }, { "name" "comment", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "text", "kind" "required", "type" "string", "description" "" } ] }, { "name" "paymentcard", "kind" "required", "type" "object", "description" "required only when paymentmethod = cc or vcc ", "children" \[ { "name" "cardholdername", "kind" "required", "type" "string", "description" "name on card " }, { "name" "cardtype", "kind" "required", "type" "string", "description" "visa/mastercard/etc " }, { "name" "cardcategory", "kind" "required", "type" "string", "description" "cc or vcc " }, { "name" "cardnumber", "kind" "required", "type" "string", "description" "valid card number" }, { "name" "expirymonth", "kind" "required", "type" "string", "description" "expiry mm " }, { "name" "expiryyear", "kind" "required", "type" "string", "description" "expiry yyyy " }, { "name" "startdaymonth", "kind" "required", "type" "string", "description" "start day month mm \nthis is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "startdayyear", "kind" "required", "type" "string", "description" "start day year yyyy \nthis is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "issuenum", "kind" "required", "type" "string", "description" "this is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "seriescode", "kind" "required", "type" "string", "description" "this is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "vccbalance", "kind" "required", "type" "string", "description" "vcc current balance" }, { "name" "vcccurrencycode", "kind" "required", "type" "string", "description" "vcc currency (iso 4217) " }, { "name" "vccactivationdate", "kind" "required", "type" "string", "description" "activation date " }, { "name" "vccdeactivationdate", "kind" "required", "type" "string", "description" "deactivation date " } ] }, { "name" "totalcharge", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "taxdetails", "kind" "required", "type" "object", "description" "the type of tax applied to the booking (e g , vat, city tax, service tax) ", "children" \[ { "name" "typetax", "kind" "required", "type" "string", "description" "the type of tax applied to the booking (e g , vat, fees) " }, { "name" "includes", "kind" "required", "type" "string", "description" "indicates whether the tax amount is included in the room price \n\n1 = tax is included in the price\n0 = tax is not included (added on top)" }, { "name" "taxprice", "kind" "required", "type" "string", "description" "the value of the tax \ncan represent either a percentage or a fixed amount, depending on the property setup " }, { "name" "taxdetails", "kind" "required", "type" "string", "description" "description of the tax applied to the booking (e g , “tax 10% not included”) " } ] }, { "name" "pricedetails", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "ratetype", "kind" "required", "type" "string", "description" "used to identify the rate type , the allowed value would be bar or net" }, { "name" "amountaftertaxes", "kind" "required", "type" "string", "description" "total amount for the reservation after taxes and fees " }, { "name" "amountbeforetaxes", "kind" "required", "type" "string", "description" "total amount for the reservation before taxes and fees " } ] } ] } ], "schema" \[ { "name" "hotelcode", "kind" "required", "type" "string", "description" "unique bakuun or partner property id " }, { "name" "hotelname", "kind" "required", "type" "string", "description" "hotel/property name " }, { "name" "resstatus", "kind" "required", "type" "string", "description" "always set as new" }, { "name" "checkin", "kind" "required", "type" "string", "description" "iso check in datetime (e g , 2025 10 05t15 00) " }, { "name" "checkout", "kind" "required", "type" "string", "description" "iso check out datetime (e g , 2025 10 05t15 00) " }, { "name" "paymentmethod", "kind" "required", "type" "string", "description" "available payment method \nvcc, cc, bank, cash, credit\nfor marketplace booking always set as bank " }, { "name" "ratetype", "kind" "required", "type" "string", "description" "used to identify the rate type , the allowed value would be bar or net" }, { "name" "currencycode", "kind" "required", "type" "string", "description" "booking currency (iso 4217) " }, { "name" "totaladult", "kind" "required", "type" "string", "description" "total adults across all rooms " }, { "name" "totalchild", "kind" "required", "type" "string", "description" "total children across all rooms " }, { "name" "childages", "kind" "required", "type" "array", "description" "ages of all children " }, { "name" "roomstays", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "occupancyrefid", "kind" "required", "type" "string", "description" "links room result to the requested occupancy " }, { "name" "roomtypeid", "kind" "required", "type" "string", "description" "bakuun room id " }, { "name" "roomname", "kind" "required", "type" "string", "description" "room name" }, { "name" "rateplanid", "kind" "required", "type" "string", "description" "bakuun rate plan id " }, { "name" "cancelpolicy", "kind" "required", "type" "string", "description" "defines the cancellation policy associated with the selected rateplanid \nsupported options are \n\nrefundable\nnon refundable" }, { "name" "numberofunits", "kind" "required", "type" "string", "description" "number of units booked 1 would be the allowed minvalue" }, { "name" "mealslncluded", "kind" "required", "type" "string", "description" "used to identify the meals included as given in the sps ( single property search)\navailable options are \n breakfast \n half bord \n full board" }, { "name" "adultcount", "kind" "required", "type" "string", "description" "number of adults in this room " }, { "name" "childcount", "kind" "required", "type" "string", "description" "number of child in this room " }, { "name" "childages", "kind" "required", "type" "array", "description" "ages of children " }, { "name" "roomindex", "kind" "required", "type" "string", "description" "room index reference " }, { "name" "resguestrph", "kind" "required", "type" "string", "description" "guest index reference " }, { "name" "bookingperdayprices", "kind" "required", "type" "object", "description" "date wise price list for the stay ", "children" \[ { "name" "dateymd", "kind" "required", "type" "string", "description" "iso date (e g , 2025 10 25) " }, { "name" "price", "kind" "required", "type" "string", "description" "date wise price" } ] }, { "name" "total", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "amountaftertaxes", "kind" "required", "type" "string", "description" "total amount for the room stay after taxes and fees " }, { "name" "amountbeforetaxes", "kind" "required", "type" "string", "description" "total amount for the room stay before taxes and fees " } ] }, { "name" "mealsexcluded", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "mealsexlcudedperdayprices", "kind" "required", "type" "object", "description" "indicates the meal types excluded by the guest in the sps (single property search) request \nthese exclusions are applied during the pricing and availability calculation \n\navailable options are \n breakfast\n half board\n full board\n", "children" \[ { "name" "dateymd", "kind" "required", "type" "string", "description" "iso date (e g , 2025 10 25) " }, { "name" "excludedmeals", "kind" "required", "type" "string", "description" "selected exclused meals for this room type by the guest ", "children" \[] }, { "name" "breakfastchargeinfo", "kind" "required", "type" "object", "description" "a list containing the meal charging rules per age category (adult, child, infant) \neach object defines how breakfast charges are applied based on age qualification ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name" "mealsperunit", "kind" "required", "type" "string", "description" "number of meals selected for this combination " }, { "name" "mealperday", "kind" "required", "type" "string", "description" "meal day wise value " }, { "name" "adultmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "childmealcount", "kind" "required", "type" "string", "description" "number of meal for child agequalifying group" }, { "name" "child ages", "kind" "required", "type" "array", "description" "child ages for this block " }, { "name" "infantmealcount", "kind" "required", "type" "string", "description" "number of meal for infant agequalifying group" }, { "name" "infant ages", "kind" "required", "type" "array", "description" "infant ages for this block" } ] }, { "name" "lunchchargeinfo", "kind" "required", "type" "object", "description" "a list containing the meal charging rules per age category (adult, child, infant) \neach object defines how breakfast charges are applied based on age qualification ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name" "mealsperunit", "kind" "required", "type" "string", "description" "number of meals selected for this combination " }, { "name" "mealperday", "kind" "required", "type" "string", "description" "meals day wise value " }, { "name" "adultmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "childmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "child ages", "kind" "required", "type" "array", "description" "child ages for this block " }, { "name" "infantmealcount", "kind" "required", "type" "string", "description" "number of meal for infant agequalifying group" }, { "name" "infant ages", "kind" "required", "type" "array", "description" "infant ages for this block" } ] }, { "name" "dinnerchargeinfo", "kind" "required", "type" "object", "description" "a list containing the meal charging rules per age category (adult, child, infant) \neach object defines how breakfast charges are applied based on age qualification ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this meal type \nadult\nchild\ninfant" }, { "name" "mealsperunit", "kind" "required", "type" "string", "description" "number of meals selected for this combination " }, { "name" "mealperday", "kind" "required", "type" "string", "description" "meal day wise value " }, { "name" "adultmealcount", "kind" "required", "type" "string", "description" "number of meal for adult agequalifying group" }, { "name" "childmealcount", "kind" "required", "type" "string", "description" "number of meal for child agequalifying group" }, { "name" "child ages", "kind" "required", "type" "array", "description" "child ages for this block " }, { "name" "infantmealcount", "kind" "required", "type" "string", "description" "number of meal for infant agequalifying group" }, { "name" "infant ages", "kind" "required", "type" "array", "description" "infant ages for this block" } ] } ] } ] }, { "name" "roomincservices", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "serviceid", "kind" "required", "type" "string", "description" "unique service identifier " }, { "name" "servicename", "kind" "required", "type" "string", "description" "name of the service " } ] }, { "name" "roomextraservices", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "serviceid", "kind" "required", "type" "string", "description" "unique service identifier " }, { "name" "servicename", "kind" "required", "type" "string", "description" "name of the service " }, { "name" "serviceschargeinfo", "kind" "required", "type" "object", "description" "service cost breakdown ", "children" \[ { "name" "agequalifying", "kind" "required", "type" "string", "description" "indicates the selected age qualifying range for this service type \nadult\nchild\ninfant" }, { "name" "extraadultcount", "kind" "required", "type" "string", "description" "indicates the cost for the service for adult age qualifying" }, { "name" "extrarate", "kind" "required", "type" "string", "description" "indicates the cost for the service for adult age qualifying" }, { "name" "totalextraamount", "kind" "required", "type" "string", "description" "indicates the cost for the service for each age qualifying range" }, { "name" "extrachildrate", "kind" "required", "type" "string", "description" "indicates the cost for the service for child age qualifying" }, { "name" "childextracount", "kind" "required", "type" "string", "description" "number of children requesting this service " }, { "name" "child ages", "kind" "required", "type" "array", "description" "ages of children requesting this service " }, { "name" "extrainfantrate", "kind" "required", "type" "string", "description" "indicates the cost for the service for infant age qualifying" }, { "name" "childinfantcount", "kind" "required", "type" "string", "description" "number of infant requesting this service " } ] } ] }, { "name" "commission ", "kind" "required", "type" "string", "description" "commission value accepted between 0 and 99, or left empty if not applicable " } ] }, { "name" "guestdetails", "kind" "required", "type" "object", "description" "standard guest contact information ", "children" \[ { "name" "resguestrph", "kind" "required", "type" "string", "description" "guest index reference " }, { "name" "firstname", "kind" "required", "type" "string", "description" "guest first name " }, { "name" "lastname", "kind" "required", "type" "string", "description" "guest surname " }, { "name" "middlename", "kind" "required", "type" "string", "description" "optional" }, { "name" "email", "kind" "required", "type" "string", "description" "guest email " }, { "name" "phone", "kind" "required", "type" "string", "description" "guest phone number " }, { "name" "address", "kind" "required", "type" "string", "description" "guest address " }, { "name" "country", "kind" "required", "type" "string", "description" "guest country " } ] }, { "name" "comment", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "text", "kind" "required", "type" "string", "description" "" } ] }, { "name" "paymentcard", "kind" "required", "type" "object", "description" "required only when paymentmethod = cc or vcc ", "children" \[ { "name" "cardholdername", "kind" "required", "type" "string", "description" "name on card " }, { "name" "cardtype", "kind" "required", "type" "string", "description" "visa/mastercard/etc " }, { "name" "cardcategory", "kind" "required", "type" "string", "description" "cc or vcc " }, { "name" "cardnumber", "kind" "required", "type" "string", "description" "valid card number" }, { "name" "expirymonth", "kind" "required", "type" "string", "description" "expiry mm " }, { "name" "expiryyear", "kind" "required", "type" "string", "description" "expiry yyyy " }, { "name" "startdaymonth", "kind" "required", "type" "string", "description" "start day month mm \nthis is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "startdayyear", "kind" "required", "type" "string", "description" "start day year yyyy \nthis is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "issuenum", "kind" "required", "type" "string", "description" "this is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "seriescode", "kind" "required", "type" "string", "description" "this is only needed for card different from visa, mastercard, amex, unionpay, jcb" }, { "name" "vccbalance", "kind" "required", "type" "string", "description" "vcc current balance" }, { "name" "vcccurrencycode", "kind" "required", "type" "string", "description" "vcc currency (iso 4217) " }, { "name" "vccactivationdate", "kind" "required", "type" "string", "description" "activation date " }, { "name" "vccdeactivationdate", "kind" "required", "type" "string", "description" "deactivation date " } ] }, { "name" "totalcharge", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "taxdetails", "kind" "required", "type" "object", "description" "the type of tax applied to the booking (e g , vat, city tax, service tax) ", "children" \[ { "name" "typetax", "kind" "required", "type" "string", "description" "the type of tax applied to the booking (e g , vat, fees) " }, { "name" "includes", "kind" "required", "type" "string", "description" "indicates whether the tax amount is included in the room price \n\n1 = tax is included in the price\n0 = tax is not included (added on top)" }, { "name" "taxprice", "kind" "required", "type" "string", "description" "the value of the tax \ncan represent either a percentage or a fixed amount, depending on the property setup " }, { "name" "taxdetails", "kind" "required", "type" "string", "description" "description of the tax applied to the booking (e g , “tax 10% not included”) " } ] }, { "name" "pricedetails", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "ratetype", "kind" "required", "type" "string", "description" "used to identify the rate type , the allowed value would be bar or net" }, { "name" "amountaftertaxes", "kind" "required", "type" "string", "description" "total amount for the reservation after taxes and fees " }, { "name" "amountbeforetaxes", "kind" "required", "type" "string", "description" "total amount for the reservation before taxes and fees " } ] } ] } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "response" \[ { "name" "success", "kind" "optional", "type" "boolean", "description" "" }, { "name" "data", "kind" "optional", "type" "object", "description" "", "children" \[ { "name" "hotelid", "kind" "optional", "type" "string", "description" "unique bakuun or partner property id " }, { "name" "bookingtokencode", "kind" "optional", "type" "string", "description" "unique token code generated in pre booking response" } ] }, { "name" "warnings", "kind" "optional", "type" "string", "description" "", "children" \[] }, { "name" "errors", "kind" "optional", "type" "string", "description" "", "children" \[] } ] }