# Getting Started with Xero

Everything you need to get started integrating Tahua and Xero

Learn how to:

* Connect and disconnect from Xero
* Test the Xero connection
* Configure Milestone sync options

{% stepper %}
{% step %}

### First, navigate to My Profile to ensure you have the required access permissions

![](/files/fb92f74c4516902d1890d3cdf9d1e8a01fa81d8a)
{% endstep %}

{% step %}

### You will need the "Can manage Integrations" permission

![](/files/e17d4717d615fd8312378ad8c15b2337adb4b70a)
{% endstep %}

{% step %}

### Now go to Settings > Organisation in the top right menu

![](/files/4381f4d42f36cfa2c80990c7cd1bada7abd6a934)

Click **Edit Details** to edit your Organisation Settings:

![](/files/2353f81a8f422dd24bc17b63f06ecdd5d732715d)
{% endstep %}

{% step %}

### Towards the bottom of settings, is Xero Integration. Click on the link to connect to Xero.

![](/files/024edd3655796abefa36d3d3f4083c9c50388baf)
{% endstep %}

{% step %}

### You will be taken to Xero where you can select an organisation to connect to.

![](/files/256d6bce56e750c3a306abb2b82c43ba9a95c137)
{% endstep %}

{% step %}

### You will then be directed back to your organisation settings, where you can test the connection, or disconnect.

![](/files/9f5553329cbc0a8e5188a155b8a3018cbfa6c914)

Once you are connected, Milestones will automatically be sent to Xero as bills.
{% endstep %}

{% step %}

### You can control which Xero account code is used for the published bills.

![](/files/b2c5cbf3326c960e70a5be92c311669404ad93de)
{% endstep %}

{% step %}

### If you use Funding Categories, we can make options for them under a specific Tracking Category in Xero. This way Milestones can be tracked per category in Xero.

![](/files/39a13d939aa494d8a0c8202b3a32ff916e0a20fa)
{% endstep %}

{% step %}

### Next, you can choose when a Xero Bill should be published.

![](/files/4be953bd36fab4a466d620be3dbec6f2c574d746)
{% endstep %}

{% step %}

### Finally, enter an email address for sync errors.

Sometimes a bill cannot be published. For example, the Bill date will usually be set to the contract start date. If this date is inside the locked period at Xero, the bill will not sync and an error will be sent to the sync error email address. The email will include a link allowing you to inspect the milestone and manually retry the sync. You can also choose a different date for the bill when you manually sync the milestone.

![](/files/2ce3a1e485e75bf6836f2d9d4d033a3432aed951)
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tahua.io/knowledge-base/integrations-help-guides/xero/getting-started-with-xero.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.