开始前
本指南假设 Xero 已连接。有关设置，请参阅 Xero 集成概览 、 连接您的账户 、 自动同步 、 手动同步 、 配置账户代码 和 映射付款方式 。
要查看同步活动，请前往 Settings → Integrations → Xero → Sync 。
如何阅读同步状态
每个同步批次会显示类似 1/38/47 的状态。其含义为 失败 / 成功同步 / 总数：
- 1 —— 失败的项目数
- 38 —— 已成功同步到 Xero 的项目数
- 47 —— 批次中的项目总数
如果数字相加不等于总数，剩余项目仍在排队、处理中或重试。例如，上述示例中有 8 个项目（47 − 38 − 1）仍在进行中。
记录显示 Succeeded 表示发票已发送到 Xero，显示 Failed 表示 EasyBiz 已尝试但无法完成同步。失败记录会在详情中说明原因。
同步需要多久？
没有固定时长——它取决于要同步的数据量。Xero 也会限制一次可发送的数据量，因此较大的日期范围应分成更小批次（例如每次一周或一个月）。
如果等待很久后 Xero 中仍没有内容出现：
- 打开 Settings → Integrations → Xero → Sync ，检查批次状态。
- 确认日期范围内的订单是否真的符合条件（参阅下一节）。
- 如果批次仍未显示进度，请向支持团队提供您同步的确切销售渠道和日期范围，以便团队精确检查记录。
为什么有些订单从未出现在 Xero 中
并非日期范围内的每张订单都会发送。订单被跳过或失败的常见原因包括：
- 已取消的订单不会发送到 Xero。
- **零金额订单（$0.00）**会自动跳过——Xero 不接受零金额发票。如果希望记录它们，请先更新这些订单的定价，然后重新同步。
- 重复的发票编号。 Xero 不允许同一组织中有两张相同编号的发票。如果 Xero 已有相同编号的发票（可能属于不同联系人，或是一张旧的已付款/已作废发票），同步无法推送新发票。请在 Xero 中使用带前缀和不带前缀的编号搜索。作废或重编现有发票编号，然后再次同步——只会重新推送缺失项目。
另请注意，尚未完成会计定稿的销售会以 Awaiting Approval 而不是 Draft 状态发送到 Xero。发票已在 Xero 中，财务团队可在其中审核和批准。如果希望在销售进入 Xero 前先审核，请使用 手动同步 ，而非自动同步。
查找并修复失败项目
- 前往 Settings → Integrations → Xero → Sync 。
- 点击同步行。它会显示错误，通常也会显示相关订单号或参考资料。
- 修复原因（例如更正 EasyBiz 中的订单，或解决 Xero 中的冲突），然后再次同步相同范围。
再次同步是否安全？
是的——对于 EasyBiz 已同步过的订单，再次同步是安全的：
- 如果要更正同一批订单，不要先删除 Xero 发票。 在 EasyBiz 中更新后再次同步——已关联的 Xero 发票会更新，不会重复。
- 添加新请求前也无需删除旧的同步请求行。
- 新的同步不会删除误发的发票。 已完成同步没有撤销功能，因此不需要的已授权发票必须在 Xero 中作废。
Xero 联系人搜索没有结果
在 EasyBiz 中选择 Xero 联系人时，请使用与 Xero 中完全一致的完整联系人名称，或联系人的确切电子邮件地址。例如，如果 Xero 中联系人保存为“Honestbee Pte Ltd”，请搜索“Honestbee Pte Ltd”，不要只搜索“Honestbee”。
有关同步时如何匹配联系人（按姓名、电话号码、顾客 ID 或单一通用联系人），请参阅 为您的业务选择正确的联系人匹配方式 。
将两个 EasyBiz 账户连接到同一个 Xero 组织
支持此做法。连接每个 EasyBiz 账户时，请在列表中选择同一个 Xero 组织。账户代码和付款映射会按账户独立配置。
唯一需要注意的是发票编号，因为 Xero 不允许同一组织内存在重复编号。在每个账户的 Xero 设置中，滚动到 Field Format Settings，并为每个账户的 Sales Order Invoice Number 和 Monthly Invoice Number 字段设置不同前缀（例如一个账户使用 BM-，另一个使用 NSK-）。在字段中输入 @ 可插入订单编号等占位符。
仍然无法解决？ 打开控制台中的帮助面板并联系支持团队——请附上销售渠道、日期范围和相关订单编号，让团队能快速检查具体记录。