Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 13 Next »

In this article we show you how to use Employment Hero integration with Tātou.

If you are looking to setup the integration, please see How to: Setup the Employment Hero integration

Employees

The employee integration is unidirectional, from Employment Hero to Tātou. You can create, update and delete* employees on Employment Hero and it should reflect on Tātou.

Deleting employees on Employment Hero will set them as inactive on Tātou

To be able to link the accounts, the integration uses the Employment Hero Employee ID as Tātou Staff ID. If you created the employee manually on Tātou, you can link them by setting the Staff ID manually, as image below:

Included fields

  • Status

  • First name

  • Last name

  • Nickname

  • Gender

  • Phone number

  • Birth date

  • E-mail

  • Job title

  • Start date

  • Passport Nationality: default to “Australia”

  • Address (address, city, region, country and postcode)

  • Emergency contact (name, relationship, phone number and address)

Pay Period (timesheets)

As part of the setup to sync timesheets, you need to make sure that all Costing Codes on Tātou are correctly linked with Locations External Id on Employment Hero, as image below:

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

On Employment Hero you will receive timesheets pending to approval.

Selecting employees to send payroll data

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

Pay Earnings

When finishing a Pay Run on Employment Hero, it sends back to Tātou information about the pay earnings. You can check it by browsing the employees timesheets tab, as image below:

Employment Hero’s Earning Lines are matched with Tātou’s Earning Types using the table (following the presented order or priority):

Tātou Earning Type

Condition to match (Employment Hero Earning Lines)

topup

Pay Category External Id = “Topup”

As topups are calculated by Tātou, they are skipped when receiving earnings back.

contract

Pay Category External Id = “Contract”

As piece rate are calculated by Tātou, they are skipped when receiving earnings back.

overtime

Pay Category / Payment Classification = “Overtime”

hourly

Pay Category / Payment Classification = “Default”

other

Pay Category / Payment Classification in

“AllowanceTransport”, “AllowanceCar”, “AllowanceLaundry”, “Allowance”, “AllowanceMeals”, “AllowanceQualificationsCertificates”, “AllowanceTasks” or “AllowanceTool” or “AllowanceTravel”

none (discarded)

all others

  • No labels