指定商品分仓库存

提供精准的SKU库存查询能力，支持按发货区域和仓库ID筛选库存信息，返回结果包含商品基本信息及各区域的库存分布。

适用场景

按SKU查询商品在指定区域或仓库的库存

获取商品的基本信息（名称、图片、型号等）及库存详情

批量查询多个SKU的库存分布情况

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
skus	array	是	-	-	SKU列表，最多不超过20个
depot_ids	array	否	-	-	仓库ID列表，用于筛选指定仓库的库存
region_codes	array	否	-	标准国家二字码	发货国家二字码列表，用于筛选指定区域的库存

响应字段说明

成功响应（HTTP 200）

根字段

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

data对象字段（以SKU为键）

字段	类型	说明
id	integer	SKU的唯一ID
sku	string	SKU编码
model	string	商品型号
product_id	integer	关联的产品ID
name	string	商品名称
inventories	array	库存列表（按发货优先级排序）
product_image	string	产品主图URL
sku_image	string	SKU对应的图片URL

inventories数组字段

字段	类型	说明
delivery_region_id	integer	发货区域ID
delivery_region_name	string	发货区域名称（如：美国）
depot_name	string	仓库名称
depot_id	integer	仓库ID
depot_sort	string	仓库排序（按发货优先级）
qty	string	库存数量

调用示例

URL请求

请求示例

{
    "skus": [
        "cbsft114yy02-一盒12pcs",
        "bns214yx01-40ml",
        "aijy114yx01-10ml"
    ],
    "depot_ids": [],
    "region_codes": [
        "TG",
        "US"
    ]
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "aijy114yx01-10ml": {
            "id": 1137,
            "sku": "aijy114yx01-10ml",
            "model": "10ml",
            "product_id": 99,
            "name": "South Moon 艾草精油 身体按摩缓解疼痛疲劳塑形精油",
            "inventories": [
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "美国1仓",
                    "depot_id": 3,
                    "depot_sort": "1",
                    "qty": "0"
                },
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "美国2仓",
                    "depot_id": 11,
                    "depot_sort": "2",
                    "qty": "0"
                }
            ],
            "product_image": "https://oss.westmonth.com/westmonth/SKUDatum/old/aijy114yx01-10ml/mainpicture/aijy114yx01-10ml-002.jpg",
            "sku_image": "https://oss.westmonth.com/westmonth/SKUDatum/aijy114yx01/mainpicture/aijy114yx01-2002.jpg"
        },
        "bns214yx01-40ml": {
            "id": 1135,
            "sku": "bns214yx01-40ml",
            "model": "40ml",
            "product_id": 96,
            "name": "Jaysuing 玻尿酸护手精华 玻尿酸抗衰老护肤保湿精华液",
            "inventories": [
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "美国1仓",
                    "depot_id": 3,
                    "depot_sort": "1",
                    "qty": "0"
                },
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "美国2仓",
                    "depot_id": 11,
                    "depot_sort": "2",
                    "qty": "0"
                }
            ],
            "product_image": "https://oss.westmonth.com/westmonth/SKUDatum/old/bns214yx01-40ml/mainpicture/bns214yx01-40ml-001.jpg",
            "sku_image": "https://oss.westmonth.com/westmonth/SKUDatum/bns214yx01-40ml/mainpicture/bns214yx01-40ml-27691196.png"
        },
        "cbsft114yy02-一盒12pcs": {
            "id": 513,
            "sku": "cbsft114yy02-一盒12pcs",
            "model": "12pcs",
            "product_id": 100,
            "name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴",
            "inventories": [
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "美国1仓",
                    "depot_id": 3,
                    "depot_sort": "1",
                    "qty": "0"
                },
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "美国2仓",
                    "depot_id": 11,
                    "depot_sort": "2",
                    "qty": "0"
                }
            ],
            "product_image": "https://oss.westmonth.com/westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
            "sku_image": "https://oss.westmonth.com/westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg"
        }
    }
}

失败返回示例

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

错误处理

公共错误码

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

注意事项

skus参数为必填项，且最多支持20个SKU，超过数量会返回参数错误

region_codes参数需传入标准国家二字码（如：US代表美国，TG代表多哥）

库存列表（inventories）按仓库发货优先级排序，可直接用于判断发货顺序

若未传入depot_ids和region_codes参数，将返回该SKU在所有区域和仓库的库存信息

常见问题

Q1：如何筛选美国区域的库存？

A：在region_codes参数中传入["US"]，即可查询SKU在美国区域的库存信息。

Q2：返回结果中data的键是什么？

A：data的键为传入的SKU编码，如查询["cbsft114yy02-一盒12pcs", "bns214yx01-40ml"]，则data的键为这两个SKU。

Q3：inventories中的仓库排序依据是什么？

A：按仓库的发货优先级排序，优先级高的仓库排在前面，可作为发货选择的参考。

Q4：如何获取商品的图片信息？

A：通过返回结果中的product_image（产品主图）和sku_image（SKU图片）字段获取图片URL。

版本历史

版本	日期	修改说明
v1.0	2025-04-01	初始版本，支持按SKU、区域、仓库查询库存

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "aijy114yx01-10ml": {
            "id": 1137,
            "sku": "aijy114yx01-10ml",
            "model": "10ml",
            "product_id": 99,
            "name": "South Moon 艾草精油 身体按摩缓解疼痛疲劳塑形精油",
            "inventories": [
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "",
                    "depot_id": 0,
                    "depot_sort": "0",
                    "qty": "0"
                }
            ],
            "product_image": "https://westmonth/SKUDatum/old/aijy114yx01-10ml/mainpicture/aijy114yx01-10ml-002.jpg",
            "sku_image": "https://westmonth/SKUDatum/aijy114yx01/mainpicture/aijy114yx01-2002.jpg"
        },
        "bns214yx01-40ml": {
            "id": 1135,
            "sku": "bns214yx01-40ml",
            "model": "40ml",
            "product_id": 96,
            "name": "Jaysuing 玻尿酸护手精华 玻尿酸抗衰老护肤保湿精华液",
            "inventories": [
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "",
                    "depot_id": 0,
                    "depot_sort": "0",
                    "qty": "0"
                }
            ],
            "product_image": "https://westmonth/SKUDatum/old/bns214yx01-40ml/mainpicture/bns214yx01-40ml-001.jpg",
            "sku_image": ""
        },
        "cbsft114yy02-一盒12pcs": {
            "id": 513,
            "sku": "cbsft114yy02-一盒12pcs",
            "model": "12pcs",
            "product_id": 100,
            "name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴",
            "inventories": [
                {
                    "delivery_region_id": 3,
                    "delivery_region_name": "美国",
                    "depot_name": "",
                    "depot_id": 0,
                    "depot_sort": "0",
                    "qty": "0"
                }
            ],
            "product_image": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
            "sku_image": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg"
        }
    }
}

指定商品分仓库存

指定商品分仓库存

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何筛选美国区域的库存？

Q2：返回结果中data的键是什么？

Q3：inventories中的仓库排序依据是什么？

Q4：如何获取商品的图片信息？

版本历史

请求参数

请求示例代码

返回响应

指定商品分仓库存

指定商品分仓库存#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：如何筛选美国区域的库存？#

Q2：返回结果中data的键是什么？#

Q3：inventories中的仓库排序依据是什么？#

Q4：如何获取商品的图片信息？#

版本历史#

请求参数

请求示例代码

返回响应

指定商品分仓库存

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何筛选美国区域的库存？

Q2：返回结果中data的键是什么？

Q3：inventories中的仓库排序依据是什么？

Q4：如何获取商品的图片信息？

版本历史