BookingChange

PUT {{endpoint}}/hotel-api/1.0/bookings/{{bookingReference}}

The BookingChange operation can be used to change (or simulate) different values of a booking or to partially cancel a booking (i.e: cancel a room of a two room reservation).

In 'examples' you can find different cases of requests and responses.

Request Body

{"mode"=>"SIMULATION", "booking"=>{"reference"=>"52-1274417", "clientReference"=>"INTEGRATIONAGENCY", "creationDate"=>"2017-08-31", "status"=>"CONFIRMED", "modificationPolicies"=>{"cancellation"=>true, "modification"=>true}, "creationUser"=>"wuupfvswdqfz342cejxfv3ku", "holder"=>{"name"=>"INTEGRATIONTESTFIRSTNAME", "surname"=>"INTEGRATIONTESTLASTNAME"}, "hotel"=>{"checkOut"=>"2017-09-20", "checkIn"=>"2017-09-15", "code"=>1, "name"=>"Villa Dorada", "categoryCode"=>"3EST", "categoryName"=>"3 STARS", "destinationCode"=>"SAL", "destinationName"=>"Salou Area / Costa Dorada", "zoneCode"=>10, "zoneName"=>"Salou", "latitude"=>"41.06865947991072", "longitude"=>"1.1524744666303377", "rooms"=>[{"status"=>"CONFIRMED", "id"=>1, "code"=>"DBT.ST-3", "name"=>"Double or Twin MONOPARENTAL 1 ADULT 2 CHILDREN", "paxes"=>[{"roomId"=>1, "type"=>"AD", "name"=>"First Adult Name", "surname"=>"Surname"}, {"roomId"=>1, "type"=>"CH", "age"=>6, "name"=>"Second Child Name"}, {"roomId"=>1, "type"=>"CH", "age"=>5, "name"=>"First Child Name"}], "rates"=>[{"rateClass"=>"NOR", "net"=>"302.26", "rateComments"=>"1x Double or Twin Estimated total amount of taxes & fees for this booking: 2.50 Euro   payable on arrival  \r. Car park NO   . Key Collection 14:00 – 00:00. Check-in hour 14:00 – 00:00. . This rate is not applicable to Spain, Italy & Portugal market/country or passport holders otherwise the reservation will not be accepted or supplement fees can be charged on arrival.", "paymentType"=>"AT_WEB", "packaging"=>false, "boardCode"=>"RO", "boardName"=>"ROOM ONLY", "cancellationPolicies"=>[{"amount"=>"141.00", "from"=>"2017-09-14T23:59:00+02:00"}, {"amount"=>"70.50", "from"=>"2017-09-12T23:59:00+02:00"}], "rooms"=>1, "adults"=>1, "children"=>2}]}], "totalNet"=>"302.26", "currency"=>"EUR", "supplier"=>{"name"=>"HOTELBEDS PRODUCT,S.L.U.", "vatNumber"=>"ESB38877676"}}, "totalNet"=>302.26, "pendingAmount"=>302.26, "currency"=>"EUR"}}

HEADERS

KeyDatatypeRequiredDescription
Api-keystringAPI Key used in the request
X-SignaturestringSHA256 hash in Hex format from your API Key, your secret plus current timestamps in seconds
AcceptstringDefines response format, posible values: application/xml, application/json
Accept-EncodingstringDefines type of encoding used on the data
Content-TypestringDefines request format, posible values: application/xml, application/json