## 商品 / **商品库存查询**（*oms.goods.inventory.query*）
###### 最后更新日期：**2024-04-10 12:00:00**
*****
### **API描述**
接入方调用该接口，进行商品查询。
*****
### **公共参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| app\_key | String(32) | 是 | 接入方AppKey，由平台对接人员提供 | |
| method | String(128) | 是 | 接口名称 | oms.goods.inventory.query |
| version | String(10) | 是 | 接口版本 | 1.0 |
| biz\_content | Text | 是 | 业务参数的集合，并以**JSON格式**表示，并做urlencode处理，最大长度不限 | |
| sign | String(32) | 是 | 请求参数签名值，参考【签名加密】 | |
### **biz\_content参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| goods_type | String | 是 | 商品类型：DISTRIBUTION-分销商品 | DISTRIBUTION |
| item\_id\_list | List \<String\> | 是 | 商品规格编码数组 |["B48970026","B48970064","B73502930"] |
```
biz_content参数原文样例：
{"goods_type":"DISTRIBUTION","item_id_list":["B48970026","B48970064","B73502930"]}
urlencode转码后：
%7B%22goods_type%22%3A%22DISTRIBUTION%22%2C%22item_id_list%22%3A%5B%22B48970026%22%2C%22B48970064%22%2C%22B73502930%22%5D%7D
```
*****
### **响应参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| code | Int| 是 | 响应代码（0为成功，非0有异常） | 0 |
| msg | String | 是 | 响应描述 | success |
| data | Object | 是 | 响应数据 | |
### **data参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| item_list | Object | 是 | 商品数据体 | |
### **item_list参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| goods\_sku | String | 是 | 商品规格编码 | B48970026 |
| sku\_name | String | 是 | 商品名称 | 益生菌胶囊 |
| good_quantity | Int | 是 | 良品数量 | 10 |
| lock_quantity | Int | 是 | 锁定数量 | 0 |
| available_quantity | Int | 是 | 可用数量（可用数量=良品数量-锁定数量） | 10 |
```
{
"code": 0,
"msg": "success",
"data": {
"item_list": [
{
"goods_sku": "B48970026",
"sku_name": "WONDERLAB女性益生菌胶囊30粒",
"good_quantity": 0,
"lock_quantity": 0,
"available_quantity": 0
},
{
"goods_sku": "B48970064",
"sku_name": "WONDERLAB男士多维片60粒",
"good_quantity": 128,
"lock_quantity": 0,
"available_quantity": 128
},
{
"goods_sku": "B73502930",
"sku_name": "BioGaia拜奥Gastrus咀嚼片30粒",
"good_quantity": 890,
"lock_quantity": 0,
"available_quantity": 890
},
{
"goods_sku": "B48970026",
"sku_name": "WONDERLAB女性益生菌胶囊30粒",
"good_quantity": 0,
"lock_quantity": 0,
"available_quantity": 0
},
{
"goods_sku": "B48970064",
"sku_name": "WONDERLAB男士多维片60粒",
"good_quantity": 128,
"lock_quantity": 0,
"available_quantity": 128
}
]
}
}
```
