Follow

August 2019: How can I set-up and configure the 2-Way HRA Cloud-Xero integration? (Australia Only)

To get started with the HRA Cloud-Xero integration, you need to execute the following actions:

  1. Authorise the relationship between the Xero and HRA Cloud:  Xero Employee Import;
  2. Configure the integration in HRA Cloud by following the steps below;
  3. Understand what is synchronised and the limitations: What Employee Information can be updated and created with the HRA Cloud-Xero 2-Way Connector?

How can I configure the integration?

After establishing the link between Xero and HRA Cloud (see Step 1 above), it is important to complete some configuration steps to ensure that the correct automations are in place.

There are different options and considerations to executing these create/update operations, which are explained in the sections below:

  • The Authoritative System to set the source of truth in case of a conflict;
  • Automatic imports with the scheduler;
  • Automatic exports with the scheduler;
  • Matching Xero records to existing HRA Cloud employees and HRA Cloud candidates;
  • Using branches when importing Xero employees into HRA Cloud and allowing for the transfer of employees between branches (Can be found here: [refer to article])

Before we start the steps: It is recommended during set-up that you should follow this whole configuration process before running the connector for the first time. Pay particular care to the Authoritative System option.

Configure the HRA Cloud-Xero Integration

To access the configuration page, click on “Settings ” and then “Account Settings”.
 

Xero3.png


Click on the “Account Details” tab and then the “Integration” sub-tab. Select “Edit. You are now in the integration tab, where the Xero configuration can start.

 xero4.png


Authoritative System - The ‘source of truth’


The HRA Cloud-Xero Connector is a two-way integration, which means that data flows from HRA Cloud to Xero and vice versa.

Because of this, it is possible to be in a situation where some data has been updated on both systems and needs to be synchronised.  In these cases, we need to know what data should be treated as the source of truth - this is called a merge conflict. Below is an example of a conflict.

mceclip0.png

We handle these situations by using the notion of Authoritative System, a mechanism by which we define what system is to be considered the source of truth when dealing with merge conflicts.

The Authoritative System can be set to one of the three following options:

  • Unselected (blank):  In the case of a merge conflict, nothing is done (neither system is updated). An email is sent to the account administrator who needs to manually fix the mismatch. This is the default value;
  • Xero:  In case of a merge conflict, Xero is considered the source of truth and therefore the Xero version of the data will be used. An email is sent to the account administrator with the before and after values (for reference);
  • enableHR:  In case of a merge conflict, HRA Cloud is considered the source of truth and therefore the HRA Cloud version of the data will be used. An email is sent to the account administrator with the before and after values (for reference).

 

mceclip0.png


Below is an example of how a merge conflict is managed.

  mceclip2.png

 

Note: The Authoritative system is only activated when some data was modified on the two systems since the last import. If this data was only activated on one system, whether it is Xero or EnableHR, this update will be synchronised to the other system.

 

To setup your Authoritative System please navigate to “Account Details” and then selectIntegration” and “Authoritative System

 mceclip1.png

 

Automatic import with the scheduler

Once you have configured the Xero integration, you can select to automatically run the import process every 3 hours. In this case, you will not have to regularly do the import manually.

This is done by selecting “Automatic Import in the configuration page. 

 mceclip2.png 


Automatic export with the scheduler

Once you have configured the Xero integration, you can select to automatically run the export process every 3 hours. In this case, you will not have to regularly do the export manually.

This is done by selecting “Automatic Export in the configuration page.



IMPORTANT:  Matching Xero records to existing HRA Cloud employees

When you first run the import process, your Xero employees are going to be created in HRA Cloud. This is fine if they do not already exist in HRA Cloud, but what happens if the employees already exist in HRA Cloud?

The import process can try and match Xero employees with records already in HRA Cloud.  If there is an employee record in HRA Cloud with the same “First NameLast Name” and “Birth Date, then it is a match and the update will merge into the existing record.  If there is no match, a new employee record will be created.

 This is done by selecting “Merge Employees by Name and Date of Birth (or Post code) in the configuration page.

 

mceclip4.png



Matching Xero records to existing HRA Cloud candidates

HRA Cloud also uses the notion of candidate records.

When the import process is running, a Xero employee might not exist as an HRA Cloud employee, but it could be a candidate. In this case, you can instruct the import process to convert the HRA Cloud candidate into an HRA Cloud employee. The search for an existing candidate will be done using the “First Name”, “Last Name” and “Birth Date” (or "Post Code").

This is done by selecting “Merge Candidates by Name and Date of Birth (or Post code) in the configuration page.

 mceclip3.png

 

Have more questions? Submit a request