基础 qianmi.cloudshop.item.update(修改商品基本信息)

根据商品编号,修改商品信息。若商品为标准商品,只能修改商品名称(货柜名称)、关键词。若商品为自定义商品,还可再修改品牌、商品外部编号、计量单位,不能修改商品详情页
 用户授权类型
 公共参数
请求地址:
环境 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分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
num_iidString 必须 P1555 商品编号ID
outer_idString 可选 p4828 商家的外部编码,当商品为自定义商品时才可以修改商家外部编码
brand_idString 可选 26550 品牌编号,当商品为自定义商品时才可以修改品牌
unitString 可选 计量单位,当商品为自定义商品时才可以修改计量单位
titleString 可选 佳能COS 700D 商品名称
keywordsString 可选 超高相素,高感光度 关键词,多个关键词用英文逗号“,”分隔,且最多只能输入5个关键字,不能有重复的关键词
siteString 可选 0 商品关联销售渠道,0:关联所有已开通渠道,1:仅云订货,2:仅云商城,3 取消关联所有销售渠道
cidString 可选 10011002 类目编号
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemUpdateRequest req = new ItemUpdateRequest();
req.setNumIid("p27302");
req.setTitle("尼康 D700");
ItemUpdateResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new ItemUpdateRequest;
$req->setNumIid("p27302");
$req->setTitle("尼康 D700");
$res = $client->execute($req, $accessToken);
   IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemUpdateRequest req = new ItemUpdateRequest();
req.Title = "尼康 D700";
req.NumIid = "p27302";
ItemUpdateResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
item Item 是否成功,只返回is_success字段
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-item-update-service-error:01030001商品不存在请确认商品编号是否正确
isv.qianmi-cloudshop-item-update-service-error:01030005商品名称已存在请重新修改商品名称
isv.qianmi-cloudshop-item-update-service-error:01030006商品外部编号(货号)已存在请重新修改商品外部编号
isv.qianmi-cloudshop-item-update-service-error:01030011非自定义商品,不可修改计量单位、品牌或货号请修改接口入参
isv.qianmi-cloudshop-item-update-service-error:01030013品牌不存在请确认品牌编号是否正确
isv.qianmi-cloudshop-item-update-service-error:01030004站点分类不存在检查类目是否存在
isv.qianmi-cloudshop-item-update-service-error:01030024目录有子目录,不可关联商品检查类目是否包含子类目
 FAQ