跳转到内容
Cheeli 文档
返回官网

修改商品基本信息

商家根据商品ID修改商品基本信息，包括属性、特殊属性、商品标题等信息

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/jd/ware/write/updateware

公共参数

参数名称参数类型是否必须示例值参数描述
appidString是合作伙伴AppId
timestampString是1657525936当前Unix时间戳，秒
seller_nickString是38173182京东的账号，对应蜂巢授权返回jdseller字段
signString是

业务参数

名称类型必须示例值描述
warecom.jd.pop.ware.ic.api.domain.Ware是商品对象
- wareIdNumber是1975652301商品ID（修改时必填）
- titleString否惠普（HP） 1200A/1005/136W黑白激光打印机 复印扫描一体机办公家用无线手机打印商品名称 限制45个字符内
- brandIdNumber否8740已经授权过的品牌ID(通过商家授权类目接口获取)
- templateIdNumber否600333248关联版式，来源关联版式ID
- transportIdNumber否6756566运费模板ID，来源商家运费模板系统
- wareStatusNumber否1商品状态 1:从未上柜 2:自主下架 4:系统下架 8:在售
- outerIdString否XXYI700006商品外部ID,商家自己维护并确保唯一，来源于商家定义
- itemNumString否FB81718-1001商品货号
- barCodeString否6922266461712商品的条形码.UPC码,SN码,PLU码统称为条形码，来源国家编码中心
- wareLocationNumber否1商品产地 id [(1-中国大陆)(2-中国香港)(3-中国澳门)(4-中国台湾)]
- deliveryNumber否1商品发货地
- promiseIdNumber否63539778配送时效，来源商家配送时效模版列表
adWordscom.jd.pop.ware.ic.api.domain.AdWords否商品广告词对象 （单品页显示的优先级低于促销广告词）
- urlString否https://pro.jd.com/mall/active/2hhx1pM32H1MWmKNnHAAL13AwSfy/index.html广告词链接地址
- urlWordsString否点击抢购广告词链接文案
- wordsString否【TOPSPORTS-滔搏官方】12.21-12.29晚20点领券1件立享7折
- wrapString否包装规格（已废弃字段）包装规格（已废弃）
- packListingString否外包装采用防拆，彩盒内标配…商品包装清单
- lengthNumber否300商品长度,单位mm
- widthNumber否300商品宽度,单位mm
- heightNumber否300商品高度,单位mm
- weightNumber否3商品重量,单位kg
propsjava.util.Set<com.jd.pop.ware.ic.api.domain.Prop>否属性列表(已废弃 请使用multiCateProps)，最多100个
- - - attrIdString是234234属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 按照类目ID获取
- - - attrValuesString是4354354属性值ID数组 jingdong.category.read.findValuesByAttrIdUnlimit 获取
featuresjava.util.Set<com.jd.pop.ware.ic.api.domain.Feature>否商品维度的特殊属性 目前两个特殊属性 IBS、FBP、FCS、SCF
- - - featureKeyString是不要写 featureKey特殊属性key，JOS平台问题需要在使用时将字段写为 key
- - - featureValueString否不要写 featureValue特殊属性value，JOS平台问题需要在使用时将字段写为 value
shopCategorysjava.util.Set否商品店内分类（商家接口获取到的最末级的分类）最多20个
- - - (Number)否15378915商品店内分类
mobileDescString否移动版的商品介绍详细信息描述移动版的商品介绍
zhuangBaIdString否641bdf1fe4b0cb7ab840752d商品描述装吧实例ID，来源装吧系统。
introductionUseFlagString否1商品描述使用标识 ,0：使用默认的商品描述,1：使用装吧商详
mobileZhuangBaIdString否641bdf1fe4b0cb7ab840752d移动版装吧实例ID，来源装吧系统。
mobileDescUseFlagString否1移动版商品描述使用标识,0：使用默认的移动商详；1：使用装吧移动版商详
introductionString否PC版的商品介绍详细信息描述PC版的商品介绍
afterSalesString否售后服务详细信息文字描述售后服务
jdPriceNumber否66.6商品维度的京东价，仅做存贮，售卖不使用此价格
marketPriceNumber否86.6商品的市场价
designConceptString否商品设计理念文字描述商品设计理念,适用范围是toplife类目
fitCaseHtmlAppString否装修案例移动版html文字描述装修案例移动版描述,装修类目才可填写
fitCaseHtmlPcString否装修案例PC版描述文字描述装修案例PC版描述,装修类目才可填写
multiCatePropsjava.util.Set<com.jd.pop.ware.ic.api.domain.Prop>否类目属性列表，类目属性中有必填项时，此字段必填
- - - attrIdString是222435属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 按照类目ID获取
- - - attrValuesString是2224453属性值ID数组 jingdong.category.read.findValuesByAttrIdUnlimit 获取
- - - expandsString否扩展信息扩展字段
- - - unitsString否G单位字段 inputType=7 是属性值单位 例如：属性值 8G units中的值为 G
specialServicesjava.util.List否特色服务,装修类目才可填写,装修类必填,最大为5,每个值最长为8个字符
- - - (String)否特色服务文字秒速特色服务
spuIdNumber否16644912标品Id

二、请求示例代码

Java

请求示例代码

@Test
    public void     JDWareWriteUpdateWare() throws Exception {
        String prodStr = "{\"wareId\":\"10026023213016\",\"outerId\":\"123456XYZ\",\"venderId\":624092}";
        String sellerNick = Config.JDSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", sellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());


        data.put("content", prodStr);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDWareWriteUpdateWare, data);
    }

三、返回结果

{
    "code": 0,
    "message": "ok",
    "data": "success"
    }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。