eBay 接続：注文取込と履行実績の返送
eBay Developers Program で App ID と Cert ID を取得し、Integration に入力、テスト・マッピング・有効化。
eBay コネクタは eBay Sell API 経由で注文を OMS に取り込み、在庫と履行実績を eBay に返送します。返品の取込、商品・在庫の送信も可能です。
前提条件#
- 出品中の商品がある eBay セラーアカウント。
- eBay Developers Program で Production の Application keys を確認できること。
- 最初のテストはサンドボックスで：Use sandbox に「true」を入力し、確認後に本番へ切替。
認証情報の取得#
- eBay Developers Program → Application keys → Production を開く。
- App ID をコピー。これは OAuth Client ID で、Integration の Client ID (App ID) に入力。
- 同じページで Cert ID をコピー。これは OAuth Client Secret で、Integration の Client Secret (Cert ID) に入力。
Integration への入力#
- Integration → コネクタマーケットプレイス → eBay → 新規接続。
- Client ID (App ID)、必須：Application keys → Production でコピーした App ID を貼付。OAuth Client ID として使用。
- Client Secret (Cert ID)、必須：同じページの Cert ID を貼付。OAuth Client Secret として使用、暗号化保存、再表示なし。
- User access token、任意：OAuth 認可コードフローで取得したユーザートークンがあれば入力（有効期間 2 時間）。Sell API 呼び出しに直接使用。空欄の場合、システムがクライアント認証情報で短期アプリトークンに自動交換。
- Use sandbox、任意テキスト：「true」でサンドボックス（api.sandbox.ebay.com）でテスト。本番では空欄。
接続テスト#
接続テストをクリック。認証情報でトークンに交換し、eBay API を確認します。通過すれば App ID、Cert ID、環境が一致。失敗時はコードを控え、下の FAQ を確認。
Mapping / テンプレート選択#
eBay 標準テンプレートを選択。注文番号、行 SKU、数量、配送先、履行ステータスをマッピング。有効化前に実注文 1 件でプレビューを確認。
有効化#
有効化後、設定した頻度で注文と返品を取得し、追跡番号付き履行実績と在庫変更を eBay に返送。最初は Runs / Logs で数件確認。
よくある質問#
テストが 401 で失敗
認証情報が一致していません：多くは App ID と Cert ID の取り違え、またはコピー時の欠落・余分なスペースが原因でトークン交換が拒否されます。
eBay Developers Program → Application keys → Production に戻り、App ID を Client ID (App ID)、Cert ID を Client Secret (Cert ID) にそのままコピーし、再テストしてください。
サンドボックスと本番の混用
環境とキーが一致していません：Use sandbox に「true」が入り api.sandbox.ebay.com を呼んでいるのに、App ID と Cert ID が本番用、またはその逆です。
両方を一致させて再テスト：本番では Use sandbox を空欄にし Production キーを使用。テストでは「true」を入力し、同じ接続でサンドボックスキーを使用。
接続済みだが注文が取り込めない
接続自体は正常です：取得範囲内に店舗の新規注文がないだけです。
eBay ストアでテスト注文を作成し、時刻が取得範囲内か確認、手動取得を実行してプレビューまたは Runs / Logs に表示されるか確認してください。
SKU が未マッピングと表示
eBay 注文明細の SKU がどの OMS 製品とも一致せず、紐付け前は取り込めません。
製品マッピングの保留タブを開き、各 eBay SKU を正しい OMS 製品に紐付け、保存してからプレビューまたは取得を再実行してください。