Tanda and Xero have a live API connection, so you can import your staff from Xero into Tanda automatically. This article will take you through requirements in Xero and Tanda for integration and how to bulk import your staff into Tanda the first time and then options for new staff going forward.
Check the following in Xero first to ensure your account is setup correctly:
- Your user account must be a Payroll administrator. Go to Settings > General Settings > Users, choose your name, ensured the Payroll Admin box is ticked.
- Your Xero organisation should be activated for Payroll. You can check by going to Payroll > Overview:
- Payroll Accounts: set
- Employees added: it helps if all your staff have a Phone Number and Email entered in Xero so this imports into Tanda
- Set your pay calendar: ensure this matches your pay period start in Tanda, i.e both start on a Monday. All staff should also have this pay calendar set on their profile in Xero under the Employment tab.
Add Xero to your Tanda account by going to Settings > Add-ons > Payroll & Accounting:
In the top right corner, click on + New Payroll Integration:
Find the Xero Australia logo and click on it:
A pop-up will then display asking you to login to Xero (if you're already logged into Xero in another tab, you'll go straight to the authorized screen). Enter your login details for Xero and click Login:
Confirm the correct file has been linked and then click Allow access:
You'll then go back to the Integration Setup screen in Tanda and you'll see a box with Xero Australia and the Xero Organisation name.
You can click on this box to go into the Integration setup where you can configure:
- Who the integration applies to: All staff by selecting Everyone or Default Locations and then selecting a Location (if you haven't set this up yet you can come back into here later). This is used if you have more than one Xero account connected to your Tanda account, you need to match a Location to a Xero file.
- Under the Xero Settings heading, you can specify Tracking Category details.
- You can also select how you want Tanda to handle new staff. If you have enabled to Automatically import new staff profiles, when you add a new employee to Xero, Tanda will automatically import this within the hour. Only new employees will be imported and existing profiles updated.
If you make any changes just click Save at the bottom.
When you first start using Tanda, you can do a bulk import of your staff from Xero. To do this, go to Workforce > Staff:
On the right, click on + Add Staff:
In the pop-up window, at the bottom select Import from > Xero Australia:
Click on the Xero organisation name to select the integration. If you only have one file attached to Tanda, you'll just see one box however if you have more than one just click on the one you want to import from first.
Next, you'll see a bar loading to show your staff are being imported, depending on the amount of staff you have this can take a few minutes, so just stay in the screen.
Once the import has finished, you'll see a list of your staff that have been imported into Tanda.
If there are any staff in the list that shouldn't have been imported to Tanda, just click Don't Import next to their name and they won't be brought through, otherwise if it's all correct just click Complete Staff Import at the bottom:
If one or more staff didn't import and they are in Xero, check their details in Xero to ensure you have added them and a start and/or finish date.
Your staff list will now show under Workforce > Staff.
How to add new employees after your first import
Going forward, when you have a new employee you have the following options:
- Add the employee to Xero and if you have enabled to automatically import new staff in your Tanda-Xero integration setup, Tanda will automatically import this employee within the hour.
- Add the employee to Xero and you can force this update to happen immediately by going to Workforce > Staff > Add Staff > Import from Xero. Only new staff will be imported and existing staff updated.
- Use Employee Onboarding: this sends the new employee an onboarding form to fill in their details. Once that's done, a profile will then be created here in Tanda and you can push the information to your payroll software.
Don't forget to also check out all our other Xero specific articles.