商品分仓库存列表

提供更精准的商品库存查询能力，支持查询SKU在各仓库下的具体库存数量，相比V1版本增加了仓库维度的库存信息。

适用场景

精确查询商品在各仓库的库存分布

按区域和仓库筛选商品库存

批量查询多个SKU的库存详情（含区域和仓库信息）

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/v2/inventory/query
测试环境：https://testing.westmonth.com/openapi/v2/inventory/query

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
depot_ids	array	否	-	-	仓库ID列表，最多不超过50个
skus	array	否	-	-	SKU列表，最多不超过20个，传此参数时不做分页
page	integer	否	1	-	页码，不填默认1
size	integer	否	50	最大100	每页显示数量，默认50，最大100

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	object	业务数据

data对象字段

字段	类型	说明
page	integer	当前页码
size	integer	每页展示数量
data_count	integer	总数据量
page_count	integer	总页数
has_next	boolean	是否有下一页（true：有，false：无）
list	array	库存信息列表

list数组字段

字段	类型	说明
sku	string	SKU编码
name	string	SKU商品名称
region_list	array	区域列表（按发货区域划分）

region_list数组字段

字段	类型	说明
region_name	string	区域名称（如：泰国、中国）
delivery_region_id	integer	发货区域ID
price	string	商品价格
depots	array	仓库列表（该区域下的仓库）

depots数组字段

字段	类型	说明
quantity	integer	该仓库下的商品库存数量
depot_id	integer	仓库ID
depot_name	string	仓库名称（如：泰国1仓、中国仓）

调用示例

URL请求

请求示例

{
    "skus": [
        "EEA02-A142-4-YE1",
        "EEA02-A143-20-VT1",
        "EEA02-A144-30-WH1"
    ],
    "page": 1,
    "size": 50,
    "depot_ids": [
        2,
        5
    ]
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "page": 0,
        "size": 0,
        "data_count": 3,
        "page_count": 0,
        "has_next": false,
        "list": [
            {
                "sku": "EEA02-A144-30-WH1",
                "name": "EELHOE 抗皱面部精华 淡斑补水抗皱防衰老精华",
                "region_list": [
                    {
                        "region_name": "泰国",
                        "delivery_region_id": 2,
                        "price": "10.50",
                        "depots": [
                            {
                                "quantity": 271,
                                "depot_id": 2,
                                "depot_name": "泰国1仓"
                            }
                        ]
                    },
                    {
                        "region_name": "中国",
                        "delivery_region_id": 5,
                        "price": 0,
                        "depots": [
                            {
                                "quantity": 0,
                                "depot_id": 5,
                                "depot_name": "中国仓"
                            }
                        ]
                    }
                ]
            },
            {
                "sku": "EEA02-A143-20-VT1",
                "name": "EELHOE 烟酰胺精华 护肤提拉淡斑抗皱精华",
                "region_list": [
                    {
                        "region_name": "泰国",
                        "delivery_region_id": 2,
                        "price": "7.50",
                        "depots": [
                            {
                                "quantity": 277,
                                "depot_id": 2,
                                "depot_name": "泰国1仓"
                            }
                        ]
                    }
                ]
            },
            {
                "sku": "EEA02-A142-4-YE1",
                "name": "EELHOE 维生素C眼霜棒 黑眼圈修护滋润紧致眼霜棒",
                "region_list": [
                    {
                        "region_name": "泰国",
                        "delivery_region_id": 2,
                        "price": "10.50",
                        "depots": [
                            {
                                "quantity": 889,
                                "depot_id": 2,
                                "depot_name": "泰国1仓"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

注意事项

当传入skus参数时，接口不进行分页，直接返回所有查询的SKU结果

若需分页查询，请勿传入skus参数，通过page和size控制分页

仓库ID可通过/openapi/depot/list接口获取

发货区域ID可通过/openapi/productCategory/getDeliveryRegions接口获取

常见问题

Q1：如何查询指定仓库的库存？

A：通过depot_ids参数传入目标仓库ID列表，如[2,5]，即可查询这些仓库的库存信息。

Q2：传入skus参数后，分页参数page和size是否生效？

A：不生效。当传入skus参数时，接口会返回所有查询的SKU结果，不进行分页。

Q3：region_list和depots的关系是什么？

A：region_list表示按发货区域划分的分组，每个区域下包含该区域内的仓库列表（depots），即一个区域可能包含多个仓库。

Q4：如何获取仓库ID和发货区域ID？

A：仓库ID可通过/openapi/depot/list接口获取，发货区域ID可通过/openapi/productCategory/getDeliveryRegions接口获取。

版本历史

版本	日期	修改说明
v2.0	2025-03-15	新增版本，支持仓库维度库存查询
v1.0	2025-01-01	初始版本，仅支持总库存查询

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "page": 0,
        "size": 0,
        "data_count": 3,
        "page_count": 0,
        "has_next": false,
        "list": [
            {
                "sku": "EEA02-A142-4-YE1",
                "name": "EELHOE 维生素C眼霜棒 黑眼圈修护滋润紧致眼霜棒",
                "region_list": [
                    {
                        "region_name": "泰国",
                        "delivery_region_id": 2,
                        "price": "8.50",
                        "depots": [
                            {
                                "quantity": 969,
                                "depot_id": 2,
                                "depot_name": "泰国1仓"
                            }
                        ]
                    }
                ]
            },
            {
                "sku": "EEA02-A143-20-VT1",
                "name": "EELHOE 烟酰胺精华 护肤提拉淡斑抗皱精华",
                "region_list": [
                    {
                        "region_name": "泰国",
                        "delivery_region_id": 2,
                        "price": "8.50",
                        "depots": [
                            {
                                "quantity": 301,
                                "depot_id": 2,
                                "depot_name": "泰国1仓"
                            }
                        ]
                    }
                ]
            },
            {
                "sku": "EEA02-A144-30-WH1",
                "name": "EELHOE 抗皱面部精华 淡斑补水抗皱防衰老精华",
                "region_list": [
                    {
                        "region_name": "泰国",
                        "delivery_region_id": 2,
                        "price": "8.50",
                        "depots": [
                            {
                                "quantity": 278,
                                "depot_id": 2,
                                "depot_name": "泰国1仓"
                            }
                        ]
                    },
                    {
                        "region_name": "中国",
                        "delivery_region_id": 5,
                        "price": "8.00",
                        "depots": [
                            {
                                "quantity": 0,
                                "depot_id": 5,
                                "depot_name": "中国仓"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

商品分仓库存列表

商品分仓库存列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何查询指定仓库的库存？

Q2：传入skus参数后，分页参数page和size是否生效？

Q3：region_list和depots的关系是什么？

Q4：如何获取仓库ID和发货区域ID？

版本历史

请求参数

请求示例代码

返回响应

商品分仓库存列表

商品分仓库存列表#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：如何查询指定仓库的库存？#

Q2：传入skus参数后，分页参数page和size是否生效？#

Q3：region_list和depots的关系是什么？#

Q4：如何获取仓库ID和发货区域ID？#

版本历史#

请求参数

请求示例代码

返回响应

商品分仓库存列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何查询指定仓库的库存？

Q2：传入skus参数后，分页参数page和size是否生效？

Q3：region_list和depots的关系是什么？

Q4：如何获取仓库ID和发货区域ID？

版本历史