Wish 接続：注文取込と履行実績の返送
Wish マーチャント OAuth2 アクセストークンを取得し、API ベース URL とともに Integration に入力、テスト・マッピング・有効化。
Wish コネクタは Wish ショップの注文を OMS に取り込み、履行実績を Wish に返送します。商品・在庫の送信も可能で、出品・在庫・出荷を両側で同期できます。
前提条件#
- Wish マーチャントショップ、そのショップの Wish マーチャントアカウントへのログインアクセス。
- そのショップの Wish マーチャント OAuth2 認可を完了できること。アクセストークンはその認可で取得します。
- 開始前に、ショップに適用される API ベース URL を確認してください：デフォルト、中国、またはテスト用サンドボックス。正確なアドレスは「Integration への入力」の手順に記載しています。
認証情報の取得#
- 接続するショップの Wish マーチャントアカウントにログインし、そのショップの OAuth2 認可を完了してください。認可前に正しいショップにログインしているか確認してください。別ショップで認可したトークンはこの接続と一致しません。
- 認可後に取得したアクセストークンをコピーしてください。これは Wish マーチャント OAuth2 アクセストークンで、Integration の Access token フィールドに貼り付けます。
- トークンの取得日を控えてください：有効期間は 30 日です。期限切れになったら OAuth2 認可を再度完了して新しいトークンを取得し、接続を更新してください。
Integration への入力#
- Integration → コネクタマーケットプレイス → Wish → 新規接続。
- API ベース URL：ショップに適用されるアドレスを入力。デフォルト：https://merchant.wish.com/api/v2 。中国：https://china-merchant.wish.com/api/v2 。サンドボックス：https://sandbox.merchant.wish.com/api/v2 。サンドボックスはテスト専用で、本番前にデフォルトまたは中国のアドレスに変更してください。
- Access token、必須：前の手順で取得した Wish マーチャント OAuth2 アクセストークンを貼付。有効期間は 30 日で、暗号化保存され、再表示されることはありません。
接続テスト#
接続テストをクリック。API ベース URL とアクセストークンをまとめて確認し、実注文 1 件で伝票レベルのプレビューを表示して、プラットフォーム項目と標準注文を並べて確認できます。ショップにまだ注文がない場合は、先に Wish でテスト注文を作成してください。プレビューには実伝票が必要です。失敗した場合はエラーを控え、他を変更する前に下の FAQ を確認してください。
Mapping / テンプレート選択#
Wish 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先、履行ステータスをマッピングします。有効化前に実注文 1 件でマッピングプレビューを確認し、特に各 Wish SKU が OMS 製品に紐付いているか確認してください。注文・商品・在庫が両側で一致します。
有効化#
有効化後、設定した頻度で新規注文を取得し、追跡番号付き履行実績を Wish に返送、商品・在庫の変更を Wish に送信します。アクセストークンの有効期限に注意してください：有効期間は 30 日です。注文が止まらないよう、期限前に更新してください。最初は Runs / Logs で数件確認してから無人運用してください。
よくある質問#
テスト失敗：アクセストークンの誤りまたは期限切れ
接続のアクセストークンが機能していません。コピーが不完全か余分なスペース入り、古い認可のもの、または 30 日の有効期間が過ぎているため、Wish が呼び出しを拒否しています。
同じショップで Wish マーチャント OAuth2 認可を再度完了し、新しいアクセストークンを取得どおりにコピーし、余分なスペースなしで Access token フィールドを置き換え、API ベース URL がショップと一致するか確認して再テストしてください。
別のショップを認可してしまった
トークン自体は有効ですが、別の Wish ショップにログインした状態で認可したものです。そのため接続先はその別ショップになり、このショップの注文は表示されません。または別ショップの注文が表示されます。
この接続の対象ショップの Wish マーチャントアカウントにログインし、OAuth2 認可を再度完了し、Access token をそのショップの新しいトークンに置き換えて再テストしてください。ショップごとに 1 接続とし、トークンを複数ショップで共有しないでください。
接続済みだが注文が取り込めない
接続自体は正常です。取得範囲内にショップの新規注文がないだけです。
Wish ショップでテスト注文を作成し、時刻が取得範囲内か確認、手動取得を実行してプレビューまたは Runs / Logs に表示されるか確認してください。