Set service job appointments and assigning appointment resources

Learn how to add or reschedule appointments for service jobs, and assign appointment resources.

Reschedule appointments for service jobs and assign appointment resources with the following operations:

• addAppointmentForServiceJobByServiceJobId
• rescheduleAppointmentForServiceJobByServiceJobId
• assignAppointmentResources

These operations confirm appointment preferences or add an initial appointment to any other valid start time in the future. Service sellers can reschedule an appointment to another valid start time in the future along with a reschedule reason.

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.
• A service job identifier assigned to the service provider. Only jobs assigned to the service provider can be accessed.
• A future-dated appointment start time pre-configured in Amazon Systems for the service provider.

Add appointment for service job by service job ID

The addAppointmentForServiceJobByServiceJobId operation confirms an initial appointment preference or sets an initial appointment.

📘

Note

• You can only add appointments in available future-date appointment slots (startTime + duration) that are pre-configured in Amazon Systems.
• If durationInMinutes is not provided, then the pre-configured service duration is picked automatically.
• If durationInMinutes is provided, then it should match the pre-configured appointment duration in Amazon Systems.

Reschedule an appointment by service job ID

The rescheduleAppointmentForServiceJobByServiceJobId operation reschedules a service job appointment and provides a reason for rescheduling.

Reschedule reason codes by marketplace

📘

Note

The RESOURCES_UNASSIGNED warning code in the response provides details of preassigned resources to the appointment that do not have an assignment. The service provider should assign new resources to the rescheduled appointment.

Add new resources to a service job appointment

The assignAppointmentResources operation assigns or updates resources in appointments for their service orders. This operation performs resource validations against a number of criteria, such as skills, available capacity, and coverage area inclusions, before setting an appointment resource assignment.