Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article we show how to use Xero AU integration with Tātou.

...

Create a new Pay item of type Ordinary Time Earnings: Xero → Payroll → Payroll Settings → Pay Items. Leave the Rate per Unit empty if you want to control hourly rate by employee, or put a rate if you want to control by Pay Item.

...

You can link the recent “Ordinary Hours” Pay item created to an Employee. Go to Xero Employee → Employment → Ordinary Earnings Rate and select the appropriate record as image below:

...

Depending on your setup, Tātou can generate these types of earnings: Hourly, Contract (Piece rate), Topup, Overtime and Paid rest break. In order to get those earnings on Xero as Payslips earning lines, you need to set up corresponding Pay Items (Xero → Payroll → Payroll Settings → Pay Items → Earnings).

Set up the following pay items:

...

The integration will always get the more specific Pay Item when available. It’s important to note that the default “Piece rate” is required for the integration, as if no task found, it will be used.

You can use the same for all Earning Types. So you can potentially have “Ordinary hours | Pruning” for your supervisors for example.

Selecting employees to send payroll data

During the sync process the integration will ignore employees who the Contract Type is “Contractor”.

...

Syncing a pay period

Before you sync your first pay period, make sure you Calendars on Xero match the pay frequency (eg. Weekly). Also check theCalendar next pay period, it needs to be in sync with the period you want to send.

To check and sync a pay period, go to Tātou → Reporting → Pay Periods and Send to Payroll

...

On Xero it will create a new Pay run and will update the Payslips with the Earnings from Tātou. It will also keep any earnings rates that you added to the Employee Pay Template on Xero. So the result will be a mix of any default earnings set on Xero and the Earnings from Tātou.

...

Please check if you follow all the steps from How to: Setup the Xero AU integration.

Possible causes:

  • Wrong link on the webhook configuration

  • Missing the Request params tatou_token

  • Expired connection with Xero

...