# Xero

## Overview

For the best experience, we recommend having your integration set as pictured below:

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FHAf6Lr8CTJ5TrSweEJBq%2FScreenshot%202024-05-07%20at%204.19.02%E2%80%AFPM.png?alt=media&#x26;token=99126e40-2a47-429e-b5f8-5f8afc2190e2" alt=""><figcaption><p>This integration page will be visible in the settings of your StayOnHire application</p></figcaption></figure>

## How it works

* Build and execute jobs/hires in StayOnHire
* Auto-draft invoices with equipment & billable items in StayOnHire
* Review and approve draft invoices in StayOnHire
* Approved invoices sync to Xero

## Sync Behaviour

Once connected to your StayOnHire account, this integration helps bridge the gap between the calendar scheduling and billing sides of your business together. This is achieved by:

1. Syncing time-sensitive data instantly (i.e. invoices, payments)
2. Syncing non-time-sensitive data every hour (i.e. new tax rates, accounts)
3. Giving you the ability to manually trigger a sync of non-essential data to update

### Background Sync

StayOnHire will sync general data every 60 minutes automatically, and when performing key actions, such as approving approving an invoice or creating a new contact.

A typical integration will sync automatically under the following conditions:

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FFqNvbWZ6DFNKCZYhSrOd%2FScreenshot%202024-05-08%20at%203.21.47%E2%80%AFPM.png?alt=media&#x26;token=02908d6e-8dac-495f-8409-1290a68f81f3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Xero is not responsible for triggering these background syncs, this is handled automatically by StayOnHire out of the box.
{% endhint %}

### Manual Sync Triggers

A typical integration displays manual sync details as follows:

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2Fj6d3dNAULOzsBR0PUE77%2FScreenshot%202024-05-08%20at%203.21.53%E2%80%AFPM.png?alt=media&#x26;token=373660ac-ea7a-48d4-a30c-71a000bc74d8" alt=""><figcaption></figcaption></figure>

If ever you need data to be manually triggered, these can be done from StayOnHire using sync buttons around the StayOnHire user interface.

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FV619wxyFwXeAFCmLOAYL%2FScreenshot%202024-05-08%20at%203.34.01%E2%80%AFPM.png?alt=media&#x26;token=b82db7f5-1ec6-4f78-bbe6-3f44122c50c4" alt=""><figcaption><p>A sync button visible on the contacts page with Xero integration</p></figcaption></figure>
