_API EmpOverrideRequest Definition

<sp:EmpOverrideRequest>

<empID>?</empID>

EmpID

Employee the override is for.

<date>?</date>

Date the override is to be applied on.

<shiftPeriod>

The startDate and endDate associate a shift that spans a day boundary with the supplied date. If not supplied, they both default to date.

Note that, because the shift override must overlap date by at least one hour (FS 190, 2.6(i)), startDate can only be the same as date or a day earlier.  Similarly, endDate can only be the same as date or a day later.

<startDate>?</startDate>

<startTime>?</startTime>

<endDate>?</endDate>

<endTime>?</endTime>

<isCapacityShift>?</isCapacityShift>

Is this shift taken account of for capacity settings?

If it is not supplied, and there is no existing shift on the override date, it will default to true.  If it is not supplied, and there is no existing shift on the override date, it will default to true. 

<isAllDayJobShift>?</isAllDayJobShift>

Can all day jobs be booked onto the shift?

<breaks>

Details of any breaks that should be applied to the override.

A maximum of SP_BreakSeq_Max (5) can be defined. All of the parameters in the <reqBreaks> section are mandatory for each <reqBreaks> section supplied.

The duration of the breaks must be between SP_BreakDurationMin (0) and SP_BreakDurationMax (999).

A BreakDuration of 0 has the effect of removing a break, however BreakEarliest and BreakLatest must still be provided, and must still lie within the shift time.

If the same BreakName as original shift breaks, or previously added overrides, is used then they are taken as replacing these breaks. If they are unique then are considered to be additional breaks to be taken.

If no <reqBreaks> are supplied then it has the effect of removing any overrides and returning to the original shift breaks.

If an original shift break is to be removed, and not replaced, the break should appear in the sequence of overrides with a BreakDuration of zero.

Breaks must be passed in chronological sequence.

BreakName

</breaks>

</shiftPeriod>

<startLoc>

In a supplied EmpLocs, if startLoc, endLoc or LKCLoc aren’t to be overridden, SP_IntNoValue or SP_IntNoUpdate should be supplied. StartLocPostcode is ignored unless startLoc is Supplied; the same applies to EndLocPostcode and endLoc, and LKCLocPostcode and LKCLoc.

<locType>?</locType>

<postcode>?</postcode>

Postcode

</startLoc>

<endLoc>

<locType>?</locType>

<postcode>?</postcode>

Postcode

</endLoc>

<LKCLoc>

<locType>?</locType>

<postcode>?</postcode>

Postcode

</LKCLoc>

<options>

<OverridePubHols>?</OverridePubHols>

An override will be generated (or an existing override replaced) for a date when an operative is on a Public Holiday only if OverridePubHol is set.

<OverrideNoShift>?</OverrideNoShift>

If OverrideNoShift is set, a shift override can be added (or an existing override replaced) for a non-shift date, including a date when the operative has no shift pattern assignment. 

</options>

</sp:EmpOverrideRequest>