匡佳华 / API-Interfaces · Files

1、新增基础商品

新增基础商品（/SellerProductController/addProduct)

请求参数

参数名称	参数类型	可否为空	示例	备注
productName	string	否	商品名称	最长100个字符
brandId	int	否	22	品牌的ID号
shopsId	int	否	22	店铺的ID号
maxSortId	int	否	1	一级品类的Id
middleSortId	int	否	22	二级品类的ID
smallSortId	int	否	33	三级品类的ID
gender	string	否	1	1代表男 2代表女 3代表通用
factoryCode	string	是	厂家编码	最长100个字符
retailPrice	double	否	188.00	吊牌价
salesPrice	double	否	188.00	销售价
goodsYears	int	否	2018	商品年
phrase	string	是	卖点	最长12个字符
goodsSeason	int	否	1	货品季 1代表春 2夏 3秋 4冬 5春夏 6秋冬
ageLevel	string	否	1	年龄层1成人2大童3小童 4中童 5幼童 多选用单竖线分隔
seasons	string	否	spring	适销季spring春秋summer夏 winter冬 seasons四季
sellerGoodsInfoStr	string	否	商品信息	json串
userId	int	否	222	登陆账号ID
expectSaleTimeStr	string	否	2017-12-02	上市日期
sellType	int	是	2	经营模式 2 代销入库 3 代销不入库JIT

商品颜色的参数说明

参数名称	参数类型	可否为空	示例	备注	默认值
factoryCode	string	是	款型编码	最长100个字符
factoryGoodsName	string	否	亚红色	最长5个字符
goodsName	string	否	红色	色系名称
colorId	int	否	22	色系ID
isDefault	string	否	Y	是否主推，不是则传N
goodsColorImage	string	否	图片的url	图片的绝对路径
goodsSizeList	string	是	JSON串	当前颜色下面尺码列表json

尺码的参数说明

参数名称	参数类型	可否为空	示例	备注	默认值
factoryCode	string	是	条码	最长100个字符
sizeId	int	是	22	尺码ID

注意，通用的头部没有列出。
请求示例 http://127.0.0.1:8088/platform/SellerProductController/addProduct

请求样例数据

请求样例：
{"productName":"商品名", "brandId":4, "shopsId":4, "maxSortId":12, "middleSortId" : 144, "smallSortId":145 , "gender" : "1", "retailPrice":"44.44", "salesPrice": "33.33", "phrase" :"商品卖点",
    "goodsYears":2019, "goodsSeason":1, "factoryCode":"厂家编号", "ageLevel":"1|2", "seasons":"1", "sellerGoodsInfoStr" : "[{\"factoryCode\":\"123123123\",\"factoryGoodsName\":\"蓝色1111\",\"goodsColorImage\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/02c52592f14a13be1014aa8c116b5d4e1c.jpg\",\"goodsName\":\"蓝色\",\"colorId\":36,\"goodsSizeList\":[{\"sizeId\":\"203\",\"factoryCode\":\"12dad%%\"},{\"sizeId\":\"207\",\"factoryCode\":\"adasd%%\"}],\"isDefault\":\"N\"},{\"factoryCode\":\"aas23123\",\"factoryGoodsName\":\"蓝色3333\",\"goodsColorImage\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/028adf5dd962895c11feb2fec8ef0c5b32.jpg\",\"goodsName\":\"蓝色\",\"colorId\":33,\"goodsSizeList\":[{\"sizeId\":\"207\",\"factoryCode\":\"asdasd$$\"},{\"sizeId\":\"203\",\"factoryCode\":\"##sdasd\"}],\"isDefault\":\"Y\"}]"
}
正常返回：
{
  "code": 200,
  "data": {
    "ageLevel": "1|2",
    "brandId": 4,
    "factoryCode": "厂家编号",
    "founder": 222,
    "gender": "1",
    "goodsSeason": 1,
    "goodsYears": 2019,
    "id": 508552,
    "maxSortId": 12,
    "middleSortId": 144,
    "phrase": "商品埋点",
    "productName": "商品名",
    "productSkn": 512587890,
    "retailPrice": 44.44,
    "salesPrice": 33.33,
    "seasons": "1",
    "sellerGoodList": [
      {
        "colorId": 36,
        "factoryCode": "123123123",
        "factoryGoodsName": "蓝色1111",
        "goodsColorImage": "http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/02c52592f14a13be1014aa8c116b5d4e1c.jpg",
        "goodsName": "蓝色",
        "goodsSizeList": [
          {
            "factoryCode": "12d1112ad%%",
            "goodsId": 671192,
            "marketPrice": 44.44,
            "productId": 508552,
            "productSkc": 680404,
            "productSkn": 512587890,
            "productSku": 2027106,
            "salePrice": 33.33,
            "sizeId": 203
          },
          {
            "factoryCode": "adas1122d%%",
            "goodsId": 671192,
            "marketPrice": 44.44,
            "productId": 508552,
            "productSkc": 680404,
            "productSkn": 512587890,
            "productSku": 2027108,
            "salePrice": 33.33,
            "sizeId": 207
          }
        ],
        "id": 671192,
        "isDefault": "N",
        "productId": 508552,
        "productSkc": 680404,
        "productSkn": 512587890
      },
      {
        "colorId": 33,
        "factoryCode": "aas23123",
        "factoryGoodsName": "蓝色3333",
        "goodsColorImage": "http://img13.static.yhbimg.com/goodsimg/2017/04/18/11/028adf5dd962895c11feb2fec8ef0c5b32.jpg",
        "goodsName": "蓝色",
        "goodsSizeList": [
          {
            "factoryCode": "asda12s12d$$",
            "goodsId": 671194,
            "marketPrice": 44.44,
            "productId": 508552,
            "productSkc": 680406,
            "productSkn": 512587890,
            "productSku": 2027110,
            "salePrice": 33.33,
            "sizeId": 207
          },
          {
            "factoryCode": "##s2d1a12sd",
            "goodsId": 671194,
            "marketPrice": 44.44,
            "productId": 508552,
            "productSkc": 680406,
            "productSkn": 512587890,
            "productSku": 2027112,
            "salePrice": 33.33,
            "sizeId": 203
          }
        ],
        "id": 671194,
        "isDefault": "Y",
        "productId": 508552,
        "productSkc": 680406,
        "productSkn": 512587890
      }
    ],
    "shopId": 948,
    "smallSortId": 145
  },
  "md5": "29528572780f49d50c36a09cc38ba0ab",
  "message": "商品添加成功."
}
异常返回：
{
    "code": 1001,
    "data": ["错误一", "错误二"],
    "md5": "d751713988987e9331980363e24189ce",
    "message": "参数校验错误"
}

2、新增基础商品以及网销扩展信息

新增基础商品以及网销扩展信息（/SellerProductController/addProductEx)

请求参数

参数名称	参数类型	可否为空	示例	备注
productName	string	否	商品名称	最长100个字符
brandId	int	否	22	品牌的ID号
shopsId	int	否	22	店铺的ID号
maxSortId	int	否	1	一级品类的Id
middleSortId	int	否	22	二级品类的ID
smallSortId	int	否	33	三级品类的ID
gender	string	否	1	1代表男 2代表女 3代表通用
factoryCode	string	是	厂家编码	最长100个字符
retailPrice	double	否	188.00	吊牌价
salesPrice	double	否	188.00	销售价
goodsYears	int	否	2018	商品年
phrase	string	是	卖点	最长12个字符
goodsSeason	int	否	1	货品季 1代表春 2夏 3秋 4冬 5春夏 6秋冬
ageLevel	string	否	1	年龄层1成人2大童3小童 4中童 5幼童 多选用单竖线分隔
seasons	string	否	spring	适销季spring春秋summer夏 winter冬 seasons四季
sellerGoodsInfoStr	string	否	商品信息	json串
userId	int	否	222	登陆账号ID
expectSaleTimeStr	string	否	2017-12-02	上市日期
sellType	int	是	2	经营模式 2 代销入库 3 代销不入库JIT
goodsImagesReqStr	string	否	图片信息	JSON格式的字符串
productStandardRelationStr	string	是	商品参数列表JSON字符串	JSON格式的字符串
attributeProValuesOne	string	是	舒适度四个、洗涤提示、材质	JSON格式字符串
attributeProValuesTwo	string	是	风格、图案纹理、工艺元素	JSON格式字符串
productMaterial	string	是	170,123	材质
productIntro	string	是	描述

商品颜色的参数说明

参数名称	参数类型	可否为空	示例	备注	默认值
factoryCode	string	是	款型编码	最长100个字符
factoryGoodsName	string	否	亚红色	最长5个字符
goodsName	string	否	红色	色系名称
colorId	int	否	22	色系ID
isDefault	string	否	Y	是否主推，不是则传N
goodsColorImage	string	否	图片的url	图片的绝对路径
goodsSizeList	string	是	JSON串	当前颜色下面尺码列表json

goodsImagesReqStr请求参数

参数名称	参数类型	可否为空	示例	备注
angle	int	否	0	暂定固定值都传0
genderCover	int	否	1	男生频道封面图传1 ;女生频道封面图 传2; 其他都传 0
imageUrl	string	否	图片信息	图片绝对路径
isDefault	string	否	如果是正面图传Y否则传N
orderBy	int	否	0	暂时都传0
factoryGoodsName	string	否	褐黄色	颜色展示名称
status	int	否	1	图片状态，暂时固定传1

尺码的参数说明

参数名称	参数类型	可否为空	示例	备注	默认值
factoryCode	string	是	条码	最长100个字符
sizeId	int	是	22	尺码ID

productStandardRelationStr请求参数

参数名称	参数类型	可否为空	示例	备注
standardId	int	否	918	商品参数ID
standardVal	string	否	帆布鞋	选择的参数属性值
parameterMakeId	int	否	4991	选择的参数属性ID

attributeProValuesOne、 attributeProValuesTwo 请求参数

参数名称	参数类型	可否为空	示例	备注
attributeId	int	否	918	商品参数ID
attributeValueId	int	否	4991	选择的参数属性ID

注意，通用的头部没有列出。
请求示例 http://127.0.0.1:8088/platform/SellerProductController/addProductEx

请求样例数据

请求样例：
{"productName":"商品名", "brandId":4, "shopsId":4, "maxSortId":12, "middleSortId" : 144, "smallSortId":145 , "gender" : "1", "retailPrice":"44.44", "salesPrice": "33.33", "phrase" :"商品卖点",
    "goodsYears":2019, "goodsSeason":1, "factoryCode":"厂家编号", "ageLevel":"1|2", "seasons":"1", "sellerGoodsInfoStr" : "[{\"factoryCode\":\"123123123\",\"factoryGoodsName\":\"蓝色1111\",\"goodsColorImage\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/02c52592f14a13be1014aa8c116b5d4e1c.jpg\",\"goodsName\":\"蓝色\",\"colorId\":36,\"goodsSizeList\":[{\"sizeId\":\"203\",\"factoryCode\":\"12dad%%\"},{\"sizeId\":\"207\",\"factoryCode\":\"adasd%%\"}],\"isDefault\":\"N\"},{\"factoryCode\":\"aas23123\",\"factoryGoodsName\":\"蓝色3333\",\"goodsColorImage\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/028adf5dd962895c11feb2fec8ef0c5b32.jpg\",\"goodsName\":\"蓝色\",\"colorId\":33,\"goodsSizeList\":[{\"sizeId\":\"207\",\"factoryCode\":\"asdasd$$\"},{\"sizeId\":\"203\",\"factoryCode\":\"##sdasd\"}],\"isDefault\":\"Y\"}]", 
    "goodsImagesReqStr" : "{\"goodsImagesBoList\":\"[{\"angle\":0,\"genderCover\":0,\"id\":1002976,\"imageUrl\":\"http://img13.static.yhbimg.com/goodsimg/2017/04/18/11/02c52592f14a13be1014aa8c116b5d4e1c.jpg\",\"isDefault\":\"Y\",\"orderBy\":0,\"factoryGoodsName\":\"蓝色3333\",\"status\":1},{\"angle\":0,\"genderCover\":0,\"id\":1002978,\"imageUrl\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/028adf5dd962895c11feb2fec8ef0c5b32.jpg\",\"isDefault\":\"Y\",\"orderBy\":0,\"factoryGoodsName\":\"蓝色1111\",\"status\":1}]\"}",
    "productStandardRelationStr" : "[{\"standardId\":918,\"standardVal\":\"帆布鞋\",\"parameterMakeId\":\"4991\"},{\"standardId\":735,\"standardVal\":\"印度尼西亚\",\"parameterMakeId\":\"3407\"},{\"standardId\":920,\"standardVal\":\"中\",\"parameterMakeId\":\"5005\"}]",
    "attributeProValuesOne" : "[{\"attributeId\":2001,\"attributeValueId\":\"2\"},{\"attributeId\":2002,\"attributeValueId\":\"4\"},{\"attributeId\":2003,\"attributeValueId\":\"4\"},{\"attributeId\":2004,\"attributeValueId\":\"3\"},{\"attributeId\":2005,\"attributeValueId\":\"1,2\"}]",
    "attributeProValuesTwo" : "[{\"attributeId\":\"17\",\"attributeValueId\":\"996,997\"},{\"attributeId\":\"31\",\"attributeValueId\":\"1,2\"},{\"attributeId\":\"118\",\"attributeValueId\":\"1,2\"}]",
    "productMaterial" : "2,9",
    "productIntro" : "商品描述"
}
正常返回：
{
  "code": 200,
  "data": {},
  "md5": "29528572780f49d50c36a09cc38ba0ab",
  "message": "商品添加成功."
}
异常返回：
{
    "code": 1001,
    "data": ["错误一", "错误二"],
    "md5": "d751713988987e9331980363e24189ce",
    "message": "参数校验错误"
}