修改商品基本信息

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

1.请求参数:

请求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

2. 请求示例代码(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);
    }

3. 返回结果如下:

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

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

文档更新时间: 2024-06-28 16:37   作者:JSL