Versions Compared

Version Old Version 9 New Version Current
Changes made by

Jason Andrew

Jason Andrew

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
title5.4.0

A pass-through API to ServiceDispatch Dispatch (when configured) which allows the ServiceDispatchDispatch's "Get Status Enquiry" API to be called.           


Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

On this page:

Table of Contents
maxLevel2

Related pages:


Resource URL Summary

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

Pass Through Call to ServiceDispatchto Dispatch's "Get Status Enquiry" API

PUT /up/v5/rest/dispatch/getStatusEnquiry   

Include Page
_Default HTTP Headers
_Default HTTP Headers

API Specifics  

These elements contains the date and datetime objects. If your language does not understand these object types, then the definition is included.

Parameter

Datatype

(length)

Description
CallNo String(20)The call number that was used when the call was originally created.
StartDate String(20)

Starting date to search for status history (format for this is YYYYDDMM).

EndDateString

Ending date to search for status history

(format for this is YYYYDDMM).

StartTimeString

Starting time to search for status history

(format for this is HH24:MI).

EndTimeString

Ending Time to search for status history

(format for this is HH24:MI).

CallStatusCallStatusEnquiryReqCallStatusLimit the search to only a certain status.
SecStatusCallStatusEnquiryReqSecStatusLimit the search to only a certain secondary status MaxAttempt, Unassigned.



Panel
borderColor#D3D3D3

Pass Through Call

to ServiceDispatch

to Dispatch's "Get Status Enquiry" API

This RESTified API will perform a pass-through call to the ServiceDispatch the Dispatch sub-system's "Get Status Enquiry" API (when configured).

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

PUT /up/v5/rest/dispatch/getStatusEnquiry

HTTP Request Body

This request requires a JSON object supplied in the HTTP request body, which defines the parameters that will be passed through to the ServiceDispatch the Dispatch "Get Status Enquiry" APi.

GetStatusEnquiry Object Format

Code Block
languagejs
{
	"Id": "",
	"CallStatus": "",
	"SecStatus": "",
	"StartDate": "",
	"StartTime": "",
	"EndDate": "",
	"EndTime": ""
}

GetStatusEnquiry Object Properties

PropertyTypeRequired?DescriptionServiceDispatch Dispatch Field Mapping
IdstringNoPass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API. CallNo
CallStatusstringNoPass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API.CallStatus
SecStatusstringNoPass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API.SecStatus
StartDatestringNo

Pass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API.

StartDate
StartTimestringNo

Pass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API.

StartTime
EndDatestringNo

Pass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API.

EndDate
EndTimestringNo

Pass through parameter to the ServiceDispatch Dispatch "Get Status Enquiry" API.

EndTime

HTTP Response

Success

On success, a JSON-formatted version of the ServiceDispatch Dispatch "Get Status Enquiry" API response will be returned.

GetStatusEnquiry Response Object Format

Code Block
languagejs
{
    "AckMsg": "",
    "WorkItemCount": "4",
    "WorkItems": [
        {
            "MFGID": "9999",
            "Id": "ka.2019-8-7.100263",
            "WorkStatus": "COMPLETED",
            "WorkSubStatus": "COMPLETED",
            "SPSvcrAcct": "FSSTEST",
            "UpdatedDate": "2019-11-04T11:47:00.000Z",
            "CompletedDate": "2019-11-04T00:00:00.000Z",
            "Payment": [
                {
                    "POAmount": "0"
                }
            ],
            "Booking": {
                "ServiceOrg": "FSSTEST",
                "SchdStart": "2019-08-09T12:00:00.000Z",
                "SchdEnd": "2019-08-09T23:00:00.000Z"
            }
        },
		// ...
    ]
}

GetStatusEnquiry Response Object Properties

PropertyTypeDescription
AckMsgstringDescription of the response success.
WorkItemCountstringThe number of ServiceDispatch Dispatch Servicer objects in the WorkItems array.
WorkItemsarrayAn array of objects, each representing the status for a ServiceDispatch Dispatch Work Item.

MFGIDstringThe ServiceDispatch Dispatch Work Item MfgSvcrAcct value.

IdstringThe ServiceDIspatch Work Dispatch Work Item CallNo value.

WorkStatusstringThe ServiceDIspatch Work Dispatch Work Item work status.

WorkSubStatusstringThe ServiceDIspatch Work Dispatch Work Item work sub-status.

SPSvcrAcctstringThe ServiceDispatch Dispatch Work Item ServicePower account number.

UpdatedDatestringThe ServiceDIspatch Work Dispatch Work Item updated date.

CompletedDatestringThe ServiceDIspatch Work Dispatch Work Item completed date.

PaymentarrayAn array containing details of the Work Item payment information.


POAmountstringThe ServiceDispatch Dispatch PO amount value.

BookingobjectAn object containing details of the Work Item booking.


ServiceOrgstringThe ServiceDIspatch Work Dispatch Work Item service organization.


SchdStartstringThe ServiceDIspatch Work Dispatch Work Item scheduled start date/time.


SchdEndstringThe ServiceDIspatch Work Dispatch Work Item scheduled end date/time.

Error

On error, a JSON-formatted version of the ServiceDispatch Dispatch "Get Status Enquiry" API response will be returned.


Code Block
languagejs
{
    "Success": false,
    "Code": 9,
    "Payload": {
        "returnCode": {
            "type": "Error",
            "message": "Dispatch Error Code"
        }
    }
}

Return Codes

In addition to the Standard Return Codes, and the ServiceDispatch Dispatch Error codes, individual API calls made have unique codes found on their individual pages.