SHEIN 接続:注文取込と履行実績の返送
SHEIN オープンプラットフォームでストアを認可し、tempToken を openKeyId と SecretKey に交換して Integration に入力、テスト・マッピング・有効化。
SHEIN コネクタは SHEIN ストアの注文を OMS に取り込み、履行実績を SHEIN に返送します。製品・在庫の更新を SHEIN に送信することもでき、両側で注文・出荷・在庫を同期します。
前提条件#
- SHEIN 販売者センターで管理できるストアを持つ SHEIN 販売者アカウント。
- SHEIN オープンプラットフォームへのアクセスと、そのストアを認可する権限。
- 認可後に返される secretKey を復号するための appSecretKey。ないと署名用の SecretKey を取得できません。
- openKeyId と SecretKey を安全に保管できる担当者。再接続時に必要です。
認証情報の取得#
- SHEIN 販売者センターのストア情報で Store code を確認し、表示どおりにコピーします。
- SHEIN オープンプラットフォームでストアを認可します。認可により tempToken が発行されます。
- tempToken を /auth/get-by-token で交換し、結果の openKeyId をコピーします。
- 返された secretKey を appSecretKey で復号します。復号した値が SecretKey(署名)で、HMAC-SHA256 のリクエスト署名に使います。安全に保管してください。
Integration への入力#
- Integration → コネクタマーケットプレイス → SHEIN → 新規接続。
- Store code:SHEIN 販売者センターのストア情報にあるストアコードを貼付。この接続がどのストアのものかを示すため、そのストアと正確に一致させる必要があります。
- openKeyId:tempToken を /auth/get-by-token で交換して得た openKeyId を貼付。必須フィールドです。
- SecretKey(署名):appSecretKey で復号した SecretKey を貼付。必須フィールドです。リクエストはこれで HMAC-SHA256 署名されます。暗号化保存され、再表示されません。
接続テスト#
接続テストをクリック。テストは SecretKey で HMAC-SHA256 署名したリクエストを、openKeyId と Store code とともに送り、SHEIN の疎通を確認します。通過すれば SHEIN が署名を受け付け、ストアも一致しています。失敗したらエラーを控え、他の設定を変える前に下の FAQ を確認してください。
Mapping / テンプレート選択#
SHEIN 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先住所、履行ステータスを SHEIN と標準注文の間でマッピングします。有効化前にプレビューを確認し、特に各 SHEIN SKU が正しい OMS 製品に紐付いているか見てください。
有効化#
有効化後、設定した頻度で SHEIN の新規注文を取得し、追跡番号付きの履行実績を SHEIN に返送し、製品・在庫の更新を SHEIN に送信します。最初は Runs / Logs で数件確認してください。
よくある質問#
テスト失敗:認証情報が拒否される
接続の openKeyId または SecretKey が誤っています。最も多い原因は、appSecretKey で復号した値ではなく暗号化されたままの secretKey を貼ったこと、または openKeyId のコピーが不完全で、SHEIN が HMAC-SHA256 署名を検証できないことです。
認証情報の手順を順番にやり直してください。SHEIN オープンプラットフォームでストアを再認可し、新しい tempToken を /auth/get-by-token で交換し、openKeyId をコピーし、返された secretKey を appSecretKey で復号し、両方の値を接続に貼って保存し、再テストしてください。
以前使えた接続が、今はテスト全て失敗する
この接続のトークンまたはキーが期限切れ、または無効になっています。例えばストアが再認可されると新しい tempToken と新しい認証情報が発行され、接続に保存された openKeyId と SecretKey がストアと一致しなくなります。
新しい認証情報を取得してください。最新の tempToken を /auth/get-by-token で交換し、新しい openKeyId をコピーし、新しい secretKey を appSecretKey で復号し、接続の両方の値を置き換えて保存し、再テストしてください。
テスト失敗:ストアが見つからない、または一致しない
Store code フィールドに誤った値が入っています。別のストアのコードが貼られたことが多く、認証情報とストアが組み合わさらず、SHEIN がこの接続を認可済みストアに紐付けられません。
SHEIN 販売者センターのストア情報に戻り、認可済みストアの Store code を正確にコピーして接続の値を置き換え、保存して再テストしてください。
接続できているのに注文が入ってこない
接続自体は正常でテストも通りますが、この SHEIN ストアには新規注文がまだなく、取り込むものがありません。
SHEIN ストアで実際に注文する(または次の顧客注文を待つ)あと、手動取得を実行して Runs / Logs を確認してください。SHEIN が注文を発行すれば新規注文が表示されます。