Account API v1

Account API v1 概要 (Account API v1 Overview)

Account API v1 は、セラーが以下のことを行うために使用されます：

• 支払い、配送、および返品ポリシーの設定/値を設定/制御するために出品で使用されるビジネスポリシーを作成および管理する
• さまざまな税管轄区域の消費税率を作成および管理する
• eBay管理の支払い（managed payments）の適格性、販売制限、配送料金テーブル、およびその他の販売機能を含む、その他のさまざまなセラーアカウント設定を取得する

技術概要 (Technical overview)

Account API v1は、以下の各リソースでメソッドを提供します：

• advertising_eligibility
• custom_policy
• fulfillment_policy
• payment_policy
• return_policy
• payments_program
• privilege
• program
• rate_table
• sales_tax
• kyc

これらのリソースの使用方法の詳細については、以下のビジネスユースケースセクションを参照してください。

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

このセクションでは、このAPIが対応する高レベルのユースケースについて概説します。

eBay広告プログラムのセラー適格性を確認する

advertising_eligibility リソースの getAdvertisingEligibility メソッドは、開発者にeBay広告プログラムのセラー適格性ステータスを確認する方法を提供します。これには以下が含まれます：

• ジェネラルストラテジーキャンペーン
• プライオリティストラテジーキャンペーン
• Promoted Offsiteキャンペーン

このメソッドからのレスポンスは SellerEligibilityEnum を返し、指定されたセラーが適格か不適格かを示します。セラーが指定されたPromoted Listingsプログラムに不適格であると判断された場合、その理由は SellerIneligibleReasonEnum タイプによって指定されます。

セラーがPromoted Listingsプログラムに適格になるには、eBayでの販売実績があり、標準以上（Above Standard）またはトップレイテッド（Top Rated）のセラーである必要があります。つまり、Promoted Listingsを初めて利用するセラーで、これらの基準を満たしていないセラーは、キャンペーンを作成および/または編集するためにPromoted Listingsにアクセスできません。

カスタムポリシーの作成と管理

カスタムポリシー は、セラーがコンプライアンスやその他の目的で作成するポリシーを記述します。

現在、2つのカスタムポリシータイプがサポートされています：

• Product Compliance（製品コンプライアンス） - 規制コンプライアンスに必要な製品情報を開示します。
• Takeback（回収） - バイヤーが新しい商品を購入した際に、以前に購入した商品を回収するセラーの法的義務について記述します。

各マーケットプレイスについて、セラーは各タイプの複数のポリシーを作成および管理でき、各ポリシーは特定の製品コンプライアンスまたは回収ポリシーを記述します。提供される各商品に複数のポリシーを適用できることに注意することが重要です。

フルフィルメントポリシーの作成と管理

フルフィルメントポリシー（以前は「配送ポリシー」と呼ばれていました）は、セラーがバイヤーに提供する配送オプションを記述します。

各フルフィルメントポリシーの配送オプションは、そのポリシーによって提供される配送サービスのタイプ（無料、定額、または計算済み配送など）を定義します。ポリシーには、提供されている特定の配送業者やサービスもリストされます。セラーは国内および国際配送サービスの両方を定義できるため、提供するフルフィルメントポリシーを完全にカスタマイズできます。

セラーは複数のフルフィルメントポリシーを設定でき、それぞれが異なる配送オプションのセットを記述します。個々のフルフィルメントポリシーはそれぞれマーケットプレイスとアイテムカテゴリタイプをターゲットにしていますが、重要なのは、セラーが単一のマーケットプレイスに対して複数のフルフィルメントポリシーを設定できることです。これにより、販売するアイテムの異なる配送ニーズを満たすために、一連の配送オプションを設定できます。

支払いポリシーの作成と管理

支払いポリシー は、セラーが販売するアイテムの支払いをどのように処理するか、および受け入れる支払いタイプを定義します。

フルフィルメントポリシーと同様に、支払いポリシーも特定のカテゴリタイプと異なるマーケットプレイスに設定できます。また、フルフィルメントポリシーと同様に、セラーは複数の支払いポリシーを作成でき、異なるアイテムに割り当てるポリシーに柔軟性を持たせることができます。

返品ポリシーの作成と管理

返品ポリシー は、バイヤーが商品を返品できる日数や返品送料の負担者など、セラーが返品をどのように処理するかを定義します。

フルフィルメントポリシーや支払いポリシーと同様に、異なるカテゴリタイプとマーケットプレイスに対して複数の返品ポリシーを作成できます。

セラーの権限を取得する

セラー権限は、eBayセラーアカウントに設定されたレート制限をカバーします。getPrivileges メソッドを使用して、eBayセラーアカウント登録のステータスと、アカウントに設定された販売制限を確認します。

セラープログラムへのオプトインまたはオプトアウト

eBayセラーとして、eBayが提供するさまざまなセラープログラムにオプトインできます。

現在、これらのプログラムには以下が含まれます：

• Out of Stock Control（在庫切れ管理） - 商品の在庫が一時的に切れた場合でも、固定価格出品をアクティブな状態に保つことができます。
• Partner Motors Program（パートナーモーターズプログラム） - 登録されたビジネスユーザーが自動車の出品を作成できるようにします。このプログラムは現在UKマーケットプレイスでのみサポートされており、セラーは自動車の出品を作成するために eBay Motors Pro 登録フローを完了する必要があります。
• Selling Policy Management（販売ポリシー管理） - 販売アカウントでのビジネスポリシーの使用を有効にします。

eBay管理の支払いのセラーのステータスを取得する

getPaymentsProgram メソッドは、セラーが eBay管理の支払い（eBay managed payments） にオプトインしているかどうかのステータスを返します。

getPaymentsProgramOnboarding メソッドは、管理された支払いに対するセラーのオンボーディングステータスを取得し、適格なセラーに対してオンボーディングプロセスの次のステップを提供します。

getKYC メソッドを使用すると、管理された支払いのセラーは、「本人確認（KYC: Know Your Customer）」チェックのアクション項目を見つけることができます。アクション項目には、会社詳細、個人詳細、または銀行口座詳細の提供が含まれる場合があります。

getPaymentsProgram メソッドは、リクエストで指定されたeBay管理の支払いにセラーがオプトインしているかどうかのステータスを返します。現在利用可能な唯一のeBay管理の支払いは eBay Payments であり、これはeBayがバイヤーとセラー間の資金移動と取引完了の方法として提供するプログラムです。

getPaymentsProgramOnboarding メソッドは、セラーのオンボーディングステータスを取得し、適格なセラーに対してオンボーディングプロセスの次のステップを提供します。

セラーが作成した配送料金テーブルを取得する

セラーは、商品の発送に使用する配送料率を確立する配送料金テーブルを作成できます。料金テーブルはセラーのフルフィルメントポリシーで参照でき、料金テーブルを更新することでポリシーのセットを簡単に更新できます。

getRateTables メソッドは、指定された国に対してセラーが定義した配送料金テーブルを返します。

管轄区域別の消費税テーブルの作成と管理

一部の国では国全体で単一の消費税率を課していますが、カナダ（CA）や米国（US）などの他の国では、複数の消費税管轄区域があります。セラーは、販売する各管轄区域の消費税テーブルを作成することで、販売商品の価格に消費税を追加するプロセスを簡素化できる場合があります。

詳細については、Establishing sales-tax tables を参照してください。

Metadata API の getSalesTaxJurisdictions 呼び出しを使用して、複数の消費税管轄区域を持つ郡の管轄区域の完全なリストを取得します。SALES_TAX リソースのメソッドを使用して、さまざまな管轄区域の消費税テーブルを作成および管理できます。

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

現在5つのマーケットプレイスでのみサポートされている カスタムポリシー を除き、Account API v1はすべてのeBayマーケットプレイスでサポートされています。