Integrate Employment Hero with Payroll classic

Available for the following plans: Employment Lite, Employment Plus, Employment Unlimited
Available for the following HR classic plans: Standard, Premium, Platinum
Available for the following user access level: Admin    

When you integrate your HR platform with your payroll platform, the HR platform becomes the primary source of truth for all information, including company settings, payroll settings, and employee data. During the connection process, the HR platform automatically imports your organisation details, payroll settings, and employee files from the payroll platform.

After this initial sync, data will only flow one way—from the HR platform to the payroll platform—because the connection is not bidirectional. This means all updates must be made in the HR platform, and any changes will automatically sync to the payroll platform.

Warning

To see which fields and data points sync between the HR and Payroll platforms, check out this article.

When offboarding the original Admin, avoid connection issues by adding another Admin with full access to both platforms. The new Admin will need to disconnect and reconnect the platforms to maintain a smooth connection and keep your data intact.

  Interactive learning

Click here for an interactive demo

Getting started

Connect to Employment Hero payroll classic

Helpful Hint

When connecting your Payroll classic account to Employment Hero, you can use the credentials of any Admin User within Payroll classic. The login email of the Employment Hero account being used does not have to match the login email used to log into Payroll classic.

  1. Click the   Settings menu.
  2. Under General Settings, click the Add-ons submenu. 
  3. Click the Connect button for Employment Hero Payroll classic.
    screenshot of the add-ons page, highlighting the connect button for employment hero payroll
  4. Read the contents of the Connecting to Payroll screen.
  5. Click the Start button.
    screenshot of the connecting to payroll screen, highlighting the start button
  6. Read the contents of the Current Employees screen.
  7. Click the Next button.
    screenshot of the current employees screen, highlighting the next button
  8. Read the contents of the Terminated Employees screen.
  9. Click the Next button.
    screenshot of the terminated employees screen, highlighting the next button
  10. Read the contents of the Match Emails screen.
  11. Click Yes or No to the question Do you have your own employee file within payroll (are you paid from this payroll file?)

    Helpful Hint

    If you answered Yes, you need to confirm the email address used in your employee file in payroll.

    If you need to switch to another email for the payroll classic platform, follow these steps:

    • Click No to the question Is this the email address used in your own employee file in payroll.
    • Type your email address in the text field that will appear.
    • Click the Update button.

    You will receive an email with instructions on how to verify your new email address.

  12. Click the Connect now button.
    screenshot of the match emails screen, highlighting the connect now button

    Helpful Hint

    After clicking the Connect now button, you will be redirected to the payroll classic platform.

  13. Enter your username and password.

    Important

    Please use the login details associated with your full user/Payroll admin account.

  14. Click the Log In button.
    screenshot of the payroll classic platform log in page, highlighting the log in button
  15. Choose how you want to receive your two-factor authentication code.
  16. Click the Send Code button.
    screenshot of the screen where you can choose how to get your verification code, highlighting the send code button
  17. Enter your two-factor authentication code.
  18. Click the Verify button.
    screenshot of the screen where to input your verification code, highlighting the verify button

    Important

    If you have multiple payroll accounts, choose which one to connect to Employment Hero. Then, click the Select button.

    Once Employment Hero has imported the data from your payroll classic 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 learn about the import conflicts.

Daily activities

Manually import employee files
  1. Click the   Settings menu.
  2. Under General Settings, click the Add-ons submenu.
  3. Click the Action   button.
  4. Click the   Update button.
    screenshot of the add ons screen, highlighting the action and update buttons for employment hero payroll
  5. In the Employees section, click the   Update From Payroll button.
    screenshot of the update data screen, highlighting the update from payroll button for the employees section

    Helpful Hint

    The Update From Payroll button for the Employees section will turn into a green Updated button. This means Employment Hero has successfully imported your employee files from your payroll classic platform.

Manually import organisation details

Warning

Employing Entities are case and typography sensitive, i.e., when importing your Employing Entities from the payroll classic platform, make sure both the platforms use the same type of case and that there is no .com or .uk in the name.

  1. Click the   Settings menu.
  2. Under General Settings, click the Add-ons submenu.
  3. Click the Action   button.
  4. Click the   Update button.
    screenshot of the add ons screen, highlighting the action and update buttons for employment hero payroll
  5. In the Organisation Details section, click the   Update From Payroll button.
    screenshot of the update data screen, highlighting the update from payroll button for the oragnisation details section

    Helpful Hint

    The Update From Payroll button for the Organisation Details section will turn into a green Updated button. This means Employment Hero has successfully imported your organisation details from your payroll classic platform.

Manually import pay items
  1. Click the   Settings menu.
  2. Under General Settings, click the Add-ons submenu.
  3. Click the Action   button.
  4. Click the   Update button.
    screenshot of the add ons screen, highlighting the action and update buttons for employment hero payroll
  5. In the Pay Items section, click the   Update From Payroll button.
    screenshot of the update data screen, highlighting the update from payroll button for the pay items section

    Helpful Hint

    The Update From Payroll button for the Pay Items section will turn into a green Updated button. This means Employment Hero has successfully imported your pay items from your payroll classic platform.

Manually import payslips
  1. Click the   Settings menu.
  2. Under General Settings, click the Add-ons submenu.
  3. Click the Action   button.
  4. Click the   Update button.
    screenshot of the add ons screen, highlighting the action and update buttons for employment hero payroll
  5. In the Payslips section, click the   Update From Payroll button.
    screenshot of the update data screen, highlighting the update from payroll button for the payslips ssection
  6. Select the required payslip from the drop-down menu.
  7. Click the Import button.
    screenshot of the import pay slips pop up, highlighting the pay run you need and the import button

    Helpful Hint

    The Update From Payroll button for the Payslips section will turn into a green Updated button. This means Employment Hero has successfully imported the payslips you selected from your payroll classic platform.

Re-authenticate your payroll integration

Important

You can re-authenticate your payroll integration if the connection between the 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 the   Update button.
    screenshot of the add ons screen, highlighting the action and update buttons for employment hero payroll
  5. In the Re-authenticate section, click the  Re-authenticate button.
    screenshot of the update data screen, highlighting the re-authenticate button

Removing data

Disconnect from payroll

Warning

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

  1. Click the   Settings menu.
  2. Under General Settings, click the Add-Ons submenu. 
  3. Click the Action   button.
  4. Click the   Disconnect button.
    screenshot of the add ons screen, highlighting the action and disconnect buttons for employment hero payroll
  5. Click the Disconnect Application button.
    screenshot of the disconnect application confirmation pop up, highlighting the disconnect application button

Further information

How do I import pay slips automatically

Employment Hero will check once a day for eligible pay slips and requires three conditions to import pay slips automatically from your payroll classic 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.
How to fix Error 400
If you are getting an "Error 400" message when syncing your HR platform to your Payroll Platform, this is usually because there have been work types that have been deleted in the Payroll System. Since the HR is your source of truth, any changes that's been done in the Payroll needs to be manually updated in HR to flow through.

To troubleshoot this issue, follow the 2 part set of steps below:

Part 1:
  • Click Settings.
  • Click Work types.
  • Click Update Payroll.
Part 2:
  1. Click the Settings menu.
  2. Click Payroll Integrations Dashboard.
  3. Select the employees whose errors need to be fixed.
  4. Click Re-sync.
    Payroll integration issues

Explore related content

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

Comments

0 comments

Article is closed for comments.