platform / yohobuy-doc · Files

Go to a project
purchase_allocation.md 9.53 KB

说明：对外接口需要通过portal-gateway透传到服务，公共参数 client_type和client_secret

1.portal-gateway统一入参为key为params，value为按接口文档入参要求封装一个java对象，使用fastjson转换为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.接口采用post方式提交

5.开发服务器：http://192.168.102.210:8080/portal-gateway

6.测试服务器：http://192.168.102.47:8080/portal-gateway

门店可卖上架商品接口服务定义

1.平台端调拨管理：上架，线下可售（品牌经理只能看到自己所管品牌skn,列表只能看到自己申请的调拨单，包括商品总监）

接口名： /PurchaseAllocationController/allocationSaleProductList

入参

属性名称 类型 例子 说明 是否必填
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 每页条数(默认一页10条 ) 否

返回


{
  "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.线下店调拨管理：上架，线下可售，本店可售，品牌绑定货架（列表只能看到本门店申请的调拨单）

接口名： /PurchaseAllocationController/allocationSaleProductListShelves

入参

属性名称 类型 例子 说明 是否必填
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 每页条数(默认一页10条 ) 否

返回


{
  "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": "操作成功"
}

3.批量插入商品调拨审核表

接口名： /PurchaseAllocationController/saveProductAllocationAudits

入参

[
    {
        //产品SKN
        "productSkn": 50018921,
        //产品SKU
        "productSku": 102102,
        // 仓库ID
        "warehouseId": 12,
        // 0、调拨审核不通过的商品  1、调拨审核通过的商品
        "status": 1
    },
    {
        "productSkn": 50001383,
        "productSku": 102117,
        "warehouseId": 12,
        "status": 1
    }
]
属性名称 类型 例子 说明 是否必填
无 json数组 是

返回

{
  "code": 200,
  "data": 2,
  "message": "success."
}

4.判读一个或多个SKN，是否是某个门店可卖的上架商品(平台端)

接口名： /PurchaseAllocationController/storeSaleProducts

入参

属性名称 类型 例子 说明 是否必填
warehouseId int 12 仓库id 否
productSkns json数组 [51198438,51198438] 多个SKN组成json数组 否

返回


{
  "code": 200,
  "data": {
    [
      {
       "productSkn":51198426,
       //0 不是门店可卖的上架商品 1 是门店可卖的上架商品
       "saleStatus":0 
      } 
    ]
  },
  "message": "操作成功"
}

5.判断一个或多个SKN，是否是某个门店可卖的上架商品并且品牌绑定了货架(线下店所有创建调拨单，里面的商品都要做这个验证)

接口名： /PurchaseAllocationController/storeSaleProductShelves

入参

属性名称 类型 例子 说明 是否必填
warehouseId int 12 仓库id 否
productSkns json数组 [51198438,51198438] 多个SKN组成json数组 否

返回

{
  "code": 200,
  "data": [
    {
      "productSkn": 50000072,
      //-1 是门店可卖的上架商品但是品牌没有绑定了货架 0 不是门店可卖的上架商品  1 是门店可卖的上架商品并且品牌绑定了货架
      "saleStatusShelf": 0
    },
    {
      "productSkn": 50023795,
      "saleStatusShelf": 1
    },
    {
      "productSkn": 51017656,
      "saleStatusShelf": 1
    }
  ],
  "message": "success."
}

6.查询商品的自动补货开关

接口名： /PurchaseAllocationController/queryProductReplenishSwitches

入参

属性名称 类型 例子 说明 是否必填
warehouseId int 12 仓库id 否
productSkns json数组 [51198438,51198438] 多个SKN组成json数组 否

返回


{
  "code": 200,
  "data": {
    [
      {
       "productSkn":51198426,
       //0 关闭 1 开启
       "replenishSwitch":0 
      } 
    ]
  },
  "message": "操作成功"
}

7.更新商品的自动补货开关

接口名： /PurchaseAllocationController/updateProductReplenishSwitches

入参

属性名称 类型 例子 说明 是否必填
warehouseId int 12 仓库id 否
productSknReplenishSwitches Json对象数组 [{"productSkn":51198426,"replenishSwitch":0 }] replenishSwitch 0 关闭 1 开启 否

返回


{
  "code": 200,
  "data": {
    //更新数量
    number：8 
  },
  "message": "操作成功"
}

8.线下门店可售的品牌列表

接口名： /PurchaseAllocationController/storeSaleBrandList

入参

属性名称 类型 例子 说明 是否必填
warehouseId int 12 仓库id 否

注意：线下可售 如果不传warehouseId，查询所有线下店可售的品牌列表，需要传递空的json对象{}

返回


{
  "code": 200,
  "data": {
    [
    "brandId":3240,
    "brandName":"品牌名称"
    ]
  },
  "message": "操作成功"
}

9.通过仓库ID获取门店ID

接口名： /StoreController/getStoreId

入参

属性名称 类型 例子 说明 是否必填
warehouseId int 12 仓库id 是

返回

{
  "code": 200,
  "message": "操作成功",
  "md5": null,
  "data": {
    "storeId": 66
  }
}