Difference between revisions of "Xero System Configuration"

From Wageloch Wiki

Line 63: Line 63:


=Pay Items=
=Pay Items=
Wageloch is able link to specific pay items in Xero, which is how we write in your timesheet data.


These pay items can only be configured as <b>multipliers of ordinary hours</b>, or as <b>rate per unit</b>.
Common types of pay items to see will be:
* Ordinary Hours
* Overtime
* Allowances
<b>NOTE:</b> Due to Xero system limitations we cannot write timesheet hours into Fixed Amounts and any unit type for any pay item must be Hours.
Certain calculations may not work correctly in Xero as leave does not accrue on Rate Per Unit pay items.
This is especially important when we're talking about staff hourly rates increasing due to higher duties, supervisor rates or similar.
We typically recommend these values to be the difference between the higher rate and ordinary hourly rate.
Always speak with your Wageloch implementation manager or contact Helpdesk if you're concerned.
===Multiplier Pay Items===
In this example we'll be setting up a standard penalty rate of pay, being weekend hours. The same steps can be completed with overtime and allowance category types.
* Click into your Xero Settings area
* Select Payroll Settings and the Pay Items tab.
* Click Add in the top right and select Ordinary Hours
<<<screenshot here>>>
* Give the pay item a name (i.e. Saturday 1.25x)
* Set the pay item type to Multiplier of Base Rate.
* Set the multiplying factor (i.e. 1.25x)
* Units will be set to Hours.
* Select if the pay item is eligible for superannuation, taxation or leave accruals.
* Save to finish.
<<<screenshot here>>>
===Rate Per Unit Pay Items===
* Click into your Xero Settings area
* Select Payroll Settings and the Pay Items tab.
* Click Add in the top right and select Ordinary Hours
<<<screenshot here>>>
* Give the pay item a name (i.e. Supervisor)
* Set the pay item type to Rate Per Unit.
* You can enter a dollar value here or leave the rate per unit blank and enter this on the Pay Template for the employee.
** <b>NOTE:</b> Certain calculations may not work correctly in Xero as leave does not accrue on Rate Per Unit pay items.
* Units will be set to Hours.
* Select if the pay item is eligible for superannuation, taxation or leave accruals.
* Save to finish.
<<<screenshot here>>>


=Pay Templates=
=Pay Templates=

Revision as of 07:04, 4 August 2023

Currently in development


Tracking Categories

Having Xero's tracking categories set up is crucial for Wageloch to be able to export timesheets through - this can be a very simple configuration to get the hours into the system, or more detailed to help with cost journalling.

If your Xero file has no tracking categories configured or existing categories have been modified since their creation, you will experience issues with exporting timesheets from Wageloch to your Xero file.

NOTE: Leave types cannot be allocated to a cost journal when using detailed tracking categories.

Basic Category Creation

This is the bare minimum configuration for a tracking category that we need for integration.

  • Click on the company file name in the top left and select Settings
  • Select Advanced Settings from the bottom of the screen.
  • Select Tracking Categories.
  • If no categories are present, click Add.
  • Call this category Timesheets.
  • Click Add Option.
  • Call this option All Hours.


<<<screenshot here>>>


  • Go into your payroll settings in Xero
  • A little ways down, you'll see an option for Timesheets.
  • Click in this drop menu and select Timesheets.
  • Click Save.
  • This will now be available in Wageloch to link our timesheet data.


<<<screenshot here>>>

Detailed Category Creation

If you're wanting to use cost journals by departments (FOH, BOH, Bar, etc.) or by job role (Job A, B, C, etc.), using detailed tracking categories will help you send through the information you require.

See more information in Departments & Roles.

  • Click on the company file name in the top left and select Settings
  • Select Advanced Settings from the bottom of the screen.
  • Select Tracking Categories.
  • If no categories are present, click Add.
  • Call this category whatever you need; Job Codes, Departments, etc.
  • Click Add Option.
  • Give this option a name according to the category name (i.e. Jobs >> Job A, Job B, Job C or Departments >> FOH, BOH, Bar, Management.)
  • Create as many options as required to meet your needs.


<<<screenshot here>>>

  • Go into your payroll settings in Xero
  • A little ways down, you'll see an option for Timesheets.
  • Click in this drop menu and select Timesheets.
  • Click Save.
  • This will now be available in Wageloch to link our timesheet data.


This setup is used when we're tracking job costings in Wageloch by departments or roles.


<<<screenshot here>>>

Pay Items

Wageloch is able link to specific pay items in Xero, which is how we write in your timesheet data.

These pay items can only be configured as multipliers of ordinary hours, or as rate per unit. Common types of pay items to see will be:

  • Ordinary Hours
  • Overtime
  • Allowances

NOTE: Due to Xero system limitations we cannot write timesheet hours into Fixed Amounts and any unit type for any pay item must be Hours.


Certain calculations may not work correctly in Xero as leave does not accrue on Rate Per Unit pay items. This is especially important when we're talking about staff hourly rates increasing due to higher duties, supervisor rates or similar.

We typically recommend these values to be the difference between the higher rate and ordinary hourly rate.

Always speak with your Wageloch implementation manager or contact Helpdesk if you're concerned.

Multiplier Pay Items

In this example we'll be setting up a standard penalty rate of pay, being weekend hours. The same steps can be completed with overtime and allowance category types.


  • Click into your Xero Settings area
  • Select Payroll Settings and the Pay Items tab.
  • Click Add in the top right and select Ordinary Hours

<<<screenshot here>>>

  • Give the pay item a name (i.e. Saturday 1.25x)
  • Set the pay item type to Multiplier of Base Rate.
  • Set the multiplying factor (i.e. 1.25x)
  • Units will be set to Hours.
  • Select if the pay item is eligible for superannuation, taxation or leave accruals.
  • Save to finish.

<<<screenshot here>>>

Rate Per Unit Pay Items

  • Click into your Xero Settings area
  • Select Payroll Settings and the Pay Items tab.
  • Click Add in the top right and select Ordinary Hours

<<<screenshot here>>>

  • Give the pay item a name (i.e. Supervisor)
  • Set the pay item type to Rate Per Unit.
  • You can enter a dollar value here or leave the rate per unit blank and enter this on the Pay Template for the employee.
    • NOTE: Certain calculations may not work correctly in Xero as leave does not accrue on Rate Per Unit pay items.
  • Units will be set to Hours.
  • Select if the pay item is eligible for superannuation, taxation or leave accruals.
  • Save to finish.

<<<screenshot here>>>

Pay Templates

Leave Loading Entitlement

Adding Leave Accruals