批次查詢商品庫存資訊

適⽤買家市場：台灣

批次查詢多個已註冊商品的詳細資訊，包含商品基本資料、選項資訊、庫存數量、銷售價格及銷售狀態。

此 API 允許您一次查詢最多 50 個商品，所有商品必須屬於同一個賣家（vendorId） 。適合需要同時監控多個商品庫存狀態的場景。

技術規格注意事項

1. 批次限制： 單次請求（Request）最多可查詢 50 個商品 ID。

2. 賣家限制： 所有查詢的商品必須屬於同一個賣家編號（vendorId）。

3. 效能建議： 請根據實際需求控制查詢數量，避免過於頻繁的大量調用，以維持系統效能。

4. 資料一致性： API 回傳的庫存資訊為查詢當下的即時（Real-time）資料。

5. 錯誤處理： 若請求中部分商品不存在，API 將僅回傳現有的商品資訊，不會因單一報錯而中斷整個請求。
    

通路

POST

/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/inventories

請求範例端點

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/inventories

參數需求

請求範例

{
"sellerProductIds": [
1234567890,
1234567891,
1234567892
]
}

返回參數

返回範例

{
 "code": "SUCCESS",
"message": "查詢成功",
"data": [
{
"sellerProductId": 1234567890,
"sellerProductName": "測試商品A",
"displayProductName": "【品牌名稱】測試商品A",
"generalProductName": "測試商品A",
"vendorId": "A00123456",
"items": [
{
"sellerProductItemId": 1271845813,
"vendorItemId": 4279191317,
"itemName": "200ml_1個",
"externalVendorSku": "SKU-A-001",
"amountInStock": 100,
"salePrice": 10000,
"onSale": true
},
{
"sellerProductItemId": 1271845814,
"vendorItemId": 4279191318,
"itemName": "200ml_2個",
"externalVendorSku": "SKU-A-002",
"amountInStock": 50,
"salePrice": 18000,
"onSale": true
}
]
},
{
"sellerProductId": 1234567891,
"sellerProductName": "測試商品B",
"displayProductName": "【品牌名稱】測試商品B",
"generalProductName": "測試商品B",
"vendorId": "A00123456",
"items": [
{
"sellerProductItemId": 1271845815,
"vendorItemId": 4279191319,
"itemName": "標準款",
"externalVendorSku": "SKU-B-001",
"amountInStock": 0,
"salePrice": 15000,
"onSale": false
}
]
}
]
}

錯誤說明