Fulfillment API

Fulfillment API 概要 (Fulfillment API Overview)

バイヤーのeBayチェックアウトプロセスの結果は「注文 (order)」となります。このAPIを使用すると、セラーはチェックアウト時に指定された支払い方法とタイミングに従って注文の完了を管理できます。注文内の品目（ラインアイテム）は、1つ以上のパッケージにグループ化されます。セラーが各パッケージに対処、処理、および発送する際、このプロセスの仕様のセットは「フルフィルメント (fulfillment)」として知られています。Fulfillment APIを使用して、注文から完了までのこれらのアクティビティを促進および監視します。eBayでのセラーのステータスは、タイムリーなフルフィルメントの記録に部分的に依存します。

「注文取得」および「出荷フルフィルメント」メソッドに加えて、Fulfillment APIにはセラー主導の issueRefund メソッドと、一連の「支払い紛争 (payment dispute)」メソッドもあります。

issueRefund メソッドを使用すると、セラーは注文に対してバイヤーに全額または一部返金を発行できます。全額または一部返金は、注文レベルまたは品目レベルで発行できます。

「支払い紛争」メソッドを使用すると、セラーはバイヤー主導の支払い紛争を取得および管理できます。これらの特定の支払い紛争は、バイヤーがPayPalやVisaなどの支払いプロバイダーで開始した紛争であり、支払い紛争がeBayのシステムに入るとセラーに通知されます。

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

このセクションでは、Fulfillment APIが対応するビジネスユースケースについて概説します。

履行が必要な注文の取得

getOrder メソッドを使用して既知の注文を取得できます。また、getOrders メソッドを使用すると、作成日、変更日、またはフルフィルメントステータスによって注文を検索できます。詳細については、Discovering unfulfilled orders を参照してください。

注文の履行

createShippingFulfillment メソッドを使用して、配送パッケージと追跡番号を注文の1つ以上の品目に関連付けます。詳細については、Handling unfulfilled line items を参照してください。

フルフィルメントの管理

getShippingFulfillments メソッドを使用して注文のすべてのフルフィルメントのステータスを取得するか、getShippingFulfillment メソッドを使用して特定のフルフィルメントを取得できます。詳細については、Managing fulfillments for an order を参照してください。

バイヤーへの全額または一部返金の発行

セラーは、注文のキャンセル、返品された商品、または「説明と異なる商品」を含むその他の注文の問題の場合に、バイヤーに全額または一部返金を発行できます。issueRefund メソッドを通じて発行されたバイヤーへの返金は非同期で処理され、セラーは getOrder 呼び出しを行うことで返金のステータスを追跡できます。

個別の注文のリンク

異なるセラーからのものである可能性のある個別のリンクされた注文からの限定的な情報は、getOrder および getOrders メソッドの linkedOrderLineItems を通じて返すことができます。この情報は、インストール（別のセラーから購入）に必要なコンポーネント（あるセラーから購入）に関する詳細を提供できます。詳細には、リンクされたセラーを特定する情報や、配送時間、商品情報、注文情報を含めることができます。

たとえば、タイヤの注文がインストールのための別の注文にリンクされている場合、タイヤの注文に関する限定的な情報がインストール注文で利用可能です：

• 注文番号
• 追跡情報（配送業者コード、推定発送日を含む）
• タイヤセラー名、タイヤ出品タイトル、およびタイヤ仕様（ホイール直径、偏平率、セクション幅、およびその他の同様のアスペクトを含む）
• バイヤーのメールアドレス、電話番号、およびバイヤーが選択した予約詳細（これらは予約のスケジュールに役立ちます）

バイヤー主導の支払い紛争の管理

eBayバイヤーがeBayプラットフォーム上で直接ではなく、支払いプロバイダーを通じて支払い紛争を開始する可能性があります。Fulfillment APIの支払い紛争操作により、セラーはこれらのタイプの紛争を発見できます。作成された支払い紛争を取得する「get」呼び出しに加えて、これらの支払い紛争を受け入れるか異議を唱える操作や、セラーが支払い紛争に異議を唱えることを決定した場合にセラーの主張を裏付ける画像ファイルをアップロードする操作もあります。

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

サポートされているマーケットプレイス

Fulfillment APIの注文およびフルフィルメントメソッドは、販売および注文管理をサポートするすべてのeBayマーケットプレイスでサポートされています。これには以下が含まれます：

• eBay US (EBAY_US, www.ebay.com)
• eBay UK (EBAY_GB, www.ebay.co.uk)
• eBay Germany (EBAY_DE, www.ebay.de)
• eBay Australia (EBAY_AU, www.ebay.com.au)
• eBay Canada (EBAY_CA, www.ebay.ca (English) and www.cafr.ebay.ca (French))
• eBay France (EBAY_FR, www.ebay.fr)
• eBay Italy (EBAY_IT, www.ebay.it)
• eBay Spain (EBAY_ES, www.ebay.es)
• eBay Austria (EBAY_AT, www.ebay.at)
• eBay Switzerland (EBAY_CH, www.ebay.ch)
• eBay Ireland (EBAY_IE, www.ebay.ie)
• eBay Netherlands (EBAY_NL, www.ebay.nl)
• eBay Poland (EBAY_PL, www.ebay.pl)
• eBay Belgium (EBAY_BE, www.benl.ebay.be (Dutch) and www.befr.ebay.be (French))
• eBay Hong Kong (EBAY_HK, www.ebay.com.hk)
• eBay Philippines (EBAY_PH, www.ebay.ph)
• eBay Malaysia (EBAY_MY, www.ebay.com.my)
• eBay Singapore (EBAY_SG, www.ebay.com.sg)

レート制限

Fulfillment APIを使用して1日に行うことができる呼び出し数は、アプリケーションのeBay互換性レベルによって異なります：

• すべてのアプリケーション: 100,000 回/日
• eBay互換アプリケーション: 2,500,000 回/日