Introduction

This section introduces the various Reservation APIs that enable distributors to facilitate real-time bookings, cancellations, modifications, and queries. These APIs ensure seamless communication between distributors and hotel suppliers, providing up-to-date information and enabling efficient reservation management. To create a reservation using Derbysoft APIs, it is required to first perform a Live Check to ensure that the rate and availability are accurate and up-to-date. Following the live check, a Prebook must be executed to confirm the final availability before proceeding with the actual booking. Once these steps are completed, the Book API can be used to finalize the reservation. Additionally, while the Reservation APIs are designed for generic use by all distributors, some fields will be specific to certain distribution models offered by DerbySoft. Exchange distribution and Corporate distribution will have specific fields tailored to support these different models. These specific fields will be clearly highlighted in the schemas, making it easier for distributors to implement the APIs correctly.

Distributors can implement the following Reservation API functionalities to integrate with our system, supporting their booking operations:

• Live Check: This API allows distributors to check real-time availability and get a list of available rooms and rates from the hotel supplier’s system.
• Prebook: Before finalizing a booking, distributors must use this API to perform a final check, verifying availability and rates in real time.
• Book: This API enables distributors to complete a booking by sending a request to the hotel supplier's system for real-time confirmation.
• Modify: This optional API allows distributors to modify an existing booking by sending a request to the supplier's system for real-time confirmation of the change. If a supplier cannot support modifications, this will follow a cancel-rebook strategy. Note that distributors working with Disney must implement this API.
• Cancel: This API allows distributors to cancel existing bookings, ensuring real-time cancellation confirmation from the hotel supplier’s system.
• Query Reservation List: This optional API allows distributors to query and retrieve a list of existing bookings, enabling efficient tracking of reservations.
• Query Reservation Detail: This optional API allows distributors to retrieve detailed information about existing bookings, including the status of time-sensitive reservations.

Key Functionalities of the Reservation API

• Real-Time Reservation Management: Distributors can manage bookings in real time, ensuring accurate reservations by interacting directly with hotel suppliers' systems for availability, bookings, modifications, and cancellations.
• Live Availability and Rates Check: Using the Live Check API, distributors can query real-time availability and rates, ensuring they only show current, available options to customers.
• Prebooking Verification: The Prebook API allows distributors to double-check availability and rates before finalizing a reservation, ensuring no discrepancies during the booking process.
• Booking Confirmation: The Book API enables distributors to finalize reservations by providing real-time confirmation, ensuring that the booking is successfully processed and confirmed within the hotel’s system.
• Booking Modifications: The Modify API allows distributors to update existing bookings, with real-time confirmation on modifications from the hotel’s system. If the supplier or you cannot support direct changes, you could  follow a cancel-rebook strategy.
• Real-Time Cancellation: The Cancel API ensures that distributors can cancel bookings, receiving immediate confirmation from the supplier’s system.
• Reservation Querying and Flexible Parameters: The Query Reservation List and Query Reservation Detail APIs allow distributors to query and retrieve detailed information about existing bookings, aiding in effective reservation management and tracking. These APIs are optional but useful for comprehensive booking oversight. Distributors can also utilize flexible query parameters, such as date ranges, reservation status, and other criteria, to filter and refine the data for more granular control over the information retrieved.
• Scalable Reservation Management: The Reservation APIs are designed to handle large volumes of real-time data, ensuring distributors can scale their operations to accommodate growing customer bases without sacrificing performance.