
## What is Auto Sync

**Auto Sync** is designed to run in the background without you touching it. Once you enable it, every _new_ sale you make is instantly pushed to Xero.

<Callout type="important-rule" title="⚠️ Important Rule">

**New Orders Only** Enabling Auto Sync does **not** look at the past. It will only sync orders created _after_ the moment you click "Save".

</Callout>

---

## Where to find this setting?

Go to <Badge>**Settings → Business Portfolios**</Badge>. Click your <Badge>business</Badge> → Click the <Badge>**three dots**</Badge><Badge>for Xero</Badge> → <Badge>**Settings**</Badge>. Scroll down to the <Badge>**Auto Syncing**</Badge>section.

---

## Understanding Contact Mapping

When setting this up, you have two choices for how these invoices appear in Xero:

**1. Auto-Match (Dynamic)**

The system looks for a contact in Xero with the exact same name.

- **For Online Stores/B2B:** It looks for the **Customer's Name** (e.g., "John Doe"). If "John Doe" doesn't exist, it creates him.

- **For POS:** It looks for the **Location Name:** (e.g., "Clementi Branch"). This groups all sales from that store under one Xero contact.

- **Auto match by Customer Phone Number.:**A separate Xero contact will be created for each customer using their phone number as a unique identifier. This means two customers with the same name but different phone numbers will become separate contacts in Xero. This is useful if your customers share common names and you need a reliable way to tell them apart.

- **Auto match by Customer ID:** A separate Xero contact will be created for each customer using their customer ID (e.g., 1001) as a unique identifier. This is best for B2C businesses that use a customer index system.

**2. Manual Select (Generic Contact)**

This acts as a "Catch-All." You force all sales from a specific channel to go into a single, generic Xero contact of your choice.

<Callout type="why-use-this" title="Why use this?">

Perfect for **"Walk-in"** POS customers. Instead of creating thousands of contacts, you can map everything to a single Xero contact named **"Walk-in Customer"** to keep your accounting clean.

</Callout>

---

## How to set up Auto Sync

![How to set up Auto Sync](https://cdn.easybizcloud.app/knowledge/99109c08c8964edc907aeff6e1378365b44660271a4c7ac5f4b1284a0f5b3ba2.png)

![How to set up Auto Sync](https://cdn.easybizcloud.app/knowledge/cfd0ab2cbf4c09d6a66a62d2d4c9d8501886005d8246530ae85afbf71f8cfd28.png)

![How to set up Auto Sync](https://cdn.easybizcloud.app/knowledge/e451571be806642fb0212f867239efb40fa3ed5e4e6e0320c00cc8ed6d652ef9.png)

![Screenshot](https://cdn.easybizcloud.app/knowledge/c26ae12b7b115c7e0480b12865b4ed8d9ecd79219e58ed000700828114a95cd9.png)

![Screenshot](https://cdn.easybizcloud.app/knowledge/9ce0435f417e0ba09e93501bf86398c9dc40af21f4ca85b6cbc35d07a0ab8901.png)

![Screenshot](https://cdn.easybizcloud.app/knowledge/3b951d8939d9ea35f3ad940d90e2b4c4eca1bdabd72cc6b2d01c30e5d23541d8.png)

![Screenshot](https://cdn.easybizcloud.app/knowledge/557ba60d7cc8084f2d041e7d8cc2c2d9db8e2fd5f035ab532960dfa26638e0ff.png)

<Callout type="note" title="Note">

Enabling Auto Sync does not automatically sync past orders. It only applies to new orders created after you click Save. To sync past orders, please use the Manual Sync tool.

</Callout>

---

## The Workflow

<Video src="https://cdn.easybizcloud.app/knowledge/video/f4ba055925bf3537e7af168c98ad2db5254c0d97206f4f5deeebffc2b2437cec.mp4" />

Once active, the process is seamless:

1. Create an order on your sales channel. (In the video guide above, we demonstrated this using the POS).

2. Wait a few seconds.

3. The order appears in Xero automatically.

<Callout type="tip" title="Tip">

If you don't see it immediately, try refreshing your Xero page.

</Callout>

---

## What's Next?

Now that auto sync is running, continue to [Manual Sync](/docs/using-manual-sync) to learn the manual fallback for re-pushing or correcting individual records when needed.
