| API名称 |
获取库存 |
| 描述 |
获取产品当前已上架库存 |
| URL |
https://www.mgoship.com/api.php?op=storage&mod=stock&action=get_stock |
| 接口测试 |
https://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"
}
]
}
