- 1The Five-Minute Triage: Auth, Data, or Config?
- 2Class 1: The Connection Dropped (Auth Expiry)
- 3Class 2: Orders Missing or Delayed
- 4Class 3: Duplicate Transactions (Bank Feed + Connector Overlap)
- 5Class 4: Fees Lumped Into Deposits
- 6Class 5: Wrong Accounts and Mapping Drift
- 7Class 6: Sync Stopped After an App or Theme Change
- 8When Your QuickBooks Shopify Integration Is Not Working by Design
- 9If This Is Your Third Time on This Page
Six failure classes cover nearly every break. Find yours in five minutes, then apply the fix — and learn which one fix never holds.
The last order in QuickBooks is from Tuesday. It's Friday. You didn't change anything, nobody touched anything, and yet your QuickBooks Shopify integration is not working — again — three days before you need clean numbers for a sales tax filing.
If this feels familiar, it probably is. Most people who land on this page have already reconnected the integration once before, watched it work for a few weeks, and assumed the problem was solved. Then it broke a different way — which is exactly why the last fix didn't hold.
Two things before the fixes. First, a disclosure: we make a competing paid sync tool, so our bias exists. Product talk stays out of the troubleshooting entirely — it appears once, clearly labeled, at the very end. Second, a reframe: the lie that keeps people stuck on this page is "I must have set it up wrong." You almost certainly didn't. Sync breakage isn't one problem with one fix — it's six distinct failure classes, each with its own symptoms, cause, and repair. Diagnose first, then fix.
The Five-Minute Triage: Auth, Data, or Config?
Every sync failure answers one of three questions. Answer them in order to find your section.
1. Is anything syncing at all? Find the most recent transaction the connector created in QuickBooks. If everything stopped on a specific date, you have a connection problem — lost authorization (Class 1), or a Shopify-side change that broke it (Class 6).
2. Is data arriving, but incomplete or late? Missing orders, or everything showing up a day later than you expect: a data-flow problem (Class 2).
3. Is data arriving, but wrong? Revenue looks doubled, fees are invisible, or income lands in strange accounts: a configuration problem (Classes 3, 4, and 5).
| Symptom | Likely class |
|---|---|
| Nothing has synced since a specific date | 1 — Authorization expired |
| Stopped right after you changed apps, themes, or plans | 6 — App/theme change |
| Some orders missing, or arriving late | 2 — Missing or delayed orders |
| Revenue looks roughly doubled | 3 — 重複 |
| 収入は入金と一致するが、手数料の支出がどこにも見当たらない | 4 — 入金に含められた手数料 |
| 「未分類の収入」または不明な口座に入金される売上 | 5 — マッピングのずれ |
クラスにジャンプします。それぞれに症状、実際の原因、および自分で実行できる修正手順が記載されています。
Class 1: The Connection Dropped (Auth Expiry)
症状: 同期が特定の日付で完全に停止しました。何も大きなエラーは発生しませんでしたが、注文が単に表示されなくなりました。コネクタの設定で、ストアが切断されていると表示されたり、再承認を求められたりする場合があります。
原因: 連携は、最初に接続したときに付与された承認トークンで実行されます。トークンは、予想よりも頻繁に失効します。パスワードの変更、スタッフアカウントの無効化、権限の変更、双方での定期的なセキュリティイベントなどです。連携を最初に接続した担当者がチームを離れることは、静かに連携を断つ典型的な原因です。その担当者の認証情報が失われると、接続も失われます。
修正方法:
- コネクタの設定で再承認してください。 ストアを切断して再接続し、要求されたすべての権限を承認してください。
- 適切なアカウントを使用してください。 後で無効になる可能性のあるスタッフログインではなく、ストアオーナーまたは会社管理者のアカウントで再接続してください。この習慣を守ることで、認証の失敗を繰り返すほとんどを防ぐことができます。
- メールフィルターを確認してください。 ほとんどのコネクタは切断通知を送信します。迷惑メールに分類されていると、気づかずに数日間の同期ロスが発生します。送信者をホワイトリストに登録してください。
- ギャップをバックフィルしてください。 再接続しても、切断された期間のデータが必ずしも再同期されるわけではありません。切断日と再接続日を記録し、それらの注文が反映されたかどうかを確認してください。反映されていない場合は、クラス2の修正で回復できます。
予防策: 連携専用の管理者アカウントを用意し、毎月2分間のチェックをカレンダーに設定してください。QuickBooksの最新の注文はShopifyの最新の注文と一致していますか?
Class 2: Orders Missing or Delayed
症状: 合計金額がShopifyレポートと一致しません。特定の注文が表示されないか、販売の1日以上後にすべてが表示されます。
原因: この1つの症状の下に、3つの異なる原因が隠れています。
- 同期頻度。 多くのコネクタはスケジュールに基づいて同期します。リアルタイムではなく、日次バッチ処理です。「遅延」は、単に設計どおりにスケジュールが機能しているだけかもしれません。
- 範囲。 コネクタは、設計上、注文タイプの一部のみを同期することがよくあります。POS販売、下書き注文、または追加の販売チャネルからの注文は除外される場合があります。
- 境界。 月の途中で開始された同期は、通常、過去に遡って同期されません。また、ShopifyとQuickBooksの会社ファイル間のタイムゾーンの不一致により、深夜に近い注文が誤った日に分類される可能性があります。
修正方法:
- コネクタの設定で同期スケジュールを確認し、遅延が単に設定された間隔によるものでないことを確認してください。オプションがある場合は、手動同期をトリガーしてください。
- 欠落している注文のパターンを見つけてください。 Shopifyで5件の注文を検索してください。同じチャネルですか?同じ日付範囲ですか?同じ支払い方法ですか?パターンがある場合は、誤動作ではなく範囲制限を示します。
- スコープ制限の場合:除外された注文は別の方法で記録します(通常は、そのチャネルの合計に対する月次仕訳)そして、コネクタがそれらを転送しないことを受け入れます。
- ギャップ期間の場合:(認証のドロップまたは月半ばの開始から)コネクタの設定で、過去のインポートまたは日付範囲の再同期オプションを探します。オプションがない場合は、ギャップを手動で一度だけ入力します。
- タイムゾーンを合わせる:Shopifyストアの設定とQuickBooksの間で、日をまたぐ注文が正しい期間に着地するようにします。
Class 3: Duplicate Transactions (Bank Feed + Connector Overlap)
症状:QuickBooksの収益が、実際に販売した額の約2倍になっている。注文または支払いが2回表示される。損益計算書が素晴らしく、完全に間違っているように見える。
発生理由:これは最も一般的な設定エラーであり、バグではありません。コネクタはShopifyの売上をQuickBooksに記録します。次に、銀行フィードがShopifyの支払い入金(同じお金)をインポートし、一致させるのではなく追加をクリックすると、QuickBooksは最初の収入エントリの上に2番目の収入エントリを作成します。追加するたびに支払いが倍増します。
修正方法:
- まず習慣を変える:今日から、銀行フィードからShopifyの支払いを入金する際に、決して追加しないでください。コネクタが既に作成したトランザクションに常に一致させてください。追加は収入を作成し、一致は既に存在する収入を確認します。
- 既存の重複をクリーンアップする。コネクタが既に売上を記録していた場合に追加された入金を見つけ、それらを元に戻すか除外し、正しく一致させます。月ごとに、最近のものから作業します。
- 2番目のシンカーを確認する。同時に実行されている2つのコネクタ(アンインストールしなかった古いアプリと新しいアプリ)または同じ日付範囲が2回インポートされた場合も重複します。1つのツール、1つの真実の情報源。
- 1回の支払いで確認する。単一の最近の支払いについてトレースします。1セットの売上エントリ、1回の入金が一緒に一致しています。そのチェーンがクリーンであれば、クリーンアップは成功しました。
Class 4: Fees Lumped Into Deposits
症状:QuickBooksの収入は、銀行の入金とほぼ一致しています。これは良いことのように聞こえますが、Shopifyが販売したと述べている額よりも少なく、損益計算書にShopifyの手数料費用が存在しないことに気づくまでです。
発生理由:Shopifyはあなたに純額を支払います。売上から返金と処理手数料を差し引いた額を1回の入金として支払います。統合がその塊を収入として記録すると、手数料はそれに消えてしまいます。純入金が総収入として記録され、収入と費用の両方が誤って表示され、税務申告の基礎となる売上高が歪む可能性があります。そのギャップの完全な解剖は、QuickBooksのShopify手数料にあります。
修正方法:
- コネクタの設定で手数料処理オプションを探す。コネクタが支払いを入金、返金、手数料に分割できる場合は、それをオンにして、手数料行を「販売業者処理手数料」勘定科目にマッピングします。
- それができない場合は、手動で総計を算出してください。月に一度、Shopifyの入金レポートを取得し、手数料を合計して、仕訳伝票を記帳します。売上を手数料額だけ増やし、同額を手数料費用として計上します。純利益は変わりませんが、収益と費用は両方とも真実になります。
- 重要な履歴を修正してください。最低でも、現在の税年度を同じ方法で、月に1回の記帳で修正してください。
正直なフラグ:ステップ1で何も見つからなかった場合、それは設定ミスではなく、限界です。修正後のセクションでそのことを覚えておいてください。
Class 5: Wrong Accounts and Mapping Drift
症状:「未分類の収益」に売上が表示される。新しい支払い方法の収益がどこか奇妙な場所に計上される。設定時には正確だったのに、徐々に不正確になっていく帳簿。
発生理由:マッピング(どのShopifyのお金がどのQuickBooks勘定科目にいくか)は、インストール時に、その時のストアに対して一度だけ設定されます。ストアは変化します。新しい支払いゲートウェイ、ギフトカード、新しい販売チャネル、勘定科目表での勘定科目の名称変更など。マッピングで認識されないものはすべて、コネクタのデフォルト勘定科目に分類され、デフォルトは静かに正確性を損なう場所です。
修正方法:
- コネクタ設定のマッピングセクションを開き、すべての行を確認してください。各Shopifyのお金のカテゴリ(売上、返金、手数料、税金、ゲートウェイ)と、それが計上されるQuickBooks勘定科目を照合します。
- 汎用的な勘定科目を検索してください。汎用的なデフォルトまたは「未分類」勘定科目にルーティングされているものは、マッピングされていないものです。実際の勘定科目を割り当ててください。
- はぐれた取引を再分類してください。マッピングを修正したら、間違った勘定科目に計上されている過去の取引を見つけて移動してください。QuickBooksの再分類ツールまたはブックキーパーがこれを一括処理できます。
- マッピングを四半期ごとにレビューし、ローンチチェックリストのステップを追加してください。新しいゲートウェイ、チャネル、または製品タイプは、その週にマッピングを確認することを意味します。
Class 6: Sync Stopped After an App or Theme Change
症状:同期の停止が変更と相関している。Shopifyアプリをインストールまたは削除した、テーマを変更した、Shopifyプランを変更した、またはチェックアウトまたは注文編集アプリを追加した。
発生理由:Shopifyアプリは権限を共有したり、注文データを変更したり、注文の作成方法を変更したりすることがあります。あるアプリをアンインストールすると、別のアプリが依存していたアクセス権が取り消される可能性があります。注文編集アプリやアップセルアプリは、コネクタが予期しない注文形式を生成し、サイレントに失敗する可能性があります。
修正方法:
- タイムラインを作成してください。同期が停止した日付を、変更ログと照合してください。Shopifyはストアのアクティビティ記録を保持しており、アプリのインストール履歴は管理画面にあります。
- まず再接続してください。権限の問題はクラス1とまったく同じように見え、クラス1の修正(管理者アカウントでの完全な再承認)でほとんどが解決します。
- 注文1件でテストしてください。特定のアプリが関与した注文が失敗し、他の注文は同期する場合、それを特定しました。
- 具体的にエスカレートしてください。コネクタのサポートとアプリのサポートに、停止日、サンプル注文番号、タイムラインを添えて連絡してください。具体的な証拠は、2週間のチケットを2日間のものに変えます。
When Your QuickBooks Shopify Integration Is Not Working by Design
Now the honest part. Look at the class you just fixed and ask: was that a you problem or a tool problem?
You-problems get fixed once and stay fixed. The Add-vs-Match habit. The mapping review nobody scheduled. The integration connected under an ex-employee's login. Disconnect emails going to spam. None of these recur if you adopt the prevention steps — and no tool, at any price, fixes them for you.
Tool-ceilings come back no matter what you do. Fees that can't be broken out of deposits per payout. Order types or channels the connector doesn't carry, ever. Sync cadence you can't change. No way to backfill a gap without manual entry. If your "fix" turned into a monthly ritual — a recurring journal entry, a recurring cleanup, a recurring manual import — you didn't fix the integration. You became part of it.
Neither verdict is an insult. A free or entry-level connector doing exactly what it was built for, at your volume, is a perfectly good answer — plenty of stores should fix the habit, keep the tool, and stop reading here. The distinction matters because the two verdicts have opposite next steps: one is a calendar reminder, the other is a migration.
If This Is Your Third Time on This Page
If you've bookmarked this post, the bookmark is the tell. Troubleshooting a sync once is maintenance. Troubleshooting it every month is a subscription paid in Sunday nights.
If you're there, three reads, in order:
- QuickBooks Shopify Connector Review — what the free connector does well and precisely where it stops, so you can name your ceiling instead of guessing.
- Outgrowing the Free QuickBooks Connector — how to migrate to a heavier sync tool without re-doing your history.
- Best Shopify Accounting Software — the full field of what you'd migrate to, including the tools that beat ours on specific jobs.
And the disclosure from the top, cashed in: we make LedgerPort, a paid Shopify and WooCommerce → QuickBooks sync built around the ceilings in this post — payout journals with fees broken out per deposit, mapping you control, and sync gaps you can see and repair instead of discover at tax time. The free plan covers 30 orders a month — enough to run one real payout through and check whether Class 4 disappears from your life. If it doesn't, you've lost five minutes, and you already triaged faster than that today.
