QuickBooks Onlineデータ同期連携のトラブルシューティング
更新日時 2025年9月10日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
HubSpotとQuickBooksの間でレコードが同期されない原因について確認および検討します。
よくあるエラー
数分以内に請求書がQuickBooks Onlineに同期されない場合、同期に失敗する原因がいくつか考えられます。
- 同期に失敗した請求書は、請求書一覧ページの上部にバナーが表示されます。[同期エラーの詳細]をクリックすると、QuickBooks連携設定の[同期に失敗]パネルが開きます。
- 請求書の同期が正常に行われたかどうかを確認するには、請求書のプレビューパネルで[連携の同期 ]カード を使用します。
- 請求書同期を含む全ての同期失敗は、QuickBooks Online の設定ページで確認できます。
以下は、よく遭遇するエラーとその解決方法です。
請求書には関連付けされた顧客が必要です。関連付けした顧客がHubSpotとQuickBooks Onlineの両方に存在することを確認して請求書を同期します。
このエラーは、同期時にQuickBooks Onlineで請求書のコンタクトが見つからなかったために発生します。多くの場合、請求書のコンタクトがQuickBooksの顧客のEメールアドレスを共有していないことが原因です。HubSpotの請求書のコンタクトを、QuickBooksの顧客のEメールと一致するコンタクトに変更すると、請求書は同期されます。
表示名が重複している
[表示名 ]フィールドはQuickBooks Onlineで一意である必要があります。会社からの最初のコンタクトは、表示名が会社名に設定されますが、その会社からの最初のコンタクトの後に QuickBooks Online に同期しようとするコンタクトは、表示名がすでに使用されているため、同期に失敗します。顧客に表示名を設定する方法について詳細をご確認ください。
ビジネス・検証・エラー:収益認識商品項目にサービス日を入力してください。
このエラーは、QuickBooks Onlineの 収益認識機能を使用している場合に発生することがあります。収益認識には、請求書の全ての商品項目にサービス当日が必要である。サービス日をHubSpotの商品項目に追加することはできません。QuickBooksで収益認識設定をオフにして、個別に収益認識レポートを作成することをお勧めします。
HubSpotネイティブ請求書での商品項目または請求書の金額の変更は、外部アプリケーションからは行えません。必要な変更はHubSpotで直接行ってください。
このエラーは、HubSpotで作成された請求書がQuickBooks Onlineで変更されたために発生します。QuickBooksで請求書の変更を元に戻し、HubSpotで請求書の調整を行い、同期先を継続します。
ドキュメント番号が重複しています エラー: 別の番号を指定する必要があります。この番号はすでに使用されています。
このエラーは、QuickBooks内の別の請求書またはクレジットメモによってすでに使用されている請求書番号を使用して、連携によってQuickBooks Onlineに請求書を送信しようとすると発生します。ほとんどの場合、 これは[カスタムトランザクション番号]設定 をオンにしているために起こります。この場合、QuickBooksではHubSpotのプレフィックスと番号が自動的に採用されます。このエラーを解決するには、HubSpotの請求書がQuickBooksに同期されるようにQuickBooks Onlineで請求書またはクレジットメモの番号を更新してから、 カスタムトランザクション番号の設定をオフにすることをお勧めします。
HubSpotネイティブ請求書の商品項目や請求金額の変更は、外部商品項目では行えません。必要な変更はHubSpotで直接行ってください。
このエラーは、HubSpotで作成され、QuickBooks Onlineに同期された請求書に、QuickBooksで財務情報(商品項目、税金など)が追加、削除、または変更されたことを示しています。これらの変更はHubSpotに同期できないため、請求書の同期に失敗しています。エラーを修正するには、QuickBooksの変更を元に戻してください。HubSpot請求書の財務情報を変更する必要がある場合は、HubSpotでその変更を行った後、QuickBooksに同期することをお勧めします。