> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.2cloudnine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flame Tree '25 - Release Notes

The Flame Tree release for 2cloudnine Payroll introduces a number of exciting additions, enhancements
and refinements to further elevate the User experience with new automation offerings, expanded
Interpretation logic and the continued improvement of calculations. Below is an outline of the new
features and updates that are included in the release.

### Superannuation Data Retrieval <Badge color="green">New</Badge>

A technical change has been made to ensure the Superannuation Fund retrieval scheduled job runs as
expected. Part of this fix includes a tidy-up for APRA/RSA Superannuation Funds in your Org based on
updated data from the ATO.

**Configuration Requirement** : **Compulsory** (For existingOrgs, contact your 2cloudnine representative for
details)

**User Story Reference Number(s)** : SC-37901

### Page Layout Updates <Badge color="green">Update</Badge>

Redundant fields have been removed from the Employment Cost Page Layout, in accordance with recent
enhancements to Rate Calculator functionality. The following two fields are no longer required and have
been removed from the Non-Superannuation Page Layout for Employment Costs:

* Last Date Rate Calc Update Completed
* Last Date Rate Calc Update Required

Two new Superannuation Fund Page Layouts have also been made available for the following Record
Types, to facilitate SuperChoice fund retrieval functionality:

* APRA and RSA Funds
* Self Managed

<span id="configuration-requirement-optional" />

**Configuration Requirement:Optional User Story Reference Number(s):** SC-37698, SC-38117

### Beta Introduction: Agreements Solution

The new 2cloudnine Agreements framework establishes a comprehensive, centralised model for
managing Client-related rates data, including Pay and Invoice Rates, Margins, and Employment Costs.
Designed to replace fragmented or manual processes, this solution delivers a scalable, maintainable, and
consistent foundation for Rates management within 2cloudnine Payroll.

Several new Objects and Record Types have been created and made available via the 2cloudnine
Agreements Permission Set, including Agreements, Job Roles, and additional Minimum Pay Rates. These
will function to elevate existing Rates management by delivering the following key benefits:

* **Centralised Agreements Management** : Agreements actas the single source of truth for Rates
  and Costs, linking directly to Clients and Assignments.
* **Establishment of Role Hierarchies** : Job Roles serveas logical groupings of Minimum Pay Rate
  records, simplifying Rates management and supporting multiple types of roles under the same
  Agreement.
* **Consolidated Rate Calculations and Automations:** Agreementsleverage Job Roles, Minimum
  Pay Rates, Pay Rate Loadings, Calculation Methods, and Employment Cost Items to calculate
  Assignment Rates automatically. This eliminates the dependency on the Rate Calculator,
  improving efficiency and reducing data volumes.
* **Enhanced Employment Cost Controls** : Employment CostItems (ECIs) may now be linked directly
  to either Agreements or Job Roles, providing granular control over on-cost calculations such as
  Superannuation, Payroll Tax, or Workcover Insurance. Exceptions may also be defined by Pay
  Code, Worker Type, or Location, for refined compliance across states.
* **Tailored Margin and Markup Options** : Margin and Markup methods can now be defined at either
  the Agreement or Minimum Pay Rate level, to accommodate flexible rate structures to be
  implemented across similar contracts without the need for duplicate records.
* **Seamless Rate Updates** : The Agreements model supports both future and historical updates for
  existing Rates, to facilitate any revisions or adjustments necessary.

Existing Rate Automation Validations have been uplifted to account for Agreements, and Rate Calculator
validations have been amended to prevent any overlap between Agreements and existing automations.

**Configuration Requirement:** Contact your Provider Partnerfor details **User Story Reference Number(s):** SC-37697, SC-37730, SC-37940, SC-37939

### Pilot Release: Leave Automations for the Employee Community

To enhance the Leave Management User experience, particularly for Employees with Work Schedules,
changes have been implemented to streamline the visibility and entry of Payee Leave Events.

The Community Leave Dashboard UI has been updated with new Calendar views that display Employee
Leave Events (including requested leave) and highlight public holiday periods.

While creating a Leave Event, the system displays the Calendar view as an overlay to the Employee's
active Work Schedule, which is now used to automatically calculate and pre-populate the Total Hours for
the Leave Event, ensuring greater accuracy and efficiency during the submission process.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-37710, SC-32956,SC-37864, SC-37865, SC-37866, SC-37867, SC-37868,
SC-37892, SC-37891, SC-38001

### Pilot Release: Timesheet Integration for Planned Payee Leave

Future-dated Payee Leave Events can now be inserted into related Timesheet Entries upon Approval, to
facilitate a more seamless integration of Leave within Employee Timesheets.

Public Holiday Leave Entry is now automated, with integration remodelled to override applied Leave
Types for Approved Leave spanning Public Holidays, inserting the appropriate Public Holiday Leave Type
instead.

Additionally, several new and updated fields have been added to both the Leave Rule and Payee Leave
Event Objects:

* Leave Rule Start Time and End Time fields have been modified to more easily accommodate
  Part-Day Payee Leave Events.
* Timesheet Entry Last Updated, Timesheet Entry Creation Status, and Source Leave Event fields
  are all now available within Payee Leave Rules, improving traceability for automated Payee Leave
  Events.
* New Payee Leave Event Pre Approval Record Type enables Employees to create and insert
  planned absences for future periods into Timesheets, without requiring approvals pre-Timesheet
  processing.

**Configuration Requirement** : **Optional User Story Reference Number(s)** : SC-32680, SC-37871,SC-37944, SC-35777, SC-37454

### Update Public Holiday Calendar Selection for Timesheet Entries

A new field Public Holiday Calendar Override is now available on Timesheet Entry records, allowing
Entries to reference alternate Public Holiday Calendars without the need to create separate Assignment
records.

By default, Timesheet Entries will continue to be interpreted against the Assignment’s Public Holiday
Calendar. However, when Payroll Users populate the Public Holiday Calendar Override field,
Interpretation will instead assess Timesheet Entries based on the Public Holiday Calendar populated.
This adjustment has been made to improve flexibility for Payees working across multiple regions or
locations, to reduce the need for duplicated Assignment data, and to minimise the need for manual
adjustments to be made post-interpretation.

**Configuration Requirement** : **Optional User Story Reference Number(s)** : SC-33992

### Consolidate Assignment Rates using Dynamic Record Matching

The newly available Assignment Rate Matching Mode picklist field enables Assignment Rates to be
dynamically allocated during the Interpretation of Breakpoints involving Project Codes or Timesheet
Activities.

This functionality reduces the number of Assignment Rates required for Timesheet Interpretation by
using decision logic (Assignment Rate Matching Mode) to determine which Assignment Rates should be
applied to the related Pay Transactions. The following matching logic options are available for selection:

* **Exact Match**

Automation will attempt to identify an Assignment Rate containing both the entered Project
Code/Timesheet Activity, and the Pay Code from the applicable Breakpoint. If no existing records
are identified, interpretation will not proceed.

* **Default to Pay Code**

Automation will attempt to identify an ‘exact match’ Assignment Rate. If this fails, an Assignment
Rate will instead be matched using only the Pay Code from the Breakpoint associated with the
entered Project Code/Timesheet Activity.

* **Allow no Assignment Rate**

Automation will apply the Assignment’s entered Pay Rate to all Breakpoints associated with
Project Code/Timesheet Activity Entries.

* All related Pay Transactions will be flagged for manual review, following creation.
* This method is not recommended for use except in special circumstances, due to lack of
  compatibility with Invoice and Pay Rate generation.

Assignment Rate Matching Modes are now available for selection within new and existing Assignment
Rates. When blank/not populated, Interpretation will continue to require an exact Assignment Rate
match for each potential combination of Pay Code, Project Code and Timesheet Activity related to
Assignments.

All Pay Transactions created as a result of Rates Matching automation will reference the Project
Code/Timesheet Activity originally entered on the Timesheet Entry, to provide record traceability for
reporting, invoicing, and auditing requirements.

**Configuration Requirement** : **Optional User Story Reference Number(s)** : SC-36387

### Specify Maximum Prior Periods for Pay Batch Creation

Payroll Users can now define the number of prior Pay Calendar Periods to be included during Pay Batch
creation and when using the Bulk Add feature.

The Maximum Earlier Pay Calendar Periods field may be updated within Pay Schedules, enabling the
default number of Prior Periods to be adjusted to improve efficiency and reduce processing times by
limiting the number of Periods retrieved during Pay Batch creation.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-35175

### Ability to choose penalty applications for Shift End and Start record types

Interpretation logic has been altered to allow Interpretation to assess Shift End Breakpoint application
based on Standard Hour End Times, rather than Timesheet Entry End Times. This enables greater
flexibility on the Penalty Pay Codes that apply for Timesheet Entries.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-35552

### Shift Logic Expansion - Pay Code Caps & Sleepover/Wake Up Interpretation

Pay Code Caps are now able to be applied on a Shift basis rather than a Daily basis, so that specific Cap
periods can be defined for individual Pay Codes.

Furthermore, Timesheet Entries for Sleepover and Wake Up Activities may now be automatically grouped
for assessment as a single Shift, when Shift Logic is applied to Interpretation. This modification ensures
Shift logic for Sleepover and Wake Up Entries are applied in accordance with the entire Sleepover period,
improving Interpretation Logic for healthcare-related Awards and reducing the requirement for manual
adjustments.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-37692, SC-35453

### Enhanced Allowance Breakpoint Application

Interpretation capability has been extended to support the application of different Pay Codes for
Allowances occurring across Saturday, Sunday, and Public Holiday periods. Specific Pay Codes may now
be defined for Hourly and Daily Allowances.

There is now the ability for users to define what type of Overtime is applied to Allowance Breakpoints for
Hourly, Daily, Weekly and Frequency where the Type is Overtime.

Allowance capabilities have also been extended to Standard Hours within Allowance Breakpoints, so that
Allowances may be calculated based on the amount of Standard Hours worked. These improvements
enhance flexibility for managing complex Award conditions.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-37691, SC-37690,SC-37689

### STP Lodgement Enhancements

A technical alteration has been made to ensure successful STP Lodgements are marked as Completed
within three business days following submission to the ATO.

The Completed Status replaces the previous Confirmed Status, and has been introduced to address a
potential discrepancy preventing Lodgements from receiving the Success/Failure responses issued by
the ATO. Improved automation ensures Lodgements are updated in a more timely manner, to provide
better visibility of historical Lodgement outcomes within the Payroll UI.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-36405

### Revised Employment Cost Exception Record Types

To align with recent functional enhancements, a number of now-redundant Employment Cost
Exceptions have been removed from the list of available Record Types.
All Assignment, Client and Payee Employment Cost Exception Record Types will be depreciated, so that
only Pay Code-based Record Types are available for creation and use.

This alteration ensures only valid and supported Employment Cost Record Types are available for
creation.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-37712, SC-38000

### Field Service Extension Bulk Data Uplift

Users may now utilise bulk-record creation to automatically generate Resource Absence Records from
Payee Leave Events, reducing manual efforts and ensuring the maintenance of data integrity.
Configurable limits, Validation Rules, and progress notifications ensure efficient and reliable processing of
large-volume Leave data.

Users and Service Resources may also be created in bulk for existing Payees, without the need for
manual creation. This automation adheres to Salesforce best practices, and provides greater scalability
and error handling when integrating large volumes of Service Resources.

**Configuration Requirement:Optional User Story Reference Number(s):** SC-35128, SC-34935

### Minor Updates

Minor updates in the following areas have also been provided. There are no configuration requirements
and these items will become available on installation of the package.

#### Timesheet Interpretation <Badge color="green">Update</Badge>

* An alteration has been made to augment the way Shift fields are populated for Timesheet Entries
  not associated with Sleepover or Wake Up Shifts.

User Story Reference Number(s): SC-38146

* Logic for Split/Broken Shift Reset Hours has been updated to enhance the accuracy of Broken
  Shift application, so that Broken Shift logic is only applied when defined maximum thresholds
  are exceeded.

User Story Reference Number(s): SC-36765

* Calculations for Broken Shift Allowances have been modified, to address instances where Broken
  Shift Logic was incorrect due to a Date/Time calculation discrepancy.

User Story Reference Number(s): SC-36863

* Minimum Hours logic has been improved for Time of Day Interpretation, to ensure consistency.

User Story Reference Number(s): SC-34306

* A fix has been applied to address the potential creation of duplicate Pay Transactions of Overtime
  hour calculations for multi-day Timesheet Entries.

User Story Reference Number(s): SC-35785

* Logic for handling Part-Day Public Holidays for Frequency calculations within Interpretation
  Rules has been refined.

User Story Reference Number(s): SC-36068

* Interpretation has been updated to ensure Frequency Overtime Breakpoints are only applied
  once the defined Maximum Threshold has been exceeded for Total Hours.

User Story Reference Number(s): SC-36320

* Improvements to edge case scenarios for Frequency Overtime Interpretation Logic.

User Story Reference Number(s): SC-36320

* Code adjustments have been made to prevent any incorrect interpretation caused by Total Hour
  Break Times populated in Timesheet Entries containing a Part-Day Public Holiday.

User Story Reference Number(s): SC-36814

* Improvements to Interpretation address an edge case scenario where Payee Leave Event details
  were not populated on all Penalty Loading and Casual Loading Pay Transactions generated for
  Leave Timesheet Entries.

User Story Reference Number(s): SC-37894

* Calculation of Dual Leave Loading has been altered to ensure that the field Penalty Pay Code and
  Casual Loading Pay Code is taken into account during Interpretation.

User Story Reference Number(s): SC-37882

#### Timesheet Entry

* A defect causing rounding to the nearest ten minutes for Timesheet Entries has been addressed,
  so that time is now saved exactly as entered.

User Story Reference Number(s): SC-35176

#### Pay Batch Manager

* Changes have been implemented to facilitate access to Pay Advice Previews within the Pay Batch
  Manager, without requiring any additional permissions to view summaries prior to PDF creation.

User Story Reference Number(s): SC-37774

* Calculations have been improved to prevent PAYG being incorrectly refunded for Payees with
  Marginal payments included in earlier Pay Batches and subsequently paid in later Pay Batches
  for the same Pay Period.

User Story Reference Number(s): SC-34172

* A small code update has been deployed to re-calibrate the calculation logic used for GST
  rounding.

User Story Reference Number(s): SC-38025

#### Single Touch Payroll (STP)

* The STP Validation comparing Pay/Update Date and Run Date (350-day rule) has been refined to
  apply only to STP Pay Events, ensuring STP Update Events are not incorrectly flagged during
  validation.

User Story Reference Number(s): SC-37667

#### Invoicing

* Refinements made to GST calculations ensure Taxable Earnings are rounded to two decimal
  places, to prevent any minor invoicing discrepancies caused by unrounded amounts.

User Story Reference Number(s): SC-36808

#### Rates Automation

* An improvement has been implemented to ensure the Hourly Rate is automatically populated on
  all Assignment Rates created via Minimum Pay Rate Automation, resolving instances where this
  value was only populated when Default Pay Rate = Yes.

User Story Reference Number(s): SC-37476

<Tip>
  Take advantage of these new features and improvements now. Talk to\_ *your Partner Provider or System Administrator about upgrading so you* \_can experience the benefits of the Flame Tree Release for yourself.
</Tip>
