| API名称 | 获取库存 |
| 描述 | 获取产品当前已上架库存 |
| URL | http://www.mgoship.com/api.php?op=storage&mod=stock&action=get_stock |
| 接口测试 | http://test.mgoship.com/api.php?op=storage&mod=stock&action=get_stock |
| 数据格式 | JSON |
| 方法 | HTTP POST |
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| params | 以下为params的子节点 | 是 | |
| -| storageid | int | 否 | 填写仓库编码：1.门真仓库、2.箕面仓库、3.东京5号、4.东京仓库、5.青海仓库，不赋值获取所有仓库库存 |
| -| goodsId | int | 否 | 产品编码,赋值可获取该编码产品当前库存 |
| -| subid | int | 否 | 子用户编号，赋值可获取该子用户当前库存 |
| -| sku | String | 否 | 产品SKU，赋值可获取该SKU产品当前库存 |
| -| page | int | 否 | 页码，如不传入默认为1，即第一页 |
| -| limit | int | 否 | 每页返回的条目数上限，如不传入默认为20,最大100 |
请求示例
{
"appid": "M10001",
"params": {
"goodsId": "",
"limit": "",
"page": "",
"sku": "",
"storageid": "1",
"subid": ""
},
"sign": "477249D2CDA1E30E6679A152895B8A5E583C08E9",
"version": "1.0"
}返回结果
| 名称 | 类型 | 说明 |
|---|---|---|
| status 状态参数 | ||
| code | string | API访问状态编码，如果成功返回"OK"，并返回结果字段，如果失败返回错误编码"ERROR"，并返回错误说明 |
| msg | string | 返回状态说明 |
| count | int | 本次访问所获取的记录数量 |
| total_count | int | 所有页面产品总数 |
| data 数据参数 | ||
| storageid | int | 仓库编码：1.门真仓库、2.箕面仓库、3.东京5号、4.东京仓库、5.東田仓库 |
| subid | int | 子用户编号 |
| goodsId | int | 产品编码 |
| sku | String | 产品SKU |
| weight | Numeric | 产品重量，单位kg |
| length | Numeric | 产品长度，单位cm |
| width | Numeric | 产品宽度，单位cm |
| height | Numeric | 产品高度，单位cm |
| e_title | string | 产品外文名 |
| num | Numeric | 当前在库数量 |
| freeze | Numeric | 已提交订单冻结数量 |
| available | Numeric | 当前可提交发货数量 |
| intime | int | 入库时间,Unix时间戳(Unix timestamp) |
结果示例
{
"status": {
"code": "OK",
"msg": "获取库存成功",
"count": "3",
"total_count": "3"
},
"data": [
{
"storageid": "1",
"subid": "1",
"goodsId": "1000100004",
"sku": "Z000INLO31",
"weight": "0.6",
"length": "21",
"width": "16",
"height": "14",
"e_title": "妊婦抱き枕",
"num": "3",
"freeze": "0",
"available": "3",
"intime": "1495882238"
},
{
"storageid": "1",
"subid": "1",
"goodsId": "1000100005",
"sku": "C000INLO31",
"weight": "1",
"length": "22",
"width": "12",
"height": "11",
"e_title": "レディースバッグ",
"num": "15",
"freeze": "3",
"available": "12",
"intime": "1495882238"
},
{
"storageid": "1",
"subid": "1",
"goodsId": "1000100002",
"sku": "T000INLO31",
"weight": "0.06",
"length": "15",
"width": "10",
"height": "3",
"e_title": "phone case",
"num": "6",
"freeze": "0",
"available": "6",
"intime": "1495882238"
}
]
}