Manage resource capacity schedules and reservations

Learn how to manage service resource capacity schedules and support appointment availability and reservations that exclude scheduled capacity from appointment availability.

Capacity management operations eliminate manual integration and operation processes related to resource capacity. With these operations, you can provide the availability of a resource in real time. Schedule provides a resource’s availability. Reservation provides a resources's unavailability.

• updateSchedule is used to create or update resource capacity schedules that make capacity available for service job appointments.
• createReservation is used to block out portions of scheduled resource capacity from being available for service job appointments.
• updateReservation is used to update reservations in order to account the need to shift existing block outs on resource capacity schedules.
• cancelReservation is used to remove reservations no longer needed to block portions of resource capacity schedules.

Prerequisites

To complete this tutorial, you need:

• Authorization from the seller for whom you are making calls. Refer to Authorizing Selling Partner Applications for more information.

Update a resource schedule

The updateSchedule operation creates or updates resource capacity schedules, which are the basis for capacity-driven appointment scheduling.

updateSchedule overwrites the resource’s existing schedule, so you can use it to provide a resource’s schedule for the first time and for subsequent changes. The schedule continues to be valid until the endTime, or recurrence’s endTime if you provide recurrence. The minimum slot duration is five minutes for US marketplaces and 30 mins for UK and DE marketplaces. There is no way to clear the schedule of a resource; providing an empty schedule is considered an invalid request.

Create a reservation against a resource

The createReservation operation creates a reservation against a resource, which reduces available capacity for that time-frame.

For service reservations, the duration is standard and is Amazon-defined. Creating a reservation requires that the resource has the requested capacity available in that time frame. A walk-in appointment for a tire-change is an example of where createReservation can be used. If you want to assign resource R1 to this job, call the API with R1 as the resourceId, with start and end times of the job and APPOINTMENT as the type.

Update an existing resource reservation

The updateReservation operation updates a reservation against a resource, reducing available capacity for that time-frame.

This operation can reschedule a reservation. No other fields can be changed except the start-times and end-times of the reservation. This operation succeeds only if there is sufficient capacity of the resource available at the new time frame. The response contains the reservationId of the reservation you update.

📘

Note

A successful call returns a new reservationID that can be used to make further changes to this reservation. The previous reservationId can be discarded.

Cancel a reservation

The cancelReservation operation cancels a reservation. Cancelling a reservation creates capacity for available appointment opportunities.