# Sync with Xero

## How do I Sync an Invoice with Xero on Maica?

{% hint style="success" %}
Syncing with Xero will only be supported if a Connection and Webhook has already been set up within your Organisation. Before attempting to Sync Invoices, please ensure this is the case. To learn more about configuring your Xero Integration, click [here](/maica-knowledge-base/maica-administration-guide/integrations/xero-integration.md). \
\
Syncing with Xero also requires your Support Items to be configured correctly. Please click [here](/maica-knowledge-base/maica-administration-guide/integrations/xero-integration/support-item-configuration.md) to learn how to configure your Support Items in order to facilitate the Xero Integration. 
{% endhint %}

Maica has `Automation` for Syncing with Xero. This article talks about scenarios in which manual Syncing may be required or chosen for a specific [Invoice](/maica-knowledge-base/getting-started/maica-key-concepts/invoice.md).

{% hint style="info" %}
To learn more about Maica's Syncing Automation, click here. 
{% endhint %}

## Sync with Xero Quick Action 

If you wish to manually Sync an Invoice with Xero outside of Maica's automation, the best way to do so is directly from the Invoice Record. Located in the top left corner of the interface, you will a find a `Sync with Xero` button, as shown below. 

<figure><img src="/files/jzSm1Ace2dcZo2I8787T" alt=""><figcaption></figcaption></figure>

Simply click this button to begin the Sync. Once clicked, Maica will display a pop-up confirming that you are about to Sync the Invoice and related Invoice Line Items with Xero. Click `Confirm` to finalise the Sync.&#x20;

<figure><img src="/files/F1g0LTKxMCgXirc39PKv" alt=""><figcaption></figcaption></figure>

Once confirmed, Maica will show a success message, and you can shut the window. As shown below.

<figure><img src="/files/fhRxav8vnbfHAdfWMztA" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you receive an error message at this stage, please ensure your [Xero Integration](/maica-knowledge-base/maica-administration-guide/integrations/xero-integration.md) has been configured correctly.&#x20;
{% endhint %}

Once done, you will be able to see the Invoice Record in Xero with the matching `Invoice Reference` from **Maica**.&#x20;

{% hint style="info" %}
To read a full overview of the Xero Integration in Maica, click [here](/maica-knowledge-base/integrations/xero-integration-overview.md).&#x20;
{% endhint %}

## What happens after my Invoice has been Synced?&#x20;

After an invoice has been successfully synced, the Invoice Record will be updated accordingly. Two new fields will be automatically populated from Xero. These are the `Xero Invoice Number` and `Xero ID`, as shown below. These values come from Xero and will help you identify the associated Invoice between **Maica** and Xero when required.&#x20;

<figure><img src="/files/RyId4OJtNH3OuoLWJzrR" alt=""><figcaption></figcaption></figure>


---

# 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://knowledge.maica.com.au/maica-knowledge-base/invoices/invoice-actions/sync-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.