Wayfair 接続：注文取込と履行実績の返送
Wayfair Partner Home から Client ID と Client secret をコピーし、Integration に貼り、テスト・マッピング・有効化。
Wayfair コネクタは Wayfair の注文を OMS に取り込み、履行実績を Wayfair に返送します。製品・在庫の更新も送信でき、注文・出荷・在庫を両側で同期できます。
前提条件#
- Wayfair Partner Home にアクセスできる Wayfair サプライヤーアカウント。
- Wayfair Partner Home の API 設定を開く権限。Client ID と Client secret はそこに表示されます。
- 在庫や tracking を送信する場合は Wayfair Supplier ID が必要です。両方の送信で必須です。フィールドの例は 5000 ですが、例ではなくご自身の ID を使ってください。
- 先に接続する環境を決めてください。最初の試行はサンドボックス、本番注文は本番環境です。サンドボックスと本番で注文は共有されないため、混同しないでください。
認証情報の取得#
- Wayfair Partner Home にサインインし、API 設定を開く。
- そのページで Client ID をコピー。
- 同じページで Client secret をコピー。安全な場所に保管してください。次の手順で Integration に貼ります。
- Access token を手動で取得する必要はありません。Integration でそのフィールドを空欄にすると、システムが Client ID と Client secret から自動生成し（client_credentials、有効期間 12 時間）、更新し続けます。
Integration への入力#
- Integration → コネクタマーケットプレイス → Wayfair → 新規接続。
- Client ID（必須）：Wayfair Partner Home → API 設定からコピーした Client ID を貼付。
- Client secret（必須）：同じページの Client secret を貼付。暗号化保存され、再表示されません。
- Access token（任意）：空欄のままにしてください。システムが Client ID と Client secret から自動でトークンを生成します（client_credentials、12 時間トークン）。生成されたトークンを自分のトークンで意図的に上書きする場合のみ入力してください。
- Supplier ID：Wayfair のサプライヤー ID を入力してください。例：5000。在庫プッシュと tracking プッシュでは必須です。未入力だとそれらの送信は実行できませんが、注文の取込は可能です。
- Sandbox mode：「true」と入力すると Wayfair のサンドボックス環境を使用します。本番環境を使う場合はデフォルト（「false」）のままにしてください。意図的に設定してください。サンドボックス接続では本番注文は表示されません。
接続テスト#
接続テストをクリック。テストでは Client ID と Client secret をアクセストークンに交換して Wayfair API の疎通を確認し、実注文 1 件で伝票レベルのプレビュー（プラットフォームのフィールドと標準注文の対照）を表示します。アカウントに注文がまだない場合でも接続確認は通過することがあります。プレビューを判断する前に実際に注文するか注文を待ち、テストが失敗した場合は下の FAQ を確認してください。
Mapping / テンプレート選択#
Wayfair 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先住所を標準注文にマッピングし、履行実績と tracking を Wayfair 形式に変換して返します。有効化前にプレビューを確認し、特に各 Wayfair SKU が正しい製品に紐付いているか見てください。在庫プッシュで正しい商品が報告されます。
有効化#
有効化後、設定した頻度で Wayfair の新規注文を取得し、追跡番号付きの履行実績に加え、製品・在庫の更新を Wayfair に返送します。無人で任せる前に、最初は Runs / Logs で数件確認してください。特に、Supplier ID が必要な最初の tracking プッシュが通るか確認してください。
よくある質問#
テスト失敗：認証が拒否される
Client ID または Client secret が誤っているため、Wayfair がアクセストークンに交換しません。この 2 つの値は同じ API 設定ページのペアです。別の場所からコピーした値を混ぜたり、Secret の文字が 1 つ欠けたりすると交換は失敗します。
Wayfair Partner Home → API 設定に戻り、同じページから Client ID と Client secret をコピーし直し、接続の両方の値を置き換えて保存し、再テストしてください。
使えていた接続が、数時間後に失敗し始めた
手動で入力した Access token の有効期限が切れています。この方法で取得したトークンは 12 時間のみ有効なため、Access token フィールドに貼ったトークンは最初は動作しても後で止まります。Client ID と Client secret からの自動交換であれば更新され続けます。
Access token フィールドを空にして保存し、システムが Client ID と Client secret から自動生成に戻るようにしてから、再テストしてください。手動フィールドは短期間の上書きにのみ使ってください。
注文は取り込めるが、在庫や tracking のプッシュが失敗する
Supplier ID が未入力または誤っています。注文の取込には Client ID と Client secret だけが必要ですが、在庫プッシュと tracking プッシュには Wayfair のサプライヤー ID も必要です。フィールドが空、他者の ID、または例の値のままだと、Wayfair はそれらの送信を受け付けません。
接続にご自身の Wayfair Supplier ID を入力し（それが本当にご自身の ID でない限り、例の 5000 は使わないでください）、保存して Runs / Logs からプッシュを再実行してください。
テストは通るが、本番注文が表示されない
サンドボックスと本番が混同されています。Sandbox mode が「true」の場合、接続先は Wayfair のサンドボックス環境で、そこにはサンドボックスのデータしかありません。何度取得しても本番注文は表示されません。
本番注文を取得するには、Sandbox mode を「false」（デフォルト）に戻して再テストしてください。試行用のサンドボックス接続も必要な場合は、名前を分かりやすくした別の接続を保持してください。
接続できているのに注文が入ってこない
接続自体は正常でテストも通りますが、このサプライヤーアカウントには Wayfair の新規注文がまだなく、取り込むものがありません。
Wayfair で次の実注文が発生するのを待ち（サンドボックスモードの場合はサンドボックス注文を使用）、手動取得を実行して Runs / Logs を確認してください。Wayfair が注文を発行すれば新規注文が表示されます。