## 先知道该去哪里查看
- **连接状态** —— ⚙️ Settings → **Integrations**。如果 **QuickBooks Online** 卡片显示 **Reconnect required**，请先处理这一项（如下）——恢复连接前不会进行任何同步。
- **手动同步结果** —— QuickBooks Online 卡片 → Sync 会打开 **QuickBooks Sync** 页面。每个同步请求都会显示错误 / 已同步 / 总数的进度，并为失败项目提供 **View Details** 链接。
临时问题——例如 QuickBooks 响应缓慢或达到速率限制——会自动以逐步延长的间隔重试几次。只有错误持续存在时才需要您处理。
---
## “Deleted or made inactive in QuickBooks”
完整消息为：*“A record referenced by this sync was deleted or made inactive in QuickBooks — fix it in QuickBooks or re-run the sync.”* 这表示此次同步依赖的某项资料在 QuickBooks 端被移除。处理方式取决于被移除的**是什么**：
- **发票本身在 QuickBooks 中被删除。** 这会自行修复：EasyBiz 会清除失效链接，并在下一次同步该订单时创建新发票。请为受影响日期范围运行手动同步，并确认发票重新出现。
- **顾客、项目、账户或税码被停用。** QuickBooks 会拒绝引用停用记录。请在 QuickBooks 中重新启用该记录（或将 EasyBiz 映射改为有效记录），然后为受影响日期重新运行同步。
在 EasyBiz 中被**作废**的订单会特意保留失效链接——重新运行同步不会为已取消的销售重新创建发票。
---
## “Duplicate DocNumber”
QuickBooks 会拒绝使用相同发票编号的两张发票。发生此问题时，EasyBiz 会先检查现有 QuickBooks 发票是否实际属于同一订单——若是，系统会直接采用它并继续。若现有发票属于_不同_订单，同步会停止并要求人工审核。
**修复方式：** 在 **QuickBooks Sync Settings → Field Format Settings** 中，让您的发票编号格式对每张订单唯一（Sales Order Invoice Number 模板会成为 QuickBooks DocNumber）。然后重新运行同步。如果两张不同订单确实撞用了一个编号，请先在 QuickBooks 中解决编号问题。
---
## “Reconnect required”
您的 QuickBooks 授权已过期或被撤销——这偶尔会发生（密码更改、QuickBooks 端的安全审核，或令牌到期）。
1. 打开 ⚙️ Settings → **Integrations**。
2. 在 QuickBooks Online 卡片上点击 Reconnect，并再次登录 QuickBooks。
3. 映射会保留——无需重新设置任何内容。
断开连接期间产生的订单不会丢失；重新连接后，请对该日期范围进行手动同步来推送它们。
---
## 订单完全没有出现在 QuickBooks 中
没有错误，但什么都没到？请依次检查：
1. **Customer Routing** —— 订单的销售渠道必须有顾客路由。没有路由的渠道完全不会同步。请参阅[设置您的 QuickBooks 映射](/docs/setting-up-your-quickbooks-mappings)。
2. **同时映射了 Xero 和 QuickBooks** —— 如果同一个销售渠道在_两个_集成中都有映射，EasyBiz 会跳过它以避免重复记账。请让每个销售渠道只路由到一个会计系统。
3. **历史订单** —— 自动同步只覆盖映射设置好之后的订单。更早订单需要手动同步：QuickBooks Online 卡片 → Sync → Add Sync Request，然后选择日期范围。
---
## 手动同步没有开始或卡住
- QuickBooks 会限制每日可接受的 API 请求数量。手动同步只有在每日配额足够时才会开始——请稍后重试，或将大批补录拆分为更小日期范围。
- 运行中的请求会在 QuickBooks Sync 页面显示进度；您可以**Cancel** 一个排队中的同步，并重新提交更窄的范围。
---
## 何时联系支持团队
出现以下情况时请联系 EasyBiz 支持团队：
- 您已修复 QuickBooks 端记录并重新运行同步，但同一错误仍然出现。
- “Duplicate DocNumber conflict”要求人工审核，而现有发票看起来不属于您。
- 付款或发票看似已同步，但两个系统中的数字不一致。
请提供订单号、View Details 中的确切错误信息和大致同步时间——这就是支持团队追踪所需的全部信息。
---
## 常见问题
**失败同步会自行重试吗？**
> 临时失败（超时、速率限制）会自动重试几次。需要您在一侧修复的问题——被删除记录、重复编号——会保持失败状态，直到您解决原因并重新运行。
**重新运行同步会重复已经同步的发票吗？**
> 不会。已经关联 QuickBooks 发票的订单会更新，而不会重新创建。重新运行一个日期范围是安全的。
**我们故意在 QuickBooks 中删除了一张错误发票。接下来怎么办？**
> 通常无需处理——EasyBiz 会清除过期链接，并在下一次同步该订单时重建发票。如果您删除它是因为销售本身有误，请改为在 EasyBiz 中作废订单，避免它继续同步。
---
## 下一步
有关这些错误背后的日常映射详情，请参阅[设置您的 QuickBooks 映射](/docs/setting-up-your-quickbooks-mappings)。如需了解在 QuickBooks 中记录的付款如何流回 EasyBiz，请参阅[将 QuickBooks 付款同步到 EasyBiz](/docs/syncing-payments-from-quickbooks)。