Important Notices and Breaking Changes V12.33

The enhancements described in the related pages below represent significant functional changes that you must be aware of prior to upgrading to this release. Some of these enhancements require specific actions before or immediately after upgrading and are therefore highlighted here for your reference. Please refer to the relevant sections of this What’s New Guide, as identified below, for detailed information about each enhancement and any configuration that is required.

Please be aware of the following important points about upgrading to this release:

Please ensure that no pay batches remain open in the Payroll module at close of business on your notified upgrade date. All pay batches must be closed before FastTrack can proceed with upgrading your environment.

New APIs

The following new APIs have been created:

Leave Balance API

API consumers may wish to be able to import payees' leave accrual and entitlement balances into FastTrack360 in bulk. This may, for example, be required where an Agency acquires another business and the payment and management of leave for the incumbent payees is required in FastTrack360.

API: PATCH/leaveBalance

Column Name	Description	Mandatory

Column Name	Description	Mandatory
payeeNo	The payee number.	Yes
leaveType	The name of the Leave Type to which the balance is to be updated.	Yes
transactionDate	Date of the accrual/entitlement adjustment transaction.	Yes
accrualValue	The number of units by which the leave accrual balance is to be increased or decreased (negative value are accepted). For example, a value of 10 will increase the leave accrual balance by 10 units while a value of -10 will decrease the leave accrual balance by 10 units. The leave accrual value must be supplied if you intend to adjust the balance of leave that has been accrued but is not yet available to be taken (i.e. is yet to be transferred into an entitlement to take leave). This value must be provided OR the entitlementValue	Conditional
entitlementValue	The number of units by which the leave entitlement balance is to be increased or decreased. For example, a value of 10 will increase the leave entitlement balance by 10 units while a value of -10 will decrease the leave entitlement balance by 10 units. The leave entitlement value must be supplied if you intend to adjust the balance of leave that is available to be taken immediately (i.e. has already been transferred into an entitlement to take leave). . This value must be provided OR AccrualValueIn	Conditional
rate	Pay rate associated with the accrual/entitlement. Must be provided if the ‘Apply to Type’ of the Leave Type is Hours with Rate, else can be optionally provided for other types of leave.	Conditional

API Changes

The following changes have been made to the FastTrack360 external APIs:

There has been a change to the validations for the patch/interpretedTimesheet API to allow the status of an interpreted adjustment timesheet to be changed such that the adjustment timesheet can be billed before the original timesheet or a prior adjustment timesheet for the same job order and period ending date.
The GET/interpretedTimesheets API has been enhanced to include fields for ‘payBatchId’ and ‘billBatchId’ so the method can be used to determine if the Timesheets have been paid and or billed.
The following APIs have been enhanced to support the ability to add an Additional Item where the Pay Code Type is leave that has been linked to an Absence Type to support the payment of leave. Changes include validating if the Pay Code is linked to an Absence Type and where true, checking to see if there are any clashes with Leave Requests and other Leave items being added to the Timesheet. Where there is a clash, the call is rejected and a response will advise of the clash.
The following changes APIs have been updated with the logic changes:
- POST/timesheet - this sets status as 'Saved'.
- POST/timesheet/adjustment - this sets status as 'Saved',
- PATCH/timesheet/{id}/status/{statusId} - where a call is made to change a timesheet status to ‘Submitted’, ‘Approved’.
- POST/timesheet/additional items - this provides the ability to add additional items to a timesheet prior to being Submitted.
- POST/timesheet/attendance absence - this provides the ability to add attendance/absence items to a timesheet in the ‘Saved’ state.
The PATCH/timesheet/{id}/status/{statusId} has been enhanced to return an error where there is an overlap (clash) of Attendance/Absence items in the call. This validation will be triggered where the status is changed to ‘Submitted’ or ‘Approved’.