1. Employment Hero Help Centre (NZ)
  2. HR Web Platform
  3. Managing HR Data by Integration
  4. Payroll Integrations
  5. Employment Hero Payroll
  6. Integrating with Employment Hero Payroll

How do I Integrate with Employment Hero Payroll? | HR Platform

James Nixon
Updated
EH Content Team

Integrating your HR platform with your payroll platform makes the HR platform your source of truth for information such as company settings, payroll settings, and employee file data. When you connect the two platforms, the HR platform will import your organisation details, payroll settings, and employee files from your payroll platform automatically.

After this initial connection, the data will only flow automatically from your HR platform to your payroll platform, as this data connection is not bidirectional. Meaning the HR platform becomes your source of truth, where you and your employees update details as they change and once saved, those changes would automatically reflect in your payroll platform.

Warning

To see a complete breakdown of what fields and data points sync between the HR and Payroll platforms, refer to the following article. To make sure no interruption with the connection when you offboard the original Admin, you need to add another Admin with full access to both the HR platform and payroll platform who will need to disconnect and reconnect the two platforms. Following this proactive step helps maintain a seamless connection and makes sure your data remains intact.

Availability

HR Plan:   Premium   Platinum
  User Access:   Employee         Manager         Admin      

  This is the default access level per user and whether they have  view,  edit and  delete access, excluding any changes made via our Custom Security feature.

Getting started

Connect to payroll
  1. Click the  General Settings menu.
  2. Click the Add-Ons submenu. 
  3. Click the  Connect button.Integrate_1__NZ_.jpg
  4. Read the first page of the connecting to Employment Hero Payroll payroll wizard.
  5. Once you have read and actioned the first page, click the Start button.
    Xero_19.jpg
  6. Read the second page of the connecting to Employment Hero Payroll payroll wizard.
  7. Once you have read and actioned the second page, click the Next button.
    Xero_20.jpg
  8. Read the third page of the connecting to Employment Hero Payroll payroll wizard.
  9. Once you have read and actioned the third page, click the Next button.
    Xero_21.jpg
  10. Read the last page of the connecting to Employment Hero Payroll payroll wizard.
  11. Once you have read and actioned the last page, click the Connect Now button.

    Helpful Hint

    Once you click the Connect button, Employment Hero will redirect you to your Employment Hero Payroll platform. If you need to change the email listed on the page, select the No option for the Is this Email Address Used in Your Own Employee File in Payroll question, followed by the Update button.

    A pop-up will now show where you can enter your new email address; once this is done click the Save button. You will now receive an email with instruction on how to verify your new email address and start using this on your HR Platform.

    Xero_22.jpg
  12. Enter your user name and password and click the Log In button.
    Integrate_2__NZ_.jpg
  13. Select how you want to receive your two-factor authentication code.
  14. Click the Send Code button.
    Integrate_3__NZ_.jpg
  15. Enter your two-factor authentication code and click the Verify button.
    Integrate_4__NZ_.jpg
  16. If you have multiple payroll accounts, you will need to select which one to connect the HR platform to and then click the Submit button.
    Integrate_5__NZ_.jpg

    Important

    Once the HR platform has imported the data from your payroll platform, you will see a status screen which will display any integration errors. If there are integration errors, you can click the View Conflicts button to see detailed information on the import conflicts.

    Integrate_6__NZ_.jpg

Daily activities

Manually importing employee files
  1. Click the  General Settings menu.
  2. Click the Add-ons submenu.
  3. Click the Actions  button.
  4. Click the  Update button.Integrate_7__NZ_.jpg
  5. In the Employees section, click the  Update from Payroll button.
    Integrate_8__NZ_.jpg

    Helpful Hint

    The Employees section will now show a green Updated button and means the HR platform has successfully imported your employees from your payroll platform.

    Integrate_9__NZ_.jpg
Manually import organisational details

Warning

Employing Entities are case and typography sensitive, i.e., when importing your Employing Entities from the payroll platform make sure both the HR and payroll platform use the same sentence case and that there is no .com or .nz in the name.

  1. Click the General Settings menu.
  2. Click the  General Settings menu.
  3. Click the Add-ons submenu.
  4. Click the Actions  button.
  5. Click the  Update button.Integrate_7__NZ_.jpg
  6. In the Organisation Details section, click the  Update from Payroll button
    Integrate_10__NZ_.jpg

    Helpful Hint

    The Organisation Details section will now show a green Updated button and means the HR platform has successfully imported your organisation details from your payroll platform.

    Integrate_11__NZ_.jpg
Manually import pay items
  1. Click the  General Settings menu.
  2. Click the Add-ons submenu.
  3. Click the Actions  button.
  4. Click the  Update button.Integrate_7__NZ_.jpg
  5. In the Pay Items section, click the  Update from Payroll button 
    Integrate_12__NZ__.jpg

    Helpful Hint

    The Pay Items section will now show a green Updated button and means the HR platform has successfully imported your pay items from your payroll platform.

    Integrate_13__NZ_.jpg
Manually import pay slips
  1. Click the  General Settings menu.
  2. Click the Add-ons submenu.
  3. Click the Actions  button.
  4. Click the  Update button.Integrate_7__NZ_.jpg
  5. In the payslips section, click the  Update from Payroll button.
    Integrate_14__NZ_.jpg
  6. Select the required pay slip and click the Import button.
    Integrate_15__NZ_.jpg

    Helpful Hint

    The Payslips section will now show a green Updated button and means the HR platform has successfully imported your selected payroll platform pay slips.

    Integrate_16__NZ_.jpg
Re-authenticate your payroll integration

Important

You can re-authenticate your payroll integration if the connection between your HR and payroll platforms is lost. For example, this might be the case if the person who previously did the authentication has left your organisation.

  1. Click the  Settings menu.
  2. Under General Settings, click the Add-ons submenu.
  3. Click the Action button.
  4. Click Update.
  5. In the Re-authenticate section, click the Re-authenticate button.

Removing data

Disconnect from payroll

Warning

After disconnecting from the payroll platform, the HR platform will no longer synchronise your employee data between the two platforms. However, all existing employee data will remain within the HR platform.

  1. Click the  General Settings menu.
  2. Click the Add-Ons submenu. 
  3. Click the Actions  button.
  4. Click the  Disconnect button. Integrate_17__NZ_.jpg
  5. Click the Disconnect Application button. 
    Integrate_18__NZ_.jpg

Further information

How do I import pay slips automatically

The HR platform will check once a day for eligible pay slips and requires three conditions to import pay slips automatically from your payroll platform, they are:

  • A finalised pay run.
  • A published pay slip.
  • The paid date is within four days of the current date, i.e., three days prior and/or three days after the current date.

Author recommended

So you have now set up your payroll and HR platform integration and you are now wondering what next can I do. There are two recommendations I would make on this front and they are:

Related to:

Was this article helpful?
0 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.