Document toolboxDocument toolbox

Work Order Dispatch REST API

3.18.1

The Work Order Dispatch REST API is used to manage dispatch status attributes for a specific work order. Work Order Dispatch REST API manages the current dispatch status, estimated planned start and end time and estimated planned duration for the work order. REST API can be used to:

  • Assign a work order to a mobile worker
  • Unassign/reassign a work order
  • Dispatch a work order
  • Schedule a work order
  • Unschedule a work order

On this page:

Related pages:

Resource URL Summary

Retrieve dispatch status for a specific work order

GET /seiapi/v3/trans/WorkOrder/${WorkOrderNum}/Dispatch

 Update dispatch status for a specific work order

PUT /seiapi/v3/trans/WorkOrder/${WorkOrderNum}/Dispatch

API Specific Parameters

Parameter
Description
${WorkOrderNum}Identifies the Work Order Dispatch Object.

Retrieve dispatch status for a specific work order

This REST API will return the dispatch status information for the work order. The work order with specified ID must already exist in the system.

URL

GET /seiapi/v3/trans/WorkOrder/${OrderNum}/Dispatch

HTTP Response Body

The HTTP response body, on success, will contain a Work Order Dispatch Object. Otherwise, on error, the response body will contain a descriptive reason for the error. 

Work Order Dispatch Object

JSON Format
{
	"DispatchStatus": 0,
	"DispatchUTC": "2016-11-17T17:30:56.847Z",
	"PlannedDur": 15,
	"PlannedEndDate": "2016-11-17T11:15:00.000Z",
	"PlannedStartDate": "2016-11-17T11:00:00.000Z",
	"PrimaryUserName": "",
	"UserName": ""
}

Update dispatch status for a specific work order

This REST API will update dispatch status information for a specific work order. The system will modify dispatch status in case work order exists in the system. If dispatch status information was changed, the HTTP response code of 200 will be returned. Otherwise, on error, the appropriate HTTP response code will be returned along with details of the error in the response body.

All properties and objects not included in the request body will be ignored. Therefore, only properties and objects that are included will be updated within the Work Order Object.

URL

PUT /seiapi/v3/trans/WorkOrder/${OrderNum}/Dispatch

HTTP Request Body

The HTTP request body must contain a valid Work Order Dispatch Object. 

HTTP Response

On success the API will return a status code of 200.Â