baseproduct.md 20.2 KB

Raw Blame History Permalink



基础商品接口服务定义


新增基础商品接口


接口名： /platform/product/addBaseProduct


入参


属性名称
类型
例子
说明
是否必填


productSkn
Integer
51198438
产品SKN号
新增时不用赋值


productName
string
商品名称
产品名称
是


brandId
Short
1234
品牌ID
是


shopId
Short
1234
店铺ID
否


supplierId
Short
1234
供应商ID
否


maxSortId
Short
1234
产品一级分类ID
是


middleSortId
Short
1234
产品二级分类ID
是


smallSortId
Short
1234
产品三级分类ID
是


sortId
Short
1234
产品四级分类ID
否


gender
string
1
性别(1男、2女、3通用)
是


models
string
1111
款型
否


isLimited
string
Y
是否限量，Y：是，N：否
否


isAdvance
string
Y
是否预售，Y：是，N：否
否


isPromotionalGifts
string
Y
是否是促销礼品，Y：是，N：否
否


isSpecial
string
Y
是否特价，Y：是，N：否
否


attribute
Byte
1
商品属性(1普通、2赠品等)
是


retailPriceStr
String
100
零售价(市场价或吊牌价)
是


salesPriceStr
string
100
销售价
是


stock
Short
10
预售库存
否


expectArrivalTimeStr
string
2016-03-22 12:00:00
预计到货时间字符串
是


goodsYears
Short
2016
货品年
否


goodsSeason
Short
0
货品季，0:四季1:春2:夏3:秋4:冬5:春夏6:秋冬
否


productStyle
string
1
风格
否


productTag
string
商品话题短语
商品话题短语
否


grade
string
1
重点款型(是：1，否:0)
否


brandFolder
string
1111
品牌款型
否


isOutLets
string
'B'
'Y','N','B'  是否奥莱，默认品牌设置
否


isVip
string
'B'
是否VIP，Y：开启，N：关闭，B：品牌设置
否


factoryCode
string
1111
厂家编号
否


ageLevel
string
1
年龄层(1成人 2大童 3小童 逗号分隔)
否


isLimitbuy
string
Y
是否限购，Y：限购，N：非限购
否


expectShelfTimeStr
string
2016-03-22 12:00:00
预计上架时间字符串
否


seasons
string
1
适销季
否


isSupplied
string
1
是否补货 1可补货，2不可补货 3部分可补货
否


founder
Integer
111
创建人id
是


baseGoodInfoStr
string
1
商品goods信息，传字符串，接口层再json解析
是


productStandardRelationStr
string
1
商品非销售属性，传字符串，接口层再json解析
否


接口接收消息体

BaseProductBO [
productName=SIP牛仔裤, 
brandId=1527, 
shopId=601, 
supplierId=0, 
maxSortId=3, 
middleSortId=27, 
smallSortId=130, 
gender=1, 
isLimited=N, 
isPromotionalGifts=N, 
attribute=1, 
retailPriceStr=299, 
salesPriceStr=299, 
goodsYears=2016, 
goodsSeason=0, 
grade=0, 
factoryCode=5699, 
ageLevel=2|3, 
isLimitbuy=N, 
expectShelfTimeStr=2016-03-23 00:00:00, 
yohoCoin=0, 
baseGoodInfoStr=[{"factoryCode":"限售关心","goodsColorImage":"","goodsName":"蓝色(+)","colorId":7,"goodsSizeList":[{"sizeId":"327","salePrice":"299","barCode":"","isSuppled":"N","presaleStorageNum":"","sizeName":"120"},{"sizeId":"343","salePrice":"299","barCode":"","isSuppled":"N","presaleStorageNum":"","sizeName":"150"}],"factoryGoodsName":"蓝色"}]
]


接口返回消息体

BaseProductBO [productSkn=51198426, productName=SIP牛仔裤, productImageUrl=null, cnAlphabet=SIPniuziku, brandId=1527, brandName=null, shopId=601, shopName=null, supplierId=0, supplierName=null, isJit=N, maxSortId=3, middleSortId=27, smallSortId=130, sortId=0, sizeMaxSortId=null, maxSortName=null, sizeMiddleSortId=null, middleSortName=null, sizeSmallSortId=null, smallSortName=null, seriesId=0, gender=1, models=null, material=null, style=null, styleList=null, pattern=null, patternList=null, isLimited=N, isAdvance=null, isMainPush=null, isPromotionalGifts=N, isSpecial=null, isSales=null, isRetrieval=null, isDown=null, attribute=1, remarks=null, replenishmentFactor=null, soldoutRate=null, retailPrice=299, retailPriceStr=299, salesPrice=299, salesPriceStr=299, stock=null, stockoutRate=null, expectArrivalTime=null, expectArrivalTimeStr=null, goodsYears=2016, goodsSeason=0, productStyle=null, productElements=null, productTag=null, grade=0, brandFolder=null, isAuditing=null, isOutLets=null, isVip=null, factoryCode=5699, ageLevel=2|3, isLimitbuy=N, limitStartTime=null, limitStartTimeStr=null, limitEndTime=null, limitEndTimeStr=null, expectShelfTime=1458662400, expectShelfTimeStr=2016-03-23 00:00:00, seasons=null, salableTime=null, yohoCoin=0, isSupplied=null, createTime=null, founder=2794, founderName=null, editId=null, editName=null, editTime=null, auditPassId=null, auditPassName=null, auditPassTime=null, auditFailId=null, auditFailName=null, auditFailTime=null, status=null, baseGoodList=[BaseGoodBO [productSkc=336337, productSkn=51198426, goodsName=蓝色(+), goodsColorImage=, colorId=7, modelCode=null, isDefault=null, createTime=null, factoryCode=限售关心, updateTime=null, status=null, goodsSizeList=[BaseSingleBo [productSku=1047533, productSkn=51198426, productSkc=336337, marketPrice=null, salePrice=299, factoryCode=null, storageNum=null, sizeId=327, sizeName=120, isSuppled=N, barCode=, createTime=null, updateTime=null, status=null], BaseSingleBo [productSku=1047534, productSkn=51198426, productSkc=336337, marketPrice=null, salePrice=299, factoryCode=null, storageNum=null, sizeId=343, sizeName=150, isSuppled=N, barCode=, createTime=null, updateTime=null, status=null]], goodsImagesList=null]], baseGoodInfoStr=[{"factoryCode":"限售关心","goodsColorImage":"","goodsName":"蓝色(+)","colorId":7,"goodsSizeList":[{"sizeId":"327","salePrice":"299","barCode":"","isSuppled":"N","presaleStorageNum":"","sizeName":"120"},{"sizeId":"343","salePrice":"299","barCode":"","isSuppled":"N","presaleStorageNum":"","sizeName":"150"}],"factoryGoodsName":"蓝色"}], rejectReason=null, operateInfo=null]


查看基础商品列表接口


接口名： /platform/product/getBaseProductList


入参


属性名称
类型
例子
说明
是否必填


productSkn
Integer
51198438
产品SKN号
否


productName
string
商品名称
产品名称
否


brandId
Short
1234
品牌ID
否


shopId
Short
1234
店铺ID
否


supplierId
Short
1234
供应商ID
否


maxSortId
Short
1234
产品一级分类ID
否


middleSortId
Short
1234
产品二级分类ID
否


smallSortId
Short
1234
产品三级分类ID
否


sortId
Short
1234
产品四级分类ID
否


gender
string
1
性别(1男、2女、3通用)
否


isLimited
string
Y
是否限量，Y：是，N：否
否


isAdvance
string
Y
是否预售，Y：是，N：否
否


isPromotionalGifts
string
Y
是否是促销礼品，Y：是，N：否
否


isOutLets
string
'B'
'Y','N','B'  是否奥莱，默认品牌设置
否


isVip
string
'B'
是否VIP，Y：开启，N：关闭，B：品牌设置
否


ageLevel
string
1
年龄层(1成人 2大童 3小童 逗号分隔)
否


isLimitbuy
string
Y
是否限购，Y：限购，N：非限购
否


founderName
String
111
创建人名称
否


page
int
1
当前页
是


size
int
10
每页显示条数
是


接口接收消息体

[supplierId=,productSkn=,productName=,founder=,shopId=,brandId=,isOutLets=,isAdvance=,gender=,maxSortId=,middleSortId=,smallSortId=,sortId=,isJit=,isAuditing=,page=1,size=10,start=0]


接口返回消息体

{
  "code": 200,
  "data": {
    "list": [
      {
        "ageLevel": "1",
        "attribute": 1,
        "auditFailTime": 0,
        "auditPassId": 2794,
        "auditPassName": "wxtest1",
        "auditPassTime": 1458647086,
        "baseGoodList": [
          {
            "colorId": 90,
            "createTime": 1458647027,
            "factoryCode": "1221",
            "factoryGoodsName": "21",
            "goodsColorImage": "http://img12.static.yhbimg.com\goodsimg/2016/03/22/19/0257a05ae92dd665f3a42894a4e7135896.jpg",
            "goodsName": "jpgs(+)",
            "goodsSizeList": [
              {
                "barCode": "12",
                "createTime": 1458647027,
                "isSuppled": "N",
                "marketPrice": 21,
                "presaleStorageNum": 0,
                "productSkc": 336352,
                "productSkn": 51198439,
                "productSku": 1047563,
                "salePrice": 21,
                "sizeId": 267,
                "updateTime": 1458647027
              }
            ],
            "productSkc": 336352,
            "productSkn": 51198439,
            "updateTime": 1458647027
          }
        ],
        "brandFolder": 0,
        "brandId": 1555,
        "brandName": "请不要用我的品牌，谢谢",
        "createTime": 1458647027,
        "editTime": 1458647027,
        "expectArrivalTime": 0,
        "expectShelfTime": 1458595500,
        "factoryCode": "",
        "founder": 2794,
        "founderName": "wxtest1",
        "gender": "1",
        "goodsSeason": 0,
        "goodsYears": 2016,
        "grade": "0",
        "isAdvance": "N",
        "isAuditing": 200,
        "isJit": "N",
        "isLimitbuy": "N",
        "isLimited": "N",
        "isMainPush": "N",
        "isOutLets": "B",
        "isPromotionalGifts": "N",
        "isSupplied": 2,
        "isVip": "B",
        "limitEndTime": 0,
        "limitStartTime": 0,
        "maxSortId": 1,
        "maxSortName": "上衣",
        "middleSortId": 12,
        "middleSortName": "衬衫",
        "operateInfo": "wxtest1 2016-03-22 19:44:46",
        "productName": "请不要用我的品牌，谢谢衬衫",
        "productSkn": 51198439,
        "productTag": "12122121",
        "rejectReason": "",
        "retailPrice": 21,
        "salesPrice": 21,
        "seasons": "",
        "seriesId": 0,
        "shopId": 0,
        "sizeMaxSortId": 0,
        "sizeMiddleSortId": 0,
        "sizeSmallSortId": 0,
        "smallSortId": 115,
        "smallSortName": "衬衫",
        "sortId": 0,
        "supplierId": 0,
        "yohoCoin": 0
      }
    ],
    "page": 1,
    "size": 10,
    "total": 119,
    "totalPage": 12
  },
  "md5": "23163c6c8ac58fc85f9cad364c165483",
  "message": "获取列表成功."
}


查看基础商品详情接口


接口名： /platform/product/getBaseProduct


入参


属性名称
类型
例子
说明
是否必填


productSkn
Integer
51198438
产品SKN号
是


接口接收消息体

[productSkn=51198438]


接口返回消息体

{
  "code": 200,
  "data": {
    "ageLevel": "1",
    "attribute": 1,
    "auditFailTime": 0,
    "auditPassId": 2794,
    "auditPassTime": 1458638622,
    "baseGoodList": [
      {
        "colorId": 8,
        "createTime": 1458638679,
        "factoryCode": "111",
        "factoryGoodsName": "111",
        "goodsColorImage": "",
        "goodsName": "紫色(+)",
        "goodsSizeList": [
          {
            "barCode": "11",
            "createTime": 1458638679,
            "isSuppled": "N",
            "marketPrice": 111,
            "presaleStorageNum": 0,
            "productSkc": 336351,
            "productSkn": 51198438,
            "productSku": 1047562,
            "salePrice": 11,
            "sizeId": 32,
            "sizeName": "15寸pro",
            "updateTime": 1458638708
          }
        ],
        "productSkc": 336351,
        "productSkn": 51198438,
        "updateTime": 1458638708
      }
    ],
    "brandId": 1504,
    "brandName": "胖头鱼骨汤",
    "createTime": 1458638677,
    "editId": 2794,
    "editTime": 1458638612,
    "expectArrivalTime": 0,
    "expectShelfTime": 1457884800,
    "expectShelfTimeStr": "2016-03-14 00:00:00",
    "founder": 2794,
    "gender": "1",
    "goodsSeason": 0,
    "goodsYears": 2016,
    "grade": "0",
    "isAuditing": 200,
    "isJit": "Y",
    "isLimitbuy": "N",
    "isLimited": "N",
    "isPromotionalGifts": "N",
    "limitEndTime": 0,
    "limitStartTime": 0,
    "maxSortId": 241,
    "maxSortName": "数码周边",
    "middleSortId": 242,
    "middleSortName": "数码配件",
    "productName": "胖头鱼骨汤数码配件",
    "productSkn": 51198438,
    "productStandardRelationBoList": [
      {
        "productId": 51198438,
        "productSkn": 51198438,
        "standardId": 32,
        "standardType": 1,
        "standardVal": "制作工艺2"
      }
    ],
    "rejectReason": "",
    "retailPrice": 111,
    "retailPriceStr": "111.00",
    "salesPrice": 111,
    "salesPriceStr": "111.00",
    "seriesId": 0,
    "shopId": 587,
    "shopName": "水产市场",
    "sizeMaxSortId": 0,
    "sizeMiddleSortId": 0,
    "sizeSmallSortId": 0,
    "smallSortId": 243,
    "smallSortName": "数码配件",
    "sortId": 0,
    "supplierId": 1388,
    "supplierName": "预生产环境",
    "yohoCoin": 0
  },
  "md5": "79dafee0ee070b9b7fbae52f7b1648bc",
  "message": "查看基础商品"
}


修改基础商品接口（审核前修改、审核后修改）


接口名： /platform/product/updateBaseProduct


入参


属性名称
类型
例子
说明
是否必填


productSkn
Integer
51198438
产品SKN号
是


productName
string
商品名称
产品名称
是


brandId
Short
1234
品牌ID
是


shopId
Short
1234
店铺ID
否


supplierId
Short
1234
供应商ID
否


maxSortId
Short
1234
产品一级分类ID
是


middleSortId
Short
1234
产品二级分类ID
是


smallSortId
Short
1234
产品三级分类ID
是


sortId
Short
1234
产品四级分类ID
否


gender
string
1
性别(1男、2女、3通用)
是


models
string
1111
款型
否


isLimited
string
Y
是否限量，Y：是，N：否
否


isAdvance
string
Y
是否预售，Y：是，N：否
否


isPromotionalGifts
string
Y
是否是促销礼品，Y：是，N：否
否


isSpecial
string
Y
是否特价，Y：是，N：否
否


attribute
Byte
1
商品属性(1普通、2赠品等)
是


retailPriceStr
String
100
零售价(市场价或吊牌价)
是


salesPriceStr
string
100
销售价
是


stock
Short
10
预售库存
否


expectArrivalTimeStr
string
2016-03-22 12:00:00
预计到货时间字符串
是


goodsYears
Short
2016
货品年
否


goodsSeason
Short
0
货品季，0:四季1:春2:夏3:秋4:冬5:春夏6:秋冬
否


productStyle
string
1
风格
否


productTag
string
商品话题短语
商品话题短语
否


grade
string
1
重点款型(是：1，否:0)
否


brandFolder
string
1111
品牌款型
否


isOutLets
string
'B'
'Y','N','B'  是否奥莱，默认品牌设置
否


isVip
string
'B'
是否VIP，Y：开启，N：关闭，B：品牌设置
否


factoryCode
string
1111
厂家编号
否


ageLevel
string
1
年龄层(1成人 2大童 3小童 逗号分隔)
否


isLimitbuy
string
Y
是否限购，Y：限购，N：非限购
否


expectShelfTimeStr
string
2016-03-22 12:00:00
预计上架时间字符串
否


seasons
string
1
适销季
否


isSupplied
string
1
是否补货 1可补货，2不可补货 3部分可补货
否


founder
Integer
111
创建人id
是


baseGoodInfoStr
string
1
商品goods信息，传字符串，接口层再json解析
是


productStandardRelationStr
string
1
商品非销售属性，传字符串，接口层再json解析
否


接口接收消息体

BaseProductBO [productSkn=51198426, productName=SIP牛仔裤, productImageUrl=null, cnAlphabet=null, brandId=1527, brandName=null, shopId=601, shopName=null, supplierId=0, supplierName=null, isJit=null, maxSortId=3, middleSortId=27, smallSortId=130, sortId=null, sizeMaxSortId=null, maxSortName=null, sizeMiddleSortId=null, middleSortName=null, sizeSmallSortId=null, smallSortName=null, seriesId=null, gender=1, models=null, material=null, style=null, styleList=null, pattern=null, patternList=null, isLimited=N, isAdvance=null, isMainPush=null, isPromotionalGifts=N, isSpecial=null, isSales=null, isRetrieval=null, isDown=null, attribute=1, remarks=null, replenishmentFactor=null, soldoutRate=null, retailPrice=null, retailPriceStr=299.00, salesPrice=null, salesPriceStr=299.00, stock=null, stockoutRate=null, expectArrivalTime=null, expectArrivalTimeStr=null, goodsYears=2016, goodsSeason=0, productStyle=null, productElements=null, productTag=null, grade=0, brandFolder=null, isAuditing=100, isOutLets=null, isVip=null, factoryCode=5699, ageLevel=2|3, isLimitbuy=N, limitStartTime=null, limitStartTimeStr=null, limitEndTime=null, limitEndTimeStr=null, expectShelfTime=null, expectShelfTimeStr=2016-03-23 00:00:00, seasons=null, salableTime=null, yohoCoin=0, isSupplied=null, createTime=null, founder=null, founderName=null, editId=null, editName=null, editTime=null, auditPassId=null, auditPassName=null, auditPassTime=null, auditFailId=null, auditFailName=null, auditFailTime=null, status=null, baseGoodList=null, baseGoodInfoStr=[{"colorId":7,"createTime":1458614538,"factoryCode":"限售关心","factoryGoodsName":"蓝色","goodsColorImage":"http://img13.static.yhbimg.com/goodsimg/2016/03/22/10/02a42a8612000501d9470dc01e54e8e110.jpg","goodsName":"蓝色(+)","goodsSizeList":[{"barCode":"","createTime":1458614538,"isSuppled":"N","marketPrice":299,"presaleStorageNum":0,"productSkc":336337,"productSkn":51198426,"productSku":1047533,"salePrice":299,"sizeId":327,"sizeName":"120","updateTime":1458614538},{"barCode":"","createTime":1458614538,"isSuppled":"N","marketPrice":299,"presaleStorageNum":0,"productSkc":336337,"productSkn":51198426,"productSku":1047534,"salePrice":299,"sizeId":343,"sizeName":"150","updateTime":1458614538}],"productSkc":336337,"productSkn":51198426,"updateTime":1458614538,"num":0,"rowid":"wqt_NaN_0","_index":0}], rejectReason=null, operateInfo=null]


接口返回消息体

BaseProductBO [productSkn=51198426, productName=SIP牛仔裤, productImageUrl=null, cnAlphabet=null, brandId=1527, brandName=null, shopId=601, shopName=null, supplierId=0, supplierName=null, isJit=null, maxSortId=3, middleSortId=27, smallSortId=130, sortId=null, sizeMaxSortId=null, maxSortName=null, sizeMiddleSortId=null, middleSortName=null, sizeSmallSortId=null, smallSortName=null, seriesId=null, gender=1, models=null, material=null, style=null, styleList=null, pattern=null, patternList=null, isLimited=N, isAdvance=null, isMainPush=null, isPromotionalGifts=N, isSpecial=null, isSales=null, isRetrieval=null, isDown=null, attribute=1, remarks=null, replenishmentFactor=null, soldoutRate=null, retailPrice=null, retailPriceStr=299.00, salesPrice=null, salesPriceStr=299.00, stock=null, stockoutRate=null, expectArrivalTime=null, expectArrivalTimeStr=null, goodsYears=2016, goodsSeason=0, productStyle=null, productElements=null, productTag=null, grade=0, brandFolder=null, isAuditing=100, isOutLets=null, isVip=null, factoryCode=5699, ageLevel=2|3, isLimitbuy=N, limitStartTime=null, limitStartTimeStr=null, limitEndTime=null, limitEndTimeStr=null, expectShelfTime=null, expectShelfTimeStr=2016-03-23 00:00:00, seasons=null, salableTime=null, yohoCoin=0, isSupplied=null, createTime=null, founder=null, founderName=null, editId=null, editName=null, editTime=null, auditPassId=null, auditPassName=null, auditPassTime=null, auditFailId=null, auditFailName=null, auditFailTime=null, status=null, baseGoodList=null, baseGoodInfoStr=[{"colorId":7,"createTime":1458614538,"factoryCode":"限售关心","factoryGoodsName":"蓝色","goodsColorImage":"http://img13.static.yhbimg.com/goodsimg/2016/03/22/10/02a42a8612000501d9470dc01e54e8e110.jpg","goodsName":"蓝色(+)","goodsSizeList":[{"barCode":"","createTime":1458614538,"isSuppled":"N","marketPrice":299,"presaleStorageNum":0,"productSkc":336337,"productSkn":51198426,"productSku":1047533,"salePrice":299,"sizeId":327,"sizeName":"120","updateTime":1458614538},{"barCode":"","createTime":1458614538,"isSuppled":"N","marketPrice":299,"presaleStorageNum":0,"productSkc":336337,"productSkn":51198426,"productSku":1047534,"salePrice":299,"sizeId":343,"sizeName":"150","updateTime":1458614538}],"productSkc":336337,"productSkn":51198426,"updateTime":1458614538,"num":0,"rowid":"wqt_NaN_0","_index":0}], rejectReason=null, operateInfo=null]


批量审核通过基础商品


接口名： /platform/product/batchAuditPassBaseProduct


入参


属性名称
类型
例子
说明
是否必填


productSkn
Integer
51198438
产品SKN号
是


接口接收消息体

ProductSknStatusReq [productSknList=[51198427], targetStatus=null, rejectReason=null]


接口返回消息体