## 什么是手动同步？

**手动同步**像一台时光机。它会将已存在于 EasyBiz 的*历史*订单重新推送到 Xero。

何时使用手动同步？

- **🗓️ 首次设置：** 您今天刚连接 Xero，但希望上个月的所有销售也出现在账目中。

- **🛠️ Xero 同步恢复：** 订单已保存在 EasyBiz 中，但网络中断导致订单未自动同步到 Xero。恢复联网后，可使用手动同步“强制推送”这些现有订单。

<Callout type="important" title="⚠️ 重要">

手动同步只会把已保存在 EasyBiz 中的订单重新推送到 Xero。它不能恢复未保存的 POS 订单或购物车，也不能恢复或确认付款。若结账期间网络中断，请勿立即再次收款；请先恢复联网，并按照[付款期间网络中断](/docs/collecting-payment-at-checkout)的步骤处理。

</Callout>

<Callout type="critical-warning" title="🛑 关键警告">

**Xero API 限制** Xero 会限制您一次可发送的数据量（“每日配额”）。

</Callout>

- **请勿**一次同步整整一年的资料。这会耗时很长。

- **最佳做法：** 以小批次同步（例如每次一周或一个月），确保所有资料顺利传送。

---

## 在哪里可以找到此设置？

前往 <Badge>**设置 → 集成**</Badge>。在 <Badge>**Xero**</Badge> 卡片上点击 <Badge>**同步**</Badge>，打开 <Badge>**Xero 同步**</Badge> 页面。您也可以在 <Badge>**Xero设置**</Badge> 的 <Badge>**自动同步**</Badge> 区域，从某一行的菜单中选择 <Badge>**手动同步**</Badge>，这样会使用该行的销售渠道和联系人。

---

## 了解联系人映射

设置时，您可选择发票在 Xero 中显示的方式：

**1. 自动匹配（动态）**

系统会在 Xero 中查找名称完全相同的联系人。

- **在线商店/B2B：** 查找**在线商店名称**或 **B2B 代理名称**（例如“John Doe”）。如果没有该名称的联系人，系统会创建一个。

- **POS：** 查找**店铺名称**（例如“Clementi Branch”）。这会把该门店的所有销售归到一个 Xero 联系人下。

- **按姓名和电话：** 系统会以电话号码作为唯一标识，为每位顾客创建单独的 Xero 联系人。因此，同名但电话号码不同的顾客会成为不同联系人。当顾客常有相同姓名而您需要可靠区分方式时，这很有用。

- **按名称与ID：** 系统会以顾客 ID（例如 1001）作为唯一标识，为每位顾客创建单独的 Xero 联系人。这最适合使用顾客索引系统的 B2C 业务。

**2. 手动选择（通用联系人）**

这相当于“统一归集”。您可让特定渠道的所有销售都进入您选定的单一通用 Xero 联系人。

- _为什么使用此方式？_ 非常适合 **“Walk-in”** POS 顾客。您无需创建数千个联系人，而可将所有资料映射到一个名为 **“Walk-in Customer”** 的 Xero 联系人，让账目保持整洁。

---

## 何时应使用手动同步？

- **历史数据：** 您今天刚安装 Xero，但希望同步上个月的销售。

- **Xero 同步恢复：** 如果 EasyBiz 中已有的已保存订单没有自动同步到 Xero，您可稍后使用手动同步将其推送出去。

---

## 如何使用手动同步

1. 在 <Badge>**Xero 同步**</Badge> 页面点击 <Badge>**添加同步请求**</Badge>。

2. 在 <Badge>**转到 Xero 组织**</Badge> 中选择您的 Xero 组织。然后在 <Badge>**来自销售渠道**</Badge> 中选择销售渠道，并在 <Badge>**转到联系人**</Badge> 中选择联系人方式。

3. 选择 <Badge>**同步日期范围**</Badge>。

4. 点击 <Badge>**同步至**</Badge>（后接您的 Xero 组织名称）。

<Callout type="note" title="说明">

API 限制：Xero 会限制一次可发送的数据量。如果需要同步较长时间范围（例如整年的销售），请将其分成较小批次（例如按月）。较大的同步可能需要几天才能完成。

</Callout>

---

## 工作流程

启用后，流程会很顺畅：

1. 在销售渠道中创建并保存订单。

2. 为特定销售渠道添加手动同步请求，并选择日期范围。

3. 您可以在 <Badge>**Xero 同步**</Badge> 页面的列表中查看进度。转圈图标消失后，同步即完成，“已同步”数量显示有多少条记录已进入 Xero。点击某个请求可打开 <Badge>**同步状态**</Badge>，查看记录失败或被跳过的原因。

---

## 下一步

现在您已覆盖自动和手动同步，请继续阅读[自定义发票编号](/docs/customizing-invoice-numbers)，控制发票编号的生成方式，让它们符合您的会计惯例。
