Add or Update Booking Accommodation
Last updated
Last updated
POST
[PlatformAddress]/api/1.0/venue?action=addOrUpdateBookingAccommodation
Adds or updates the details of a specific booking accommodation group on a specific venue booking. This action will fail if the booking cannot support accommodation blocks.
Property | Type | Required | Description | |
---|---|---|---|---|
One of the following values
Updating an existing accommodation group overlays the existing data. Optional request data that is excluded will not change existing data. This does not guarantee that the request data will validate if other data is changed. For example, if the end date of the accommodation is extended, rates for the new dates will be required.
If the start and/or end dates of the accommodation group change: * Any existing rates on dates that no longer apply (i.e. bookingDate is outside the new group dates) will be removed. * Any existing room options on dates that no longer apply (i.e. bookingDate is outside the new group dates) will be removed. * Rates for any new dates are required. * If the accommodation group dates extend beyond the accommodation dates of the booking (to which the group belongs) then the booking's accommodation dates will be adjusted to include the new date range.
Day rates override existing data based on the bookingDate value in the request. For example, to change the rate on 23/12/2019: { "bookingDate": "2019-12-23", "numRooms": 5, "cost": 180, "numPayableByGuest": 0 }
Room options override existing data based on the roomOptionId and bookingDate values in the request.
The same room option can only be added to the accommodation group once (this also applies when adding an accommodation group). If a room option appears multiple times in the request for the same date, the last value is used. For example: "roomOptions": [ { "bookingDate", "2019-01-01", "roomOptionId": 124, "numRooms": 4, "numOptionsPerRoom": 1, "price": 25, "excludedTaxIds": [], "numPayableByGuest": 0 }, { "bookingDate", "2019-01-01", "roomOptionId": 124, "numRooms": 6, "numOptionsPerRoom": 2, "price": 30, "excludedTaxIds": [], "numPayableByGuest": 0 } ]
roomOptionId 124 on 01/01/2019 will have: numRooms 6, numOptionsPerRoom 2, price 30 etc.
To remove room options from an accommodation group, pass zero values as follows: { "bookingDate": "2019-01-01", "roomOptionId": 124, "numRooms": 0, "numOptionsPerRoom": 0, "price": 0, "excludedTaxIds": [], "numPayableByGuest": 0 }
The numRooms & numPayableByGuest values of a room option cannot exceed the numRooms value on the same bookingDate. For example, if the following day rate exists: { "bookingDate": "2019-12-23", "numRooms": 5, "cost": 180, "numPayableByGuest": 0 }
Then the numRooms & numPayableByGuest values of any room option on 23/12/2019 cannot exceed 5. It is possible to update an existing accommodation group and either decrease or increase numRooms of the day rate. If the day rate numRooms is decreased, all existing room options that exceed the new value will also be decreased. If the day rate numRooms is increased, no existing room options are modified (unless the new values are passed in the request).
Property | Type | Required | Description |
---|---|---|---|
Property | Type | Required | Description |
---|---|---|---|
Property | Type | Required | Description | |
---|---|---|---|---|
Property | Type | Required | Description |
---|---|---|---|
Property | Type | Required | Description |
---|---|---|---|
Property | Type | Required | Description |
---|---|---|---|
Property | Type | Required | Description | |
---|---|---|---|---|
Property | Type | Required | Description |
---|---|---|---|
Property | Type | Required | Description |
---|---|---|---|
# | Description |
---|---|