1) The Easy Employer to Xero integration
2) Integration diagram
3) How the integration works
i) New users
ii) Updating user details
iii) Updating leave entitlement balances
iv) Inactive cards
v) New pay items
vi) Leave loading
5) Where the pay run exports to, what causes a pay slip to lose pay
🔍 RELATED ARTICLES
Xero | Managing Users
Xero | Managing Entitlement Types + Entitlement Balances
Xero | Error Handling + Pay Run Troubleshooting
1) The Easy Employer to Xero integration
- Employee base rates detected and updated in Xero via the API so you don't have to manually keep each employees rate up to date (as Easy Employer has rate table functionality).
- Pay item multipliers or hourly rates are updated as required in Xero via the API.
- Pay items are created if they are missing in Xero via the API.
- Employee 'Ordinary Hours' or default code standard pay is forced to 0.
- New employee profiles are detected and created in Xero via the API.
- When the timesheet entries are imported via the API into Xero they are broken down by day and tracking categories if this functionality is being used.
- Pay run gross total is compared to Easy Employer and differences are shown for easy checking.
2) Integration diagram
NOTE: The integration diagram has different tabs for Overview, User details sync and Payroll export (hover over the image to see the tabs).
NOTE: You can download a PDF of the integration diagram (all pages) by clicking HERE.
Click here to view the integration diagram
3) How the integration works
Both Easy Employer and Xero act as "master databases" for certain information. The connection is done through the internet via an API connection.
Xero:
🡪 Is the master database for bank details, super funds and tax file numbers once the user is created and linked via the API.
🡪 Is the master database for entitlement accruals and balances (except for Time in Lieu and Roster Day Off).
🡪 When a new user starts, you can add them into Xero and import them into Easy Employer. Or add to Easy Employer and sync to Xero. See recommend process below “New user(s)”.
Easy Employer:
🡪 Is the master database for user’s pay rates (this is why it is very important the rates in Easy Employer are correct).
🡪 When exporting a pay run, if a difference in rates exists the system will flag this and prompt users to update Xero via the integration (not manually). This greatly helps the process when there is a yearly increase.
🡪 Easy Employer will create new pay items in Xero as required (e.g. for a pay item level you have not used before).
i) New users
It is important to understand that there are two potential workflows for adding new users into Easy Employer (when integrated with Xero). For full details on adding new users see the related articles section "Xero | Managing Users" for further information.
ii) Updating user details
Once an employee has been synced to Xero, some of their personal details (located in the details page in Easy Employer) are locked from editing. This is because Xero is the master database for employee details; bank details, super details, etc.
The recommended process for updating details is:
1. Update the employee details in Xero.
2. Import the employees into Easy Employer.
For full instructions on performing a manual user sync, see the related articles section "Xero | Managing Users" for further information.
iii) Updating leave entitlement balances
Xero is the master database for all leave entitlement balances. These balances should be updated in Easy Employer regularly and it is recommended to do this after each pay run.
For full instructions on performing a manual entitlement balance sync, see the related articles section "Xero | Managing Entitlement Types + Entitlement Balances" for further information.
iv) Inactive cards
Employee cards in Xero should not be made inactive or terminated until the employee no longer exists within a pay period in Easy Employer.
v) New pay items
When new pay items are created in Xero, Easy Employer will notify you of this through the payroll report when exporting.
If these pay items need configuration (e.g. super, PAYG or entitlement accrual set/not set) these need to be checked and updated as required in Xero.
vi) Leave loading
Easy Employer does not export leave loading to Xero. If leave loading is required it must be configured in Xero. Instructions have been provided by Xero on how to configure leave loading.
4) Integration error handling.
If errors are received during the pay run or sync process, the Xero error handling guide should be consulted before escalating to support. See the related articles section "Xero | Error Handling + Pay Run Troubleshooting" for further information.
5) Where the pay run exports to, and what can cause a pay slip to lose pay