Click here to expand...

Web Service					Type	Description	Req?	Val?
`<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.
			`<reqBreaks>`
				`<BreakName>?</BreakName>`	`BreakName`
				`<BreakType>?</BreakType>`
				`<BreakEarliest>?</BreakEarliest>`
				`<BreakLatest>?</BreakLatest>`
				`<BreakDuration>?</BreakDuration>`
			`</reqBreaks>`
		`</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>`

Browser not supported