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