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

Integrate with Xero accounting on the Payroll platform

Updated

Available for the following Payroll Plan: Standard, Premium

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 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 platform.

Connect to your Xero platform
  1. Log into your Employment Hero Payroll 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 tanuma training. they are xero, and zoho books 
  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. 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. below once you have confirmed the company and export pay run data, it shows you are connected.

     

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.
    C SG 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.

Importing Xero employees

You can use the Employee Importing feature within the Payroll Settings module to import the employee data stored within your Xero platform. Using the Xero Payroll import feature will import the following data:

  • Employee details.
  • Leave Categories.
  • Pay Categories.

However, it is essential to note that the import process may not always yield accurate and complete data due to varying Xero settings. Therefore, you must verify the imported information thoroughly. Pay particular attention to the following points:

  • Opening Balances are not included in this import and will need to be manually entered.
  • Employee leave allowances and accrual rates should be checked for accuracy.
  • Tax file numbers (TFNs) may have to be added manually for imported employees.

Warning

When using any Xero integration features within the payroll platform, you need to have at least Standard + Payroll admin access on your Xero platform.

Important

If you have used an external Id before, you cannot save ‌this data point if you have enabled the Unique External Id setting. You can read further information on this setting in the following article. The payroll platform does not import leave balances when setting up new employees.

Importing my Xero employees
  1. Log into your Employment Hero Payroll platform.
  2. Click the  Business Settings menu.
  3. Click the Payroll Settings submenu.
  4. Select the Xero option in the Import Employees From drop-down.
  5. Under Do Not Import, tick the items that you do not want to import into Employment Hero Payroll:
    • Pay categories
    • Deduction categories
    • Leave categories
    • Pay schedules

Important

By default, the above items will be ticked, which means that these will not import into Employment Hero Payroll.

  1. Click the Import button.
    Xero_1.jpg 
  2. Enter your Xero login information and click the Log In button.
    Xero_2.jpg 
  3. Enter your 2 Factor Authentication code and click the Confirm button.
    Xero_3.jpg 
  4. Click the Allow Access button.
    Xero_4.jpg 

  5. Click the Import button.
    Xero_5.jpg

     

    Helpful Hint

    You will now see on your screen a status message showing the successful uploading of your Xero employee data into your payroll platform.

    Xero_6.jpg 

Potential discrepancies when importing employees

One critical aspect to be mindful of when importing employees from Xero is the potential discrepancies in Leave and Pay Categories. Any categories imported from Xero will be 'Blank' and so might not align with Employment Hero's compliance standards, particularly concerning the STP Phase 2 regulations.

To avoid issues such as incorrect data being sent to the tax office, we strongly recommend taking the following steps:

  1. Assign Employment Hero Native Pay Categories and Leave Accruals: Before proceeding, assign the appropriate Employment Hero native categories to employees.
  2. Delete Imported Categories from Xero: After assigning the correct categories, delete any categories that were imported from Xero to prevent them from being mistakenly used. Categories Imported from Xero will include a long External ID.

Failing to follow these steps could result in issues with tax reporting and employee payment processing. For instance, pay categories imported from Xero might be blank from a tax reporting perspective, defaulting to wages.

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 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 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 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 tanuma training. they are xero and zoho books. 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. The integration is then disabled. 
    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 does 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