在庫 API（Inventory API）

在庫 API は、eBay マーケットプレイスで販売する在庫を作成・管理し、オファーとして公開・管理するために使用されます。また、適格なアクティブな eBay 出品を在庫 API モデルに変換するメソッドも提供しています。

バージョン: 1.18.4

ベースURL: https://api.ebay.com/sell/inventory/v1

認証（OAuth スコープ）

この API では、以下の OAuth 2.0 スコープが使用されます。

リソース一覧

Inventory API は以下の 6 つのリソースカテゴリで構成されています。

inventory_item — 在庫アイテム管理

在庫アイテムは、販売者が eBay で販売する個々の商品を表します。各在庫アイテムは一意の SKU（在庫管理単位）値で識別されます。

GET /inventory_item

getInventoryItems — 販売者のアカウントに定義されているすべての在庫アイテムレコードを取得します。

limit クエリパラメータで1ページあたりの返却レコード数を制御し、offset クエリパラメータで特定のページを取得できます。1回の呼び出しで多数の在庫アイテムを SKU 値で取得したい場合（一度に最大25件）、bulkGetInventoryItem メソッドを使用できます。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

GET /inventory_item/{sku}

getInventoryItem — 特定の SKU の在庫アイテムレコードを取得します。

SKU 値は呼び出し URI の末尾にパスパラメータとして渡されます。この呼び出しにはリクエストペイロードはありません。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

PUT /inventory_item/{sku}

createOrReplaceInventoryItem — 新しい在庫アイテムレコードを作成するか、既存の在庫アイテムレコードを置き換えます。

在庫アイテムレコードを最初に作成する際は、呼び出しパスの SKU 値のみが必要です。最初から完全なレコードを作成するか、複数回の呼び出しで情報を段階的に追加することができます。

重要: Inventory API を使用して作成された eBay 出品は、Trading API 呼び出しを使用して修正または再出品することはできません。各出品は1暦日に最大250回まで修正できます。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功（更新）
• 201 — 作成済み
• 204 — コンテンツなし
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

DELETE /inventory_item/{sku}

deleteInventoryItem — 指定された SKU に関連付けられた在庫アイテムレコードを削除します。

削除すると、以下の効果があります:

• その SKU に関連付けられている未公開のオファーがすべて削除される
• その SKU に関連付けられている単一バリエーションの eBay 出品がすべて終了する
• その SKU が複数バリエーションの出品から自動的に削除され、関連する在庫アイテムグループからも削除される

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（削除成功）
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /bulk_create_or_replace_inventory_item

bulkCreateOrReplaceInventoryItem — 最大25件の新しい在庫アイテムレコードを一括で作成および/または更新します。

最初から完全な在庫アイテムレコードを作成するか、最初の呼び出しで一部の情報のみを提供し、追加の呼び出しで段階的にフィールドを完了することができます。在庫アイテムレコードを最初に作成する際は、SKU 値のみが必要です。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 207 — マルチステータス（一部成功・一部失敗）
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

POST /bulk_get_inventory_item

bulkGetInventoryItem — 最大25件の在庫アイテムレコードを一括で取得します。

取得する各在庫アイテムレコードの SKU 値は、リクエストペイロードで指定されます。1件のみ取得したい場合は getInventoryItem、すべてを取得したい場合は getInventoryItems を使用してください。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 207 — マルチステータス
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

POST /bulk_update_price_quantity

bulkUpdatePriceQuantity — 1つの在庫アイテムに関連付けられたオファーの価格や数量を一括更新します。

1回の呼び出しで、1つの SKU に関連付けられた最大25件のオファーの価格・数量を更新できます。公開済み（ライブ出品）のオファーを更新すると、eBay のリアルタイム出品が直接更新されます。各出品は1暦日に最大250回まで変更できます。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 207 — マルチステータス
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

product_compatibility — 製品互換性管理

製品互換性リストは、在庫アイテムと互換性のある車両やその他の製品を定義します。現在、自動車部品とアクセサリのカテゴリに適用されますが、将来的にはさらに多くのカテゴリがサポートされる可能性があります。

GET /inventory_item/{sku}/product_compatibility

getProductCompatibility — 在庫アイテムと互換性のある製品リストを取得します。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

PUT /inventory_item/{sku}/product_compatibility

createOrReplaceProductCompatibility — 在庫アイテムと互換性のある製品リストを作成または置換します。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功（更新）
• 201 — 作成済み
• 204 — コンテンツなし
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

DELETE /inventory_item/{sku}/product_compatibility

deleteProductCompatibility — 在庫アイテムに関連付けられた製品互換性リストを削除します。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（削除成功）
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

inventory_item_group — 在庫アイテムグループ管理

在庫アイテムグループは、複数バリエーション出品（サイズ・色などの異なるバリエーションを持つ商品）を管理するために使用されます。グループ内の各在庫アイテムは、1つの製品バリエーションを表します。

GET /inventory_item_group/{inventoryItemGroupKey}

getInventoryItemGroup — 指定された inventoryItemGroupKey の在庫アイテムグループを取得します。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

PUT /inventory_item_group/{inventoryItemGroupKey}

createOrReplaceInventoryItemGroup — 新しい在庫アイテムグループを作成するか、既存のグループを更新します。

在庫アイテムグループを最初に作成する際に必要な要素は、呼び出し URI の inventoryItemGroupKey 識別子と、リクエストペイロードの variantSKUs 配列で指定されたグループメンバーのみです。inventoryItemGroupKey の値は一度設定すると変更できません。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功（更新）
• 201 — 作成済み
• 204 — コンテンツなし
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

DELETE /inventory_item_group/{inventoryItemGroupKey}

deleteInventoryItemGroup — 指定された在庫アイテムグループを削除します。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（削除成功）
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

offer — オファー管理

オファーは、在庫アイテムを特定の eBay マーケットプレイスで販売するための出品条件（価格、数量、ポリシー、カテゴリなど）を定義します。オファーを「公開」すると、eBay 上のライブ出品になります。

オファー公開に必要なフィールド:

• 在庫場所（location）
• オファー価格
• 入手可能な数量
• eBay 出品カテゴリ
• 支払い・返品・フルフィルメントの出品ポリシープロファイル

GET /offer

getOffers — 指定された SKU 値の既存のオファーをすべて取得します。

オークションと固定価格出品で同時に同じ SKU を提供することができます。この場合、getOffers は2つのオファーを返します。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /offer

createOffer — 特定の eBay マーケットプレイスで特定の在庫アイテムのオファーを作成します。

オファーを初めて作成する際、リクエストペイロードに sku、marketplaceId、および format フィールドが必要です。

OAuth スコープ: sell.inventory

レスポンス:

• 201 — 作成済み
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

GET /offer/{offerId}

getOffer — 特定の公開済みまたは未公開のオファーを取得します。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

PUT /offer/{offerId}

updateOffer — 既存のオファーを更新します。

updateOffer 呼び出しは、既存のオファーオブジェクトを完全に置き換えるため、値が変更されたかどうかに関係なく、現在のオファーオブジェクトを構成するすべてのフィールドが必要です。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 204 — コンテンツなし
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

DELETE /offer/{offerId}

deleteOffer — オファーを削除します。

未公開のオファーは完全に削除されます。公開済みのオファー（ライブ出品）の場合、単一バリエーション出品は終了し、複数バリエーション出品ではその製品バリエーションが出品から削除されます。ただし、そのバリエーションに1件以上の販売がある場合は削除できません（代わりに在庫数を 0 に設定してください）。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（削除成功）
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /offer/{offerId}/publish

publishOffer — 未公開のオファーをライブ eBay 出品に変換します。

複数のオファー（最大25件）を一括公開したい場合は bulkPublishOffer を使用してください。複数バリエーションの出品には publishOfferByInventoryItemGroup を使用してください。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /offer/{offerId}/withdraw

withdrawOffer — オファーに関連付けられた単一バリエーションの出品を終了します。

deleteOffer と異なり、このメソッドはオファーオブジェクトを削除せず、未公開状態に戻します。再出品するには publishOffer を使用してください。複数バリエーションの出品を終了するには withdrawOfferByInventoryItemGroup を使用してください。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /bulk_create_offer

bulkCreateOffer — 特定の eBay マーケットプレイスの特定の在庫アイテムに対して、最大25件のオファーを一括作成します。

リクエストペイロードでは sku、marketplaceId、および format フィールドが常に必須です。1回の呼び出しで複数のオファーを更新できる一括操作はないため、必要なすべての詳細をこの呼び出しで提供することを推奨します。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 207 — マルチステータス
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

POST /bulk_publish_offer

bulkPublishOffer — 未公開のオファー（最大25件）を一括でライブ eBay 出品に変換します。

各オファーの一意識別子（offerId）をリクエストペイロードに渡します。1件のみ公開する場合は publishOffer を使用してください。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 207 — マルチステータス
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

POST /offer/get_listing_fees

getListingFees — 最大250件の未公開オファーの予想出品料を取得します。

レスポンスでは、すべての出品料が eBay マーケットプレイスごとにグループ化されます。この呼び出しは販売者が publishOffer でオファーを公開する前に使用してください（公開済みオファーの offerId を渡すとエラーが発生します）。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /offer/publish_by_inventory_item_group

publishOfferByInventoryItemGroup — 在庫アイテムグループに関連付けられたすべての未公開オファーを、アクティブな複数バリエーション出品に変換します。

在庫アイテムグループの一意識別子（inventoryItemGroupKey）をリクエストペイロードに渡します。グループ内のすべての在庫アイテムとオファーが有効である必要があります。一部のオファーだけ有効な場合、呼び出し全体が失敗します。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

POST /offer/withdraw_by_inventory_item_group

withdrawOfferByInventoryItemGroup — 在庫アイテムグループに関連付けられた複数バリエーションの eBay 出品を終了します。

在庫アイテムグループオブジェクトやオファーは削除されません。すべてのオファーが未公開状態になります。再出品するには publishOfferByInventoryItemGroup を使用してください。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（成功）
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

listing — 出品管理

listing リソースは、既存の eBay 出品を在庫 API モデルに移行する機能と、SKU のロケーションマッピング管理機能を提供します。

POST /bulk_migrate_listing

bulkMigrateListing — 既存の eBay 出品を在庫 API オブジェクトに変換します。

出品が在庫 API モデルに正常に移行されると、新しい在庫場所、在庫アイテム、およびオファーオブジェクトが作成されます。複数バリエーション出品の場合は、在庫アイテムグループオブジェクトも作成されます。自動車部品の互換性リストを含む出品の場合は、製品互換性オブジェクトも作成されます。

移行要件:

• 出品タイプが固定価格であること（オークション出品の移行は不可）
• 各アイテムに販売者定義の SKU 値が関連付けられていること
• ビジネスポリシー（支払い、返品、配送）を使用していること
• 郵便番号または出品場所が指定されていること

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 207 — マルチステータス
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

GET /listing/{listingId}/sku/{sku}/locations

getSkuLocationMapping — 出品内の特定の SKU にマッピングされたフルフィルメントセンターの場所を取得します。

複数バリエーション出品のすべてのアイテムのロケーションマッピングを取得するには、各バリエーションごとにこのメソッドを呼び出す必要があります。

OAuth スコープ: sell.inventory または sell.inventory.readonly

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

PUT /listing/{listingId}/sku/{sku}/locations

createOrReplaceSkuLocationMapping — 複数のフルフィルメントセンターの場所を出品内の単一 SKU にマッピングします。

これにより、eBay は販売者のフルフィルメントセンターに関連付けられた場所メタデータを活用して、出品商品のより正確な配達予定日を計算できます。既存のロケーションマッピングは完全に置換されます。

注意: 現時点では、改善された配達予定日機能は、米国国内に配送する米国ベースのフルフィルメントセンターでのみサポートされています。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（成功）
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

DELETE /listing/{listingId}/sku/{sku}/locations

deleteSkuLocationMapping — 出品内の特定の SKU に関連付けられたすべてのロケーションマッピングを削除します。

重要: 複数バリエーションの出品からすべてのロケーションマッピングを削除するには、出品内の個々の SKU ごとにこのメソッドを使用する必要があります。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（削除成功）
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

location — 在庫場所管理

在庫場所は、販売者が商品を保管・出荷する物理的な場所を表します。すべてのオファーには少なくとも1つの場所が関連付けられている必要があります。以下の3種類の場所タイプがサポートされています:

• WAREHOUSE — 倉庫（商品が保管・出荷される場所）
• STORE — 店舗（営業時間や特別営業時間の設定が可能）
• FULFILLMENT_CENTER — フルフィルメントセンター（配達予定日の計算に使用）

GET /location

getInventoryLocations — 販売者のアカウントに関連付けられたすべての在庫場所を取得します。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 500 — 内部サーバーエラー

GET /location/{merchantLocationKey}

getInventoryLocation — 指定された在庫場所のすべての詳細を取得します。

OAuth スコープ: sell.inventory.readonly または sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /location/{merchantLocationKey}

createInventoryLocation — 新しい在庫場所を作成します。

オファーを作成して公開するには、少なくとも1つの場所が必要です。場所を最初に作成する際は、販売者定義の場所識別子と物理的な場所のみが必要です。一度設定すると、これらの値は変更できません。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — コンテンツなし（作成成功）
• 400 — リクエスト形式が不正
• 409 — 場所はすでに存在します
• 500 — 内部サーバーエラー

DELETE /location/{merchantLocationKey}

deleteInventoryLocation — 在庫場所を削除します。

場所を削除しても、削除された場所に関連付けられたアクティブな eBay 出品には影響しませんが、その場所に関連付けられたオファーを変更できなくなります。

注意: フルフィルメントセンターの場所の削除は現在サポートされていません。代わりに disableInventoryLocation メソッドを使用して無効にしてください。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /location/{merchantLocationKey}/disable

disableInventoryLocation — 在庫場所を無効にします。

無効にすると、その場所に在庫をロード/変更することはできなくなります。アクティブな eBay 出品には影響しませんが、無効な場所に関連付けられたオファーは変更できません。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /location/{merchantLocationKey}/enable

enableInventoryLocation — 無効な在庫場所を有効にします。

有効にすると、その場所への在庫のロード/変更を再開できます。

OAuth スコープ: sell.inventory

レスポンス:

• 200 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

POST /location/{merchantLocationKey}/update_location_details

updateInventoryLocation — 既存の在庫場所のロケーション詳細を更新します。

以下のフィールドを更新できます:

• name、phone、timeZoneId、geoCoordinates
• fulfillmentCenterSpecifications、locationTypes
• locationWebUrl、locationInstructions、locationAdditionalInformation

倉庫および店舗の場所は住所フィールドを何度でも更新可能です。フルフィルメントセンターの住所フィールドは更新できませんが、初回作成時に省略された場合はこのメソッドで追加できます。店舗の場所については、営業時間や特別営業時間も更新できます。

OAuth スコープ: sell.inventory

レスポンス:

• 204 — 成功
• 400 — リクエスト形式が不正
• 404 — 見つかりません
• 500 — 内部サーバーエラー

主要なエラーコード

Inventory API で返される主要なエラーコードの一覧です。

エンドポイント一覧