# Getting Started

## 1. Open your App <a href="#login" id="login"></a>

### Login <a href="#login" id="login"></a>

Go to [app.stayonhire.com](https://app.stayonhire.com/)

This will redirect you to a login portal[ auth.stayonhire.com/u/login](https://auth.stayonhire.com/u/login) if you are not currently logged in.

Enter your login credentials:

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FBCLbfqX8P68X1J8u2Gid%2FScreenshot%202024-05-03%20at%201.50.20%E2%80%AFPM.png?alt=media&#x26;token=2b693914-dd91-4249-b5a1-979903dfeffe" alt=""><figcaption><p>StayOnHire login screen</p></figcaption></figure>

### Settings&#x20;

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 [Settings > Business](https://app.stayonhire.com/org/business):

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FaXRWGjfwAYApqgU1KNJG%2FScreenshot%202024-05-03%20at%2012.54.38%E2%80%AFPM%20(2).png?alt=media&#x26;token=fdedd344-f063-41c8-bf17-e77fbd118be7" alt=""><figcaption></figcaption></figure>

### Integrations&#x20;

Go to [Settings > Integrations](https://app.stayonhire.com/org/integrations)

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

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FtvuiEsMw6TYeYowSB7GO%2FScreenshot%202024-05-03%20at%201.01.31%E2%80%AFPM.png?alt=media&#x26;token=f83134fb-d8dd-46ee-b49b-db3fac8d1314" alt=""><figcaption></figcaption></figure>

## 2. Connect Xero

### Find Xero&#x20;

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

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

<figure><img src="https://lh7-us.googleusercontent.com/qAYv2QqqmyYDlez715PYgZOo75b2wSxApAmpEOFsimRdH4q6joNngWlTYAdN_ssD-KWIYWp78LsYcYP71Yn5TjYsOLzT81CfaxAnuAju_iYGvlVQObSPw13diNGxdWOfF0KFtno8frdcvVAV0D7gocQ" alt=""><figcaption></figcaption></figure>

### Connect

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

<figure><img src="https://lh7-us.googleusercontent.com/68uq4mFa2AlQuxuzl6KuE-8Yn_LRm61An5WYXVEWROyiJVrz2Zh1ro87JBCONvdRnJXV7j4ifwD4C1adryi-oUOb3kaC-kDoiLZ302PZ6UGVD3CaxeuZuqRItNqf2KL6UqdXXMmDQMWuFU1vBp4VOnU" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://lh7-us.googleusercontent.com/-MMWdg0WvzNxgdO8IhJyKEDYAeN-77WLH8d20uAONml7uq0rKTUFD6dQ4wmaZi4xvSjL6igxyIyGdTp7dz5HMQn3599UWojpsh4yG959Vg8c3YZt_tkHPlTmDDK0nZHxjJc7djV8BvPdEgsu3ZLFou0" alt=""><figcaption></figcaption></figure>

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:

<figure><img src="https://lh7-us.googleusercontent.com/aKmNMR9MLeWnqh1fX64GSeElbOy40b6mb3PnE3nFKSpvOy5jQG1TA7jN7ily6Qh7Y7VaeOsPVi2ydQ6L85V-mpcBIh0AbE9vEjumS61UQmLdEbl8uYhmXLyse4_vSMfCSvyJQs_v42M9Ox07RyCEnVQ" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Only one Xero organisation can be connected to a StayOnHire account at a time. To disconnect a Xero integration, refer to the [Xero Disconnect / Re-Connect](https://docs.stayonhire.com/integrations/xero/disconnect-reconnect) guide.
{% endhint %}

### 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:

<figure><img src="https://lh7-us.googleusercontent.com/VV7wJI8oTz_Mcfrp6a6aCClxIdPTewuhJfwsiWNU4HOsTrRXdCEkR_lTH4597Vgt6t5cSwh7gD9Q0JFEg9Rp3SdQzyO3sZ10pIArGhgr-sSIO4LKjUxZumUEhHbPIKic2WfbLja5KKh1_yB1JwKSsas" alt=""><figcaption></figcaption></figure>

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

{% hint style="success" %}
Only one StayOnHire organisation can be connected to your Xero integration at a time.&#x20;
{% endhint %}

<figure><img src="https://lh7-us.googleusercontent.com/aw8RuiaFbtm6fb0BcsNmWw-bzeqTw_wZy7BwHwEYVATrPSqvVDqfZlZZRQOytYpbwm5BqJ9LogerH7XnXiBqO4-U8fF6N5XqIL293Uyeix7QM9FydfBaWG1q7tWNSgM_KSod4lHy24p0x0FfRfUaylg" alt=""><figcaption></figcaption></figure>

Review which Xero resources you want to be integrated with your account.&#x20;

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

<figure><img src="https://lh7-us.googleusercontent.com/9mr0-gOO01L_6AU-5Zll1pQzQ8H_VocZWy7b_35LmcbCwhP7PgQS_cWJHqnTSqLmOjoTjt3R_yfaxUuq-x87XQ_1BldHssr6lj5QtWSYNiFMDt7zPYSdy7l47ikUE4OTQVidx7haHIYoX_oQxTyHDhs" alt=""><figcaption></figcaption></figure>

We recommend syncing invoices and payments.&#x20;

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”.

<figure><img src="https://lh7-us.googleusercontent.com/rxyo1HQB1EneToIpgPtyiAd77SSoKbICq3HAzXeVyBwQKHM5s05KBwwA-0-O_MiDh6cq1deQB_M3lrYMPB5g6cR1d-tBzCtVccPR0d64_o97O2NbxPOQGU5ePb74wTAXti30mkYy-Idv16rw157AuAo" alt=""><figcaption></figcaption></figure>

Review sync triggers and click “Finish”:

<figure><img src="https://lh7-us.googleusercontent.com/YlReyd5RWDxxvxifA4YsDbZNdIDP-6xH3jRphbWh6Aq3z9rf2FMw0lsImckFva4QGDVwdzmqpnvBugZa-8p1RTiCb-DupuwnXceFSMgRHDTtAZKp7Vj3wQh79nmzznzh3DOKOdfYuHCJrXpKwtIQG7c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://lh7-us.googleusercontent.com/oldmtm3-5-Zd5cf3rRHth-qk78GxZBeb-cvU9OImYSQXCrMR2H54rd97fNGvVAqljVKX96oj5w-YXu8qCKMyRg8giNAgBLfKx9Ep7gS6AlSlgP_0IR5AV6T157KeDcZ0LdyILvKyouE_psO6T0TlhL8" alt=""><figcaption></figcaption></figure>

Congratulations, your Xero integration has now been connected!

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

<figure><img src="https://lh7-us.googleusercontent.com/7HtShiQPn_PPUGC1sOqIuizhquF6leWCltdmK1EScL2XmLy6l-aBKhoxG-wD9oahzxavMj5UPPit8G7AX1ewBMnoFvoLhQPwzFsByhx5_AGxqCGZtpqMxOvnkQWvFXZRzs5rW2dVS5kdXkszeHOT-Og" alt=""><figcaption></figcaption></figure>

## 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:

&#x20;[app.stayonhire.com/org/accounting](https://app.stayonhire.com/org/accounting)

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FyQSFec2pUYH3oprjfMEb%2FScreenshot%202024-05-03%20at%202.51.23%E2%80%AFPM.png?alt=media&#x26;token=3c94f9c3-bc79-456e-8536-909c9904a1bd" alt=""><figcaption></figcaption></figure>

Click the 'Manage Tax Rates' option:

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FGkXub3vUooIysQxEdPNH%2FScreenshot%202024-05-07%20at%203.10.18%E2%80%AFPM.png?alt=media&#x26;token=8f8613ab-2317-44e2-a8e3-05476daaa7ab" alt=""><figcaption></figcaption></figure>

This will open a page showing tax rates now imported to StayOnHire.&#x20;

*Note:* Tax Rates are only imported from Xero, and cannot be edited. For a detailed breakdown of how this works, view the [Tax Rates](https://docs.stayonhire.com/integrations/xero/tax-rates) support page.

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FTE9sVxZQ8wiewzEE6dCu%2FScreenshot%202024-05-07%20at%203.16.04%E2%80%AFPM.png?alt=media&#x26;token=1022c920-2ea3-4eda-adbe-ed67a31979bf" alt=""><figcaption></figcaption></figure>

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

*Note:* Accounts are only imported from Xero, and cannot be edited. For a detailed breakdown of how this works, view the [Accounts](https://docs.stayonhire.com/integrations/xero/accounts) support page.

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FkQ27ZYndbIsY9HPzbnaG%2FScreenshot%202024-05-07%20at%203.21.54%E2%80%AFPM.png?alt=media&#x26;token=2a3fb5ae-2961-4f2d-a338-ae2c995e1fc4" alt=""><figcaption></figcaption></figure>

Lastly, this can be viewed on our Contacts page:

[app.stayonhire.com/contacts/all](https://app.stayonhire.com/contacts/all)

*Note:* Contacts can be managed in both Xero and StayOnHire depending on your configuration. For a detailed breakdown of how this works, view the [Contacts](https://docs.stayonhire.com/integrations/xero/contacts) support page.

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2FtZgay34siSYXHiGxmyOn%2FScreenshot%202024-05-07%20at%203.24.47%E2%80%AFPM.png?alt=media&#x26;token=0323eae7-5239-4957-a636-70b771bd69fb" alt=""><figcaption></figcaption></figure>

## 4. Confirm Billing Settings

This is now the optimal time to review your billing setup in StayOnHire.&#x20;

### 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:

Head to [Settings > Advanced > Accounting](https://app.stayonhire.com/org/accounting) to see an option called 'Default revenue account':

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2F913iTS5LFtvTr51CPjxW%2FScreenshot%202024-05-07%20at%203.48.23%E2%80%AFPM.png?alt=media&#x26;token=1a65045c-6d58-4fa6-930a-6667a687fa28" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://50563950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lzplo2osBdXGzFtPu2f%2Fuploads%2F0k1HyiZjUNoqstiv1E98%2FScreenshot%202024-05-07%20at%203.48.50%E2%80%AFPM.png?alt=media&#x26;token=1bffbcbc-1d6c-4c51-b55d-11fc54c5bbde" alt=""><figcaption></figcaption></figure>

### Invoice Configuration

For new users, we recommend reviewing your invoicing setup detailed in the [StayOnHire Invoices](https://docs.stayonhire.com/billing/invoicing), before proceeding to read details of how [Xero Invoicing](https://docs.stayonhire.com/integrations/invoices#overview) works.
