Get Service Job data

Learn how to obtain Service Job data to determine the Jobs that require a service seller to take action and the Jobs that need additional API calls.

Obtain Service Job data with the following operations:

• getServiceJobs responds with a list of Service Jobs as constrained by filter inputs.
• getServiceJobByServiceJobId responds with Service Job details using Service Job IDs that getServiceJobs returns, or that the Seller Central Manage Jobs Download CSV Report file contains.

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.
• The Professional Services role.

Step 1. Get all jobs created or updated during a time frame that you specify

The getServiceJobs operation:

• Gets the status of service jobs and appointments.
• Flags appointments that need a resource assignment, such as a technician.
• Manages route and fulfillment planning.

After fulfillment, you can use this operation along with getServiceJobByServiceJobId to audit technician performance.

Step 2. Get service job details

The getServiceJobByServiceJobId operation provides service sellers access to details about their service orders and their fulfillment, including:

• What orders are routed to service sellers.
• Appointment and job-level statuses.
• Orders that are already routed and need technician assignment.
• Technician assignment gaps.

You can use this operation to determine technician on-time arrival, completion within slot, technician no-shows, and fulfillment breaks. After fulfillment, this operation can measure performance, which can be used to set up payment dashboards for sellers.