purchase_allocation.md
5.79 KB
说明：对外接口需要通过portal-gateway透传到服务，公共参数 client_type和client_secret
1.portal-gateway统一入参为key为params，value为按接口文档入参要求封装一个java对象，用fastjson转一下，post方式提交,转换为json格式字符串。例如： params={"productSkns":[50000074,50000076],"warehouseId":12}）
2.北京服务调用南京服务client_type是yoho（android客户端，client_type是android），client_secret 是md5加密字符串。例如：params=json格式字符串和client_type=yoho对应盐值（fd4ad5fcsa0de589af23234ks1923ks）的md5加密字符串
3.形式为：params=json格式字符串&client_type=yoho&client_secret=md5加密字符串。例如：params={"productSkns":[50000074,50000076],"warehouseId":12}&client_type=yoho&client_secret=d488c0b90a68f881598253f75d0005ff）
4.开发服务器：http://192.168.102.210:8080/portal-gateway
5.测试服务器：http://192.168.102.47:8080/portal-gateway
门店可卖上架商品接口服务定义
1.门店可卖上架商品列表
接口名：
/PurchaseAllocationController/storeSaleProductList
入参
| 属性名称 | 类型 | 例子 | 说明 | 是否必填 |
|---|---|---|---|---|
| warehouseId | int | 12 | 仓库id | 否 |
| productSkns | json数组 | [51198438,51198438] | 多个SKN组成json数组 | 否 |
| productSkcs | json数组 | [3242,3240] | 多个SKC组成json数组 | 否 |
| productSkus | json数组 | [102011,102013] | 多个SKU组成json数组 | 否 |
| factoryCode | String | VN0003Z6KM2105000M | 条码(条码是sku条码) | 否 |
| maxSortId | Short | 1234 | 产品一级分类ID | 否 |
| middleSortId | Short | 1234 | 产品二级分类ID | 否 |
| smallSortId | Short | 1234 | 产品三级分类ID | 否 |
| sortId | Short | 1234 | 产品四级分类ID | 否 |
| brandIds | json数组 | [1234,1234] | 多个品牌ID组成json数组 | 否 |
| page | int | 1 | 第几页 | 否 |
| size | int | 20 | 每页条数 | 否 |
返回
{
"code": 200,
"data": {
"list": [
{
"productSkn":51198426,
"productSkc":3240,
"colorName":"颜色名称",
"productSku":102011,
"sizeName":"尺码名称",
"imageUrl": "http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg",
"productName":"牛仔裤",
"factoryCode":"VN0003Z6KM2105000M",
"brandName":"初语",
"maxSortName":"上衣",
"middleSortName":"T恤",
"smallSortName":"长袖T恤",
"sortName":"长袖T恤",
// 1 男 2 女 3 通用
"gender":1,
//0 关闭 1 开启
"replenishSwitch":0
}
],
"page": 1,
"size": 10,
"total": 79,
"totalPage": 8
},
"message": "操作成功"
}2.判读一个或多个SKN，是否是某个门店可卖的上架商品
接口名：
/PurchaseAllocationController/storeSaleProducts
入参
| 属性名称 | 类型 | 例子 | 说明 | 是否必填 |
|---|---|---|---|---|
| warehouseId | int | 12 | 仓库id | 否 |
| productSkns | json数组 | [51198438,51198438] | 多个SKN组成json数组 | 否 |
返回
{
"code": 200,
"data": {
[
{
"productSkn":51198426,
//0 不是门店可卖的上架商品 1 是门店可卖的上架商品
"saleStatus":0
}
]
},
"message": "操作成功"
}3.查询商品的自动补货开关
接口名：
/PurchaseAllocationController/queryProductReplenishSwitches入参
| 属性名称 | 类型 | 例子 | 说明 | 是否必填 |
|---|---|---|---|---|
| warehouseId | int | 12 | 仓库id | 否 |
| productSkns | json数组 | [51198438,51198438] | 多个SKN组成json数组 | 否 |
返回
{
"code": 200,
"data": {
[
{
"productSkn":51198426,
//0 关闭 1 开启
"replenishSwitch":0
}
]
},
"message": "操作成功"
}4.更新商品的自动补货开关
接口名：
/PurchaseAllocationController/updateProductReplenishSwitches
入参
| 属性名称 | 类型 | 例子 | 说明 | 是否必填 |
|---|---|---|---|---|
| warehouseId | int | 12 | 仓库id | 否 |
| productSknReplenishSwitches | Json对象 | [{"productSkn":51198426,"replenishSwitch":0 }] | replenishSwitch 0 关闭 1 开启 | 否 |
返回
{
"code": 200,
"data": {
//更新数量
number：8
},
"message": "操作成功"
}5.线下门店可售的品牌列表
接口名：
/PurchaseAllocationController/storeSaleBrandList
入参
| 属性名称 | 类型 | 例子 | 说明 | 是否必填 |
|---|---|---|---|---|
| warehouseId | int | 12 | 仓库id | 否 |
注意：线下可售
返回
{
"code": 200,
"data": {
[
"brandId":3240,
"brandName":"品牌名称"
]
},
"message": "操作成功"
}6.通过仓库ID获取门店ID
接口名：
/StoreController/getStoreId
入参
| 属性名称 | 类型 | 例子 | 说明 | 是否必填 |
|---|---|---|---|---|
| warehouseId | int | 12 | 仓库id | 是 |
返回
{
"code": 200,
"message": "操作成功",
"md5": null,
"data": {
"storeId": 66
}
}