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

发布pop商品接口

仅发布POP商品 获取有经营权限的品牌[查询商家已授权的品牌接口] 获取有经营权限类目接口[查询商家所有有效经营类目接口] 获取属性接口[通过属性ID，获取类目的新属性，可以查询销售属性接口] 获取属性值接口[获取新属性的可选值列表接口] 关于成本价[FBP商品成本价必填，字段key为 costPrice，传参方式参考 jdPrice] 商品发布示例：https://jos.jd.com/commondoc?listId=435 不支持批量上传商品； 没有设置支付方式的字段，参考下接口jingdong.pay.save.payway（保存/更新支付方式）； 京东商品新增设置“货到付款”这个字段，features字段传入isPayFirst；值是否先款后货（1是 0否）； features字段是打标字段，用于辅助识别图片，product维度的features标里传ocrImg； 京东pop店模式由商家仓库发货，支持商家商品和京东商品绑定关系 inputType属性解析类型 值及说明 1 按照单选模式解析, 2 按照多选模式解析, 3 按照文本模式解析, 4 日期年解析方式, 5 日期月解析方式, 6 日期日解析方式, 7 数值解析方式, 10 多输入多单位解析方式, 11 地域级联解析方式, 12 经纬度解析方式, 13 时间选择器解析方式, 15 分层属性，入参按照多选方式, 103 沙特项目定制-文本多语言

一、请求参数

请求URL:

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

公共参数

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

业务参数

名称类型必须示例值描述
warecom.jd.pop.ware.ic.api.domain.Ware是无商品对象
- titleString是惠普（HP） 1200A/1005/136W黑白激光打印机复印扫描一体机办公家用无线手机打印商品名称（限制50个字符以内）
- categoryIdNumber是717已经授权过的京东“三级”类目
- multiCategoryIdNumber否21392末级类目ID
- brandIdNumber否4760品牌ID
- templateIdNumber否600333248关联版式ID
- transportIdNumber是6756566运费模板ID
- wareStatusNumber否1商品状态
- outerIdString否XXYI700006商品外部ID
- itemNumString否FB81718-1001商品货号
- barCodeString否6922266461712商品的条形码
- wareLocationNumber否1商品产地ID
- deliveryNumber否1商品发货地
- promiseIdNumber否1配送时效模版ID
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商品长度
- widthNumber否300商品宽度
- heightNumber否300商品高度
- weightNumber否3商品重量
propsjava.util.Set否无属性列表
- Propcom.jd.pop.ware.ic.api.domain.Prop否无属性列表中的属性
- attrIdString否23423属性ID
- attrValuesString否435345属性值ID数组
featuresjava.util.Set否无商品维度的特殊属性
- Featurecom.jd.pop.ware.ic.api.domain.Feature否无特殊属性
- keyString是例如7天无理由 key=is7ToReturn特殊属性key
- valueString否例如：value=1特殊属性value
imagesjava.util.List是无商品图片列表
- Imagecom.jd.pop.ware.ic.api.domain.Image是无图片
- colorIdString是2532030957颜色id
- imgIndexNumber是1图片顺序
- imgUrlString是jfs/t1/145707/36/32512/39840/64658b41F1d9bf817/938f89967aa95714.jpg京东图片服务器地址
shopCategorysjava.util.Set否无商品店内分类
- Number[]Number否15378915商品店内分类ID
- mobileDescString是移动版的商品介绍详细信息描述移动版的商品介绍
- introductionString是PC版的商品介绍详细信息描述PC版的商品介绍
- afterSalesString否售后服务详细信息文字描述售后服务
- jdPriceNumber否66.6商品的京东价
- marketPriceNumber否86.6商品的市场价
- zhuangBaIdString否641bdf1fe4b0cb7ab840752d商品描述装吧实例ID
- introductionUseFlagString否1商品描述使用标识
- mobileZhuangBaIdString否641bdf1fe4b0cb7ab840752d移动版商品描述装吧实例ID
- mobileDescUseFlagString否1移动版商品描述使用标识
- designConceptString否商品设计理念文字描述商品设计理念
- fitCaseHtmlAppString否装修案例移动版html文字描述装修案例移动版描述
- fitCaseHtmlPcString否装修案例PC版描述文字描述装修案例PC版描述
specialServicesjava.util.List否无特色服务
- StringString否特色服务文字描述特色服务描述
multiCatePropsjava.util.Set否无类目属性列表
- Propcom.jd.pop.ware.ic.api.domain.Prop否无类目属性
- attrIdString是456456属性ID
- attrValuesString[]是675677属性值
- Propcom.jd.pop.ware.ic.api.domain.Prop否无商品属性
- attrIdString是456456属性ID来源于类目属性接口
- attrValuesString[]是675677属性值ID数组
- expandsString[]否扩展信息描述扩展信息
- unitsString[]否G单位字段 inputType=7 是属性值单位
- spuIdNumber否16644432标品ID
skusjava.util.List否无sku列表（只写属性用于新建商品且必填），最多299个
- Skucom.jd.pop.ware.ic.api.domain.Sku是无SKU对象
- skuIdNumber否10026654592375商品skuId
- saleAttrsjava.util.Set是无SKU销售属性列表
- Propcom.jd.pop.ware.ic.api.domain.Prop是无SKU销售属性
- attrValueAliasString[]否粉红色值别名
- attrIdString是1001078250属性ID
- attrValuesString[]是6635315651销售属性值
- attrValuesSeqNoNumber[]否1销售属性值排序
- featuresjava.util.Set否无特殊属性集合
- Featurecom.jd.pop.ware.ic.api.domain.Feature是无SKU级别特殊属性
- cnString否废弃字段忽略即可废弃字段
- valuesString否例如7天无理由 value=1sku级别特殊属性值
- keyString否例如7天无理由 key=is7ToReturnsku级别特殊属性
- jdPriceNumber是1京东价必填 单位：元
- outerIdString否XXYI7000055外部ID
- stockNumString是600总库存数
- barCodeString否6922266461712SKU的条形码
- propsjava.util.Set否无SKU属性(已废弃)
- multiCatePropsjava.util.Set否无多级SKU属性
- Propcom.jd.pop.ware.ic.api.domain.Prop否无多级SKU属性中的属性
- attrValueAliasString[]否粉红色值别名
- attrIdString否234234属性ID
- attrValuesString[]否23424332属性值
- expandsString[]否扩展信息描述扩展字段
- unitsString[]否KG单位字段
- capacityString否20L 20T容量，在有特殊要求的类目下必填
- promiseIdNumber否123456时效模板id
- saleAttrTemplateIdString否POP_MODEL销售属性模板id
- enableNumber否1启用-1，停用-2
- currencySpuIdNumber否16644802标品ID
- mappingIdString否641bdf1fe4b0cb7ab854645映射Id
- weightString否100sku维度的重量，单位KG

二、请求示例代码

Java

请求示例代码

@Test
public void     JDWareWriteAdd() throws Exception {
        String prodStr = "{\"ware\":{\"promiseId\":27881358,\"brandId\":955844,\"wareLocation\":1,\"outerId\":1,\"weight\":2300,\"venderId\":0,\"title\":\"测试品牌（0506-2）测试0624\",\"height\":10,\"length\":10,\"barCode\":\"123\",\"marketPrice\":2300,\"width\":10,\"categoryId\":12034,\"introduction\":\"测试0624\",\"images\":[{\"@type\":\"com.jd.pop.ware.ic.api.domain.Image\",\"imgUrl\":\"jfs/t1/232363/1/19595/1498/66759013Fb49a5601/e8620d87e32262af.jpg\",\"colorId\":\"0000000000\",\"imgIndex\":1,\"type\":\"com.jd.pop.ware.ic.api.domain.Image\"}],\"multiCateProps\":[{\"@type\":\"com.jd.pop.ware.ic.api.domain.Prop\",\"attrid\":\"113009\",\"attrValues\":[825894]},{\"@type\":\"com.jd.pop.ware.ic.api.domain.Prop\",\"attrid\":\"107349\",\"attrValues\":[603918]}]},\"skus\":[{\"@type\":\"com.jd.pop.ware.ic.api.domain.Sku\",\"venderId\":0,\"stockNum\":1,\"jdPrice\":300,\"saleAttrTemplateId\":\"POP_MODEL\"}]}";
        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.JDWareWriteAdd, data);
    }

三、返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "skus": [{
            "skuId": 10107945973278,
            "wareId": 10026046774708
        }],
        "wareId": 10026046774708
    }
}

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