# 基础商品接口服务定义 --------------------- # 新增基础商品接口 > 接口名: `/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] ### 接口返回消息体 ```