Skip to main content
Xero Payroll Integration

A step-by-step guide to get you started with Breathe's Xero Payroll integration

Russell avatar
Written by Russell
Updated over 4 months ago

With Breathe's integration to Xero Payroll, your people's payslips and payrun information will pull across from Xero into Breathe and be stored in their personal profiles.

In return, Breathe synchronises your people's data with Xero, ensuring everything is kept up to date without the need for manual changes.

Getting started

Get up and running in 5 easy steps.

To start using the Xero Payroll integration, the Admin or any HR user will need to first activate the module within your Breathe account.

Step 1: turn on the module

Head to Configure > settings > account > modules > Included modules > Xero Payroll select this to on.

Only the Admin user of your account will be able to carry out this first part of the set-up. HR users will have access to the module after it has been enabled.

In your Blue menu navigation bar now head to Modules > Xero Payroll > integration settings

Step 2: authenticate

The next step is to authenticate your Xero account. If you're not already logged in, you'll be taken to the Xero login page.

You'll then see the following:

Select allow access, this will initiate the sync and will take you to 40% complete.

Step 3: select employees you don't want to include. Select the tick-box under the 'Exclude' column and then the green Exclude these people box.

This will take a few moments to register. You'll then be taken back to the set-up screen which will show at 60% completion.

If you don't wish to exclude anyone, simply leave the boxes un-ticked and select the green Exclude these people box to continue.

Step 4: update your people in Xero

Select the Update button to take you to the next step: updating your people info in Xero

You'll then see a page like this detailing your people that will be synced through to Xero:

Any missing data will be highlighted in red boxes. These fields are mandatory and will need

to be completed to send the employees through to Xero. To update a person’s record, click

on the pencil icon and complete the required fields.

Once the fields have been completed for each person you’ll be able to click on the

‘Complete people setup’ button at the bottom of the page.

Please note: This data is matched with HMRC so we are unable to edit these fields and add gender types- the only options you will see are male and female.


Step 5: match your people record

This step takes a few moments as it will run a cross-referencing check against your Breathe and Xero accounts. Once completed, you'll be 80% of the way there.

Once you’ve clicked the ‘Match’ button on the Xero Payroll integration screen , you'll be

presented with a list of employees.

Here, you will clearly be able to see from the list which data could be matched with the green tick. Any data that could not be matched to Xero will appear as a red icon

Pressing the pencil edit icon under the actions header for the employee with data that could not be matched will display the screen below, showing you the details of the data that is present in Breathe compared to Xero. You are then able to edit this and press the green Update Person button to update the record.

You will then be redirected back to the people list and their data will show as matched by displaying the green tick icon.

On the Match your people screen, you will also see a list of employees that are not in your Xero account, but have been found in your Breathe account and will have a new record created in Xero when you complete the set-up.

When you are happy that all your records and data match, tick the sync box next to all employees that you wish to sync to Xero and press the green Sync People to Xero button

Please note: If you do not tick the box under the sync header, your people will not sync to Xero.

Lastly, you will be presented with a pop-up titled "Important Information about this sync" providing a summary of the data that will be updated and created in Xero.

To confirm, press the green Sync People to Xero button to complete the process.

Please note: The Sync can take a few minutes to complete and is not an immediate process.

You will now have completed the setup and the progress bar will show as 100%.


Importing pay runs into Breathe

Once you've run a pay run in Xero, you’ll be able to import payslips into Breathe.

You’ll see a record of your payruns by heading to Modules > Xero Payroll > Import new Pay Run in Breathe.

Click ‘Import Pay Run’ for the pay run that you wish to import into Breathe.

The final step is choosing when you'd like payslips to be published for your people to see.

Once published, the payslips will be available under More > Xero Payslips within your

people's profile.

Please note: The payslip that appears in your people's profiles is created by Breathe, therefore the design and formatting will be different to what they currently see from Xero. There will not be a company logo on the payslip.

Account Admin & Super Users (HR & Finance) will be able to view all people's payslips. Employees will only be able to view their own payslip.


Past imports

Once you’ve imported a pay run from Xero, you will see these listed here:

Modules > Xero Payroll > Past imports

You’ll be able to edit the publication date for the pay slips or delete the pay run if it’s no

longer valid. Deleting the pay run, will remove the pay slips for your people. You’ll then be

able to import the pay run again from Xero.


Synch data to Xero

If you have a new starter or make changes to a person’s data, you’ll need to head to:

Modules > Xero Payroll > Synch data to Xero.

Here you will see any changes to send through to Xero.

If you have any missing information, the fields will be highlighted in red to complete.

Data changes sent to Xero currently include:

  • Title

  • First name

  • Last name

  • Date of birth

  • Gender for payroll

  • Address line

  • City

  • Postcode


Xero payroll status report

To view this report head to: Reports > People records > Xero Payroll Status. This report

gives you a summary of your people that are awaiting synchronisation, synchronised with

Xero or excluded from the integration.


Excluding people from the integration

If you’d like to exclude a person from the integration, you can do this by updating their

permissions.

Please Note: To access our Xero Integration users will require Admin, HR or Super User permissions (HR & Finance permissions combined)

The Xero organisation is required to have Payroll provisioned, and the Breathe user that connects to Xero is required to be a Payroll Administrator in Xero

Xero is not part of the Breathe suite of products, so we're unable to offer support with the Xero Payroll product itself.

We're here to help

Any questions? Simply drop us a message using the chat feature at the bottom right of your screen 💬

Did this answer your question?