<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.

When creating an override, if startDate/startTime and/or endDate/endTime are not supplied, the override will be created using the start and/or end times from the original shift.

When creating an override on a Public Holiday (provided that OverridePubHols is set), if startDate/startTime and/or endDate/endTime are not supplied, the override will be created using the start and/or end times from the shift that would be in place if there was no Public Holiday on that day.

When updating an override, the original shift times are no longer considered. In this case, if startDate/startTime and/or endDate/endTime are not supplied then the start/end times in the override will remain unchanged.

<startDate>?</startDate>

<startTime>?</startTime>

<endDate>?</endDate>

<endTime>?</endTime>

<isCapacityShift>?</isCapacityShift>

Is this shift taken account of for capacity settings?

When creating or updating an override, if it is not supplied, it defaults to the setting from the original shift pattern. If 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?

When creating or updating an override, if it is not supplied, it defaults to the setting from the original shift pattern. If there is no existing shift on the override date, it will default to true. 

<breaks>

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

When creating an override:

• If no reqBreaks are supplied, then the override will be created with breaks at the same times and durations as the original shift breaks.
• If the same BreakName(s) are supplied for any of the original shift breaks, these will be takes as replacing those breaks.
• If unique BreakName(s) are supplied these will be considered to be additional breaks to be taken.
• If any break from the original shift is not included in the reqBreaks container at all, then the override will be created with the times and duration of that original shift break.
• 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 -1.
• As with shift start and end times above, if date is a Public Holiday, then the break times used as defaults will be those of the shift that would be in place if there was no Public Holiday.
• If the day for which the override is being created already contains one or more breaks that are Fixed, Started or Finished then the details for these breaks should not be included in the reqBreaks, the override will take the fixed time/duration for these breaks. Any request to override a break in Fixed, Started or Finished state will silently ignore that update (no error will be returned).

When updating an override, the values from the original shift are no longer considered:

• If no reqBreaks are supplied, then the breaks created by the original override will be unchanged.
• If the same BreakName(s) are supplied for any of the breaks in the original override, these will be takes as replacing those breaks.
• If unique BreakName(s) are supplied these will be considered to be additional breaks to be taken.
• If an break is to be removed from the override, the break should appear in the sequence of overrides with a BreakDuration of -1.
• If the day for which the override is being updated already contains one or more breaks that are Fixed, Started or Finished then the details for these breaks should not be included in the reqBreaks, the override will take the fixed time/duration for these breaks. Any request to override a break in Fixed, Started or Finished state will silently ignore that update (no error will be returned).

For both creation and update, the breaks may not overlap with each other- so for each break, the BreakLatest + BreakDuration must be less than the next BreakEarliest. All breaks must be contained within the shift; that is:

• BreakEarliest must be greater than or equal to startTime; and
• BreakLatest + BreakDuration must be less than or equal to endTime.

The duration of the breaks must be between 0 and 999.

A BreakDuration of -1 has the effect of removing a break, however BreakEarliest and BreakLatest must still be provided, but they will be ignored. It is not possible to create a new break with a BreakDuration of -1.

A maximum of SP_BreakSeq_Max (10) can be defined in the structure, but the total number of breaks in the override period once breaks have been added and removed may not exceed 5.

All of the parameters in the <reqBreaks> section are mandatory for each <reqBreaks> section supplied.

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>