修改商品基本信息

商家根据商品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