A state hash is employed to verify that any submitted updates are applied to the most recent version of the booking. Upon receiving an update request, the provided hash is compared against the current booking state. A successful match results in the processing of the update and the subsequent modification of the booking state.
Conversely, if the state hashes do not align, a 400 Bad Request response is issued, prompting you to retrieve the latest booking data via a GET request prior to any further update attempts.
The state hash changes whenever there is a modification to any of these fields, ensuring the supplier is notified of booking changes:
- Booking Reference
- Pickup Location
- Dropoff Location
- Pickup Date Time
- Vehicle Type
- Passenger Count
- Passenger Details
- Booking State (excluded the ones listed below)
- Flight Number
For booking state, the state hash will not change if state changes to CANCELLED, DECLINED, DRIVER_ASSIGNED, ACCEPTED.
See the API documentation section for more details.