Best Buy 接続：注文取込と履行実績の返送
Best Buy Mirakl Seller Portal から API Key をコピーし、Integration に貼り、テスト・マッピング・有効化。注文が入り、履行実績、製品と在庫の更新が戻ります。
Best Buy コネクタは Best Buy の注文を OMS に取り込み、履行実績を Best Buy に返送し、製品と在庫の更新も送信します。1 つの接続で 1 つの API Key を使います。
前提条件#
- Best Buy Mirakl Seller Portal にログインできる Best Buy の販売者アカウント。
- そのポータルの右上にあるユーザー名から API Key ページを開く権限。
- API Key を安全に保管できる担当者。再接続や交換の際に完全なキーが必要です。
認証情報の取得#
- Best Buy Mirakl Seller Portal にログインし、右上のユーザー名をクリック。
- そのメニューから API Key を開く。
- Generate / Copy をクリックし、完全な API Key をコピー。キーがまだない場合は先に生成してからコピー。
Integration への入力#
- Integration → コネクタマーケットプレイス → Best Buy → 新規接続。
- API key：Best Buy Mirakl Seller Portal からコピーした API Key を貼付。これが唯一の認証情報フィールドで、必須です。暗号化保存され、再表示されません。
接続テスト#
接続テストをクリック。テストは API Key を使って Best Buy から注文を 1 ページ取得し、キーが使えるか確認します。通過すれば Best Buy がキーを受け付け、その注文ページが返っています。失敗したらエラーを控え、他の設定を変える前に下の FAQ を確認してください。
Mapping / テンプレート選択#
Best Buy 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先住所、履行ステータスを Best Buy と標準注文の間でマッピングします。有効化前にプレビューを確認し、特に各 Best Buy SKU が正しい OMS 製品に紐付いているか見てください。
有効化#
有効化後、設定した頻度で Best Buy の新規注文を取得し、履行実績を Best Buy に返送し、製品と在庫の更新を送信します。最初は Runs / Logs で数件確認してください。
よくある質問#
テスト失敗：API Key が拒否される
API Key が誤っているか失効しているため、テストが注文を 1 ページ取得する際に Best Buy がそのキーを受け付けません。
Best Buy Mirakl Seller Portal → ユーザー名（右上）→ API Key → Generate / Copy で新しい API Key を生成し、新しい完全なキーを接続に貼り、保存して再テストしてください。
キーを貼った直後にテストが失敗する
キーのコピーが不完全で一部が欠けているため、貼り付けた値が Best Buy Mirakl Seller Portal の API Key と一致しません。
Best Buy Mirakl Seller Portal → ユーザー名（右上）→ API Key → Copy に戻り、キーを再度全文コピーして接続の値を置き換え、保存して再テストしてください。
接続できているのに注文が入ってこない
接続自体は正常でテストも通りますが、アカウントには Best Buy の新規注文がまだなく、取り込むものがありません。
Best Buy Mirakl Seller Portal で新規注文が表示されたことを確認し、手動取得を実行して Runs / Logs を確認してください。Best Buy が注文を発行すれば新規注文が表示されます。
SKU が未マッピングと表示される
チャネル SKU が OMS の製品にまだ紐付いていないため、その SKU を含む注文を製品に紐付けられません。
製品マッピングの保留タブを開き、各チャネル SKU を OMS 製品に紐付けてから、次に取り込まれた注文を Runs / Logs で確認してください。