Xero Integration

Updated: Jul 6

Table of contents


Integration overview and features

Xero is a powerful all-in-one solution for your business. Run everything smoothly, keep tidy records, and make compliance a breeze with this integration between Xero and Zelt.

Once connected Zelt will enable admins to see user access and use additional Accounting functionality in Zelt when running payroll.


Signing up with Xero

The simplest way to connect your Xero account to Zelt is to get connected from Xero app store. Follow the OAuth flow from there to get your organisation created on Zelt in a few simple clicks. When you select this way of setting up your integration - we will lead you to creating a Zelt account first, as this is a requirement. We will read some basic information about your Org and pre-populate the sign-up form. You will still be able to make any changes if necessary.


Sign up with Xero form


Connect your Xero to Zelt

You can also always connect your Xero account to Zelt from the app itself once your organisation account is all set in Zelt and you would like to start using integration functionality with Zelt.

In order to authenticate your Xero account in Zelt, head to Apps and then click "Add Apps". Find Xero app in the App Store and click "Connect". This will re-direct you to the authentication flow in Xero. Please select the correct organisation you would like to connect before proceeding, if you have a few in your Xero account.

You will be able to check all permissions you will be giving Zelt with this integration.

OAuth flow with Xero

Once you have successfully connected Xero you will be taken back to Zelt and you will be able to see your people directory.

Zelt helps you gain a better understanding of your Xero usage as you can track who in your team has an account and if there are any people that have already left your organisation that should be offboarded from Xero. Check "External" tab in your App Directory to see if there are any ex-employees who remained active on Xero.


Importing employee information

Xero integration on Zelt allows you to save time on onboarding users and filling out their profiles. Instead, if your company is already set in Xero you can use import functionality to populated existing user's accounts with the important information your already have stored in Xero.

To start import, make sure you have access to Company Settings first. Then navigate to the Import tab. Here you have to select the Data type first. Select Payroll information to benefit from Xero's integration.

In step 2 "Source" select Xero and click Continue.

The next step will show you a matching table where you can match imported users to your Zelt account and existing employees' accounts. For each user select a respective record in Xero from the drop down. If you can't see any of the Xero accounts - check if any account have been matched automatically. You can only match 1 Xero account to 1 Zelt employee profile. You can also undo the matching if you selected an incorrect person by clicking "X".

Once every account that you would like to import has been selected, click "Continue".

As a final step you will be shown all successful imports and the exact information that has been added to Zelt.


Setting accounting codes for Payroll

Zelt allows you to run payroll seamlessly for the whole team. Integration with Xero will push your Accounting journal when you complete each month's payroll. Zelt's payroll flow makes it easy to manage all additions, deductions, income balances and tax payments. In order to successfully sync your accounting journal, you need to make sure that your accounting codes are set up correctly.

Go to Salary app and click settings to access your accounting code settings. You can do this manually or integrate with Xero and select codes from there.


Example of Accounting Codes matching (Note: This is an example and not an advice on how to match your codes)

Pushing Accounting Journal

Once you are ready to run payroll and get to the accounting step Zelt will take care of translating all of your employees salaries, deductions and more - to sync it correctly to your Accounting software. Once your Xero integration is set up, you will see the following flow:


  1. Going into Salary app, check that every employees salaries and deductions are correct.

  2. Click to "Process Payrun" to submit your final figures for the payroll for this month.

  3. Once you have launched the flow, you will see the accounting step and check the notification there. It can be one of the following:

✅Accounting Journal sent successfully.

✅Accounting Journal was manually marked as sent.

❌Accounting Journal failed to be sent.


The last message means that there was an error. Please check detailed transcript for the error and see if you are able to resolve this yourself. You can send us an error report via an in-app chat if you are unsure about it. Once resolved - you can mark journal as sent. This will complete the step.

You can also download the CSV file for this month's journal.


4. Complete Payrun and close the page 👍


You will be able to come back to any of the closed payruns and retrieve the CSV accounting journal file for any previous months.


Settings and removing the integration

Once Xero is connected to Zelt you can always access integration in the settings. Click on the app and then navigate to a gear icon.

In settings you will see exactly who connected the app in the first place.

You can also remove this integration by clicking "Remove Integration".


Support with your Xero integration

If you have any issues or questions about your Xero integration, you can use in-app chat to contact the team or send us an email on support@zelt.app



FAQ

How do I disconnect from Xero?

In order to disconnect your Xero integration - head to the App settings from your Apps page. Or you can use this link here https://go.zelt.app/apps/xero/settings.

Click "Remove integration" and confirm.

What doesn’t this integration do?

How and what data is used in this integration?

When and how does data sync occur? Is it manual, automatic, on login, in real-time. Are there any settings related to synchronizing?

Why do I see "token expired" error?

Why do I see "Accounting code for Accrued Holiday Pay not provided. Please provide missing accounting codes in your payroll settings."?

Don't see an answer to your question here?