快工助手跨境电商知识与商机助手

Description of seller inventory information with multiple "location_id"

Shopee 官方资料 · Shopee Open Platform 常见问题(FAQ) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.faq
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/help_centertopic/apitopic/developertopic/faqtopic/feature-apistopic/product

资料正文

§1 Description of seller inventory information with multiple "location_id"

Description of seller inventory information with multiple "location_id"

The following is an example of the response of the "v2.product.get_model_list" API.

The seller set the "location_id": SG000007Z warehouse to holiday mode, but set the stock to 100, and other warehouses did not set the holiday mode:

{

"error": "",

"message": "",

"warning": "",

"request_id": "556f63b0698a0f744b47213fd3def377",

"response": {

"tier_variation": [

{

"name": "size",

"option_list": [

{

"option": "XS"

},

{

"option": "S"

}

]

}

],

"model": [

{

"model_id": 9210772,

"promotion_id": 0,

"tier_index": [

0

],

"stock_info": [

{

"stock_type": 2,

"stock_location_id": "SG000005Z",

"current_stock": 100,

"normal_stock": 100

},

{

"stock_type": 2,

"stock_location_id": "SG000006Z",

"current_stock": 100,

"normal_stock": 100

},

{

"stock_type": 2,

"stock_location_id": "SG000007Z",

"current_stock": 0,

"normal_stock": 0

},

{

"stock_type": 2,

"stock_location_id": "SGZ",

"current_stock": 100,

"normal_stock": 100

},

{

"stock_type": 1,

"current_stock": 0,

"normal_stock": 0,

"reserved_stock": 0

}

],

"price_info": [

{

"current_price": 80,

"original_price": 80,

"inflated_price_of_current_price": 80,

"inflated_price_of_original_price": 80

}

],

"model_sku": "1123",

"pre_order": {

"is_pre_order": false,

"days_to_ship": 3

},

"stock_info_v2": {

"summary_info": {

"total_reserved_stock": 0,

"total_available_stock": 300

},

"seller_stock": [

{

"location_id": "SG000005Z",

"stock": 100

},

{

"location_id": "SG000006Z",

"stock": 100

},

{

"location_id": "SG000007Z",

"stock": 100

},

{

"location_id": "SGZ",

"stock": 100

}

]

}

]

}

In Summary:

  1. It can be seen that "total_available_stock" will not contain the stock of SG000007Z warehouse. While a warehouse is in holiday mode, sellers can still modify this warehouse's stock, but buyers won't be able to see it.

  2. When calling the "v2.product.update_stock" API to modify the stock, it is necessary to ensure that the stock of all the "location_id" is uploaded, otherwise the API will return an error. Sellers can view all "location_id" through the "v2.shop.get_warehouse_detail" API.

  3. When the seller has set up multiple warehouses, "seller_stock" must be used to modify the stock, otherwise the API will return an error.

#