# 基础商品接口服务定义
---------------------
# 新增基础商品接口
> 接口名： `/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=<null>,productSkn=<null>,productName=<null>,founder=<null>,shopId=<null>,brandId=<null>,isOutLets=<null>,isAdvance=<null>,gender=<null>,maxSortId=<null>,middleSortId=<null>,smallSortId=<null>,sortId=<null>,isJit=<null>,isAuditing=<null>,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]
### 接口返回消息体
```