StayOnHire Docs
StayOnHire Website
  • Getting Started
    • Welcome
    • Setup
      • Business Details
      • Users & Permissions
      • Features
      • Integrations
    • Apps
      • Field Actions
      • Software Updates
    • Glossary
  • PLANNING
    • Jobs
      • Getting Started
        • Configure & Setup
        • Users & Permissions
      • Create a Job
      • Deleting ("Archiving") a Job
  • Billing
    • Invoicing
      • Getting Started
        • Configure & Setup
        • Users & Permissions
      • Create an Invoice
      • Remove Feature
  • Documents
    • Templates
      • Job Summary
      • Hire Agreement
      • Reference Tags
        • Troubleshooting
  • Integrations
    • Xero
      • Getting Started
      • Contacts
      • Accounts
      • Tax Rates
      • Invoices
      • Recording Payments
      • Troubleshooting
      • Disconnect / Reconnect
Powered by GitBook
On this page
  • 1. Open your App
  • Login
  • Settings
  • Integrations
  • 2. Connect Xero
  • Find Xero
  • Connect
  • Configure
  • 3. Testing your Connection
  • Data Imports
  • 4. Confirm Billing Settings
  • Default Revenue Account
  • Invoice Configuration
  1. Integrations
  2. Xero

Getting Started

A step-by-step guide on how to setup your Xero integration with StayOnHire. The section is ideal for those setting up their Xero integration for the first time.

PreviousXeroNextContacts

Last updated 3 months ago

1. Open your App

Login

Go to

This will redirect you to a login portal if you are not currently logged in.

Enter your login credentials:

Settings

Integrations

Select the menu option in the bottom left titled "Integrations":

2. Connect Xero

Find Xero

Find the Xero integration card, and click “Connect”.

This will reveal a bottom sheet with integration-specific details:

Connect

Click the blue “Connect now” button to begin the connection process:

This will redirect you to login with your associated Xero login credentials. Enter your Xero login details:

Select a Xero organisation you wish to connect to your StayOnHire account and click “Allow Access”. This will take you to your Xero setup page:

Configure

You will be redirected back to StayOnHire to begin the configuration of your Xero integration.

Review the summary page and click the blue “Next” button:

Confirm the Xero Organisation you wish to configure and click “Save & Next”:

Only one StayOnHire organisation can be connected to your Xero integration at a time.

Review which Xero resources you want to be integrated with your account.

By default contacts, tax rates and accounts will be toggled on:

We recommend syncing invoices and payments.

To turn these on, double-click the blue toggle next to each Xero resource and switch the sync direction to “StayOnHire sends & receives”.

Click “Save & Next”.

Review sync triggers and click “Finish”:

This will navigate you to your Xero settings page, where you can make changes at a later date if required:

Congratulations, your Xero integration has now been connected!

To access this page again, simply navigate to Settings > Integrations > Xero

3. Testing your Connection

Data Imports

A simple and effective starting point to see if your integration is working correctly is to navigate to the 'Accounting' page of your StayOnHire settings. This will show us Xero data importing to your account:

Click the 'Manage Tax Rates' option:

This will open a page showing tax rates now imported to StayOnHire.

The same process can be followed to view your 'Chart of Accounts' importing to StayOnHire:

Lastly, this can be viewed on our Contacts page:

4. Confirm Billing Settings

This is now the optimal time to review your billing setup in StayOnHire.

Default Revenue Account

Most businesses have a default revenue account in Xero, likely '200 Sales':

Code
Name
Type
Tax Rate
Description

200

Sales

Revenue

GST on Income (10%)

Income from any normal business activity

Depending on the complexity of your business, you may still be using this account of have a new one. Now is the time to set the default in StayOnHire:

Clicking this field will allow us to search all current accounts in StayOnHire and select a default:

Invoice Configuration

From the bottom left-hand side of your page, click your organisation logo/business image, then click the round settings ‘cog’ icon to navigate to :

Go to

Only one Xero organisation can be connected to a StayOnHire account at a time. To disconnect a Xero integration, refer to the guide.

Note: Tax Rates are only imported from Xero, and cannot be edited. For a detailed breakdown of how this works, view the support page.

Note: Accounts are only imported from Xero, and cannot be edited. For a detailed breakdown of how this works, view the support page.

Note: Contacts can be managed in both Xero and StayOnHire depending on your configuration. For a detailed breakdown of how this works, view the support page.

Head to to see an option called 'Default revenue account':

For new users, we recommend reviewing your invoicing setup detailed in the , before proceeding to read details of how works.

Settings > Business
Settings > Integrations
Xero Disconnect / Re-Connect
app.stayonhire.com/org/accounting
Tax Rates
Accounts
app.stayonhire.com/contacts/all
Contacts
Settings > Advanced > Accounting
app.stayonhire.com
auth.stayonhire.com/u/login
StayOnHire Invoices
Xero Invoicing
StayOnHire login screen