eBayコネクタのセットアップ¶

概要¶

OdooのeBayコネクタはeBayのリストとOdooプロダクトを接続することができます。一旦接続されると、リスティングの更新 はOdooでもeBayでも行うことができます。商品がeBayで販売されると、ユーザが確認できるように販売オーダのドラフトがOdooに作成されます。販売オーダが確認されると、Odooの 在庫 アプリと 販売 アプリが標準機能として機能し、在庫からプロダクトを引出し、ユーザが請求書を作成することができます。

eBay - Odooリンク済フィールド¶

以下はeBayプロダクトの詳細です。これらのeBayの各フィールドはOdooの対応するフィールドを更新します。

• eBay URL

• eBayステータス

• 販売済数量

• 開始日

• タイトル

• サブタイトル

• 商品コンディション

• カテゴリー

• カテゴリ2

• 店舗カテゴリ

• 店舗カテゴリ2

• 支払ポリシー

• 販売者プロフィール

• 郵便番号

• 配送ポリシー

• リスティングタイプ(定額またはオークション)

  • オークション用開始価格

  • 今すぐ購入価格

  • 定額金額

• 在庫数量を使用

• eBay上の数量

• 期間

• ベストオファーを許可

• プライベートリスティング

• eBay説明

• eBayプロダクト画像

• 国

eBay条件¶

バリエーション は複数のプロダクトをバリエーション(またはバリアント)オプションで1つにグループ化します。バリエーションはOdooの属性と値に同期することができます。バリエーションはeBayのリスティングを閲覧する際、ページ上部付近のドロップダウンメニューに表示されます。これらはOdooのプロダクトバリアントに相当します。

商品詳細 はリストの下部にあり、プロダクト固有の情報を詳細に表示します。これらの明細はデフォルトではOdooのフィールドと同期されません。これらのフィールドをリンクするには開発が必要です。

Sandbox と Production は、eBayの環境を、まだ開発/テスト中 (Sandbox)か、実際の顧客情報/データセット (Production) を持つデータベースの実際のインスタンスで使用するかのどちらかに分類するために使用される用語です。まず Sandbox でテストを開始し、以下のプロセスに従って Production インスタンスを作成することをお勧めします。

Odooで使用可能なeBayアクション¶

以下はeBay出品を追加または更新するOdooのビルトインアクションです:

• リスト/ リンク: eBayに商品を出品する または 既存のeBay出品とリンクする をクリックして、Odooプロダクトで新しいeBayリスティングを生成します。

• 項目を修正 ボタン:OdooでeBayリスティングに変更を加えた後、レコードを保存し、Odooの 項目を修正 をクリックしてeBayリスティングを更新します。

• 再リスティング: が早期に終了したアイテムや、自動再リスティング が選択されていないアイテムは、ユーザがOdooから再リスティングすることができます。リスティング開始日はリセットされます。

• :guilabel:`項目のリスティングを終了`ボタン：Odooから直接eBayへのリスティングを終了します。

• プロダクトリスティングのリンク解除:ユーザはeBayのリストからプロダクトのリンクを解除することができます。

eBayの設定の前にOdooの設定が必要です。¶

eBayとOdooをリンクするには、Odooのダッシュボードに移動し、アプリ 利用をクリックしてeBayモジュールをインストールします。 eBay を検索し、eBayコネクタ 　モジュールをインストールします。

eBayを設定する前に、以下の項目を設定する必要があります:

• OdooでeBayにリスティングするプロダクトを作成・設定します。 eBayは新しいプロダクトをOdooにインポートしません。全てのプロダクトをまずOdooで作成し、それからリスティングにリンクされる必要があります。

  • Odooではプロダクトごとに複数のeBayリストをリンクすることができません。同じプロダクトを複数のリスティングで販売している場合は、以下の手順に従って下さい:

    • ベース プロダクトを1つ設定します(部品表) の:guilabel:構成品 フィールドに記載)。これは保管可能なプロダクトになるため、在庫を確保することができます。下記の緑色でハイライトされているプロダクトは、その後に続く“リンクされた” 各プロダクトのキットに含まれます。

    • 2つ以上の リンクされた プロダクトを設定します(部品表)`の :guilabel:`プロダクト フィールドに記載されており、eBayの各リスティングに対して1つずつ設定します。プロダクトタイプはOdooのドキュメントで説明されているように、会社の会計設定によって決定されます。各プロダクトは 部品表タイプ が キット で、ベースプロダクトがキットの 構成品 である必要があります。このリンクされたeBayプロダクトが販売されると、作成される配送オーダにはリンクされたプロダクトの代わりにベースプロダクトがリストされます。

    

  参考

  Bill of materials

• eBayでは、eBayのオーダに対する請求書は自動的に生成されず、Odooにプッシュ通知が送信されます。eBayアイテムの請求書ポリシーを設定して下さい。請求書ポリシーによって、アイテムの請求書を発行できる時期が決まります。eBayユーザーは、ほとんどの場合、商品が発送される前に支払いを受けるため、“オーダ時に請求”に設定すると、eBayオーダの請求書を毎日大量に生成することができます。

• 倉庫の 出荷配送 ルートを 商品を直接配送 (1ステップ) に設定します。

  警告

  出荷配送 のルートが2ステップまたは3ステップに設定されている場合、既知のバグが発生します:Odooのピッキング操作が確認されると、eBayはオーダを配送済として誤ってマークします。期待される動作は、配送オーダ が確認された 後 に配送済みと表示されることです。この誤った表示により、eBayの追跡番号は配送オーダにインポートされません。

• 会計/請求書作成アプリがインストールされている場合は、支払登録と、eBayのオーダから作成された請求書とeBayの入金を消込を実施します。

  参考

  銀行消込

• マーケットプレイスアカウントの削除/閉鎖通知トークンを生成します。まず、 販売アプリ ‣ 設定 ‣ 管理設定 に移動します。eBay 見出しの下で、モードを 本番 に変更し、 本番認証キー にランダムなテキスト値を入力します。そして eBayマーケットプレイスアカウントの削除/閉鎖通知 セクションの下にある トークンを生成 ボタンをクリックします。このトークンは、eBayでの削除/閉鎖通知の設定時に使用されます。

eBayの設定¶

eBayデベロッパーアカウントの設定¶

まず、 `eBayデベロッパーポータル<https://go.developer.ebay.com/>`_ からeBayのeBay デベロッパーアカウントを作成します。このサイトでは eBay アカウントとは別のログイン名とパスワードが必要ですが、同じメールアドレスで登録できます。eBayデベロッパーアカウントを作成するための認証は約24時間です。

eBayキーセットの設定¶

eBayデベロッパーアカウントを作成したら、`eBayデベロッパーアカウントポータル　<https://go.developer.ebay.com/>`_ でアプリケーションをセットアップします。次に、画面右上の こんにちは [ユーザ名] の見出しに移動し、ドロップダウンメニューのオプションから アプリケーションキーセッツ をクリックします。そうすると、ユーザに アプリケーションタイトルを入力 (50文字以内)と開発環境(Sandbox または Production)の選択を促すポップアップが開きます。この2つのフィールドが最初のキーセットを生成します。このアプリケーションタイトルはキーセットが生成されるまで保存されません。キーセットを生成するには キーセットを生成 をクリックして下さい。

アカウント削除/通知設定(プロダクト)¶

プロダクト環境で通知を設定したりデータベースを削除するには、eBayでベロロッパーポータル に移動します。eBay のアカウント削除/通知設定を行うには、画面右上の [ユーザー名]`から アプリケーションキーセッツ に移動して下さい。

次に、 Production キーセット列の下にある マーケットプレイス削除/アカウント閉鎖通知 オプションをクリックします。マーケットプレイスアカウント削除通知エンドポイントがダウンした場合に通知するEメール の下にEメールを入力します。guilabel:保存 をクリックしてメールを有効にします。

このアクションに続いて、Odooが提供する マーケットプレイスアカウント削除通知エンドポイント URLを入力します。このHTTPsエンドポイントはOdooの 販売アプリ ‣ 設定 ‣ 管理設定 の eBayマーケットプレイスアカウントの削除/閉鎖通知 フィールドにあります。

このフィールドの下にあるOdooの トークンを生成 ボタンをクリックすると、eBay本番環境用の検証トークンが作成されます。Odooで新しく作成されたトークンを コピー し、eBayに移動して 認証トークン フィールドに入力します。guilabel:保存 をクリックして イベント通知配送方法 を有効にします。

上記のフィールドが完了したら、新しい通知をテストするために テスト通知を送信 をクリックします。緑色のチェックマークが表示されたら次のステップに進んで下さい。テスト投稿が期待通りでない場合は、上記の設定を再確認して下さい。

通知設定を構成した後、 アプリケーションキー ページに戻って本番用キーセットを生成して下さい。

キーセットを作成¶

通知のセットアップに成功すると、残りのOdoo設定で必要となる本番キーセットを作成することができます。アプリケーションキー ページに戻り、本番キーセットを作成します。

管理者は 主な連絡先を確認する を求められます。アカウント所有者(eBay APIライセンス契約の法的責任者)を入力または確認します。名前、 苗字、 Eメール、 電話 を入力します。次に、 個人 または ビジネス オプションを選択します。

キーの作成に進む をクリックし、主連絡先を確認します。新しい画面に アプリケーションキー が入力され、開発者アカウントにメールが送信されます。guilabel:App ID (Client ID)、Dev ID、Cert ID (Client Secret) が全て入力されます。

これらの値は後でOdooに入力するため、コピーして下さい。

eBayユーザトークンを作成する¶

画面右上の`こんにちは [ユーザ名]` → ユーザアクセストークン に移動して、eBayで ユーザトークン を作成します。

適正な 環境: Sandbox (テスト用) または Production (本番データベース用) を選択して下さい。eBayとOdooの全ての環境設定で同じ選択を維持して下さい。

次に、Auth'n'Auth と書かれたラジオボタンを選択します。

Productionにサインイン または Sandboxにサインイン を選択して、選択した環境のユーザトークンを取得します。このボタンは上記の Sandbox または Production の選択によって変わります。

そうすると 法的住所の確認 というポップアップウィンドウが表示されます。姓、名、主なEメール、法的住所、アカウントタイプ の必須項目を入力します。アカウントタイプ では、 個人 または ビジネス のいずれかを選択します。確認を完了するには、 eBayにサインインしてトークンを入手 をクリックします。

管理者はeBayのsandboxまたはproductionサインインページにリダイレクトされます。このログインはeBayデベロッパーコンソールとは異なり、アイテムが販売されるeBayアカウントです。このメールおよび/またはログインは、eBayデベロッパーアカウントとは異なる場合があります。

eBayアカウントの Eメール または ユーザ名 を入力し、eBayアカウントにサインインします。

アプリケーションへのアクセスを許可する¶

本番環境またはSandobox環境にサインインした後、eBayは管理者にユーザのeBayデータへのアクセスを許可する*同意*を提示します。

同意 をクリックすると、eBayはeBayアカウントと アプリケーションプログラミングインターフェース (API)をリンクさせます。この同意はeBayのアカウント設定からいつでも変更することができます。

画面に ユーザトークン が表示されます。このトークンは次のステップで アプリケーションキーセット と共に使用されるので、必ずコピーしておいて下さい。

APIエクスプローラ¶

これで アプリケーションキーセット と ユーザトークン が作成されたので、APIエクスプローラ を使ってテストを実行し、 API が正しく設定されていることを確認することができます。このテストでは API を使って簡単な検索を行います。

abbr:API (アプリケーションプログラミングインターフェイス) テストを開始するには、 OAuthアプリケーション・トークンの取得 をクリックします。これで Token フィールドにキーが入力されます。

基本的な検索機能が実行されるように設定されています。guilabel:実行 をクリックしてテストを完了します。テストが成功すると コールレスポンス に 200 OK と 時間 が応答します。

Odooに認証情報を入力する¶

先にコピーした ユーザトークン と アプリケーションキーセット をOdooデータベースに入力する準備ができました。

OdooのeBay設定（販売アプリ ‣ 設定 ‣ 管理設定 ‣eBay）に戻り、eBayの以下の認証情報をOdooの対応するフィールドに貼り付けます。

Odooで認証情報を保存し、設定が正しいことを確認します。初期設定が完了すると、プロダクトに eBay という新しいメニュータブが表示され、eBayで販売する というオプションが表示されます。プロダクトのリスティング方法については 管理 ドキュメンテーションを参照して下さい。