排查 QuickBooks Online 数据同步集成问题

如果您在 HubSpot 与 QuickBooks Online 之间同步记录时遇到问题，请查看常见的同步错误及其解决方法。例如，如果相关客户在 QuickBooks Online 中无法找到，或者发票编号重复，发票可能无法同步。了解如何识别并解决这些错误，以成功同步您的记录。

常见错误

如果几分钟内未看到发票同步到 QuickBooks Online，可能有多种原因导致同步失败。

• 如果任何发票未能同步，发票索引页顶部将显示一条横幅提示。点击“同步失败 详情”将打开 QuickBooks 集成设置中的“同步失败 ”面板 。
• 您还可以通过查看发票预览面板上的“ 集成”同步卡片，来确认发票同步是否成功。

• 所有同步失败情况（包括发票同步）均可在您的QuickBooks Online 设置页面中查看。

以下是一些您可能遇到的常见错误及其解决方法。

发票应关联一个客户。请确保 HubSpot 和 QuickBooks Online 中均存在该关联客户，才能同步此发票

出现此错误是因为在尝试同步发票时，QuickBooks Online 中未找到发票上的联系人。大多数情况下，这是因为发票上的联系人与 QuickBooks 中客户的电子邮件地址不一致。 如果您将 HubSpot 中发票上的联系人更改为与 QuickBooks 中客户邮箱匹配的联系人，发票即可同步。

显示名称重复

在 QuickBooks Online 中，“显示名称”字段必须唯一。同一公司的第一个联系人的“显示名称”将默认设置为公司名称，但该公司的后续联系人若尝试同步至 QuickBooks Online，将因“显示名称”已被占用而同步失败。了解有关如何为客户设置显示名称的更多信息。

业务验证错误：请为收入确认明细行输入服务日期

如果您正在使用 QuickBooks Online的收入确认功能，可能会出现此错误。收入确认要求发票上的所有明细行都必须具有服务日期。无法为 HubSpot 明细行添加服务日期。建议在 QuickBooks 中关闭收入确认设置，并单独进行收入确认报表编制。

HubSpot 原生发票中的明细行或发票金额无法通过外部应用程序进行修改。请直接在 HubSpot 中进行必要的更改

此错误是由于在 HubSpot 中创建的发票在 QuickBooks Online 中被修改所致。请在 QuickBooks 中撤销对该发票的更改，并在 HubSpot 中对发票进行相应调整，以继续同步。

文档编号重复错误：您必须指定一个不同的编号。该编号已被使用

当集成尝试将一张发票发送至 QuickBooks Online，而该发票编号已在 QuickBooks 中的另一张发票或信用备忘录中使用时，会发生此错误。通常，这是因为您启用了“自定义交易编号”设置，导致 QuickBooks 会自动采用 HubSpot 的前缀和编号。 要解决此错误，建议先更新 QuickBooks Online 中相关发票或信用备忘录的编号，以便 HubSpot 发票能够同步到 QuickBooks，然后关闭“自定义交易编号”设置。

HubSpot 原生发票中的明细行或发票金额无法通过外部应用程序进行修改。请直接在 HubSpot 中进行必要的更改

此错误表明，在 HubSpot 中创建并同步到 QuickBooks Online 的发票，其财务信息（例如明细行、税费）已在 QuickBooks 中被添加、删除或修改。这些更改无法同步回 HubSpot，因此发票同步失败。 要修复此错误，请在 QuickBooks 中撤销相关更改。如果您需要修改 HubSpot 发票的财务详细信息，建议先在 HubSpot 中进行修改，然后允许其同步到 QuickBooks。

由工作流生成的发票未与商机关联

如果工作流创建了发票，但该发票未与已关联的交易相关联，则发票同步可能已被暂停或尚未开始。只有在发票同步处于开启状态时，HubSpot 才会将发票与交易相关联。对于在同步关闭期间创建的发票，HubSpot 不会建立关联。要解决此问题：

1. 在 QuickBooks 数据同步设置中开启或恢复发票同步。
2. 对于在同步关闭期间生成的任何发票，请重新运行工作流。