Skip to main content
English (Australia) English (Canada) English (United Kingdom) English (Malaysia) English (Singapore)

Integrate with Xero accounting on the Payroll classic platform

Updated

Available for the following plans: Employment Lite, Employment Plus
Available for the following Payroll plans: Standard, Premium, Core Payroll, Unlimited+Payroll

Glossary

What is a Journal feature?

A journal service is a feature that allows you to connect your accounting software with your payroll platform so that you can capture journal entries in your chart of accounts. If you use Xero for your accounting software and journal service, and Employment Hero for your payroll, you can simply connect Xero with your Employment Hero Payroll classic platform via the Journal Service integration feature.

What happens after I connect to Xero?

After connecting your Xero and EH Payroll platforms together, and setting up your chart of accounts, you can post payroll journals automatically into Xero upon finalising a Pay Run, cutting the need for manual data import/exports or CSV uploads. You will also notice that with this export feature we format the data to reflect automatically your Xero reporting layouts.

Connecting to Xero

The below premise will walk you through how you can connect your Xero accounting platform with your Employment Hero Payroll classic platform.

Connect to your Xero platform
  1. Log into your Employment Hero Payroll classic platform.
  2. Click the   Business Settings menu.
  3. Click the Payroll Settings submenu.
  4. Click the   Integrations button.
  5. Locate the Xero logo and click the Add button.
    Screenshot of employment hero payroll integration software options. down the lefthand side of the screen is a menu of payroll settings. In the main screen panel we have the options shown for company progenitor training. 
  6. Click the Connect to Xero button.
    Screenshot of the popup to add xero integration. it reads add xero integration. Integrating with xero will allow you to import your chart of accounts, employee data, tax codes (used for logging payroll related expenses) and tracking categories. You can also export your payroll journal. please refer to the support article for more detailed information. the popup then links to the relevant support article 
  7. Click the Allow Access button.
    Screenshot of the xero access page. a white page with the blue xero logo at the top. it asks your payroll wants access to organisation data, and user account information. There are links to the terms of use and privacy policies and a blue allow access button or the option to cancel. 
  8. Complete the following fields:
    • Export pay run as:
      • Accounts payable invoice.
      • Journal.
    • Post a draft.
  9. Click the Save button.
    Xero_4_NZ.jpg

Import chart of accounts

You can import your Xero chart of accounts and then map them to the various transaction types on the chart of accounts page. You can import your chart of accounts by following these steps. Once you have imported your accounts, you can map them to GL transaction types. You will also notice an Export button in the Chart of Accounts. This allows you to export the chart of accounts setup so that you can better see what you​ have mapped.

Setup Chart of Accounts
  1. Click the Business menu.
  2. Click the Payroll Settings sub-menu.
  3. Click the Chart of Accounts button.
  4. Click the Manage Accounts button.
  5. Click the Import button.
  6. Once on the import accounts page, you will see a list of all the accounts in your cloud accounting service chart of accounts. Tick each account that you​ would like to map to a payroll transaction type
  7. Once you​ have selected all your accounts, click the Save button.
    NZ C 1.jpg 

Configuring your chart of accounts

Once you have imported your accounts, you can map them to GL transaction types. When you map your default GL accounts, you​ will notice that there is an option to Split by location. This allows you to write a transaction line per location to the journal for the same account.

This is particularly useful if you are using locations, classes, or tracking categories within Xero. Rhe Xero API does not allow us to write transactions to a bank account. As such, you have two options:

  1. You can post your payroll info to Xero as a purchase invoice, much like the inbuilt Xero Payroll does now. When you do this, the purchase invoice is reconciled against the bank account transaction and as such, does not need a transaction line written to the bank account
  2. You can post to Xero using a journal. If you do this, you’ll need to create a payroll clearing account that we can post to which you can then use to reconcile against the bank account.

What if I have multiple entities?

If your business has ‌multiple employing entities, you can only link one employing entity to your Xero accounting platform. You will need to setup the remaining employing entities as a manual file upload to sync this data to your Xero accounting platform.

Exporting Pay Run data

You can use the Export to Xero feature to transfer the finalised Pay Run data over to your Xero accounting platform.

Export a finalised Pay Run into Xero
  1. Log into your Employment Hero Payroll classic platform.
  2. Click the   Pay Run menu.
  3. Click the finalised Pay Run that needs exporting to Xero.
    Screenshot of pay runs with the date range on the left hand side vertical column. the second pay run on the page is highlighted 
  4. Click the Actions tab.
  5. Click the   Export to Xero button.
    Screenshot of the details of a pay run with names and earning detailed. along the top is a menu bar with the option to export to xero highlighted in red. 

Re-export Pay Run data

You can use the Re-export to Xero feature to transfer the finalised Pay Run data over to your Xero accounting platform.

Re-export a finalised Pay Run into Xero
  1. Log into your Employment Hero Payroll classic platform.
  2. Click the   Pay Run menu.
  3. Click the finalised Pay Run that needs re-exporting to Xero.
    Screenshot of pay runs with the date range on the left hand side vertical column. the second pay run on the page is highlighted 
  4. Click the Actions tab.
  5. Click the   Re-export to Xero button.
    Screenshot of the details of a pay run with names and earnings detailed. along the top is a menu bar with the option to re-export to xero highlighted in red 

Disconnecting from Xero

The below premise will walk you through how to disable your Xero accounting integration.

Disable your Xero connection
  1. Log into your Employment Hero Payroll classic platform.
  2. Click the   Business Settings menu.
  3. Click the Payroll Settings submenu.
  4. Click the   Integrations button.
  5. Locate the Xero logo and click the   button. 
    Screenshot of employment hero payroll integration software options. down the lefthand side of the screen is a menu of payroll settings. In the main screen panel we have the options shown for company progenitor training. In the xero panel, the no entry icon is highlighted in red. clicking this is the first step in disabling xero. 
  6. Click the Disable button.
    Screenshot of popup to confirm you wish to disable the xero integration. There is a button to disable or the option to cancel. 

Error resolution

Your Xero account is already linked to a payroll and therefore is not available to select

If you receive this error message, then you need to within Xero, go to Settings Connected apps for Business Name here, and then disconnect the related app currently connected to the business.

Your Xero user does not have the required permissions to authorise the integration

Xero has updated their Accounting API authorisation requirements to align with user roles and permissions. As a result, existing integrations may begin returning authorisation errors if they were originally connected using a Xero user that no longer has the required permissions.

If you receive this error, within Xero, navigate to Settings and confirm the user who authorised the integration has either:

  • Adviser access, or
  • Standard access with permission to create Manual Journals.

Users with Read-only or Invoice-only access do not have sufficient permissions to authorise the Accounting API.

Once the user's permissions have been confirmed or updated:

  1. Disconnect the Xero integration in KeyPay.
  2. Reconnect the integration, ensuring you sign in with the Xero user that has the required permissions.
  3. Retry the journal export.

Further information

Can I write transactions to my Xero bank account?

The Xero API does not allow us to write transactions to a bank account. You have two options:

  • You can post your payroll info to Xero as a purchase invoice, much like the inbuilt Xero payroll does now. When you do this, we reconcile the purchase invoice against the bank account transaction and do not need a transaction line written to the bank account.
  • You can post to Xero using a journal. If you do this, you will need to create a payroll clearing account that we can post to which you can then use to reconcile against the bank account.

Related articles