> For the complete documentation index, see [llms.txt](https://docs.stayonhire.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stayonhire.com/integrations/xero.md).

# Xero

## Overview

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

<figure><img src="/files/7k2wN4KoHelLAPByt25l" 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="/files/wRTWxTay9xoUnkq3PBqr" 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="/files/reRvhwzR4XkhPQWSaiCv" 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="/files/1Pf80qceTQFqQKCimgR6" alt=""><figcaption><p>A sync button visible on the contacts page with Xero integration</p></figcaption></figure>
