修改商品基本信息

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

一、请求参数

请求URL:

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

公共参数

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

业务参数

名称	类型	必须	示例值	描述
ware	com.jd.pop.ware.ic.api.domain.Ware	是		商品对象
- wareId	Number	是	1975652301	商品ID（修改时必填）
- title	String	否	惠普（HP） 1200A/1005/136W黑白激光打印机 复印扫描一体机办公家用无线手机打印	商品名称 限制45个字符内
- brandId	Number	否	8740	已经授权过的品牌ID(通过商家授权类目接口获取)
- templateId	Number	否	600333248	关联版式，来源关联版式ID
- transportId	Number	否	6756566	运费模板ID，来源商家运费模板系统
- wareStatus	Number	否	1	商品状态 1:从未上柜 2:自主下架 4:系统下架 8:在售
- outerId	String	否	XXYI700006	商品外部ID,商家自己维护并确保唯一，来源于商家定义
- itemNum	String	否	FB81718-1001	商品货号
- barCode	String	否	6922266461712	商品的条形码.UPC码,SN码,PLU码统称为条形码，来源国家编码中心
- wareLocation	Number	否	1	商品产地 id [(1-中国大陆)(2-中国香港)(3-中国澳门)(4-中国台湾)]
- delivery	Number	否	1	商品发货地
- promiseId	Number	否	63539778	配送时效，来源商家配送时效模版列表
adWords	com.jd.pop.ware.ic.api.domain.AdWords	否		商品广告词对象 （单品页显示的优先级低于促销广告词）
- url	String	否	https://pro.jd.com/mall/active/2hhx1pM32H1MWmKNnHAAL13AwSfy/index.html	广告词链接地址
- urlWords	String	否	点击抢购	广告词链接文案
- words	String	否	【TOPSPORTS-滔搏官方】12.21-12.29晚20点	领券1件立享7折
- wrap	String	否	包装规格（已废弃字段）	包装规格（已废弃）
- packListing	String	否	外包装采用防拆，彩盒内标配…	商品包装清单
- length	Number	否	300	商品长度,单位mm
- width	Number	否	300	商品宽度,单位mm
- height	Number	否	300	商品高度,单位mm
- weight	Number	否	3	商品重量,单位kg
props	java.util.Set<com.jd.pop.ware.ic.api.domain.Prop>	否		属性列表(已废弃 请使用multiCateProps)，最多100个
- - - attrId	String	是	234234	属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 按照类目ID获取
- - - attrValues	String	是	4354354	属性值ID数组 jingdong.category.read.findValuesByAttrIdUnlimit 获取
features	java.util.Set<com.jd.pop.ware.ic.api.domain.Feature>	否		商品维度的特殊属性 目前两个特殊属性 IBS、FBP、FCS、SCF
- - - featureKey	String	是	不要写 featureKey	特殊属性key，JOS平台问题需要在使用时将字段写为 key
- - - featureValue	String	否	不要写 featureValue	特殊属性value，JOS平台问题需要在使用时将字段写为 value
shopCategorys	java.util.Set	否		商品店内分类（商家接口获取到的最末级的分类）最多20个
- - - (Number)	否	15378915	商品店内分类
mobileDesc	String	否	移动版的商品介绍详细信息描述	移动版的商品介绍
zhuangBaId	String	否	641bdf1fe4b0cb7ab840752d	商品描述装吧实例ID，来源装吧系统。
introductionUseFlag	String	否	1	商品描述使用标识 ,0：使用默认的商品描述,1：使用装吧商详
mobileZhuangBaId	String	否	641bdf1fe4b0cb7ab840752d	移动版装吧实例ID，来源装吧系统。
mobileDescUseFlag	String	否	1	移动版商品描述使用标识,0：使用默认的移动商详；1：使用装吧移动版商详
introduction	String	否	PC版的商品介绍详细信息描述	PC版的商品介绍
afterSales	String	否	售后服务详细信息文字描述	售后服务
jdPrice	Number	否	66.6	商品维度的京东价，仅做存贮，售卖不使用此价格
marketPrice	Number	否	86.6	商品的市场价
designConcept	String	否	商品设计理念文字描述	商品设计理念,适用范围是toplife类目
fitCaseHtmlApp	String	否	装修案例移动版html文字描述	装修案例移动版描述,装修类目才可填写
fitCaseHtmlPc	String	否	装修案例PC版描述文字描述	装修案例PC版描述,装修类目才可填写
multiCateProps	java.util.Set<com.jd.pop.ware.ic.api.domain.Prop>	否		类目属性列表，类目属性中有必填项时，此字段必填
- - - attrId	String	是	222435	属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 按照类目ID获取
- - - attrValues	String	是	2224453	属性值ID数组 jingdong.category.read.findValuesByAttrIdUnlimit 获取
- - - expands	String	否	扩展信息	扩展字段
- - - units	String	否	G	单位字段 inputType=7 是属性值单位 例如：属性值 8G units中的值为 G
specialServices	java.util.List	否		特色服务,装修类目才可填写,装修类必填,最大为5,每个值最长为8个字符
- - - (String)	否	特色服务文字秒速	特色服务
spuId	Number	否	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会包含失败原因。