修改商品基本信息
商家根据商品ID修改商品基本信息,包括属性、特殊属性、商品标题等信息
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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