基础 qianmi.cloudshop.item.add(发布一个新商品)

添加一个自定义商品到商品仓库,商品所属的卖家是当前会话的用户。发布商品可选择使用规格和不使用规格。当使用规格时,需要传入skus_json参数,系统会根据skus_json参数生成此商品的sku,skus_json参数中须指定sku的规格、价格、库存;当不使用规格时,系统会生成一个默认的sku,该sku的销售价、库存和此商品的销售价、库存一致;
 用户授权类型
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
fieldsField List 必须 num_iid,title,price 所发布商品的商品详情,返回字段参照Item商品结构,多个字段用”,”分隔;
titleString 必须 2016夏季新款洞洞鞋 商品名称
长度:2-120个字符
outer_idString 可选 qm-0001 商品的商家外部编码
格式:32位 大小写字母,数字 ,“-”,“_” 组成
unitString 可选 商品的计量单位
brand_idString 可选 23756 商品品牌编号
brand_nameString 可选 飞利浦 品牌名称,若不存在则会先新建品牌(优先处理brand_id)。
skus_jsonString 必须 [{"outer_id":"qm-0001-0001","price":"1999.00","quantity":"10","sku_props_values":{"尺码":"35","颜色分类":"白色"}},{"outer_id":"qm-0001-0002","price":"1999.00","quantity":"10","sku_props_values":{"尺码":"35.5","颜色分类":"白色"}}] 构造SKU的json串;格式参考示例值,可用字段只能为以下几种:
sell_point(副标题) 可选、
price(销售价) 必填
quantity(库存) 必填
cost_price(成本价) 可选、
weight(重量) 可选、
market_price(市场价) 可选、
outer_id(SKU商家编码) 可选、
barcode(条形码) 可选、
sku_props(规格项ID) 特殊可选、
sku_props_values(规格项值) 特殊可选。
sku_props和sku_props_values任选一种发布,建议以sku_props_values方式发布,开放平台内部会处理好属性值关系。
sku_props参考格式为{pid1:vid1,pid2:vid2,...}例如如:sku_props:{"2328":"234”,"2389":"148”}中,”2328”和"2389"为规格项编号,“234”和"148”为规格值编号。
sku_props_values参考格式为:{pText1:vText1,pText2:vText2,...},例如如:sku_props_values:{"颜色分类":"白色”,"尺码":"35.5”}中,”颜色分类”和"尺码"为规格项,"白色"和"35.5"为规格值
备注:
1:当has_props传false时,sku_json中包含的SKU个数确保只有1条,并且无需包含sku_props字段
2:weight 单位为kg, 最多支持3位小数。
3:当 has_props传true时,sku_json中包含的sku个数最多不超过50条,请合理规划商品、SKU数据。
4:sku_props和sku_props_values方式任选一种发布,若两者都传以sku_props为准。
5:每个SKU的外部编码(outer_id)不能重复,确保唯一。
imageString 可选 jpg@/9j/4AAQSkMEQ8SEhEP..... 商品主图,建议尺寸:800*800 PX,单张大小不得超过1M ,支持的文件类型:gif,jpg,jpeg,png;注:使用BASE64将图片文件进行编码,得到字符串,然后用“@”字符连接字符串(例:contentStr)和图片文件的格式(例:jpg);示例:“jpg@contentStr”。

注意:图片参数不参与签名计算

descString 可选 这是一双性感的洞洞鞋 商品描述
has_propsBoolean 可选 truetrue 商品是否开启规格,默认: true 开启规格
备注:
1:如果启用规格,sku_json中必须包含sku_props或sku_props_values的内容。
2:如果不开启规格,sku_json中只能含有一条sku数据,并且不需要填加sku_props或sku_props_values字段,即使添加也会被忽略。
siteString 可选 00 默认0:关联所有已开通的销售渠道,1仅云订货,2仅云商城,3:不关联任何销售渠道
cidString 可选 10011002 类目编号
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemAddRequest req = new ItemAddRequest();
req.setTitle("苹果手机");
req.setOuterId("1234");
req.setSkusJson("[{\"price\":\"5288.00\",\"quantity\":\"10\",\"sku_props\":{\"2328\":\"234\",\"2329\":\"245\",\"2340\":\"332\"}]");
req.setDesc("这是一部iPhone6土豪金");
req.setImage("jpg@/9j/4AAQSkMEQ8SEhEP.....");
req.setUnit("箱");
req.setFields("num_iid");
ItemAddResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new ItemAddRequest;
$req->setTitle("苹果手机");
$req->setOuterId("1234");
$req->setSkusJson("[{\"price\":\"5288.00\",\"quantity\":\"10\",\"sku_props\":{\"2328\":\"234\",\"2329\":\"245\",\"2340\":\"332\"}]");
$req->setDesc("这是一部iPhone6土豪金");
$req->setImage("jpg@/9j/4AAQSkMEQ8SEhEP.....");
$req->setUnit("箱");
$req->setFields("num_iid");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemAddRequest req = new ItemAddRequest();
req.Title = "苹果手机";
req.OuterId = "1234";
req.SkusJson = "[{\"price\":\"5288.00\",\"quantity\":\"10\",\"sku_props\":{\"2328\":\"234\",\"2329\":\"245\",\"2340\":\"332\"}]";
req.Desc = "这是一部iPhone6土豪金";
req.Image = "jpg@/9j/4AAQSkMEQ8SEhEP.....";
req.Unit = "箱";
req.Fields = "num_iid";
ItemAddResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
item Item 具体的字段根据请求中设定的fileds决定
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-item-add-service-error\:01030045skus_josn格式不正确确保skus_json为标准的json格式
isv.qianmi-cloudshop-item-add-service-error:01030046sku价格和库存必传给参数skus_json的price和quantiy字段设值
isv.qianmi-cloudshop-item-add-service-error:01030005商品名称已存在修改入参的商品名称
isv.qianmi-cloudshop-item-add-service-error:01030006商品货号(外部编号)已存在替换商品外部编号或者不传入,让系统自动生成
isv.qianmi-cloudshop-item-add-service-error:01030010单品外部编号已存在skus_json中的outer_id与已经存在的其他sku的outer_id重复,可以替换重复的外部编号或者不传入,让系统自动生成。
isv.qianmi-cloudshop-item-add-service-error:01030026sku的规格项或规格值不存在确保入参skus_json的规格项编号和规格值编号正确
isv.qianmi-cloudshop-item-add-service-error:01030025单品列表规格项不一致确保入参skus_josn中,所有sku的sku_props值的规格项编号统一
isv.qianmi-cloudshop-item-add-service-error:01030053所上传图片为非图片文件检查所上传图片格式是否正确
isv.qianmi-cloudshop-item-add-service-error:01030052sku规格项和规格值不匹配检查入参skus_json中,所有规格项下面是否有对应的规格值
isv.qianmi-cloudshop-item-add-service-error:01030051sku规格不可超过3组检查入参skus_json中,,每个sku的sku_props的规格项个数是否多于3个
isv.qianmi-cloudshop-item-add-service-error:01030047商品价格和库存与skus_json不可同时为空传入商品价格和库存或者skus_json
isv.qianmi-cloudshop-item-add-service-error:01030036入参不能含有特殊字符检查商品名称、详细介绍等参数是否有特殊字符
isv.qianmi-cloudshop-item-add-service-error:01030028图片上传失败检查图片格式和大小是否正确
isv.qianmi-cloudshop-item-add-service-error:01030029图片大小超过1M检查图片大小是否小于等于1M
isv.qianmi-cloudshop-item-add-service-error:01030042图片格式错误检查图片格式是否正确
isv.qianmi-cloudshop-item-add-service-error:01030040规格项编号和规格值编号必须由数字组成检查规格项编号和规格值编号是否是由数字组成
isv.qianmi-cloudshop-item-add-service-error:01030027sku入参单品编号重复检查skus_json入参中,sku外部编号是否有重复
isv.qianmi-cloudshop-item-add-service-error:01030041sku入参规格不可为空检查入参skus_josn中,每个sku是否有sku_props参数
isv.qianmi-cloudshop-item-add-service-error:01030048存在两个sku的规格值重复检查入参 skus_json中,是否有两个sku的规格完全一样
isv.qianmi-cloudshop-item-add-service-error:01030050sku个数不能超过50个检查sku个数是否大于50个
isv.qianmi-cloudshop-item-add-service-error\:01030062不启用规格时只能添加一条sku检查sku_json中包含的sku数据条数
isv.qianmi-cloudshop-item-add-service-error:01030004站点分类不存在检查类目是否存在
isv.qianmi-cloudshop-item-add-service-error:01030024目录有子目录,不可关联商品检查类目是否有子类目
isv.qianmi-cloudshop-item-add-service-error:01030066商品价格不正确检查商品价格格式是否正确
isv.qianmi-cloudshop-item-add-service-error:01030067商品成本价不正确检查商品成本价格式是否正确
isv.qianmi-cloudshop-item-add-service-error:01030068商品库存不正确检查商品库存格式是否正确
isv.qianmi-cloudshop-item-add-service-error:01030069商品条形码不正确检查商品条形码是否正确
isv.qianmi-cloudshop-item-add-service-error:01030070商品外部编码不正确检查商品外部编码格式是否正确
isv.qianmi-cloudshop-item-add-service-error:01030071商品副标题不正确检查商品副标题是否正确
 FAQ