Reservation Services
The Hotel Reservation Services provide the ability to create, update, cancel and retrieve reservations from the SynXis Platform.
This service manages reservation orchestrations relating to booking, modification, cancellation, retrieval, and back-office processing. An agent can reserve a product or packages for a specific hotel. The reservation status can change. Each status has its own set of rules that might need different data. The movement from one status to another can be different depending on the original status and the new one.
| Status | Description | Transition/Reservation Requirements |
|---|---|---|
| Stored | Includes all information related to a reservation, but does not contain blocked inventory, confirmation number, or a confirmed price. | No requirement. |
| Booked | Indicates the "pending" state of a new reservation where inventory is decremented. A confirmation is generated; however, the reservation stays in a pending state until it is either Ignored or Confirmed. | No requirement |
| OnHold | An extension of the Booked reservation status including decremented inventory but has some overriding attributes such as not needing a payment. | No requirement After a timeout, based on a time configured by chain the system will automatically ignore the reservation. |
| Confirmed | This is the final state of a valid reservation regardless of whether it is a new or modified reservation. | A guest is required, Inventory will be blocked at the property. Booking policy will be applied including pre-payment. |
| Waitlisted | Indicates an attempted booking where the requested product was not available, so the reservation is waitlisted and stored in the database for confirmation if the product becomes available. Guests receive a waitlist e-mail indicating that their reservation could not be confirmed at that time. | A guest is required. |
| Cancelled | The final status of a canceled reservation. | Prior to cancellation, the system evaluates the cancel policy to determine eligibility. |
| Ignored | Indicates the final state of a pending reservation that equivalent to it being (logically) deleted. | The system is the only one that ignores a reservation. |
| PendingModify | Indicates pending changes to a confirmed reservation where inventory is decremented. The changes stay in this status, and the changes stay in a pending state until the reservation is either Ignored by the system or Confirmed. | Only reservations with a Confirmed status can be changed to PendingModifystatus. |
REST API Tokens
How to Construct and Use security tokens
Header Parameters
| Parameter | Description | Type | Example |
|---|---|---|---|
| Accept-Language | Language code with optional culture code. Use to request content in the specified language. | String | en-US |
| Context | Business context for caller | String | WBSVC |
| ActivityID | Unique Id per request for system tracing | String | MyCompany_123sdjwiiw456 |