# 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](https://app.gitbook.com/s/9selzjEx6KX7RYEawAVr/integrations/xero-integration). \
\
Syncing with Xero also requires your Support Items to be configured correctly. Please click [here](https://app.gitbook.com/s/9selzjEx6KX7RYEawAVr/integrations/xero-integration/support-item-configuration) 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](https://knowledge.maica.com.au/maica-knowledge-base/getting-started/maica-key-concepts/invoice).

{% 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="https://2670482622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhehRshYIRk6XUlay9L3b%2Fuploads%2FuChpSUUzLtl8D7tz6MQe%2Fsync%20with%20xero%20button.png?alt=media&#x26;token=b3dfe250-5e0b-44c7-839c-2cafc87430af" 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="https://2670482622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhehRshYIRk6XUlay9L3b%2Fuploads%2FU8g2Xthf8C5h7LU13dZQ%2FScreenshot%202024-08-29%20at%202.06.10%20pm.png?alt=media&#x26;token=15911ec2-e9e7-493b-bcde-eb18b9d5def2" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2670482622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhehRshYIRk6XUlay9L3b%2Fuploads%2FOhSAiYbt84wIkivqRK38%2FScreenshot%202024-08-29%20at%202.30.01%20pm.png?alt=media&#x26;token=35967a05-7ab3-4164-93af-8633f3639f7a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you receive an error message at this stage, please ensure your [Xero Integration](https://app.gitbook.com/s/9selzjEx6KX7RYEawAVr/integrations/xero-integration) 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](https://knowledge.maica.com.au/maica-knowledge-base/integrations/xero-integration-overview).&#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="https://2670482622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhehRshYIRk6XUlay9L3b%2Fuploads%2Fs211bPDEkrnXRO8xUfOC%2Fxero%20info%202.png?alt=media&#x26;token=f392b55e-ec84-4d0f-b598-0f99f476d1b5" alt=""><figcaption></figcaption></figure>