先知道该去哪里查看

  • 连接状态 —— ⚙️ 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 映射改为有效记录），然后为受影响日期重新运行同步。

“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 映射 。

  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 映射 。如需了解在 QuickBooks 中记录的付款如何流回 EasyBiz，请参阅 将 QuickBooks 付款同步到 EasyBiz 。