In this article we show you how to use Keypay integration with Tātou.
If you are looking to setup the integration, please see How to: Setup the Keypay integration
Employees
The employee integration is unidirectional, from Keypay to Tātou. You can create, update and delete* employees on Keypay and it should reflect on Tātou.
Deleting employees on Keypay will set them as inactive on Tātou
To be able to link the accounts, the integration uses the Keypay 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:
Keypay Employee ID
Tātou Employee Staff ID
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 Keypay, as image below:
Keypay Location
To check and sync a pay period, go to Tātou → Reporting → Pay Periods and Send to Payroll
On Keypay you will receive timesheets pending to approval.
Pay Earnings
When finishing a Pay Run on Keypay, it sends back to Tātou information about the pay earnings. You can check it by browsing the employees timesheets tab, as image below:
Keypay’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 (Keypay Earning Lines) |
|---|---|
| Pay Category External Id = “Topup” As topups are calculated by Tātou, they are skipped when receiving earnings back. |
| Pay Category External Id = “Contract” As piece rate are calculated by Tātou, they are skipped when receiving earnings back. |
| Pay Category / Payment Classification = “Overtime” |
| Pay Category / Payment Classification = “Default” |
| All others |
Add Comment