Set service job appointments and assigning appointment resources

Learn how to add or reschedule appointments for service jobs, and assign 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:

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

Reason code Reason description Default Heavy bulk Recurring
RS1 Customer requested - DE -
RS2 Product will not be delivered in time - DE -
RS3 Need follow-up visit - DE -
RS4 Provider cannot meet original appointment US, AE, JP US, DE, JP US, JP
RS5 Product incompatible or broken - DE -
RS6 Work is different than scoped US, IN, UK, DE, AE, JP US, IN, UK, JP -
RS7 Code not in use - - -
RS8 No longer works with customer schedule UK, DE US, UK, JP US, JP
RS9 Problem with Amazon product or its delivery US, IN, UK, DE, AE, JP US, IN, UK, JP -
RS10 Problem with non-Amazon product, delivery, or service US, UK, DE, AE, JP US, UK, JP -
RS11 Customer didn't show up US, IN, UK, DE, AE, JP US, IN, UK, JP US, JP
RS12 Provider cannot meet original appointment IN, UK, DE IN, UK -
DRS1 Unable to access location - US, JP -
DRS2 Customer requested a future date - US, JP -
DRS3 Customer declined - US, JP -
DRS4 Delivery will be too late - US, JP -
DRS5 Can't find access - US, JP -
DRS6 Business closed - US, JP -
SRS1 Customer requested cancellation - US, JP -

📘

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.