Description

Cancelling a job in ServiceOptimizer causes the the job to be completely removed from the system, although, if activated, an audit trail for the job will remain.

Definition

The definition of this API is:

Web Service			Type	Description	Req?	Val?
`<sp:JobCancelRequest>`
	`<jobID>?</jobID>`		`JobID`	Identifier of the job that should be cancelled.
	`<cancelReason>`
		`<cancelReasonId>?</cancelReasonId>`	`cancelReasonId`	Cancellation reason ID.
		`<cancelDescription>?</cancelDescription>`	`cancelReasonDesc`	Free-form text reason for cancellation.
	`</cancelReason>`
`</sp:JobCancelRequest>`

Return Structure

The API returns a non-standard return structure.

Click here to expand...

Web Service			Type	Description	Req?	Val?
`<sp:JobCancelResponse>`
	`<result>?</result>`			This contains the standard return structure.
	`<jobInfo>`			This will only be present if the cancel request has succeeded.
		`<jobID>?</jobID>`	`JobID`
		`<onHold>?</onHold>`	`Boolean`	This indicates whether or not the Job is set 'on Hold'; the value returned is 'true' if the Job is On-Hold and 'false' otherwise.
		`<bookDuration>?</bookDuration>`	`unsigned int`	For a non-all-day job, `BookDuration` returns the Actual Duration of the job if it’s known (i.e. the job has been logged on or cleared), or, if not, the Scheduled Duration. For an all-day job, `BookDuration` returns the same values, except if the job is in the in-tray, in which case `SP_IntNoValue` is returned since all-day jobs in the in-tray have no Scheduled Duration.
		`<disStatus>?</disStatus>`	`DisStatus`	Current dispatch status for the job. Null if the job is unresourced.
		`<empID>?</empID>`	`EmpID`	The employee the job is currently assigned to. Null if the job is in the unreasourced tray.
	`</jobInfo>`
`</sp:JobCancelResponse>`

Return Codes

In addition to the Standard Return Codes, the possible Return Codes from this API are:

SP_OK (0)
SP_JOBID_INVALID (1)

Browser not supported