v2.sbs.get_stock_aging
GET /api/v2/sbs/get_stock_aging
Get Seller Center Stock Aging page data
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/sbs/get_stock_aging
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Request Parameters
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| page_no | int32 | False | 1 | Specifies the page number of data to return in the current call. Starting from 1. if data is more than one page, the page_no can be some entry to start next call. If empty, the default value is 1. |
| page_size | int32 | False | 10 | Each result set is returned as a page of entries. Use the "page_size" filters to control the maximum number of entries to retrieve per page (i.e., per call), and the "page_no" to start next call. This integer value is used to specify the maximum number of entries to return in a single "page" of data. If empty, the default value is 10. The value should be between 1 and 100. |
| search_type | int32 | False | 2 | 1-Product Name;2-SKU ID;3-Variations;4-Item ID |
| keyword | string | False | bound with search_type | |
| whs_ids | string | False | IDL,IDG | split by comma |
| aging_storage_tag | int32 | False | 0 | 0-false;1-true |
| excess_storage_tag | int32 | False | 0 | 0-false;1-true |
| category_id | int64 | False | 100002 | L1-level product category ID. You need to call the get_category API to obtain the first-level category_id |
| whs_region | string | True | CN | BR、CN、ID、MY、MX、TH、TW、PH、VN、SG If do not pass, will get error "block by gateway due to invalid cid" |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | Indicate error type if hit error. Empty if no error happened. | |
| message | string | Indicate error details if hit error. Empty if no error happened. | |
| request_id | string | The identifier for an API request for error tracking. | |
| response | object | Detail informations you are querying. | |
| item_list | object[] | Data list of item sku | |
| warehouse_item_id | string | 900626943 | Warehouse item id; To indicate an unique item in a warehouse one warehouse item id can match with multiple shop_item_id For Global Item, warehouse_item_id=Global Item id For Local Item, shop_item_id=item_id |
| item_name | string | 跨境商品测试00002 - 1666171546 | item name |
| item_image | string | http://mms.img.susercontent.com/08b3fc410c8eaa7e3f52b06b486a8658 | item image |
| sku_list | object[] | Data list of mtsku | |
| mtsku_id | string | 900626943_15359982 | mtsku id |
| model_id | string | 15359982 | Warehouse model SKU ID For CB global items, this is equal to the global model_id. For local items, it differs from model_id; use shop_model_id to match the model_id |
| fulfill_mapping_mode | int32 | 1 | 0-Null;1-Bundle SKU;2-Parent SKU |
| model_name | string | Orange,Large | model name |
| barcode | string | 1231 | |
| whs_list | object[] | Info of whs | |
| whs_id | string | CNN | Whs id |
| qty_of_stock_age_one | int64 | 0 | 0-30Days |
| qty_of_stock_age_two | int64 | 0 | 31-60Days |
| qty_of_stock_age_three | int64 | 0 | 61-90Days |
| qty_of_stock_age_four | int64 | 0 | 91-120Days |
| qty_of_stock_age_five | int64 | 0 | 121-180Days |
| qty_of_stock_age_six | int64 | 0 | >180Days |
| excess_stock | int64 | 0 | expired stock |
| aging_storage_tag | int32 | 0 | |
| shop_sku_list | object[] | ||
| shop_sku_id | string | shop level sku_id shop_sku_id="item_id" _ "model_id" | |
| shop_item_id | string | shop_item_id="item_id" in Product Module For Global Item, warehouse_item_id=Global Item id For Local Item, shop_item_id=item_id | |
| shop_model_id | string | shop_model_id= item level model_id For Global Item, warehouse_item_id=Global Item id For Local Item, shop_item_id=item_id |
No Request Example Set.