Skip to main content

Integrate TOIL/TIL with Xero

How to link your TOIL setup in Tanda with Xero.

Updated this week

Once you've set up TOIL in Tanda, you can integrate this with your setup in Xero.

TOIL set up in Xero

For TOIL, you only need one pay item, which will be used for accrual and time taken. This pay item should be a 'Leave' pay item. It should also be the only pay item of its name. If you have another pay item of the same name among your Earnings or Inactive pay items, this can cause duplicates, leading to errors.

To create your Leave Pay item, in Xero, navigate to Settings > Payroll Settings > Pay Items > Leave > Add. When creating the Pay Item, ensure the Type of Units is set to 'hours', as Tanda integrates with Xero via Timesheets.

Important:

After you've created the Leave Pay Item, you'll need to assign this Leave Type to the applicable employees in Xero under Payroll > Employees > Leave > Assign Leave Type.

When assigning the Leave Type to an employee, set the Leave Calculation Method to 'No Calculation Required'. If relevant, you can also enter an opening balance here.

Export TOIL from Tanda to Xero

When TOIL is exported from Tanda to Xero, TOIL accrued will display on the payslip under 'Accruals' alongside other leave accruals (e.g., Annual Leave), and TOIL taken will appear as an approved Leave Request. TOIL is not visible on the timesheet in Xero, as this is reserved for hours worked. 

Troubleshooting

If your TOIL accruals are not exporting from Tanda to Xero, check the following:

  1. One of the most common reasons TOIL accruals do not export is that there is an earnings pay item with the same name as the TOIL leave pay item in Xero. If this is the case, rename the earnings pay item so that it can correctly scope to the leave pay item.

  2. Additionally, check if there is an inactive leave pay item with the same name as the active one in Xero. If this is the case, rename the deactivated one.

Related Keywords:

TOIL, TIL, Time Off in Lieu, Time in Lieu

Did this answer your question?