BigCommerce 接続：注文取込と履行実績の返送
BigCommerce 設定 → API から Store hash と Access Token をコピーし、Integration に貼り、テスト・マッピング・有効化。
BigCommerce コネクタは BigCommerce ストアの注文を OMS に取り込み、履行実績を BigCommerce に返送します。製品・在庫の更新も送信でき、注文・出荷・在庫が両側で同期します。
前提条件#
- BigCommerce ストアと、そのストアの設定 → API へのアクセス。
- BigCommerce → 設定 → API で API アカウントを作成する権限。
- API アカウントに Orders、Products、Inventory の権限が必要です。これがないとコネクタは注文を取り込めず、製品・在庫の更新も送信できません。
認証情報の取得#
- BigCommerce で設定 → API を開き、API アカウントを作成します。
- アカウント作成時、Orders、Products、Inventory の 3 つの権限が含まれていることを確認してください。コネクタには 3 つとも必要です。
- その API アカウントの Access Token をコピーし、安全な場所に保管してください。次の手順で Integration に貼り付けます。
- その API アカウントの API パスで Store hash を確認します。パスは https://api.bigcommerce.com/stores/abc123def/v3 のようになります。/stores/ の後ろの部分が Store hash で、この例では abc123def です。その部分だけをコピーしてください。
Integration への入力#
- Integration → コネクタマーケットプレイス → BigCommerce → 新規接続を開きます。
- Store hash：API パスからストアハッシュだけを貼り付けます。例：abc123def。URL 全体は貼らないでください。このフィールドにはハッシュ単体を入れ、それが接続先のストアを識別します。
- Access token：BigCommerce → 設定 → API の API アカウントからコピーした Access Token を貼り付けます。両フィールドとも必須です。トークンは暗号化して保存され、再表示されることはありません。
接続テスト#
接続テストをクリックします。テストは入力した Store hash と Access Token を使って BigCommerce ストアにアクセスし、認証情報が使えるか確認します。通過すればストアが見つかり、トークンが受け付けられたということです。失敗したらエラーを控え、他の設定を変える前に下の FAQ を確認してください。
Mapping / テンプレート選択#
BigCommerce 標準テンプレートを選択します。注文番号、明細 SKU、数量、配送先住所、履行ステータスを BigCommerce と標準注文の間でマッピングします。有効化前にプレビューを確認し、特に各 BigCommerce SKU が正しい OMS 製品に紐付いているか見てください。
有効化#
有効化後、設定した頻度で BigCommerce の新規注文を取得し、追跡番号付きの履行実績を BigCommerce に返送し、製品・在庫の更新を送信します。無人で任せる前に、まず Runs / Logs で最初の数件を確認してください。
よくある質問#
テスト失敗：トークンが受け付けられない
接続の Access Token が誤っているか、もう有効ではありません。例えばコピーが不完全だった、または発行元の API アカウントが現在使われているものではなくなった場合です。BigCommerce が認識しないトークンでは、すべてのリクエストが入口で失敗します。
BigCommerce → 設定 → API を開き、API アカウントを開いて Access Token を全文コピーし直し、接続の Access token フィールドに貼り直してください。保存して再テストしてください。
同期が止まる：API アカウントに権限が不足している
認証情報はストアに届いていますが、API アカウントにコネクタが必要な権限が全て付いていません。Orders 権限がないと注文を取り込めず、Products や Inventory がないと製品・在庫の更新を送信できません。
BigCommerce → 設定 → API で API アカウントを確認し、Orders、Products、Inventory が全て含まれているか見てください。権限を揃えた新しい API アカウントを作成した場合は、その Access Token も接続に更新してください。保存して再テストしてください。
テストでストアが見つからない
Store hash フィールドに誤った値が入っています。最も多い原因は、ハッシュ単体ではなく API パス全体や URL 全体を貼ってしまったこと、または別のストアのハッシュを使ったことです。どちらでも、接続先のストアとトークンが BigCommerce 側で一致しません。
BigCommerce → 設定 → API を開き、API アカウントを開いて API パスを確認してください。/stores/ の後ろの部分だけをコピーします。例えば https://api.bigcommerce.com/stores/abc123def/v3 の abc123def です。接続の Store hash をその値に置き換え、保存して再テストしてください。
接続できているのに注文が入ってこない
接続自体は正常でテストも通りますが、BigCommerce ストアに新規注文がまだなく、取り込むものがありません。
BigCommerce ストアで注文する（または次の顧客注文を待つ）あと、手動取得を実行して Runs / Logs を確認してください。ストアが注文を発行すれば新規注文が表示されます。