Skip to main content
Employment Hero Integration

Tanda & Employment Hero Integration (previously known as Keypay)

Updated over a week ago

Connecting Tanda and Employment Hero

Add Employment Hero to your Tanda account by going to Settings > Integrations > Payroll Integrations > New Payroll Integration and select Employment Hero:

You'll need to fill in a few details from your Employment Hero account to successfully connect the account, including ABN and API key.

You can find your API key in Employment Hero in the Payroll Settings tab on the dashboard > My Account.

Here you will see your API key:


If you have more than one business in your Employment Hero account, you'll also need to enter the Employment Hero Business name in Tanda, ensuring you enter the name exactly as it appears in Employment Hero. Your Business Name can be found in the Payroll Settings tab on the dashboard > Details tab.

Payroll Configuration

Tanda sends data through to Employment Hero via Timesheets. So we need to ensure:

  1. Employees have External IDs in Employment Hero and these have been entered on their Tanda profile under Payroll > Payroll ID.

  2. Employees are setup for Timesheets by selecting 'Uses Timesheets' on each employee's profile, under the Employment Details tab.

  3. We've mapped Award rules and Leave Types in Tanda (under the Compliance tab) to Work Types in Employment Hero (Payroll Settings > Work Types).


In Tanda, approve timesheets > click Preview & Export > followed by Export to Payroll Software:

Then, in Employment Hero, timesheets that have already been approved in Tanda will automatically be approved.

Next, head to Pay Runs and add a new pay run. Enter the pay run dates so they match your pay run in Tanda and ensure you've opted to import timesheets for this pay run. Then click 'Create'. You should then see the timesheets for Tanda in Employment Hero.

Once you've got a pay run with timesheets imported, you've completed the export from Tanda. From here you can process payroll as you usually would in Employment Hero.


I've made changes to an employee's timesheet and need to re-export - what's the best process to do this?

If you've already created a pay run for an employee, but have had to make changes to the total hours being paid, you'll need to delete the existing pay run for the employee from Employment Hero and re-import the updated one.

If additions are being made to the pay run for the employee (i.e. only an allowance is being added, and no change is made to the total hours paid), a re-import of just the allowance will stack onto the existing pay run in Employment Hero.

An employee worked a shift that spanned across two pay periods, what gets exported from Tanda to Employment Hero?

If you run pay periods Monday - Sunday, and an employee works a shift from Sunday 9pm to Monday 2am, all hours of the shift will be exported and paid through Employment Hero, despite the fact that 12am - 2am on Monday fall in the new pay period.

The exception to this is when shifts are rostered back to back. If the employee works 9pm - 12am in team A, then 12am - 2am in team B, the two hours in team B will be included in the new pay period.

Did this answer your question?