来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [Important]Old stock fields will be deprecated soon
Dear developer,
Please note the following changes:
We will deprecate the old stock fields (please click here for the previous related announcement), so please switch to use the new stock fields before October 15th to avoid errors when you call the APIs. Please refer to the following table for the APIs and fields that you need to adjust:
| API | Old stock field (request parameter) | New stock field (request parameter) |
|---|---|---|
| v2.product.add_item | normal_stock | seller_stock |
| v2.product.init_tier_variation | normal_stock | seller_stock |
| v2.product.add_model | normal_stock | seller_stock |
| v2.product.update_stock | normal_stock | seller_stock |
| API | Old stock field (response parameter) | New stock field (response parameter) |
|---|---|---|
| v2.product.add_item | stock_info | seller_stock |
| v2.product.init_tier_variation | stock_info | seller_stock |
| v2.product.add_model | stock_info | seller_stock |
| v2.product.update_stock | normal_stock | stock & location_id |
| v2.product.get_item_base_info | stock_info | stock_info_v2 |
| v2.product.get_model_list | stock_info | stock_info_v2 |
| v2.product.get_item_promotion | reserved_stock_info | promotion_stock_info_v2 |
Please note our plans:
- From September 15th to October 15th: If the request parameter contains the old stock field, the APIs will prompt in the warning response parameter, and the stock upload is still successful.
Warning message: Normal_stock will be offline under Oct 15th, please switch to a new field seller_stock as soon as possible.
- From October 16th to October 31st: If the request parameter contains the old stock field, the APIs will prompt in the error response parameter, and the stock upload is unsuccessful.
Error message: Normal_stock is no longer available, please switch to the new field stock list.
- On November 1st: Request parameters and response parameters of old stock field will be permanently deprecated.
尊敬的开发者，
请留意以下变动：
我们将要弃用旧库存字段（之前的相关公告请点击这里），请您在10月15号前完成新库存字段的切换，避免您调用接口出现报错。调整涉及的接口和字段请看下列表格：
| 接口 | 旧库存字段名（请求参数） | 新库存字段名（请求参数） |
|---|---|---|
| v2.product.add_item | normal_stock | seller_stock |
| v2.product.init_tier_variation | normal_stock | seller_stock |
| v2.product.add_model | normal_stock | seller_stock |
| v2.product.update_stock | normal_stock | seller_stock |
| 接口 | 旧库存字段（返回参数） | 新库存字段（返回参数） |
|---|---|---|
| v2.product.add_item | stock_info | seller_stock |
| v2.product.init_tier_variation | stock_info | seller_stock |
| v2.product.add_model | stock_info | seller_stock |
| v2.product.update_stock | normal_stock | stock & location_id |
| v2.product.get_item_base_info | stock_info | stock_info_v2 |
| v2.product.get_model_list | stock_info | stock_info_v2 |
| v2.product.get_item_promotion | reserved_stock_info | promotion_stock_info_v2 |
请注意我们的下线计划：
9月15号～10月15号：如果请求参数包含旧库存字段，API将会在返回参数中的warning字段中提示，此时库存上传仍然成功。
warning提示：Normal_stock will be offline under Oct 15th, please switch to a new field seller_stock as soon as possible.
10月16号～10月31号：如果请求参数包含旧库存字段，API将会在返回参数中的error字段中提示，此时库存上传不成功。
error提示：Normal_stock is no longer available, please switch to the new field stock list.
11月1号：所有旧库存字段的请求参数和返回参数将弃用和移除。