Inventory API

Inventory API 概要 (Inventory API Overview)

Inventory APIは、在庫アイテムレコードの作成・管理を行い、それらの在庫アイテムをeBayマーケットプレイス上の製品オファー（出品）に変換するために使用されます。Inventory APIは以下のエンティティ（実体）を持っています：

  • Location（ロケーション）：セラーがInventory APIを使用してオファーの作成と公開を開始する前に、少なくとも1つの店舗または倉庫の在庫ロケーションを設定する必要があります。すべての在庫ロケーションには、セラー定義のマーチャントロケーションキー値も必要です。
  • Inventory Item（在庫アイテム）：eBayマーケットプレイスのオファーで製品を販売する前に、その製品の在庫アイテムレコードが存在する必要があります。在庫アイテムレコードには、製品の詳細、アイテムの状態、利用可能な数量などが含まれます。すべての在庫アイテムには、セラー定義のSKU値も必要であり、この値はセラーの在庫全体で一意である必要があります。
  • Offer（オファー）：オファーは、実際のeBay出品（リスティング）になるものです。オファーは最初に作成され、その後Inventory APIで公開されます。各オファーは、eBayマーケットプレイス、在庫アイテム、在庫ロケーション、およびカテゴリIDに関連付けられている必要があります。オファーには、オファーの利用可能数量、出品説明、およびオファー価格が含まれます。すべてのオファーは、支払い、フルフィルメント（配送）、および返品のビジネスポリシーを参照する必要があるため、セラーはビジネスポリシーにオプトインし、オファーに適用できるビジネスポリシーを持っている必要があります。
  • Inventory Item Group（在庫アイテムグループ）：セラーがInventory APIを通じてマルチバリエーション出品を作成および管理したい場合、在庫アイテムグループが必要です。在庫アイテムグループは、色やサイズなどのいくつかの側面（アスペクト）が異なる類似した在庫アイテムのコレクションです。
  • Compatible Products（適合製品）：製品適合性呼び出しにより、セラーは適合車両リスト、つまり自動車部品またはアクセサリーと適合する車両を作成できます。
重要！ オファー公開に関する注記：メソッドを呼び出す際にフィールドがオプションまたは条件付きで必須であっても、オファーを公開してアクティブな出品を作成する際には必須になる場合があります。詳細については、Required fields for publishing an offer を参照してください。

技術概要 (Technical overview)

Inventory APIは多かれ少なかれ「スタンドアロン」のRESTベースのAPIですが、他のAPIと以下の関係を持っています：

  • Trading API：セラーはTrading APIを使用して出品関連のメタデータを取得する場合があり、また、Offer呼び出しを通じて作成した出品を表示するために GetItem 呼び出しを使用したい場合があります。
  • Account API：セラーはAccount APIを使用してビジネスポリシーにオプトインし、ビジネスポリシー（Inventory APIの createOffer 呼び出しで使用/参照される）を作成および管理できます。Inventory APIユーザーは、フルフィルメントビジネスポリシーに適用したい配送料金テーブルの一意の識別子を取得するために、Account APIの getRateTables 呼び出しを使用する必要がある場合もあります。
  • Fulfillment API：セラーはFulfillment APIを使用して注文詳細を取得し、出荷追跡を管理できます。

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

以下は、Inventory APIが対応する高レベルのユースケースです。

  • 在庫ロケーションの作成と管理
  • 在庫アイテムレコードの作成と管理
  • オファーの作成
  • オファーの公開と管理
  • bulkMigrateListings 呼び出しを使用して、既存のeBay出品をInventory APIデータモデルに移行する

以下のユースケースは必ずしも必須ではありませんが、セラーは利用可能です：

  • 未公開オファーの予想出品手数料を取得する
  • 在庫アイテムグループの作成と管理（マルチバリエーション出品を作成および管理する場合に必要）
  • 自動車部品の適合車両リストを作成する（自動車部品またはアクセサリーの出品を作成および管理する場合に役立ちます）
  • 在庫ロケーションの無効化または有効化
  • 特定の倉庫ロケーションでのSKUの利用可能数量を設定する
  • 拡大生産者責任（Extended Producer Responsibility）規制およびカスタムポリシーを出品に適用する。これらの機能は、限られた数のサイトおよび特定のカテゴリでサポートされています。有効なサイトとカテゴリを返すには、Sell Metadata API を参照してください。

リアルタイム在庫チェック (Real-time Inventory Check)

リアルタイム在庫チェックは、チェックアウト時に在庫の可用性と数量情報を自動的に更新できるようにするInventory APIの機能です。加盟店（マーチャント）はAPIエンドポイントをeBayに提供でき、eBayはチェックアウト時にこのエンドポイントを呼び出して、在庫アイテムの注文を履行するのに十分な数量が存在することを確認します。

詳細については、Selling Integration Guideの Real-time inventory check セクションを参照してください。

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

重要！ 現在、Inventory API を通じて作成された出品は、セラーハブ（Seller Hub）やその他の出品プラットフォームでは編集できません。修正はすべて Inventory API を通じて行う必要があります。

Inventory API（またはその他のeBayパブリックAPI）を使用するには、ユーザーはeBay Developers Programアカウントを持っている必要があり、ユーザーのセラーアカウントは ビジネスポリシー にオプトインしている必要があります。オプトインしたら、Account API v1 を使用して、フルフィルメント（以前は配送として知られていた）、返品、および支払いを含むポリシーを作成および更新します。これらのポリシーは、Inventory API を通じて出品（公開されたオファーとも呼ばれます）を作成するために必要です。

また、セラーに対して「在庫切れ（Out-of-Stock）」管理機能をオンにすることは非常に良いアイデアです。「在庫切れ」管理機能を使用すると、利用可能数量が「0」の出品は最大90日間維持/アクティブのままになり、セラーはアクティブな出品に対してより多くの在庫をロードする機会が得られます。アクティブな出品が「在庫切れ」の間、検索からは非表示になるため、興味を持ったバイヤーが利用可能数量のない出品を見ることはありません。セラーはMy eBayのサイト設定（Site Preferences）で「在庫切れ」管理オプションをオンにするか、Trading APIの SetUserPreferences 呼び出しを使用してこの機能をオンにすることができます。

bulkMigrateListings 呼び出しを使用する場合、アクティブなeBay出品がInventory APIデータモデルに変換される前に満たす必要がある追加の要件があります。これらの要件については、Selling Integration Guideで説明されています。

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

Inventory APIは、APIサポートがあるすべてのeBayマーケットプレイスでサポートされています。Inventory APIは、固定価格（fixed-price）とオークション（auction）アイテムの両方をサポートしています。

トップに戻る