Odoo eBay コネクタ: 出品、注文、在庫の同期

eBay は、世界中で 1 億 3,200 万人のアクティブな購入者を抱える世界最大のマーケットプレイスの 1 つです。 eBay と Odoo 19 Enterprise の両方を使用する販売者にとって、注文、在庫、顧客データを 2 つの別々のシステムで管理することは非効率的であり、エラーが発生しやすくなります。 ECOSIRE Odoo eBay Connector は、eBay ストアを Odoo と同期させ、出品の作成から注文処理、販売後の会計までの販売ワークフロー全体を自動化します。

このガイドでは、eBay API 認証情報の設定から出品管理、注文の自動化、在庫の同期、返品処理、販売者のパフォーマンスの監視までのすべてを説明します。

重要なポイント

• コネクタは認証に eBay REST API と OAuth 2.0 を使用します
• eBay モーター、eBay ビジネスおよび産業、および消費者カテゴリーをサポート
• 固定価格とオークションの両方の出品がサポートされています (オークションの場合のみ注文インポート)
• 在庫同期により、Odoo 在庫変更から 10 分以内に eBay 数量が更新されます
• eBay の在庫切れ (OOS) 設定は、数量が 0 になると自動的に管理されます
• 注文のインポートには、購入者の詳細、配送要件、eBay チェックアウト金額が含まれます
• 返品および eBay 返金保証ケースが Odoo RMA ワークフローと同期
• マルチストアのサポート: 1 つの Odoo インスタンスから複数の eBay 販売者アカウントを管理

---

eBay API のセットアップと認証

コネクタは eBay の REST API スイートを使用し、ほとんどの操作で古い取引 API を置き換えます。

ステップ 1: eBay 開発者アカウントを作成する

1. developer.ebay.com に登録します
2. [マイ アカウント] → [アプリケーション キーセット] で新しいアプリケーションを作成します。
3. アプリ ID (クライアント ID)、開発 ID、証明書 ID (クライアント シークレット) をメモします。
4. OAuth フロー用の RuName (eBay リダイレクト URL 名) を生成します

ステップ 2: OAuth スコープを構成する

アプリケーションには次の OAuth スコープが必要です。

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

ステップ 3: ユーザー トークンを生成する

販売者の操作には OAuth 2.0 ユーザー トークン (アプリケーション トークンではない) が必要です。

1. コネクタ設定で、eBay で認証 をクリックします。
2. eBay OAuth 同意フローを完了します。
3. コネクタはアクセス トークンとリフレッシュ トークンを自動的に保存します。
4. トークンは 18 か月後に期限切れになります。コネクタはリフレッシュトークンを使用して自動リフレッシュされます

サンドボックスと本番環境

必ず最初に eBay のサンドボックス環境でテストしてください。

• サンドボックス API: api.sandbox.ebay.com
• サンドボックス認証情報は本番認証情報とは異なります
• developer.ebay.com/sandbox でサンドボックスの販売者アカウントと購入者アカウントを作成します

---

コネクタのインストールと構成

ECOSIRE マーケットプレイスからインストール:

1. ECOSIRE 製品 から eBay コネクタ モジュールを購入します。
2. アプリ経由でインストール → アプリリストを更新 → 「eBay Connector」を検索 → インストール
3. 在庫 → 設定 → eBay ストア または 販売 → eBay に移動します

ストア構成:

フルフィルメントポリシー:

出品する前に、Seller Hub で eBay フルフィルメント ポリシーを設定します。

• 配送ポリシー: 配送業者、配達予定時間、取り扱い時間
• 返品ポリシー: 30 日間の返品、返品手数料
• 支払いポリシー: 2021 年以降、eBay 管理の支払いが必須

コネクタは、ポリシー ID によってこれらを参照します。ストア設定でそれらをリンクします。

---

リスティング管理

このコネクタは、Odoo 製品レコードから直接固定価格リストの作成と管理をサポートします。

Odoo 製品からのリストの作成:

1. 製品フォーム → eBay タブを開きます
2. [eBay にリストする] をクリックします。
3. リストフィールドを設定します。

• タイトル: 最大 80 文字、製品名から自動入力されます
• カテゴリ: eBay カテゴリを選択します (キーワードまたは ID で検索)
• 状態: 新品、中古、部品欠品/動作しないなど。
• 価格: 製品の価格リストまたは価格の上書きを使用します。
• 数量: 利用可能な在庫またはカスタム数量
• 期間: 固定価格には GTC (キャンセルされるまで有効) が推奨されます
• 商品詳細: eBay でカテゴリに必要な属性

4. [eBay に公開] をクリックします。

リストテンプレート:

同じカテゴリ内の多くの商品を扱う販売者の場合は、出品テンプレートを作成します。

• eBay → テンプレート → テンプレートの作成に移動します
• 共有フィールドの設定: カテゴリ、配送、返品ポリシー、商品詳細
• テンプレートを複数の製品に同時に適用します

一括出品:

100 以上の製品を含むカタログの場合:

1. 必須の eBay フィールドを含む製品リストを CSV にエクスポートします
2. eBay で一括インポートを使用 → 一括出品 → CSV アップロード
3. バッチでレビューして公開する

リストの同期:

Odoo で行われた変更は eBay に同期されます:

• 価格変更 → eBay の価格は 15 分以内に更新されます
• 製品説明の変更 → 次回の同期時に eBay のリストが更新されます
• 画像変更 → eBay 画像更新 (一部変更のため再出品が必要)

eBay カテゴリ商品の詳細:

eBay では、カテゴリ固有の属性 (衣料品のブランド、サイズ、色など) が必要です。コネクタは、Odoo 製品属性を eBay アイテムの詳細にマッピングします。

---

注文の同期

注文インポートプロセス:

注文は eBay から Odoo に自動的に流れます。

1. 購入者が eBay で注文し、チェックアウトを完了します
2. eBay は「発送待ち」ステータスで注文を作成します。
3. コネクタは 15 分ごとに eBay Orders API をポーリングします (構成可能)
4. Odoo は、eBay からの購入者の詳細を使用して sale.order を作成します。 5.配達注文は自動的に作成されます
5. 倉庫が注文を処理し、配送を検証します
6. コネクタは追跡番号を eBay に送り返します
7. eBay は注文を「発送済み」としてマークします

注文データのマッピング:

追跡情報の送信:

Odoo で配送を検証し、追跡番号を入力すると、次のようになります。

1. コネクタは在庫の追跡番号を検出します。ピッキング
2. eBay の Order Fulfillment API を呼び出して追跡を追加します
3. 購入者は追跡詳細が記載された eBay 通知を受け取ります
4. eBay は注文ステータスを「発送済み」に更新します。

自動追跡更新がサポートされている運送業者: USPS、UPS、FedEx、DHL、Royal Mail、Deutsche Post、および eBay の運送業者コード リストにあるその他 100 社以上。

---

インベントリの同期

正確な在庫により、在庫切れの状況による eBay の「欠陥」指標が回避されます。

在庫同期メカニズム:

コネクタは、次のロジックで eBay の在庫 API を使用します。

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

在庫が同期される場合:

• 配達注文が確認されるたびに（即時）
• 検証された領収書を受け取るたびに (即時)
• 30分ごとにスケジュールされた完全同期
• いつでも手動同期が可能

在庫切れの対応:

数量が 0 になった場合の動作を設定します。

• オプション A: OOS モード (Odoo 推奨): eBay の在庫切れオプションを使用して数量 0 でアクティブな出品を維持します — 出品では履歴とレビューが維持されます
• オプション B: 出品終了: 在庫が 0 になったら eBay から出品を削除し、再入荷したら再出品します。
• オプション C: 最小値を設定: 最小数量 (例: 1) を設定し、OOS 最小値がトリガーされた場合にのみ Odoo で 0 に進みます。

終了と再出品は、eBay の検索順位に悪影響を与えることがよくあります。 OOS モードをお勧めします。

複数拠点の在庫:

複数の倉庫から発送する場合:

• ストア設定で eBay のプライマリ倉庫を設定します
• または複数の倉庫にわたる在庫を集約する
• 一部の SKU が特定の場所から出荷される場合は、製品ごとに構成します

---

返品および返金の取り扱い

eBay の返金保証は、販売者が返品を受け入れなければならないことを意味します。コネクタは、Odoo の返品ワークフローを処理します。

同期ワークフローを返す:

1. 購入者が eBay で返品リクエストを開始します
2. コネクタは、返品ケースを RMA (Return Merchandise Authorization) として Odoo にインポートします。
3. 運用チームが Odoo で返品理由を確認します。
4. 受け入れられた場合: 返送ラベルを生成します (前払いラベルを提供する場合)
5. 購入者が商品を返送する
6. Odoo で返品商品を受け取る → 受領書を検証する
7. 返金の処理: Odoo でクレジットノートを作成 → コネクタが eBay の返金をトリガーします

追跡された返品ケースのステータス:

---

eBay 販売者のパフォーマンスのモニタリング

eBay は、出品の可視性に直接影響する指標に基づいて販売者を評価します。 Odoo でそれらを監視します。

eBay 販売者の主な指標:

Odoo のパフォーマンス ダッシュボード:

eBay → パフォーマンスに移動して、以下を確認します。

• 過去 30 日間のステータス別の注文
• 発送の遅延（注文の発送が処理時間後に行われる）
• カテゴリ別の返品率
• 注文IDを含む欠陥の概要
• 次回評価の予想販売者レベル

---

価格とプロモーション

自動化された価格設定ルール:

Odoo のコスト データに基づいて eBay の動的な価格設定を構成します。

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

例: コストが 10 ドルの場合、目標マージンは 40%、eBay 手数料は通常 12.5% です。

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

マークダウン プロモーション:

コネクタは eBay プロモーション マネージャーの統合をサポートしています。

• Odoo で販売を作成 → コネクタが対応する eBay プロモーションを作成
• フラッシュセール、注文割引、配送プロモーション
• スケジュールされたプロモーション: Odoo で設定された開始日と終了日

---

よくある質問

コネクタは eBay オークションの出品をサポートしていますか?

コネクタは、固定価格の出品と同様に、オークションの出品から注文をインポートします。ただし、コネクタ経由でのオークション リストの作成と管理 (開始価格、最低価格、期間の設定) には制限があります。オークションは eBay Seller Hub で直接管理するのが最適です。コネクタの主なリスト管理機能は、固定価格/GTC リスト用です。

コネクタは eBay マネージド ペイメント (eBay の支払い処理) をどのように処理しますか?

2021 年以降、eBay はすべての支払いを eBay 管理の支払いを通じて処理します。コネクタは、eBay のチェックアウト価格 (商品価格 + 送料) を含む注文合計をインポートします。 eBay は、純収益 (手数料控除後) をお客様の銀行口座に送金します。コネクタは、調整のための eBay 支払いレポートのインポートをサポートし、支払いから差し引かれる eBay 手数料を考慮した仕訳入力を自動的に作成します。

Odoo の商品を複数の eBay ストア (異なる販売者アカウント) に同期できますか?

はい。複数の eBay ストア構成を作成し、それぞれに独自の OAuth 資格情報を割り当てます。ストア固有の価格設定を上書きして、製品を複数のストアに同時に掲載できます。在庫は Odoo でグローバルに追跡され、設定されたルールに基づいて各ストアのリストに割り当てられます。

出品を更新すると、eBay の出品履歴 (レビュー、販売数) はどうなりますか?

標準の出品更新 (価格、数量、説明、画像) では、出品履歴と販売数が保存されます。履歴をリセットするアクション: 終了と再出品、一部のカテゴリの eBay カテゴリの変更。コネクタは、定期的な変更に eBay Inventory API の「アップデート オファー」エンドポイントを使用し、履歴を保存します。

コネクタは、国際的な eBay の販売と税関の要件をどのように処理しますか?

eBay International Shipping または GSP (Global Shipping Program) を介した国境を越えた販売の場合、コネクタは販売注文に購入者の国をマークします。 Odoo で国際販売向けに適切な会計ポジションと税務処理を構成します。 GSP の注文は eBay の国内フルフィルメント センターに発送されます。税関書類は、お客様の業務ではなく、eBay の GSP プログラムによって処理されます。

---

次のステップ

Odoo を通じて eBay の運営を管理すると、手動でのデータ入力が不要になり、在庫エラーが防止され、すべての販売チャネルに対する単一の信頼できる情報源が得られます。 ECOSIRE eBay Connector は Odoo 19 Enterprise 用に構築されており、eBay の最新 REST API の完全なサポートが含まれています。

Odoo 19 用 ECOSIRE eBay コネクタを入手 →

すべての購入には、モジュール ライセンス、セットアップ ドキュメント、実装サポート チームへのアクセスが含まれており、初日から eBay-Odoo 同期をスムーズに実行できます。