AliExpress 接続：注文取込と履行実績の返送
AliExpress App コンソールからゲートウェイ URL、App Key、App Secret をコピーし、セラーアカウントの OAuth Session を取得して Integration に入力、テスト・マッピング・有効化。
AliExpress コネクタは AliExpress セラーストアの注文を OMS に取り込み、履行実績を AliExpress に返送します。商品と在庫の送信も可能で、商品・在庫・出荷を両側で同期させます。1 接続は 1 セラーストア用です。
前提条件#
- 販売・出荷できるストアを持つ AliExpress セラーアカウント。
- AliExpress App コンソールにアプリがあり、そのアプリを開いて値をコピーできること。
- セラーアカウントの保有者が AliExpress の OAuth 認可フローを完了し、Session（アクセストークン）を取得できること。
認証情報の取得#
- AliExpress App コンソール → アプリを開き、表示されている TOP ゲートウェイ URL をそのままコピー。記憶で入力しないこと——アドレスは固定ではないため、コンソールに表示されたものを正確にコピーしてください。
- 同じアプリで App Key をコピー。
- 同じページで App Secret をコピー。リクエスト署名に使用されるため、安全に保管してください。
- セラーアカウントで AliExpress の OAuth 認可フローを完了し、そのアカウントの Session（アクセストークン）を取得。
Integration への入力#
- Integration → コネクタマーケットプレイス → AliExpress → 新規接続。
- API ゲートウェイ URL、必須：AliExpress App コンソールでコピーした TOP ゲートウェイ URL を、表示どおりに貼付（プレースホルダー：https://…）。
- App Key、必須：AliExpress App コンソール → アプリの App Key を貼付。
- App Secret、必須：同じページの App Secret を貼付。リクエスト署名に使用され、ログに残らず、フロントエンドにも返されません。
- Session（アクセストークン）、必須：AliExpress の OAuth 認可フローで取得した、セラーアカウントの OAuth session / access token を貼付。
接続テスト#
接続テストをクリック。ゲートウェイ URL を確認し、App Key と App Secret でリクエストに署名し、Session がセラーアカウントで受け入れられるか確認します。通過すれば 4 つの値がそろっています。失敗時はエラーを控え、他の設定を変える前に下の FAQ を確認してください。
Mapping / テンプレート選択#
AliExpress 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先、履行ステータスをマッピングします。有効化前に実注文 1 件でプレビューを確認——特に各 AliExpress SKU が OMS 製品に紐付いているかを確認し、商品・在庫の送信が両側で一致するようにしてください。
有効化#
有効化後、設定した頻度で新規注文を取得し、追跡番号付きの履行実績を AliExpress に返送し、商品と在庫の変更を送信します。最初は Runs / Logs で数件確認してから無人運用にしてください。
よくある質問#
テスト失敗：App Key または App Secret の誤り
簡単に言うと、AliExpress が呼び出し元を確認できません：入力した App Key と App Secret がコンソールのアプリと一致していません——多くはどちらかのコピー欠落、余分なスペース、または 2 つの値の取り違えが原因で、署名付きリクエストが拒否されます。
AliExpress App コンソール → アプリに戻り、App Key を App Key に、App Secret を App Secret に、そのページの表示どおりにコピーし、ゲートウェイ URL もコンソールから正確にコピーされているか確認して、再テストしてください。
認可の期限切れ：Session が使えない
簡単に言うと、Session は前回の OAuth 認可でもらった通行証にすぎず、その有効期限が切れています。App Key と App Secret が正しくても、有効な Session がなければ AliExpress はこの接続がセラーアカウントのために動作することを許可せず、テストと取得が失敗します。
再認可してください：セラーアカウントで AliExpress の OAuth 認可フローをもう一度完了し、新しい Session（アクセストークン）を取得して、接続の Session（アクセストークン）に新しい値を貼り、保存して再テストしてください。
接続済みだが注文が取り込まれない
簡単に言うと、接続自体は正常です——取得範囲内にストアの新規注文がまだないだけです。認証失敗とは異なり、テストは通過し、注文リストが空で返ってくるだけです。
AliExpress セラーストアでテスト注文を作成し、時刻が取得範囲内か確認、手動取得を実行してプレビューまたは Runs / Logs に表示されるか確認してください。