Negotiation API

Negotiation API 概要 (Negotiation API Overview)

Negotiation API は、セラーがバイヤーと販売交渉を行う機能を提供します。

このAPIは現在、セラーが出品に関心を示したバイヤーにオファーを提示する機能のみをサポートしています。より詳細な交渉に参加する機能は、APIの機能拡張に伴い増加する予定です。

技術概要 (Technical overview)

バイヤーは、出品を「ウォッチリスト（Watch list）」に追加するか、ショッピングカートに出品を追加した後、しばらく購入せずに放置することで、出品への関心を示します。バイヤーが出品への関心を示すと、そのバイヤーは出品アイテムに対するセラー主導のオファーを受け取る「資格」を得ます。

バイヤーへのセラーオファーは、特定の出品に対する割引であり、オファーは出品価格からのパーセンテージ割引、または単に出品価格よりも低い新しい価格（割引価格）のいずれかになります。

Negotiation APIには現在、単一のリソースにメソッドがあります：

  • offer

このリソースのメソッドにより、セラーは以下のことができます：

  • バイヤーが積極的に関心を示している出品のセットを取得する。
  • セラーの商品に関心を示しているバイヤーにオファーを提示する。

ビジネスユースケース (Business use cases)

Negotiation APIは、以下に概説するユースケースをサポートしています。

Negotiation APIの仕組みとメソッドの実装方法の詳細については、Selling Integration Guideの Offers to buyers を参照してください。

セラー主導オファーの対象となるセラーの出品セットを取得する

findEligibleItems メソッドは、セラーの全出品の中から、バイヤーがウォッチリストに追加したか、ショッピングカートに追加した商品のセットを返します。

セラーは、バイヤーが関心を示している任意のアイテムに対してオファーを開始できます。

関心のあるバイヤーにセラー主導のオファーを提示する

sendOfferToInterestedBuyers メソッドは、セラーがバイヤーとの交渉を開始するために使用するメカニズムです。

このメソッドは、出品ID値（Trading APIで使用）とセラーの割引額を受け取ります。その後、メソッドは商品に関心を示したすべてのバイヤーに、セラーのオファーを含むメッセージを送信します。

Negotiation APIの要件と制限 (Negotiation API requirements and restrictions)

Negotiation APIはすべてのeBayセラーが利用可能であり、サービスへのリクエストを行うために特別な要件は必要ありません。

ただし、Negotiation APIは以下のeBayマーケットプレイスに制限されています：

  • オーストラリア (EBAY_AU)
  • カナダ (EBAY_CA)
  • フランス (EBAY_FR)
  • ドイツ (EBAY_DE)
  • イギリス (EBAY_GB)
  • イタリア (EBAY_IT)
  • スペイン (EBAY_ES)
  • 米国 (EBAY_US)
注: sendOfferToInterestedBuyers メソッドを通じてオファーを送信する場合、サポートされている各マーケットプレイスには、offerDuration フィールドで定義されたサイト固有のオファー有効期間があります。ほとんどのサポート対象サイト（EBAY_USおよびEBAY_GBを除く）では、この期間は 2日間 です。EBAY_USおよびEBAY_GBマーケットプレイスでは、この期間は 4日間 です。

カナダのマーケットプレイスでは、英語とフランス語の両方のロケールがサポートされています。Using eBay RESTful APIs ドキュメントに記載されているように、Content-Language ヘッダーを使用してロケールを指定してください。

Negotiation APIは、自動車を含むeBay取引をサポートしていないことに注意してください。

トップに戻る