排除 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. 針對在同步功能關閉期間所建立的任何發票，請重新執行工作流程。