企业采购

服务对接之前请先查看：服务调用必读须知
以下服务只包含大客户商品采购相关服务，如需采购第三方虚拟权益相关商品可以查看虚拟权益采买服务

商品

商品组列表查询

接口方法：/jddx-sc/jddx-sc-sku/findSkuGroup

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/findSkuGroup?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

注意：系统给用户分配appKey和appSecret，调用时请将appKey的值替换为系统分配用户的相应值，timestamp为当前毫秒时间戳，sign为通过appSecret加密后的签名，加密算法如下：

	/**
     * 获取签名
     */
	long millis = System.currentTimeMillis();
	
    public String getSign(String appKey,String appSecret,long millis) {
        return md5(md5(appKey+appSecret)+millis);
    }

    public static String md5(String content){
        MessageDigest md = null;
        byte[] bytes = new byte[0];
        try {
            md = MessageDigest.getInstance("md5");
            bytes = md.digest(content.getBytes("utf-8"));
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }
        return getBytesToString(bytes);
    }
    private static String getBytesToString(byte[] bytes) {
        StringBuilder sign = new StringBuilder();
        for (int i = 0; i < bytes.length; i++) {
            String hex = Integer.toHexString(bytes[i] & 0xFF);
            if (hex.length() == 1) {
                sign.append("0");
            }
            sign.append(hex);
        }
        return sign.toString();
    }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

后续接口调用方式相同，不再赘述。

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
pageNo	int	否	页码,默认1
pageSize	int	否	分页大小，默认20，最大50

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	java.util.List
├ skuGroup	Object	商品分组实体
├ name	String	分组名称
├ groupCode	String	商品分组编码
pageBean		分页数据实体
├ pageNo	Integer	当前页码，从1开始
├ pageSize	Integer	分页条数
├ totalPage	Integer	总页数
├ totalRecord	Integer	总记录条数
├ lastId	String	上一次查询主键id（保留字段，可忽略）
├ end	Boolean	是否是最后一页 true 是 false 否（保留字段，可忽略）
├ param	Object	请求参数实体（保留字段，可忽略）
├ params	java.util.Map	请求参数Map（保留字段，可忽略）

请求Body参数示例

{
	"params": {}
}

1
2
3

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"pageBean": {
			"pageNo": 1,
			"totalPage": 2,
			"pageSize": 20,
			"end": false,
			"totalRecord": 28,
			"params": {},
			"class": "com.jd.jr.jddx.common.export.PageBean"
		},
		"value": [
			{
				"skuGroupCode": 4064,
				"name": "本地生活/旅游出行",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3678,
				"name": "箱包皮具",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3677,
				"name": "生鲜",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3676,
				"name": "母婴",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3675,
				"name": "美妆护肤",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3674,
				"name": "礼品",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3673,
				"name": "酒类",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3672,
				"name": "家庭清洁、纸品",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3671,
				"name": "家居日用",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3670,
				"name": "家纺",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3669,
				"name": "个人护理",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3668,
				"name": "电脑/办公",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3667,
				"name": "数码",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3666,
				"name": "厨具",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3665,
				"name": "鞋靴",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3664,
				"name": "汽车用品",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3663,
				"name": "运动户外",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3662,
				"name": "玩具乐器",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3661,
				"name": "医药保健",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			},
			{
				"skuGroupCode": 3660,
				"name": "宠物生活",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuGroupVo"
			}
		],
		"resultMsg": "成功"
	}
}

商品组商品列表查询

接口方法：/jddx-sc/jddx-sc-sku/findSkusByGroupCode

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/findSkusByGroupCode?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
groupCode	String	是	商品分组编码
pageNo	int	否	页码,默认1
pageSize	int	否	分页大小，默认20，最大50

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	java.util.Map
├totalCount	int	商品分组下商品总数
├skuList	java.util.List
├skuInfo	java.util.Map	商品信息map实体
├skuId	String	商品Sku编码
├spuId	String	商品Spu编码
├skuName	String	sku商品名称
├deleted	int	逻辑删除标记: 1、正常 2、已删除
├brandId	String	商品品牌编码
├firstCategoryCode	Number	商品一级类目id
├firstCategoryName	String	商品一级类目名称
├secondCategoryCode	Number	商品二级类目id
├secondCategoryName	String	商品二级类目名称
├thirdCategoryCode	Number	商品三级类目id
├thirdCategoryName	String	商品三级类目名称
├mainImg	String	商品主图
├saleStatus	int	商品上下架状态 1：上架(可搜索，可购买)， 0：下架(可通过skuid搜索，不可购买)，2：可上架（可通过skuid搜索，不可购买），10：pop 删除（不可搜索，不可购买）
├shopId	Number	店铺ID
├spuName	String	spu商品名称
├lastCategoryCode	String	商品分类的最后一级id
├lastCategoryName	String	商品分类的最后一级名称

备注：实际返回结果可能会多一些无用字段，可选择忽略

请求Body参数示例

{
	"params": {"pageNo":1,"pageSize":5,"groupCode":"3660"}
}

1
2
3

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": {
			"skuList": [
				{
					"lastCategoryName": "",
					"skuPrice": 259,
					"saleUnit": "袋",
					"firstCategoryName": "宠物生活",
					"productArea": "中国大陆",
					"skuId": "1844573828886",
					"groupCode": "3660",
					"suggestPrice": 259,
					"secondCategoryCode": "6995",
					"brandName": "麦富迪（MYFOODIE）",
					"upc": "100014035662",
					"weight": "10.0",
					"distributionPrice": 259,
					"firstCategoryCode": "6994",
					"mainImg": "//img30.360buyimg.com/cf/jfs/t1/129404/34/5943/425928/5efc4152E4179e2be/08639d1859e1f333.jpg",
					"spuName": "麦富迪（MYFOODIE）牛肉钙奶成犬狗粮 中大型犬通用型（10kg）",
					"jdSkuId": "100014035662",
					"thirdCategoryCode": "7002",
					"skuName": "麦富迪（MYFOODIE）牛肉钙奶成犬狗粮 中大型犬通用型（10kg）",
					"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuVo",
					"thirdCategoryName": "狗干粮",
					"secondCategoryName": "宠物主粮",
					"spuId": "100014035662"
				},
				{
					"lastCategoryName": "",
					"skuPrice": 24,
					"saleUnit": "个",
					"firstCategoryName": "宠物生活",
					"productArea": "中国大陆",
					"skuId": "1844681685002",
					"groupCode": "3660",
					"suggestPrice": 24,
					"secondCategoryCode": "6998",
					"brandName": "悠梵萌",
					"upc": "100007540129",
					"weight": "0.13",
					"distributionPrice": 24,
					"firstCategoryCode": "6994",
					"mainImg": "//img30.360buyimg.com/cf/jfs/t1/128938/24/4937/161948/5ee72572E09256f96/7ec3b23d69623b07.jpg",
					"spuName": "悠梵萌猫碗狗碗防打翻悬挂式宠物食盆不锈钢固定挂笼猫粮饭盆水碗猫咪碗 蓝色小号",
					"jdSkuId": "100007540129",
					"thirdCategoryCode": "7018",
					"skuName": "悠梵萌猫碗狗碗防打翻悬挂式宠物食盆不锈钢固定挂笼猫粮饭盆水碗猫咪碗 蓝色小号",
					"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuVo",
					"thirdCategoryName": "食具水具",
					"secondCategoryName": "猫狗日用",
					"spuId": "100013723144"
				},
				{
					"lastCategoryName": "",
					"skuPrice": 13.9,
					"saleUnit": "个",
					"firstCategoryName": "宠物生活",
					"productArea": "中国大陆",
					"skuId": "1844681685791",
					"groupCode": "3660",
					"suggestPrice": 13.9,
					"secondCategoryCode": "6999",
					"brandName": "悠梵萌",
					"upc": "100013778562",
					"weight": "0.06",
					"distributionPrice": 13.9,
					"firstCategoryCode": "6994",
					"mainImg": "//img30.360buyimg.com/cf/jfs/t1/142564/17/733/80797/5ee721e6E9b7de705/eeff05ebaad24bd8.jpg",
					"spuName": "悠梵萌七彩铃铛球狗狗发声玩具磨牙耐咬马卡龙编织球 小号",
					"jdSkuId": "100013778562",
					"thirdCategoryCode": "7025",
					"skuName": "悠梵萌七彩铃铛球狗狗发声玩具磨牙耐咬马卡龙编织球 小号",
					"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuVo",
					"thirdCategoryName": "狗玩具",
					"secondCategoryName": "猫狗玩具",
					"spuId": "100013778546"
				},
				{
					"lastCategoryName": "",
					"skuPrice": 168,
					"saleUnit": "袋",
					"firstCategoryName": "宠物生活",
					"productArea": "中国大陆",
					"skuId": "1844681683252",
					"groupCode": "3660",
					"suggestPrice": 168,
					"secondCategoryCode": "6995",
					"brandName": "parlmu",
					"upc": "6972091540571",
					"weight": "12.72",
					"distributionPrice": 168,
					"firstCategoryCode": "6994",
					"mainImg": "//img30.360buyimg.com/cf/jfs/t1/147674/17/1819/362274/5efd4e7bE27850158/e3c962b3908f9c68.jpg",
					"spuName": "parlmu天然深海鱼猫粮10kg20斤赠猫砂2.5kg 成猫幼猫英短蓝猫波斯折耳加菲猫咪全阶段通用型",
					"jdSkuId": "100014054422",
					"thirdCategoryCode": "7003",
					"skuName": "parlmu天然深海鱼猫粮10kg20斤赠猫砂2.5kg 成猫幼猫英短蓝猫波斯折耳加菲猫咪全阶段通用型",
					"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuVo",
					"thirdCategoryName": "猫干粮",
					"secondCategoryName": "宠物主粮",
					"spuId": "100014054422"
				},
				{
					"lastCategoryName": "",
					"skuPrice": 79,
					"saleUnit": "根",
					"firstCategoryName": "宠物生活",
					"productArea": "中国大陆",
					"skuId": "1844681689342",
					"groupCode": "3660",
					"suggestPrice": 79,
					"secondCategoryCode": "13968",
					"brandName": "森森（SUNSUN）",
					"upc": "6955974939280",
					"weight": "1.14",
					"distributionPrice": 79,
					"firstCategoryCode": "6994",
					"mainImg": "//img30.360buyimg.com/cf/jfs/t1/128139/21/6279/246703/5efec9f1Ecc75e80c/e80abe9aa420b70d.jpg",
					"spuName": "森森鱼缸潜水灯管陆两用灯造景灯鱼缸灯水族箱照明灯LED灯 长76cm 13W 高亮白光（带独立开关）",
					"jdSkuId": "100013911398",
					"thirdCategoryCode": "17322",
					"skuName": "森森鱼缸潜水灯管陆两用灯造景灯鱼缸灯水族箱照明灯LED灯 长76cm 13W 高亮白光（带独立开关）",
					"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuVo",
					"thirdCategoryName": "照明设备",
					"secondCategoryName": "水族",
					"spuId": "100013911398"
				}
				
			],
			"totalCount": 5271
		},
		"resultMsg": "成功"
	}
}

商品详情查询

接口方法：/jddx-sc/jddx-sc-sku/findSkuInfo

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/findSkuInfo?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
groupCode	String	是	商品分组编码
skuId	String	是	商品编码

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	Object	商品详情对象
├ skuId	String	商品Sku编码
├ spuId	String	商品Spu编码
├ skuName	String	商品名称
├ mainImg	String	商品主图，商详页banner图，多张图片使用","间隔拼接
├ videoUrl	String	商品视频地址（暂无法提供）
├ spec	String	自定义属性
├ brandId	String	商品品牌编码
├ shopId	Number	店铺Id
├ shopName	String	店铺名称（暂无法提供）
├ shopCategory	String	店内商品分类
├ firstCategoryCode	Number	商品一级类目id
├ secondCategoryCode	Number	商品二级类目id
├ thirdCategoryCode	Number	商品三级类目id
├ lastCategoryCode	Number	商品最后一级级类目id
├ firstCategoryName	String	商品一级类目名称
├ secondCategoryName	String	商品二级类目名称
├ thirdCategoryName	String	商品三级类目名称
├ lastCategoryName	String	商品最后一级类目名称（暂无法提供）
├ productArea	String	产地
├ deliveryArea	String	发货地
├ saleStatus	int	商品上下架状态 1：上架(可搜索，可购买)， 0：下架(可通过skuid搜索，不可购买)，2：可上架（可通过skuid搜索，不可购买），10：pop 删除（不可搜索，不可购买）
├ model	String	型号
├ sellPoint	String	销售亮点
├ popPid	String	POP店商品ID
├ spuName	String	SPU名称
├ saleUnit	String	商品销售单位:个、台、箱等
├ specName	String	自定义属性名
├ specSequence	String	自定义属性顺序
├ valueWeight	String	重量(千克) 原数据以毫克为单位转换成千克后四舍五入保留小数点后3位
├ weight	String	重量(千克) 原数据以毫克为单位转换成千克后四舍五入保留小数点后2位
├ color	String	颜色
├ colorSequence	String	颜色顺序
├ size	String	尺码
├ sizeSequence	String	尺码顺序
├ width	String	宽（毫米）
├ height	String	高（毫米）
├ length	String	长（毫米）
├ upc	String	upc码
├distributionPrice	Bigdicimal	分销价
├suggestedPrice	Bigdicimal	建议零售价
├saleProperty	Object	销售属性
├ size	List<String>	商品销售大小集合
├ color	List<String>	商品销售颜色集合
├ image	List<String>	商品销售图片集合
├ brandId	String	商品销售品牌id
├ brandName	String	商品销售品牌名称
├ saleProp	Map<String,String>	商品销售属性类别
├ salePropSeq	Map<String,List<String>>	商品销售属性类别值
├ newColorSize	List<Map<String,Object>>	商品销售属性集合
├ spec	List<String>	商品销售属性规格
├ deleted	int	逻辑删除 1、正常 2 已删除
├ coupon	Map	优惠券信息

备注：实际返回结果可能会多一些无用字段，可选择忽略

请求Body参数示例

{
	"params": {
	    "groupCode":"3660",
	    "skuId":"1844681685799"
	}
}

1
2
3
4
5
6

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": {
			"lastCategoryName": "",
			"skuPrice": 30,
			"saleUnit": "个",
			"firstCategoryName": "宠物生活",
			"productArea": "中国大陆",
			"skuId": "1844681685799",
			"suggestPrice": 30,
			"secondCategoryCode": "6998",
			"brandName": "悠梵萌",
			"saleProperty": {
				"image": [
					"https://img30.360buyimg.com/popshop/jfs/t1/139381/3/776/161948/5ee722e8Ec46787ea/8fe1565abcf92532.jpg",
					"https://img30.360buyimg.com/popshop/jfs/t1/123317/25/4871/66076/5ee723bcE71846401/57f2eb3162adbebf.jpg",
					"https://img30.360buyimg.com/popshop/jfs/t1/122504/17/4882/200786/5ee722e9Ebd73db21/31d2b5af2697557b.jpg",
					"https://img30.360buyimg.com/popshop/jfs/t1/132078/38/2291/156933/5ee722e9Ef6ce1f4d/ba4a5b5f7686f7f0.jpg"
				],
				"brandName": "悠梵萌",
				"newColorSize": [
					{
						"1": "蓝色大号",
						"2": "",
						"3": "",
						"sequenceNo3": 0,
						"sequenceNo2": 0,
						"specName": "",
						"yn": 1,
						"imagePath": "https://img30.360buyimg.com/popshop/jfs/t1/139381/3/776/161948/5ee722e8Ec46787ea/8fe1565abcf92532.jpg",
						"index": 1,
						"skuId": "1844681685799",
						"sequenceNo1": 1
					},
					{
						"1": "蓝色小号",
						"2": "",
						"3": "",
						"sequenceNo3": 0,
						"sequenceNo2": 0,
						"specName": "",
						"yn": 1,
						"imagePath": "https://img30.360buyimg.com/popshop/jfs/t1/128938/24/4937/161948/5ee72572E09256f96/7ec3b23d69623b07.jpg",
						"index": 2,
						"skuId": "1844681685002",
						"sequenceNo1": 2
					}
				],
				"salePropSeq": {
					"1": [
						"蓝色大号",
						"蓝色小号"
					],
					"2": [
						""
					],
					"3": [
						""
					]
				},
				"color": [
					"蓝色大号",
					"蓝色小号"
				],
				"size": [],
				"brandId": "494035",
				"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SaleProperty",
				"saleProp": {
					"1": "颜色",
					"2": "尺码",
					"4": "规格"
				},
				"skuId": "100013723144",
				"spec": []
			},
			"upc": "100013723144",
			"weight": "0.16",
			"distributionPrice": 30,
			"size": "",
			"firstCategoryCode": "6994",
			"mainImg": "//img13.360buyimg.com/n0/jfs/t1/139381/3/776/161948/5ee722e8Ec46787ea/8fe1565abcf92532.jpg",
			"spuName": "悠梵萌猫碗狗碗防打翻悬挂式宠物食盆不锈钢固定挂笼猫粮饭盆水碗猫咪碗 蓝色大号",
			"jdSkuId": "100013723144",
			"color": "蓝色大号",
			"thirdCategoryCode": "7018",
			"description": "<div cssurl='//sku-market-gw.jd.com/css/mobile/100013723144.css?t=1591584516235'></div><div skucode=\"100011\"></div><img src=\"//img30.360buyimg.com/sku/jfs/t1/114541/4/9438/281379/5edb1196Ef69d6bcd/eed0927e235ed2fb.jpg\" width=\"640\" height=\"911\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/127550/27/4296/236005/5edb1196Ebb618216/92caddb65bc724f7.jpg\" width=\"640\" height=\"866\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/140261/9/59/261364/5edb1196Ee118f9a8/7f3c23da15eda5a3.jpg\" width=\"640\" height=\"912\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/147029/8/60/229190/5edb1196Edb21054f/275d9ad40bd35d27.jpg\" width=\"640\" height=\"767\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/134262/36/1607/214890/5edb1196E72b6c155/625177ddb2a6e6a8.jpg\" width=\"640\" height=\"829\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/142254/20/45/204635/5edb1196E5fb6efdb/83f2769943e57d89.jpg\" width=\"640\" height=\"625\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/114089/19/9543/116017/5edb1196Ee70a1ff4/401685cd25dc5e0c.jpg\" width=\"640\" height=\"853\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/115310/8/9530/177390/5edb1196E45a27c33/8cff25753d3c195d.jpg\" width=\"640\" height=\"671\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/146381/35/58/278280/5edb1196E0e064636/522f4450bdc60a2e.jpg\" width=\"640\" height=\"1082\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/128698/21/4208/131618/5edb1196Edee337b1/0dca9a59c3f73996.jpg\" width=\"640\" height=\"487\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/138812/20/58/240379/5edb1196Eb921bb97/3064043dec37bdcf.jpg\" width=\"640\" height=\"1113\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/111004/8/9459/110109/5edb1196Ec88cbc3f/a885341f0148204a.jpg\" width=\"640\" height=\"853\" alt=\"\" />",
			"skuName": "悠梵萌猫碗狗碗防打翻悬挂式宠物食盆不锈钢固定挂笼猫粮饭盆水碗猫咪碗 蓝色大号",
			"class": "com.jd.jr.jddx.sc.sku.export.vo.output.SkuVo",
			"saleStatus": "1",
			"thirdCategoryName": "食具水具",
			"secondCategoryName": "猫狗日用",
			"spuId": "100013723144"
		},
		"resultMsg": "成功"
	}
}

商品详情图列表查询

接口方法：/jddx-sc/jddx-sc-sku/findSkuDetailImgList

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/findSkuDetailImgList?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595235037818&sign=75c32e70cd693d5dc93267e0c38f52b1

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
groupCode	String	是	商品分组编码
skuIds	List	是	商品编码

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	String	商详html
├skuId	String	商品编码
├mobileIntroduction	String	手机端商品详情介绍
├pcIntroduction	String	PC端商品详情介绍

请求Body参数示例

{
	"params": {
	    "groupCode":"3660",
	    "skuIds":["1844681685799","1844681685791"]
	}
}

1
2
3
4
5
6

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"mobileIntroduction": "<div cssurl='//sku-market-gw.jd.com/css/mobile/100013723144.css?t=1591584516235'></div><div skucode=\"100011\"></div><img src=\"//img30.360buyimg.com/sku/jfs/t1/114541/4/9438/281379/5edb1196Ef69d6bcd/eed0927e235ed2fb.jpg\" width=\"640\" height=\"911\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/127550/27/4296/236005/5edb1196Ebb618216/92caddb65bc724f7.jpg\" width=\"640\" height=\"866\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/140261/9/59/261364/5edb1196Ee118f9a8/7f3c23da15eda5a3.jpg\" width=\"640\" height=\"912\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/147029/8/60/229190/5edb1196Edb21054f/275d9ad40bd35d27.jpg\" width=\"640\" height=\"767\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/134262/36/1607/214890/5edb1196E72b6c155/625177ddb2a6e6a8.jpg\" width=\"640\" height=\"829\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/142254/20/45/204635/5edb1196E5fb6efdb/83f2769943e57d89.jpg\" width=\"640\" height=\"625\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/114089/19/9543/116017/5edb1196Ee70a1ff4/401685cd25dc5e0c.jpg\" width=\"640\" height=\"853\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/115310/8/9530/177390/5edb1196E45a27c33/8cff25753d3c195d.jpg\" width=\"640\" height=\"671\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/146381/35/58/278280/5edb1196E0e064636/522f4450bdc60a2e.jpg\" width=\"640\" height=\"1082\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/128698/21/4208/131618/5edb1196Edee337b1/0dca9a59c3f73996.jpg\" width=\"640\" height=\"487\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/138812/20/58/240379/5edb1196Eb921bb97/3064043dec37bdcf.jpg\" width=\"640\" height=\"1113\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/111004/8/9459/110109/5edb1196Ec88cbc3f/a885341f0148204a.jpg\" width=\"640\" height=\"853\" alt=\"\" />",
				"skuId": "1844681685799",
				"pcIntroduction": "<div cssurl='//sku-market-gw.jd.com/css/pc/100013723144.css?t=1592217747406'></div><div skucode=\"100010\"></div><img src=\"//img30.360buyimg.com/sku/jfs/t1/130806/35/1601/355751/5edb10a7Ebc69dc02/193344c17fbbfa4c.jpg\" width=\"790\" height=\"1125\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/139935/2/69/292750/5edb10a7E6af78b03/9df44927d5882162.jpg\" width=\"790\" height=\"1069\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/147259/16/60/341683/5edb10a7Ed2fed7f7/c38e4c8989215368.jpg\" width=\"790\" height=\"1126\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/143546/40/52/272714/5edb10a7Ebe83af75/7eb7b7d2a23926ec.jpg\" width=\"790\" height=\"947\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/129322/9/4242/262166/5edb10a7Ebb67db3e/7efff601f57de1ae.jpg\" width=\"790\" height=\"1023\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/121378/39/4278/240782/5edb10a7Eef7a181b/da4332c32be8b15d.jpg\" width=\"790\" height=\"771\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/128285/34/4253/123461/5edb10a7E1364783f/b2fb037bd264f148.jpg\" width=\"750\" height=\"1000\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/134290/16/1630/210275/5edb10a7E772ac6f9/58c84e70a3b496cf.jpg\" width=\"790\" height=\"828\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/125272/4/4271/353354/5edb10a7E53b0debe/5c2b7752e659c125.jpg\" width=\"790\" height=\"1335\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/138481/3/52/146614/5edb10a7E51a0fb1a/7fb58a99780fa938.jpg\" width=\"790\" height=\"601\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/126544/13/4257/291039/5edb10a7Ed4a94102/b1d2d6527f850d50.jpg\" width=\"790\" height=\"1374\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/127023/40/4282/118008/5edb10a7Ed3c8c980/896593a34988bb69.jpg\" width=\"750\" height=\"1000\" alt=\"\" />"
			},
			{
				"mobileIntroduction": "<div skucode=\"100011\"></div><img src=\"//img30.360buyimg.com/sku/jfs/t1/144689/10/283/68199/5edf41a5Ec61bb45b/dca943115a7e8b32.jpg\" width=\"640\" height=\"802\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/145082/6/537/113159/5ee46fc5E2a999388/0c143e3bab02e05a.jpg\" width=\"640\" height=\"932\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/136606/31/1834/93157/5edf41a5E1e0bb078/80a47261c6aa6d5f.jpg\" width=\"640\" height=\"958\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/136093/26/1823/77819/5edf41a5E94669f0e/069771d042e81118.jpg\" width=\"640\" height=\"884\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/135293/21/1837/51060/5edf41a5E9fd18dc5/e2e3b88c1a9d401a.jpg\" width=\"640\" height=\"522\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/117998/31/9763/32909/5edf41a4E552d5ea7/3f575cc7912664b3.jpg\" width=\"640\" height=\"345\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/122779/7/4447/70496/5edf41a5E7e095723/75bd1ffcee3bd164.jpg\" width=\"640\" height=\"917\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/110737/20/12343/64042/5edf41a5Ef2b30649/66b8462bec19e88e.jpg\" width=\"640\" height=\"578\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/144859/36/302/55829/5edf41a5E35f7c5b6/56fb825901c0bee9.jpg\" width=\"640\" height=\"516\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/146638/18/262/50273/5edf41a5E55728a36/3e9dcc293cc166a5.jpg\" width=\"640\" height=\"614\" alt=\"\" />",
				"skuId": "1844681685791",
				"pcIntroduction": "<div skucode=\"100010\"></div><img src=\"//img30.360buyimg.com/sku/jfs/t1/123880/33/4396/134698/5edf417eEe0967d64/d736b658d3ac6397.jpg\" width=\"790\" height=\"990\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/132685/24/2144/159166/5ee46f99Ed705b588/70405beee31aec12.jpg\" width=\"790\" height=\"1150\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/126651/19/4411/208886/5edf417fEb6c6c21e/c928986ac9c13d21.jpg\" width=\"790\" height=\"1183\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/118644/13/9641/139098/5edf417fE45c5557e/dcf4caa2b1de2b4a.jpg\" width=\"790\" height=\"1091\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/141316/22/272/78140/5edf417eE0bab5fce/5b84b12e5adc63d0.jpg\" width=\"790\" height=\"644\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/126064/9/4548/52737/5edf417dEc2acda68/da22af96dd063733.jpg\" width=\"790\" height=\"426\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/113514/36/9589/109446/5edf417eE3ccdf7af/3ccc021b0cb9b990.jpg\" width=\"790\" height=\"1132\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/136241/2/1853/89180/5edf417eEaaec2eea/bfb1dcaf7108b1d3.jpg\" width=\"790\" height=\"713\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/147591/8/294/67335/5edf417eE1adb49fd/6790a756629133b9.jpg\" width=\"790\" height=\"637\" alt=\"\" /><img src=\"//img30.360buyimg.com/sku/jfs/t1/138161/34/291/68385/5edf417eE8e64a769/1dd7dd334dcf5f1b.jpg\" width=\"790\" height=\"758\" alt=\"\" />"
			}
		],
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

商品售卖上下架状态查询

接口方法：/jddx-sc/jddx-sc-sku/findSkuSaleStatus

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/findSkuSaleStatus?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
skuIds	List<String>	是	商品编码
groupCode	String	是	商品分组编码

响应参数

名称	类型	描述
success	Boolean 调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	java.util.List
├skuId	String	商品编码
├saleStatus	int	售卖状态：1、上架 2、下架

请求Body参数示例

{
	"params": {
	    "groupCode":"3660",
	    "skuIds":["1844681685799","1844681685791"]
	}
}

1
2
3
4
5
6

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"saleStatus": 1,
				"skuId": "1844681685799"
			},
			{
				"saleStatus": 1,
				"skuId": "1844681685791"
			}
		],
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

商品规格详情查询

接口方法：/jddx-sc/jddx-sc-sku/findSkuSpecsDetail

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/findSkuSpecsDetail?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
skuId	String	是	商品编码

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	String	商城商详页商品规格介绍

请求Body参数示例

{
	"params": {
	    "skuId":"1844681685799"
	}
}

1
2
3
4
5

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": "      <table cellpadding=\\\"0\\\" cellspacing=\\\"1\\\" width=\\\"100%\\\" border=\\\"0\\\" class=\\\"Ptable\\\">\\n                        <tr><th class=\\\"tdTitle\\\" colspan=\\\"2\\\">主体</th><tr>\\n                                                    <tr><td class=\\\"tdTitle\\\">包装重量（kg）</td><td>0.35kg</td></tr>\\n                                                       </table>\\n  ",
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11

商品运费查询

接口方法：/jddx-sc/jddx-sc-sku/freightQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/freightQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
skus	List<Map<String,Object>>	是	无	sku列表
├ skuId	String	是	无	skuID
├ num	Integer	是	无	认购数量
province	Integer	是	无	省
city	Integer	是	无	市
county	Integer	是	无	区
town	Integer	是	无	镇
groupCode	String	是	无	商品组编号

响应参数

名称	类型	描述
freight	BigDicimal	运费
baseFright	BigDicimal	基础运费
remoteRegionFreight	BigDicimal	偏远运费
remoteSkus	java.util.List	需收偏远运费的sku集合
├ skuId	String	skuId

请求Body参数

{
	"params": {
	    "skus":[{"skuId":"1844681685799","num":1}],
	    "groupCode":"3660",
	    "province":7,
	    "city":549,
	    "county":558,
	    "town":34718
	}
}

1
2
3
4
5
6
7
8
9
10

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": {
			"baseFreight": 8,
			"remoteRegionFreight": 0,
			"freight": 8,
			"remoteSkus": "[]"
		},
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

商品库存查询

接口方法：/jddx-sc/jddx-sc-sku/stockQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/stockQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
skus	List<Map<String,Object>>	是	无	sku参数集合
├skuId	String	是	无	skuId
├num	Integer	否	无	认购数量，可不传，默认1
province	Integer	是	无	省
city	Integer	是	无	市
county	Integer	是	无	区
town	Integer	是	无	镇
groupCode	String	是		商品组编号

响应参数

名称	类型	描述
skuStock	java.util.Map<String,Boolean>	key表示skuId，value表示是否有库存

请求Body参数示例

{
	"params": {
	    "skus":[{"skuId":"1844681685799","num":1}],
	    "groupCode":"3660",
	    "province":7,
	    "city":549,
	    "county":558,
	    "town":34718
	}
}

1
2
3
4
5
6
7
8
9
10

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": {
			"1844681685799": true
		},
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13

商品价格查询

接口方法：/jddx-sc/jddx-sc-sku/priceQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/priceQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
skuIds	List<String>	是	无	skuId集合
groupCode	Long	是	无	商品组编号

响应参数

名称	类型	描述
priceResults	List<Map<String,Object>>	商品价格结果集
├ Map<String,Object>	java.util.Map	商品价格map对象
├ skuId	String	skuId
├ price	BigDicimal	商品原始采买价格
├ jdPrice	BigDicimal	商品京东价格
├ distributePrice	BigDicimal	商品渠道价格

请求Body参数示例

{
	"params": {
	    "skuIds":["1844681685799","1844681685791"],
	    "groupCode":"3660"
	}
}

1
2
3
4
5
6

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"price": 13.9,
				"jdPrice": 13.9,
				"distributePrice": 13.9,
				"skuId": "1844681685791"
			},
			{
				"price": 30,
				"jdPrice": 30,
				"distributePrice": 30,
				"skuId": "1844681685799"
			}
		],
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

商品可售性批量查询

接口方法：/jddx-sc/jddx-sc-sku/batchQuerySkuCheck

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/batchQuerySkuCheck?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
skuIds	String	是	无	skuId集合
addressDto	map	是	无	四级地址校验
├provinceId	int	是	无	省
├cityId	int	是	无	市
├countyId	int	是	无	县
├townId	int	是	无	镇

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	List<Map<String,object>>	商详html
├saleState	Boolean	是否可售
├skuId	String	江湖商品id

请求Body参数示例

{
    "params":{
        "skuIds":"1844681685799,1844681685791",
        "addressDto":{
            "countyId":3972,
            "cityId":3970,
            "townId":12234,
            "provinceId":26
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"saleState": true,
				"skuId": "1844681685799"
			},
			{
				"saleState": true,
				"skuId": "1844681685791"
			}
		],
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

一级地址查询

接口方法：/jddx-sc/jddx-sc-sku/provinceQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/provinceQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
无		否	无

响应参数

名称	类型	描述
provinceList	java.util.List	一级地址列表
├ id	Integer	一级地址代码
├ name	String	一级地址名称

请求Body参数示例

{"params":{}}

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"name": "北京",
				"id": 1
			},
			{
				"name": "广西",
				"id": 20
			},
			{
				"name": "江西",
				"id": 21
			},
			{
				"name": "四川",
				"id": 22
			},
			{
				"name": "海南",
				"id": 23
			},
			{
				"name": "贵州",
				"id": 24
			},
			{
				"name": "云南",
				"id": 25
			},
			{
				"name": "西藏",
				"id": 26
			},
			{
				"name": "陕西",
				"id": 27
			},
			{
				"name": "甘肃",
				"id": 28
			},
			{
				"name": "青海",
				"id": 29
			},
			{
				"name": "宁夏",
				"id": 30
			},
			{
				"name": "新疆",
				"id": 31
			},
			{
				"name": "台湾",
				"id": 32
			},
			{
				"name": "钓鱼岛",
				"id": 84
			},
			{
				"name": "广东",
				"id": 19
			},
			{
				"name": "湖南",
				"id": 18
			},
			{
				"name": "上海",
				"id": 2
			},
			{
				"name": "天津",
				"id": 3
			},
			{
				"name": "重庆",
				"id": 4
			},
			{
				"name": "河北",
				"id": 5
			},
			{
				"name": "山西",
				"id": 6
			},
			{
				"name": "河南",
				"id": 7
			},
			{
				"name": "辽宁",
				"id": 8
			},
			{
				"name": "吉林",
				"id": 9
			},
			{
				"name": "黑龙江",
				"id": 10
			},
			{
				"name": "湖北",
				"id": 17
			},
			{
				"name": "福建",
				"id": 16
			},
			{
				"name": "浙江",
				"id": 15
			},
			{
				"name": "安徽",
				"id": 14
			},
			{
				"name": "山东",
				"id": 13
			},
			{
				"name": "江苏",
				"id": 12
			},
			{
				"name": "内蒙古",
				"id": 11
			},
			{
				"name": "港澳",
				"id": 52993
			}
		],
		"resultMsg": "成功"
	}
}

二级地址查询

接口方法：/jddx-sc/jddx-sc-sku/cityQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/cityQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
parentId	Integer	是	无	一级地址id

响应参数

名称	类型	描述
cityList	java.util.List	二级地址列表
├ id	Integer	二级地址代码
├ name	String	二级地址名称

示例：

请求Body参数示例

{"params":{"parentId":5}}

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"name": "保定市",
				"id": 199
			},
			{
				"name": "承德市",
				"id": 239
			},
			{
				"name": "沧州市",
				"id": 264
			},
			{
				"name": "石家庄市",
				"id": 142
			},
			{
				"name": "邢台市",
				"id": 164
			},
			{
				"name": "邯郸市",
				"id": 148
			},
			{
				"name": "衡水市",
				"id": 275
			},
			{
				"name": "廊坊市",
				"id": 274
			},
			{
				"name": "秦皇岛市",
				"id": 248
			},
			{
				"name": "唐山市",
				"id": 258
			},
			{
				"name": "张家口市",
				"id": 224
			}
		],
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

三级地址查询

接口方法：/jddx-sc/jddx-sc-sku/countyQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/countyQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
parentId	Integer	是	无	二级地址id

响应参数

名称	类型	描述
countyList	java.util.List	三级地址列表
├ id	Integer	三级地址代码
├ name	String	三级地址名称

请求Body参数示例

{"params":{"parentId":142}}

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"name": "长安区",
				"id": 42547
			},
			{
				"name": "高邑县",
				"id": 158
			},
			{
				"name": "藁城区",
				"id": 42540
			},
			{
				"name": "行唐县",
				"id": 156
			},
			{
				"name": "晋州市",
				"id": 145
			},
			{
				"name": "井陉矿区",
				"id": 3182
			},
			{
				"name": "井陉县",
				"id": 153
			},
			{
				"name": "栾城区",
				"id": 154
			},
			{
				"name": "灵寿县",
				"id": 157
			},
			{
				"name": "石家庄高新技术产业开发区",
				"id": 60619
			},
			{
				"name": "鹿泉区",
				"id": 42541
			},
			{
				"name": "无极县",
				"id": 162
			},
			{
				"name": "平山县",
				"id": 4158
			},
			{
				"name": "桥东区",
				"id": 42545
			},
			{
				"name": "桥西区",
				"id": 42544
			},
			{
				"name": "深泽县",
				"id": 161
			},
			{
				"name": "新华区",
				"id": 42543
			},
			{
				"name": "辛集市",
				"id": 143
			},
			{
				"name": "新乐市",
				"id": 146
			},
			{
				"name": "元氏县",
				"id": 163
			},
			{
				"name": "裕华区",
				"id": 42546
			},
			{
				"name": "赵县",
				"id": 159
			},
			{
				"name": "正定县",
				"id": 42542
			},
			{
				"name": "赞皇县",
				"id": 160
			}
		],
		"resultMsg": "成功"
	}
}

四级地址查询

接口方法：/jddx-sc/jddx-sc-sku/townQuery

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/townQuery?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	示例值	描述
parentId	Integer	是	无	三级地址id

响应参数

名称	类型	描述
townList	java.util.List	四级地址列表
├ id	Integer	四级地址代码
├ name	String	四级地址名称

请求Body参数示例

{"params":{"parentId":42547}}

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": [
			{
				"name": "长丰街道",
				"id": 54561
			},
			{
				"name": "城区",
				"id": 51268
			},
			{
				"name": "阜康街道",
				"id": 54572
			},
			{
				"name": "广安街道",
				"id": 54571
			},
			{
				"name": "高营镇",
				"id": 42906
			},
			{
				"name": "河东街道",
				"id": 54570
			},
			{
				"name": "建北街道",
				"id": 54568
			},
			{
				"name": "建安街道",
				"id": 54569
			},
			{
				"name": "南村镇",
				"id": 42905
			},
			{
				"name": "青园街道",
				"id": 54567
			},
			{
				"name": "胜利北街道",
				"id": 54566
			},
			{
				"name": "谈固街道",
				"id": 54565
			},
			{
				"name": "桃园镇",
				"id": 54564
			},
			{
				"name": "西兆通镇",
				"id": 42904
			},
			{
				"name": "跃进街道",
				"id": 54562
			},
			{
				"name": "育才街道",
				"id": 54563
			},
			{
				"name": "中山东路街道",
				"id": 54560
			}
		],
		"resultMsg": "成功"
	}
}

高销商品输出

接口方法：/jddx-sc/jddx-sc-sku/distributionSkuSearch

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/distributionSkuSearch?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
skuId	String	否	江湖统一编码
productNameLike	String	否	商品名称
distributionPriceStart	Decimal	否	最低价格
distributionPriceEnd	Decimal	否	最高价格
itemFirstCateCode	String	否	商城一级类目ID,多个以","分隔
itemSecondCateCode	String	否	商城二级类目ID,多个以","分隔
itemThirdCateCode	String	否	商城三级类目ID,多个以","分隔
itemFourthCateCode	String	否	商城四级类目ID,多个以","分隔
pageNo	String	否	最小1，最大495
pageSize	String	否	默认：20

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	List<Map<String,Object>>	响应内容
├ skuId	String	江湖统一编码
├ goodsName	String	商品名称
├ imageUrl	String	商品图片
├ distributionPrice	Decimal	分销价

请求Body参数示例

{
    "params": {
                  "pageNo":1,
                  "pageSize":20
              }
    }
}

1
2
3
4
5
6
7

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "pageBean": {
            "pageNo": 1,
            "totalPage": 67293,
            "pageSize": 20,
            "end": false,
            "totalRecord": 1345856,
            "params": {},
            "class": "com.jd.jr.jddx.common.export.PageBean"
        },
        "value": [
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "1162.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/130724/20/4678/74272/5f1153cbE5304c279/1046c0ce8fccea24.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 男休闲鞋 CE0B3M03MU1AM0 黑色 255",
                "skuId": "1846732285465"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "288.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/129399/28/7592/113176/5f163e48E2d863055/2acd5f5bed3fd723.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "依立腾DP5801衬衫长袖商务休闲职业正装四季衬衣团购定制",
                "skuId": "1846732285823"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "288.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/129399/28/7592/113176/5f163e48E2d863055/2acd5f5bed3fd723.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "依立腾DP5801衬衫长袖商务休闲职业正装四季衬衣团购定制",
                "skuId": "1846732285653"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "1120.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/122482/19/7625/130953/5f165fe3E268a771d/f1cc95d208fc5b90.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "时光一百（Time100）航海家系列飞轮款高级机械自动男士腕表 W70035G钢色",
                "skuId": "1846732285341"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "955.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/119358/8/13539/49998/5f1697b0Eaa733898/38a60c6d48681e6e.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CE0B4G01FA1BL0 白色 235",
                "skuId": "1846732285568"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "288.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/129399/28/7592/113176/5f163e48E2d863055/2acd5f5bed3fd723.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "依立腾DP5801衬衫长袖商务休闲职业正装四季衬衣团购定制",
                "skuId": "1846732285895"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "288.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/129399/28/7592/113176/5f163e48E2d863055/2acd5f5bed3fd723.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "依立腾DP5801衬衫长袖商务休闲职业正装四季衬衣团购定制",
                "skuId": "1846732285611"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "142.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/113746/20/11948/44184/5f06e3b5Eb19dd74b/f118f078c837884f.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "小米（MI）米家有品黑加手环1S智能运动彩屏触控多功能NFC公交卡地铁支付睡眠心率监测来电提醒游泳防水",
                "skuId": "1846732285619"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "955.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/119358/8/13539/49998/5f1697b0Eaa733898/38a60c6d48681e6e.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CE0B4G01FA1BL0 白色 240",
                "skuId": "1846732285845"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "27.80",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/131449/40/4952/101368/5f1644efE81f211b4/2da07b1b598558eb.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "兰伊佩（Lanexpress）收纳箱 棉麻内衣收纳盒 多格可折叠 有盖内裤袜子整理盒 深灰色32*26*13cm",
                "skuId": "1846732282928"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "288.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/129399/28/7592/113176/5f163e48E2d863055/2acd5f5bed3fd723.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "依立腾DP5801衬衫长袖商务休闲职业正装四季衬衣团购定制",
                "skuId": "1846732285846"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "288.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/129399/28/7592/113176/5f163e48E2d863055/2acd5f5bed3fd723.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "依立腾DP5801衬衫长袖商务休闲职业正装四季衬衣团购定制",
                "skuId": "1846732282991"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "1254.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/142837/14/3146/77696/5f11541fE99ec70fa/7aa62c918a1a17c2.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 男休闲鞋 CE0B3M04MU1AM0 黑色 260",
                "skuId": "1846732285352"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "771.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/116883/5/12634/35052/5f11500dE9213b512/9edd30d75f60c3f4.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CNDU1S02FK1BL0 粉色 235",
                "skuId": "1846732282997"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "955.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/144651/40/3413/56191/5f169778E88d12b76/5c4238fe6aadbebe.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CE0B3W02FK1BL0 粉色 230",
                "skuId": "1846732285688"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "840.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/124971/4/7238/33709/5f114f84E690f92c9/8bba5ab351d6ab5f.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CNDU1H08FA1BH0 白色 230",
                "skuId": "1846732285684"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "955.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/119358/8/13539/49998/5f1697b0Eaa733898/38a60c6d48681e6e.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CE0B4G01FA1BL0 白色 245",
                "skuId": "1846732285689"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "178.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/134588/13/4665/91479/5f1050f4Ee378fd68/01a366f6cf1f4c49.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "蕉下BENEUNDER 遮阳伞防紫外线防晒折叠晴雨伞单层五折胶囊伞 栖寻系列 浮豹",
                "skuId": "1846732285848"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "955.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/134240/21/4935/56871/5f1697d6Ef70b784f/ad5100f2e685c910.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CE0B4G01FF1BL0 卡其色 245",
                "skuId": "1846732282946"
            },
            {
                "businessLineName": "vop",
                "salesPricce": "0.00",
                "saleFlag": false,
                "distributionPrice": "955.00",
                "businessLine": "203",
                "imageUrl": "//img30.360buyimg.com/cf/jfs/t1/134240/21/4935/56871/5f1697d6Ef70b784f/ad5100f2e685c910.jpg",
                "class": "com.jd.jr.jddx.sc.sku.export.vo.DistributionSkuInfoVO",
                "goodsName": "暇步士HushPuppies 女凉鞋 CE0B4G01FF1BL0 卡其色 240",
                "skuId": "1846732285607"
            }
        ],
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241

根据产品入口编码查询商品

接口方法：/jddx-sc/jddx-sc-sku/ztRecommend

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/ztRecommend?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
recommendId	String	是	场景id
source	String	是	来源
rid	String	是	请求id，唯一请求ID，使用追踪日志
lastId	String	是	首次查询为空，后面用请求返回的lastId
pageSize	int	否	每页条数，默认10
userId	String	否	江湖入驻商家方的用户id
groupId	String	否	江湖商品组id

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	DiscoveryRecommendResp	响应内容
├ resultData	List<RecommendVo>	最终结果
├ lastId	String	最后一条数据ID
├ isEnd	int	是否到底 0有数据 1无数据或者最后一页
├ realId	String	上一次请求的最后一条数据信息

请求Body参数示例

成功响应示例

商品通用转链

接口方法：/jddx-sc/jddx-sc-sku/linkTranslateUniversal

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/linkTranslateUniversal?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
agencyId	String	是	渠道id
url	String	是	商品url
skuId	String	否	商品id
sub	int	否	自定义字段，最大20 数字+字母组合，可做跟单标记
coupon	int	否	传 1 需要优惠券必须传skuId 不传不需要

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	Map<String，Object>	响应内容
├ resultData	linkTranslate	最终结果
├ clickUrl	String	转链后的链接
├ linkCode	String	链接在本系统中的唯一ID
├ shortUrl	String	短链

请求Body参数示例

{"params":{"skuId":"2795902","url":"https://q.jd.com/m/react/index.html?skuId=2795902","coupon":"1","agencyId":"8655"}}

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "success": true,
            "linkTranslate": {
                "clickUrl": "https://union-click.jd.com/jdc?e=&p=AyIGZRprFgQaA10aWCVGTV8LRGtMR1dGFxBFC1lKWANMD0odSVJKSQVJHEpCAUdETEdOWltZAVEOEQFdH1MUAQVHWW9ZR1JmZBxfLxR2cXNUThliYHpgIUI4VnR7bzx4WmpCcn4Hfyx2eUxkV2gpdmFlRiFyIGNhSmQQbFlPYGVkLkQsT3VPUixaG3ZJU3M2eDtVemtVPGwCXF5mWC15LGdiBgUgKysSem8ABk4QdXB0byEFL05VGl5VQx0ZDiIHUhxdHQsSBlwfaxUDEwZSGlkQABs3CUccF2waDzsSXBEGfAY7ZiV9X2RaDUMaSzISAmVNNRUDEwZUG18SBRc3VRNeHAAQBl0TWyUCFg9dHl0VAREPVhtYJQITD2XN85nVvpeBv%2BzBrK03ZStYJTIiB1YrWCVdVloIK1kUAxQE",
                "linkCode": "LOYlGliipo",
                "shortUrl": "https://u.jd.com/StXRIa"
            }
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

获取商品详情

接口方法：/jddx-sc/jddx-sc-sku/getSkuInfo

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/getSkuInfo?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
skuId	String	是	skuId

响应参数

请求Body参数示例

成功响应示例

商品搜索接口

接口方法：/jddx-sc/jddx-sc-sku/recommendSearch

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/recommendSearch?appkey=cb61edde871d4d6fbec2438288ae3f56&timestamp=1602643642275&sign=71419a3e3b9f35c077f464e4c60b557e

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
applyCode	String	是	江湖场景编号，必填项
inputValue	String	是	关键词，搜索时必填项；

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	Map<String，Object>	响应内容
├ resultData	List	最终结果

名称	类型	描述
RecommendVo	RecommendVo	响应实体
├ id	String	商品id
├ itemDetail	SkuInfoVo	商品数据明细

请求Body参数示例

 {"params":{"applyCode":"A365043709778038784"}}

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "extMapData": {},
            "resultData": [
                {
                    "templateType": "1",
                    "itemDetail": {
                        "selfService": 0,
                        "spinChainType": 0,
                        "exposal_url": "https://m.360buyimg.com/jrqb/jfs/t1/75774/7/7160/95/5d5404a0Eff3f80ba/728068dfc942243b.png",
                        "isPeriodization": 0,
                        "pingouTmCount": 0,
                        "mxPlans": [],
                        "cid2": 686,
                        "thumbnailImageList": [
                            "jfs/t1/142210/37/8293/157832/5f5c8a0eE0835e588/93ce67c0e8a85433.jpg",
                            "jfs/t1/114761/32/17537/215380/5f5c9408E48c7e74b/27730c9c32b8291d.jpg",
                            "jfs/t1/2984/6/748/371706/5b924e7aEbbb7287f/a28899f73865e0c9.jpg",
                            "jfs/t1/146888/10/8168/121980/5f5c940dE5a8b95d7/af56c2b01b41630b.jpg",
                            "jfs/t1/148136/35/8084/137655/5f5c9412E0d2fc527/f746390f99e4dafb.jpg",
                            "jfs/t1/3729/33/4951/378171/5b9e179dEa9b18418/d2f6436564b28505.jpg",
                            "jfs/t1/506/17/1062/430499/5b924e7bE3151812f/54f5ce469cfdd26e.jpg",
                            "jfs/t1/147829/14/8180/157652/5f5c9419E494a6eb2/3fe090754f7054d0.jpg"
                        ],
                        "cid1": 670,
                        "skuId": "1543721098",
                        "cid1Name": "电脑、办公",
                        "extDataMap": {},
                        "image_url": "jfs/t1/142210/37/8293/157832/5f5c8a0eE0835e588/93ce67c0e8a85433.jpg",
                        "tags2": [],
                        "pingouStartTime": 0,
                        "wlCommissionShare": "20.0",
                        "tags": [],
                        "wlCommission": "9.5",
                        "goodsPrice": "59.9",
                        "imageList": [
                            "https://img14.360buyimg.com/ads/jfs/t1/142210/37/8293/157832/5f5c8a0eE0835e588/93ce67c0e8a85433.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/114761/32/17537/215380/5f5c9408E48c7e74b/27730c9c32b8291d.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/2984/6/748/371706/5b924e7aEbbb7287f/a28899f73865e0c9.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/146888/10/8168/121980/5f5c940dE5a8b95d7/af56c2b01b41630b.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/148136/35/8084/137655/5f5c9412E0d2fc527/f746390f99e4dafb.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/3729/33/4951/378171/5b9e179dEa9b18418/d2f6436564b28505.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/506/17/1062/430499/5b924e7bE3151812f/54f5ce469cfdd26e.jpg",
                            "https://img14.360buyimg.com/ads/jfs/t1/147829/14/8180/157652/5f5c9419E494a6eb2/3fe090754f7054d0.jpg"
                        ],
                        "isHot": 1,
                        "realPrice": "50.40",
                        "xfzkPlans": [],
                        "shopName": "敏涛数码专营店",
                        "ad_title": "前行者游戏背光发光真机械手感键盘鼠标套装吃鸡键鼠台式有线薄膜静音网吧外设电脑笔记本办公套us外接键盘 黑色彩虹背光键盘+七彩黑鼠标",
                        "pingouEndTime": 0,
                        "hasCoupon": 1,
                        "cid2Name": "外设产品",
                        "click_url": "https://q.jd.com/m/react/index.html?skuId=1543721098&groupId=7196&xxfSceneId=A365043709778038784",
                        "class": "com.jd.cf.discovery.export.vo.SkuInfoVo",
                        "comments": 934400,
                        "coupon": {
                            "useEndTime": 1602777599000,
                            "useStartTime": 1601481600000,
                            "quota": 48.0,
                            "platformType": 0,
                            "couponKind": 6,
                            "link": "http://coupon.m.jd.com/coupons/show.action?key=1b89379003dc40429a6ca12fdd34263c&roleId=38949612",
                            "discountPriceCommission": "9.58",
                            "discountPrice": "47.90",
                            "discount": 12.0,
                            "beginTime": 1601481600000,
                            "endTime": 1602691199000
                        },
                        "sku_cid3": "689",
                        "lowestPriceType": 1,
                        "commentMap": {},
                        "inOrderCount30Days": 9416,
                        "interestFree": 0,
                        "goodComments": 679966,
                        "cid3Name": "键盘",
                        "benefitMap": {}
                    },
                    "type": "101",
                    "strategyType": "cps",
                    "extMap": {
                        "allDataIndex": 10,
                        "rpcStrategyType": "cps",
                        "rpcStrategySkuGroupId": "7196",
                        "rpcStrategyClstags": ""
                    },
                    "subtype": "101001",
                    "id": "1543721098",
                    "clstags": "jr|keycount|jddx_A365043709778038784|#wpin_A365043709778038784_7196_101_1543721098_11__##",
                    "realId": "101_1543721098",
                    "class": "com.jd.cf.discovery.export.vo.RecommendVo"
                }
            ],
            "success": true,
            "resultCode": "0000",
            "lastId": "2",
            "resultMapData": {
                "componentStyleShow": "jdOneRowTuoTwoColNew",
                "isTransparence": 1,
                "proxyStatus": 4,
                "componentBackUrl": "https://jddx.jd.com/m/jddnew/btyingxiao/sfstore/index.html",
                "skugroupId": 7196,
                "isShortName": 1,
                "volumePrice": "1",
                "channel": "1",
                "edition": 1,
                "goldProcessType": "COMMON",
                "webMasterId": "1000603438",
                "menberMode": 1,
                "websiteId": "1797718550",
                "componentBackContent": "返回首页",
                "pageType": 1,
                "isFpBg": 2,
                "isValidUnion": 2,
                "promotionLocationId": "1865610199",
                "applyName": "内_社区团_首页分类页_底部",
                "isValidBt": 1,
                "isAngularRadian": 1,
                "isBi": 2,
                "componentType": 10,
                "lineMode": 1,
                "skuShow": "4,8",
                "feedBannerStatus": 0,
                "isWhiteNote": 1,
                "isApi": 1,
                "isMIX": 2,
                "periodization": 2,
                "componentStyle": 1,
                "accountId": "8655",
                "shopGroupMap": [
                    {
                        "7196": {
                            "skugroupId": 7196,
                            "screenMode": 1
                        }
                    }
                ],
                "skugroupIds": "7196",
                "applyCode": "A365043709778038784",
                "isShowTitle": 1,
                "isBgStyle": 1,
                "customer": "794162-27487687"
            },
            "totalCount": 10,
            "class": "com.jd.cf.discovery.export.vo.DiscoveryRecommendResp",
            "isEnd": 0,
            "resultMsg": "成功"
        },
        "resultMsg": "成功"
    }
}

智能商品组查询

接口方法：/jddx-sc/jddx-sc-sku/pkgSkuSearch

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/pkgSkuSearch?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
skugroupId	String	是	智能商品组id
pageNo	String	否	页码默认1
pageSize	String	否	页面大小默认10

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	List>	响应内容

请求Body参数示例

成功响应示例

类目查询

接口方法：/jddx-sc/jddx-sc-sku/pkgCategorySearch

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/pkgCategorySearch?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
firstCategory	List	否	一级类目
secondCategory	List	否	二级类目
thirdCategory	List	否	三级类目

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	List>	响应内容

请求Body参数示例

成功响应示例

品牌查询

接口方法：/jddx-sc/jddx-sc-sku/pkgBrandSearch

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/pkgBrandSearch?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
skuBrand	SkuBrandVO	否	品牌对象
pageNo	String	否	页码默认1
pageSize	String	否	页面大小默认10

其中SkuBrandVO 中key和value结构

名称	类型	必须	描述
thirdCateCode	String	否	三级分类编码
thirdCateName	String	否	三级分类名称
secondCateCode	String	否	二级分类编码
secondCateName	String	否	二级分类名称
firstCateCode	String	否	一级分类编码
firstCateName	String	否	一级分类名称
brandCode	String	否	品牌编码
brandName	String	否	品牌名称
rank	String	否	归类

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	List>	响应内容

请求Body参数示例

成功响应示例

商品基础信息查询接口

接口方法：/jddx-sc/jddx-sc-sku/pkgSkuDetailBySkuIdForRecommend

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/pkgSkuDetailBySkuIdForRecommend?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
skuIds	List	是	商品sku集合，商品skuId不能重复
stock	String	否	是否查询库存 :1：查询，0：不查询
valid	String	否	是否查询最优免息 :1：查询，0：不查询
union	String	否	是否查询佣金 :1：查询，0：不查询
selectPg	String	否	是否查询拼购:1：查询，0：不查询
btPlanShow	String	否	是否查询息费信息 :1：查询，0：不查询
bdsUnified	String	否	是否查询商品透图信息，1：查询，0：不查询
comment	String	否	是否查询商品评论信息：1：查询，0：不查询
shortName	String	否	是否查询商品短名称信息：1：查询，0：不查询

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	List>	响应内容

请求Body参数示例

成功响应示例

商品检索/推荐接口

接口方法：/jddx-sc/jddx-sc-sku/pkgSkuInfoByCondition

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx-sc-sku/pkgSkuInfoByCondition?appkey=jd4a1a1e5d9cec3282&timestamp=1595337977744&sign=bdb90156269e2644a02afba9170ab9f3

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
isZy	Integer	否	是否自营，1：是
isPg	Integer	否	是否京喜，1：是，2：否，不传：全部
startJdPrc	Integer	否	商品价格起
endJdPrc	Integer	否	商品价格止
isLmSrc	Integer	否	是否分佣推广，1：是，2：否，不传：全部
startLmWlCommShare	Integer	否	分佣区间起
endLmWlCommShare	Integer	否	分佣区间止
itemFirstCateCode	Integer	否	一级类目编码,多选时逗号分隔
itemSecondCateCode	Integer	否	二级类目编码，多选时逗号分隔
itemThirdCateCode	Integer	否	三级类目编码，多选时逗号分隔
brandName	String	否	品牌名称，多选时逗号分隔
brandCode	Integer	否	品牌编码，多选时逗号分隔
sortJdPrc	String	否	价格排序,desc/asc
sortPxYj	String	否	佣金排序，desc/asc
sortSaleOrdCnt30days	String	否	销量排序，desc/asc
params	Map<String, Object>	否	扩展字段，如果作【推荐】用，传pin或者手机号时，以pin、phone为key
pageNo	Integer	否	页码
pageSize	Integer	否	页大小

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	boolean	是否成功
├ resultCode	String	响应码
├ value	List>	响应内容
├ pageBean	PageBean	商品分页参数

请求Body参数示例

成功响应示例

订单

地址详情转换京东地址编码

接口方法：/jddx-sc/jddx_sc_order/getJDAddressFromAddressApi

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/getJDAddressFromAddressApi?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595421559817&sign=a29d5e74a05f1392734ea62f7df79857

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
address	String	是	详细地址
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ value	Map<String,Object>	响应内容
├ provinceId	Number	省
├ cityId	Number	市
├ countyId	Number	县
├ townId	Number	乡镇

请求Body参数示例

{
    "params": {
        "address": "北京市亦庄开发区京东总部1号楼" ,
        "clientInfo": {
            "userId": "123",
            "userIP": "213",
            "serverName": "1212",
            "serverIP": "123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "countyId": 51081,
            "cityId": 2810,
            "townId": 0,
            "provinceId": 1
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

查询配送预计送达时间

接口方法：/jddx-sc/jddx_sc_order/getPromiseTips

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/getPromiseTips?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
skuId	String	是	江湖商品ID
skuNum	String	是	数量
addressDto	Map<String,Object>	是	地址信息
├ provinceId	Number	是	省
├ cityId	Number	是	市
├ countyId	Number	是	县
├ townId	Number	是	乡
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
success	boolean	是否成功
resultCode	String	响应码
resultMsg	String	响应描述
value	Map<String,Object>	响应实体
├content	String	预计送达时间

请求Body参数示例

{
    "params":{
        "skuId":"1844681685007",
        "skuNum":1,
        "addressDto":{
            "provinceId":1,
            "cityId":2810,
            "countyId":51081,
            "townId":0
        },
        "clientInfo":{
            "userId":"123",
            "userIP":"213",
            "serverName":"1212",
            "serverIP":"123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": {
			"content": "23:10前下单，预计<b>明天(07月23日)</b>送达"
		},
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13

订单(创建订单)

接口方法：/jddx-sc/jddx_sc_order/submitOrder

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/submitOrder?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595419697069&sign=d63a7d7040abe3ffe50be98a26734061

注意：目前下单支持一单一品

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
cartReq	Map<String,Object>	是	购物车
├ skuList	List<Map>	是	sku
├ sku	Number	是	商品id
├ num	Number	是	购买商品数量
├ name	String	是	商品名称请utf-8 url编码
├ discountPrice	Number	否	优惠金额
orderParam	Map<String,Object>	是	订单信息
├ channel	Number	是	订单渠道值；1：众筹订单，2：VOP订单，0或空：其他订单
├ remark	String	否	订单备注
├ address	Map<String,Object>	是	地址信息
├ addressId	Number	否	对应收货地址id，可以不传
├ name	String	是	收货人姓名，必传
├ provinceId	Number	是	省
├ cityId	Number	是	市
├ countyId	Number	是	县
├ townId	Number	是	乡
├ provinceName	String	否	省
├ cityName	String	否	市
├ countyName	String	否	县
├ townName	String	否	乡
├ addressDetail	String	是	详细地址
├ postCode	String	否	邮编
├ mobile	String	是	手机
├ phone	String	否	电话
├ email	String	是	email
├ longitude	Number	否	经度
├ latitude	Number	否	纬度
├ invoice	Object	否	发票
├ invoiceType	Number	是	发票类型 1不开发票 2个人发票 3公司发票
├ invoiceTitle	String	是	发票抬头
├ freight	number	否	运费
clientInfo	Object	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip
├ userAgent	String	是	流览器UA

响应参数

名称	类型	描述
code	String	响应码
message	String	响应消息
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ class	String	类名
orderId	Number	生成的订单号
submitSkuNum	Number	提交的商品数量
orderInfo	String	订单信息
noStockSkuList	Object[]	没有库存商品列表
receivableAmount	Nubmer	订单应收金额

请求Body参数示例

{
    "params": {
        "cartReq": {
            "skuList": [
                {
                    "name": "悠梵萌狗狗飞盘狗边牧用品金毛宠物飞碟训练狗狗玩具耐咬可浮水",
                    "num": 1,
                    "sku":1844681685007
                }
            ]
        },
        "orderParam": {
            "address": {
                "addressDetail": "北京市亦庄开发区京东总部",
                "addressId": 0,
                "cityId": 2810,
                "countyId": 51081,
                "email": "test@[qq.com](http://qq.com)",
                "latitude": 0,
                "longitude": 0,
                "mobile": "13111111111",
                "name": "收货人",
                "provinceId": 1,
                "townId": 0,
                "invoiceType":"1",
                "invoiceTitle":"无"
            },
            "channel": 2,
            "remark": "测试202004161026"
        },
        "clientInfo": {
            "userId": "123",
            "userIP": "213",
            "serverName": "1212",
            "serverIP": "123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "orderNo": "3200202821720867"
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13

取消订单

接口方法：/jddx-sc/jddx_sc_order/cancelOrder

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/cancelOrder?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
orderNo	String	是	订单号
channel	Number	是	订单渠道值；1：众筹订单，2：VOP订单，0或空：其他订单
afterSaleType	Integer	是	售后类型：10、取下订单 20、退款
applyReasonId	Integer	否	取消原因id：601、订单不能按预计时间送达 608、其他渠道价格更低 609、该商品京东降价了 610、不想买了 611、其他原因 613、操作有误（商品、地址等选错）615、商品无货
cancelReason	String	是	取消订单原因
applyPin	String	否	申请人pin
customerPhoneNo	String	否	申请人电话
skuId	String	否	商品id
voucher	String	否	凭证

响应参数

名称	类型	描述
success	boolean	是否成功
resultCode	String	响应码
resultMsg	String	响应描述

请求Body参数示例

{
    "params":{
        "orderNo":"4000202913980867",
        "channel":2,
        "afterSaleType":10,
        "cancelReason":"我就是不想要了"
    }
}

1
2
3
4
5
6
7
8

成功响应示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"resultMsg": "成功"
	}
}

1
2
3
4
5
6
7
8
9
10
11

确认订单

接口方法：/jddx-sc/jddx_sc_order/orderSubmitApi

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/orderSubmitApi?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595422658169&sign=9bc10c98e083c89b85b5315e154d4c5d

请求方式

POST

Content-Type

application/json

注意：确认订单，确认之后不能通过API取消订单

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	订单号
channel	Number	是	订单渠道值；1：众筹订单，2：VOP订单，0或空：其他订单
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

订单号，返回订单号才是支付成功

名称	类型	描述
code	String	响应码
message	String	响应消息
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ class	String	类名
├ value	String	响应内容
├ value	String	订单号
├ businessNo	String	业务订单号
├ pin	String	下单人pin
├ orderChannel	String	订单来源
├ originalAmount	BigDecimal	原价
├ orderAmount	BigDecimal	订单价
├ actualPayAmount	BigDecimal	实际支付金额
├ benefitAmount	BigDecimal	优惠金额
├ freight	BigDecimal	运费
├ couponType	Integer	优惠券类型 1不使用优惠券
├ couponKey	String	优惠券的key
├ platform	String	下单客户端平台
├ invoiceType	Integer	发票类型
├ invoiceTitle	String	发票抬头
├ taxpayerNo	String	纳税人识别号
├ createOrderDate	Date	订单创建时间
├ createOrderProductDtoList	List<CreateOrderProductDto>	订单商品
├skuId	Long	skuId
├productId	Long	商品Id
├merchantId	Long	商户号
├customerId	String	客户id
├senceId	String	场景Id
├productName	String	商品名称
├productPrice	BigDecimal	商品价格
├sellPrice	BigDecimal	销售价格
├quantity	Integer	数量
├picture	String	商品图片链接
├attr	String	规格属性json
├orderAmount	BigDecimal	订单金额
├ createOrderAddressDto	Object	收货地址
├receiverName	String	收货人姓名
├ provinceId	Integer	省Id
├cityId	Integer	市Id
├ countyId	Integer	区县Id
├townId	Integer	街道Id
├ province	String	省
├city	String	市
├ county	String	区
├ town	String	街道
├ receiverDetail	String	收货人详细地址json
├ receiverPhone	String	收货人手机号
├ holeReceiverAddress	String	含有省市区的完整收货地址
├ addressId	String	收货地址id
├ splitType	Integer	拆单状态 1子单 2父单
├ parentBussinessOrderNo	String	父单号
├ platformSource	Integer	订单平台来源 0默认，1简单点pop店，2众筹pop店
├ InitFactPrice	BigDecimal	原始应付金额
├ actualPayAmount	BigDecimal	实际支付金额
├ payStatus	Integer	支付状态
├ skuGroupId	Integer	商品组id
├ extMap1	Map	扩展参数
├ jhProjectId	String	jhProjectId

请求Body参数示例

{
    "params": {
        "orderNo": "4000202899800867" ,
        "channel":2,
        "clientInfo": {
            "userId": "213213214",
            "userIP": "192.168.12.1",
            "serverName": "huoas",
            "serverIP": "192.168.12.254"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "benefitAmount": 0.00,
            "freight": 8.00,
            "orderStatus": 500,
            "orderChannel": 15,
            "createOrderDate": 1595420721000,
            "platform": "h5",
            "createOrderAddressDto": {
                "receiverName": "收货人",
                "cityId": 2810,
                "townId": 0,
                "provinceId": 1,
                "receiverPhone": "13111111111",
                "holeReceiverAddress": "北京市亦庄开发区京东总部",
                "countyId": 51081,
                "receiverDetail": "{\"cityId\":2810,\"countyId\":51081,\"holeReceiverAddress\":\"北京市亦庄开发区京东总部\",\"provinceId\":1,\"receiverName\":\"收货人\",\"receiverPhone\":\"13111111111\",\"townId\":0}",
                "class": "com.jd.jr.jddx.sc.order.export.createorder.dto.CreateOrderAddressDto"
            },
            "businessNo": "B122893223154",
            "orderAmount": 18.00,
            "pin": "C1000987468",
            "couponType": 1001,
            "invoiceType": 1,
            "createOrderProductDtoList": [
                {
                    "quantity": 1,
                    "productId": 1844681685007,
                    "sellPrice": 18.0000,
                    "skuGroupId": 0,
                    "productName": "悠梵萌狗狗飞盘狗边牧用品金毛宠物飞碟训练狗狗玩具耐咬可浮水",
                    "picture": "//img30.360buyimg.com/cf/jfs/t1/124498/8/4308/90319/5edb4feeEf9d31df0/7c24fc4cd54bafb2.jpg",
                    "orderAmount": 18.0000,
                    "createdDate": 1595420720000,
                    "merchantId": 0,
                    "customerId": "C1000987468",
                    "attr": "",
                    "class": "com.jd.jr.jddx.sc.order.export.createorder.dto.CreateOrderProductDto",
                    "productPrice": 18.0000,
                    "skuId": 100007350553
                }
            ],
            "class": "com.jd.jr.jddx.sc.order.export.createorder.dto.CreateOrderDto",
            "platformSource": 6,
            "orderNo": "4000202899800867",
            "splitType": 0,
            "actualPayAmount": 26.00,
            "originalAmount": 18.00,
            "payStatus": 100,
            "settleType": 0
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

查询订单列表

接口方法：/jddx-sc/jddx_sc_order/orderList

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/orderList?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595423273794&sign=53149e91135d6b1b5071b9eb1568de58

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	PageBean	是	分页参数

其中PageBean为分页参数

名称	类型	必须	描述
pageNo	int	否	页数，默认第一页
pageSize	int	否	每页显示数量，默认10

响应参数

名称	类型	描述
code	String	响应码
message	String	响应消息
Result	java.util.Map	请求参数体
├ value	MAP	响应内容
├ total	Number	商户下单订单条数
├ lists	String	订单号
├ orderNo	String	订单号
├ businessNo	String	B端订单号
├ pin	String	商户号
├ orderAmount	String	订单金额
├ freight	String	运费
├ orderStatus	String	订单状态
├ createOrderDate	String	订单创建时间
├ receiverName	String	收货人姓名
├ receiverAddress	String	收货地址
├ receiverPhone	String	收货电话
├ receiverAddressDetail	String	收货信息详情
├ payStatus	String	支付状态
├ orderProductDtoList	List<Map>	订单商品内容
├ skuId	String	江湖商品编号
├ productName	String	商品文案

请求Body参数示例

{
    "params": {"pageNo":1,"pageSize":3}
}

1
2
3

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "total": "6",
            "lists": [
                {
                    "receiverAddress": "北京市亦庄开发区京东总部",
                    "orderNo": "2900202841310867",
                    "orderAmount": 18.00,
                    "receiverPhone": "13111111111",
                    "receiverName": "收货人",
                    "freight": 8.00,
                    "orderStatus": 100,
                    "payStatus": 100,
                    "createOrderDate": 1595420713000,
                    "receiverAddressDetail": "{\"cityId\":2810,\"countyId\":51081,\"holeReceiverAddress\":\"北京市亦庄开发区京东总部\",\"provinceId\":1,\"receiverDetail\":\"{\\\"cityId\\\":2810,\\\"countyId\\\":51081,\\\"holeReceiverAddress\\\":\\\"北京市亦庄开发区京东总部\\\",\\\"provinceId\\\":1,\\\"receiverName\\\":\\\"收货人\\\",\\\"receiverPhone\\\":\\\"13111111111\\\",\\\"townId\\\":0}\",\"receiverName\":\"收货人\",\"receiverPhone\":\"13111111111\",\"townId\":0}",
                    "orderProductDtoList": [
                        {
                            "skuId": 1844681685007,
                            "productName": "悠梵萌狗狗飞盘狗边牧用品金毛宠物飞碟训练狗狗玩具耐咬可浮水"
                        }
                    ]
                },
                {
                    "receiverAddress": "北京市亦庄开发区京东总部",
                    "orderNo": "4000202899800867",
                    "orderAmount": 18.00,
                    "receiverPhone": "13111111111",
                    "receiverName": "收货人",
                    "freight": 8.00,
                    "orderStatus": 400,
                    "payStatus": 200,
                    "createOrderDate": 1595420721000,
                    "receiverAddressDetail": "{\"cityId\":2810,\"countyId\":51081,\"holeReceiverAddress\":\"北京市亦庄开发区京东总部\",\"provinceId\":1,\"receiverDetail\":\"{\\\"cityId\\\":2810,\\\"countyId\\\":51081,\\\"holeReceiverAddress\\\":\\\"北京市亦庄开发区京东总部\\\",\\\"provinceId\\\":1,\\\"receiverName\\\":\\\"收货人\\\",\\\"receiverPhone\\\":\\\"13111111111\\\",\\\"townId\\\":0}\",\"receiverName\":\"收货人\",\"receiverPhone\":\"13111111111\",\"townId\":0}",
                    "orderProductDtoList": [
                        {
                            "skuId": 1844681685007,
                            "productName": "悠梵萌狗狗飞盘狗边牧用品金毛宠物飞碟训练狗狗玩具耐咬可浮水"
                        }
                    ]
                },
                {
                    "receiverAddress": "北京市亦庄开发区京东总部",
                    "orderNo": "2600202855880867",
                    "orderAmount": 30.00,
                    "receiverPhone": "13111111111",
                    "receiverName": "收货人",
                    "freight": 8.00,
                    "orderStatus": 100,
                    "payStatus": 100,
                    "createOrderDate": 1595419704000,
                    "receiverAddressDetail": "{\"cityId\":2810,\"countyId\":51081,\"holeReceiverAddress\":\"北京市亦庄开发区京东总部\",\"provinceId\":1,\"receiverDetail\":\"{\\\"cityId\\\":2810,\\\"countyId\\\":51081,\\\"holeReceiverAddress\\\":\\\"北京市亦庄开发区京东总部\\\",\\\"provinceId\\\":1,\\\"receiverName\\\":\\\"收货人\\\",\\\"receiverPhone\\\":\\\"13111111111\\\",\\\"townId\\\":0}\",\"receiverName\":\"收货人\",\"receiverPhone\":\"13111111111\",\"townId\":0}",
                    "orderProductDtoList": [
                        {
                            "skuId": 1844681685799,
                            "productName": "悠梵萌猫碗狗碗防打翻悬挂式宠物食盆不锈钢固定挂笼猫粮饭盆水碗猫咪碗 蓝色大号"
                        }
                    ]
                }
            ]
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

查询订单详情

接口方法：/jddx-sc/jddx_sc_order/orderDetail

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/orderDetail?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595423672248&sign=a77308074a8b885fe2c9371882f3676e

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	订单号
clientInfo	Object	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	Map<String,Object>	请求参数体
├ orderNo	String	订单号
├ businessNo	String	B端订单号
├ pin	String	商户号
├ orderAmount	String	订单金额
├ freight	String	运费
├ orderStatus	String	订单状态 100已下单 200订单取消 400待发货 410已发货 500确认收货
├ createOrderDate	String	订单创建时间
├ receiverName	String	收货人姓名
├ receiverAddress	String	收货地址
├ receiverPhone	String	收货电话
├ receiverName	String	收货人姓名
├ receiverAddressDetail	String	收货信息详情
├ payStatus	String	支付状态 100 未支付 200已支付 300已退款 310退款中
├ orderProductDtoList	List<Map>	订单商品内容
├ skuId	String	江湖商品编号
├ productName	String	商品文案

请求Body参数示例

{
    "params": {
        "orderNo": "4000202899800867",
        "clientInfo": {
            "userId": "123",
            "userIP": "213",
            "serverName": "1212",
            "serverIP": "123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "receiverAddress": "北京市亦庄开发区京东总部",
            "orderNo": "4000202899800867",
            "orderAmount": 18.00,
            "receiverPhone": "13111111111",
            "receiverName": "收货人",
            "freight": 8.00,
            "orderStatus": 400,
            "payStatus": 200,
            "createOrderDate": 1595420721000,
            "receiverAddressDetail": "{\"cityId\":2810,\"countyId\":51081,\"holeReceiverAddress\":\"北京市亦庄开发区京东总部\",\"provinceId\":1,\"receiverDetail\":\"{\\\"cityId\\\":2810,\\\"countyId\\\":51081,\\\"holeReceiverAddress\\\":\\\"北京市亦庄开发区京东总部\\\",\\\"provinceId\\\":1,\\\"receiverName\\\":\\\"收货人\\\",\\\"receiverPhone\\\":\\\"13111111111\\\",\\\"townId\\\":0}\",\"receiverName\":\"收货人\",\"receiverPhone\":\"13111111111\",\"townId\":0}",
            "orderProductDtoList": [
                {
                    "skuId": 1844681685007,
                    "productName": "悠梵萌狗狗飞盘狗边牧用品金毛宠物飞碟训练狗狗玩具耐咬可浮水"
                }
            ]
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

查询订单配送信息

接口方法：/jddx-sc/jddx_sc_order/orderTrack

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/orderTrack?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595423927856&sign=1d8ae771c5dd4d2a0c5b2f8a82320363

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	订单号
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	java.util.Map	请求参数体
├ success	String	是否成功
├ resultCode	String	响应码
├ value	Map<String,Object>	响应内容
├ orderNo	String	订单号
├ orderTrack	List<Map>	订单商品内容
├ content	String	内容
├ msgTime	String	发生时间
├ operator	String	操作人员
├ waybillCode	List<Map>	运单
├ parentId	String	父订单号
├ deliveryOrderId	String	运单号
├ carrier	String	快递公司
├ orderNo	String	订单号

请求Body参数示例

{
    "params": {
        "orderNo": "4000202899800867",
        "clientInfo": {
            "userId": "123",
            "userIP": "213",
            "serverName": "1212",
            "serverIP": "123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "orderNo": "4000202899800867",
            "orderTrack": [
                {
                    "msgTime": "2020-07-22 20:25:20",
                    "content": "您提交了订单，请等待系统确认",
                    "operator": "客户"
                },
                {
                    "msgTime": "2020-07-22 21:04:22",
                    "content": "您的订单已经进入京东北京仓库准备出库",
                    "operator": "系统"
                },
                {
                    "msgTime": "2020-07-22 21:04:22",
                    "content": "您的订单预计2020-07-22 21:04开始处理，请您耐心等待",
                    "operator": "系统"
                },
                {
                    "msgTime": "2020-07-22 21:04:23",
                    "content": "温馨提示：您的订单预计7月23日09:00-15:00送达您手中",
                    "operator": "系统"
                }
            ],
            "waybillCode": [
                {
                    "carrier": "京东快递",
                    "orderNo": "4000202899800867",
                    "parentId": "0",
                    "deliveryOrderId": "JD0021422114101"
                }
            ]
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

确认收货

接口方法：/jddx-sc/jddx_sc_order/completeOrderApi

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/completeOrderApi?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595421559817&sign=a29d5e74a05f1392734ea62f7df79857

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	售后订单号
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
code	String	响应码
message	String	响应消息
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ class	String	类名
├ value	String	响应内容
├ orderNo	String	订单号

请求Body参数示例

{
    "params": {
        "orderNo": "4000202899800867",
        "clientInfo": {
            "userId": "123",
            "userIP": "213",
            "serverName": "1212",
            "serverIP": "123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "orderNo": "4000202899800867"
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13

根据父订单号查询子单(查询子单)

接口方法：/jddx-sc/jddx_sc_order/getChildrenOrderApi

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/getChildrenOrderApi?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595422316703&sign=9f8ce564d12923e8cca7323b3bd81933

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	订单号
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ value	java.util.Set	["子订单号1" , "子订单号2" , "子订单号3"]
├ orderNo	String	订单号

请求Body参数示例

{
    "params": {
        "orderNo": "4000202899800867" ,
        "clientInfo": {
            "userId": "213213214",
            "userIP": "192.168.12.1",
            "serverName": "huoas",
            "serverIP": "192.168.12.254"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功响应示例

{
  "code": "00000000",
  "message": "响应成功",
  "result": {
      "success": true,
      "resultCode": "0000",
      "class": "com.jd.jr.jddx.common.export.Result",
      "value": {
          "4000202899800867": []
      },
      "resultMsg": "成功"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13

查询账户余额

接口方法：/jddx-sc/jddx_sc_order/getBingAccountInfo

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/getBingAccountInfo?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595423927856&sign=1d8ae771c5dd4d2a0c5b2f8a82320363

请求方式

POST

Content-Type

application/json

参数无（公共参数必传）

响应参数：

名称	类型	描述
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ value	Map<String,Object>	响应内容
├ customerId	String	商户ID
├ accountAmount	String	余额

入参：

{
    "params": {}
}

1
2
3

出参：

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "customerId": "C1000987468",
            "accountAmount": "272.18"
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

对账接口

接口方法：/jddx-sc/jddx_sc_order/reconciliation

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/reconciliation?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595944647558&sign=1d00cd2a8e20c10f77b245e0ababcc38

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参
├ pageBean	Map<String,Object>	是	分页参数
├ pageNo	Integer	否	页码
├ pageSize	Integer	否	页大小
├ queryOrderDto	Map<String,Object>	是	过滤条件
├ createBeginDate	java.util.Date	否	订单起始时间
├ createEndDate	java.util.Date	否	订单终止时间

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ value	Map<String,Object>	返回实体
├ pageBean	Map<String,Object>	分页信息
├ pageNo	Integer	页码
├ pageSize	Integer	页大小
├ totalPage	Integer	总页数
├ totalRecord	Integer	总条数
├ orderDtos	List<Map<String,Object>>	订单信息
├ orderNo	String	订单号
├ businessNo	String	业务订单号
├ pin	String	下单人pin
├ orderChannel	String	订单来源
├ originalAmount	BigDecimal	原价
├ orderAmount	BigDecimal	订单价
├ actualPayAmount	BigDecimal	实际支付金额
├ benefitAmount	BigDecimal	优惠金额
├ freight	BigDecimal	运费
├ orderStatus	Integer	订单状态
├ createOrderDate	java.util.Date	订单创建时间
├ createBeginDate	java.util.Date	下单开始时间
├ createEndDate	java.util.Date	下单结束时间
├ receiverName	String	收货人
├ receiverAddress	String	收货地址
├ receiverPhone	String	收货人手机号
├ expressCompany	String	快递公司
├ expressNo	String	快递单号
├ invoiceType	Integer	发票类型
├ invoiceTitle	String	发票抬头
├ skuId	Long	商品编码
├ customerId	String	客户id
├ payStatus	Integer	支付状态
├ parentId	String	父单号
├ splitType	Integer	拆单状态 1子单（默认） 2父单
├ receiverAddressDetail	String	完整的收货地址json
├ platformSource	String	订单平台来源
├ delTag	Integer	删除标记
├ orderProductDtoList	List<Map<String,Object>>	订单商品信息
├ skuId	Long	sku编号
├ productId	Long	product编号
├ productName	String	商品名称
├ productPrice	BigDecimal	商品单价
├ quantity	Integer	数量
├ picture	String	图片路径
├ senceId	String	场景id
├ createdDate	java.util.Date	创建时间
├ merchantId	Long	客商id
├ customerId	String	商户号
├ attr	String	属性

请求Body参数示例

{
    "params":{
        "pageBean":{
            "pageNo":1,
            "pageSize":2
        },
        "queryOrderDto":{

        }
    }
}

1
2
3
4
5
6
7
8
9
10
11

成功示例

{
	"code": "00000000",
	"message": "响应成功",
	"result": {
		"success": true,
		"resultCode": "0000",
		"class": "com.jd.jr.jddx.common.export.Result",
		"value": {
			"orderDtos": [
				{
					"benefitAmount": 0,
					"freight": 8,
					"orderStatus": 400,
					"orderChannel": 15,
					"createOrderDate": 1587438543000,
					"receiverAddressDetail": "",
					"businessNo": "B112721838712",
					"orderAmount": 20.2,
					"receiverPhone": "134111184959",
					"pin": "C1006496665",
					"invoiceType": 1,
					"class": "com.jd.jr.jddx.sc.order.export.queryorder.dto.QueryOrderDto",
					"platformSource": 6,
					"orderNo": "3200143167543934",
					"receiverName": "王大华",
					"delTag": 1,
					"splitType": 0,
					"receiverAddress": "南头",
					"actualPayAmount": 20.2,
					"originalAmount": 20.2,
					"payStatus": 200,
					"orderProductDtoList": [
						{
							"quantity": 1,
							"createdDate": 1587438542000,
							"productId": 1836793518359,
							"merchantId": 0,
							"customerId": "C10022226665",
							"attr": "",
							"class": "com.jd.jr.jddx.sc.order.export.queryorder.dto.QueryOrderProductDto",
							"skuId": 100011937680,
							"productName": "柠檬香洗洁精 清洁卫生 高效去油污 清洁餐具 1.2 kg/瓶 不支持零售 16瓶起订",
							"productPrice": 10.2,
							"picture": "//img30.360buyimg.com/cf/jfs/t1/94984/21/15306/61773/5e6f6407E13421245/ec1974cbfdaed080.jpg"
						}
					]
				},
				{
					"benefitAmount": 0,
					"freight": 8,
					"orderStatus": 400,
					"orderChannel": 15,
					"createOrderDate": 1587439945000,
					"receiverAddressDetail": "",
					"businessNo": "B112714914103",
					"orderAmount": 20.2,
					"receiverPhone": "13431181159",
					"pin": "C1006496665",
					"invoiceType": 1,
					"class": "com.jd.jr.jddx.sc.order.export.queryorder.dto.QueryOrderDto",
					"platformSource": 6,
					"orderNo": "2100143181903934",
					"receiverName": "王大华",
					"delTag": 1,
					"splitType": 0,
					"receiverAddress": "南头9号",
					"actualPayAmount": 20.2,
					"originalAmount": 20.2,
					"payStatus": 200,
					"orderProductDtoList": [
						{
							"quantity": 1,
							"createdDate": 1587439945000,
							"productId": 1836793518359,
							"merchantId": 0,
							"customerId": "C1006496665",
							"attr": "",
							"class": "com.jd.jr.jddx.sc.order.export.queryorder.dto.QueryOrderProductDto",
							"skuId": 100011937680,
							"productName": "柠檬香洗洁精 清洁卫生 高效去油污 清洁餐具 1.2 kg/瓶 不支持零售 16瓶起订",
							"productPrice": 10.2,
							"picture": "//img30.360buyimg.com/cf/jfs/t1/94984/21/15306/61773/5e6f6407E13421245/ec1974cbfdaed080.jpg"
						}
					]
				}
			],
			"pageBean": {
				"totalPage": 213,
				"pageNo": 1,
				"pageSize": 2,
				"end": false,
				"totalRecord": 426,
				"params": {},
				"class": "com.jd.jr.jddx.common.export.PageBean"
			}
		},
		"resultMsg": "成功"
	}
}

售后

查询商品是否可退货

接口方法：/jddx-sc/jddx_sc_order/afsSaleGetAfsSaleType

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/afsSaleGetAfsSaleType?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595424557860&sign=0eac202d5f31898846a73e3fc61d630b

查询商品是否可退货

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	订单号
skuId	String	是	江湖商品ID
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	java.util.Map	响应实体
├ success	String	是否成功
├ resultCode	String	响应码
├ value	Map<String,Object>	响应内容
├ services	Boolean	是否可以售后
├ serviceType	List<Map<String,String>>	售后类型 10:退货
├ deliveryType	List<Map<String,String>>	售后配送方式: 4:上门取件 40:客户发货 7:客户送货

请求Body参数示例

{
    "params": {
        "orderNo": "4000202899800867",
         "skuId":1844681685007,
        "clientInfo": {
            "userId": "123",
            "userIP": "213",
            "serverName": "1212",
            "serverIP": "123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

成功示例

{
    "code":"00000000",
    "message":"响应成功",
    "result":{
        "success":true,
        "resultCode":"0000",
        "resultMsg":"成功",
        "value":{
            "services":true,
            "serviceType":[
                {
                    "code":"10",
                    "name":"退货"
                }
            ],
            "deliveryType":[
                {
                    "code":"4",
                    "name":"上门取件"
                }
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

失败响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "value": {
            "services": false
        },
        "resultMsg": "成功"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13

申请售后

接口方法：/jddx-sc/jddx_sc_order/applyAfterSale

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/applyAfterSale?appkey=b354e3d87e5c4ff9af9e3320ae38e53f&timestamp=1595425882853&sign=2f429c373c8932c3688c42dd573d44c6

查询商品是否可退货

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	订单号
skuNum	Number	是	售后商品数量
questionDesc	String	是	申请售后描述
deliveryEnum	String	是	售后配送方式: 4:上门取件 40:客户发货7:客户送货,这里传固定值4
questionPic	String	否	申请售后图片（暂未支持，填空即可）
addressDto	Map<String,Object>	是	地址信息
├ mobile	String	否	手机号
├ name	String	是	联系人
├ provinceId	Number	是	返件省
├ cityId	Number	是	返件市
├ countyId	Number	是	返件县
├ townId	Number	是	返件乡镇
├ addressDetail	String	是	返件街道地址
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数：

名称	类型	描述
Result	java.util.Map	请求参数体
├ services	Boolean	是否可以售后

请求Body参数示例

{
    "params":{
        "orderNo":"4000202899800867",
        "questionDesc":"7天无理由退货",
		"deliveryEnum":"4",
        "questionPic":"",
        "skuNum":1,
        "addressDto":{
            "name":"老大",
            "mobile":"13111111111",
            "provinceId":1,
            "countyId":1,
            "cityId":1,
            "townId":0,
            "addressDetail":"北京市朝阳区朝阳一路100号"
        },
        "clientInfo":{
            "userId":"123",
            "userIP":"213",
            "serverName":"1212",
            "serverIP":"123"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

成功响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": true,
        "resultCode": "0000",
        "resultMsg": "成功",
        "value": {
            "services": true
     
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13

失败响应示例

{
    "code": "00000000",
    "message": "响应成功",
    "result": {
        "success": false,
        "resultCode": "0000",
        "class": "com.jd.jr.jddx.common.export.Result",
        "resultMsg": "此订单不能申请售后"
    }
}

1
2
3
4
5
6
7
8
9
10

查询服务单列表

接口方法：/jddx-sc/jddx_sc_order/getAfsService

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/getAfsService?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

根据订单号查询服务单列表-可查询审核中的服务单列表

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
orderNo	String	是	售后订单号
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	List<java.util.Map>	请求参数体
├ afsServiceId	String	服务单号
├ customerExpect	String	服务类型码：退货(10)
├ customerExpectName	String	服务类型名称
├ afsApplyTime	String	服务单申请时间格式为yyyy-MM-dd HH:mm:ss
├ orderNo	String	订单号
├ wareName	String	商品名称
├ afsServiceStep	Number	服务单环节：申请阶段(10),审核不通过(20),客服审核(21),商家审核(22),京东收货(31),商家收货(32), 京东处理(33),商家处理(34), 用户确认(40),完成(50), 取消(60);
├ afsServiceName	String	服务单环节名称
├ cancel	Boolean	是否可取消: true、false

请求Body参数示例

{
    "orderNo":40245152920,
    "clientInfo":{
        "userId":"",
        "userIP":"",
        "serverName":"",
        "serverIP":""
    }
}

1
2
3
4
5
6
7
8
9

成功响应示例

{
    "success":true,
    "resultCode":"0000",
    "resultMsg":"成功",
    "value":[
        {
            "afsServiceStep":40,
            "cancel":false,
            "customerExpectName":"退货",
            "orderNo":113459968084,
            "afsServiceStepName":"待用户确认",
            "afsServiceId":780525619,
            "afsApplyTime":"2020-05-07 00:56:33",
            "customerExpect":10,
            "wareName":"云蕾 黑色垃圾袋 18只装45*50cm垃圾桶袋纸篓袋塑料袋 垃圾分类"
        },
        {
            "afsServiceStep":50,
            "cancel":false,
            "customerExpectName":"退货",
            "orderNo":112465801299,
            "afsServiceStepName":"完成",
            "afsServiceId":776543354,
            "afsApplyTime":"2020-04-30 04:12:51",
            "customerExpect":10,
            "wareName":"库博光学(coopervision) 佰视明硅水凝胶隐形眼镜月抛3片375度"
        }
    ],
    "pageBean":null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

取消售后单

接口方法：/jddx-sc/jddx_sc_order/afterSaleCacel

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/afterSaleCacel?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
serviceId	String	是	服务单id
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应结果：

名称	类型	描述
Result	java.util.Map	请求参数体
├ serviceStep	String	服务状态code 10：申请阶段 20：审核不通过 50：完成 60：取消

请求Body参数示例

{
    "serviceId":"100011597",
    "clientInfo":{
        "userId":"",
        "userIP":"",
        "serverName":"",
        "serverIP":""
    }
}

1
2
3
4
5
6
7
8
9

成功响应示例

{
    "resultCode":"0000",
    "resultMsg":"成功",
    "success":true,
    "value":{
        "serviceStep":"50",
        "serviceStepName":"完成",
        "services":true
    }
}

1
2
3
4
5
6
7
8
9
10

确认售后单

接口方法：/jddx-sc/jddx_sc_order/afsSaleConfirm

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/afsSaleConfirm?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
serviceId	String	是	服务单id
orderNo	String	是	售后订单号
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	java.util.Map	请求参数体
├ serviceStep	String	服务状态code 10：申请阶段 20：审核不通过 50：完成 60：取消

请求Body参数示例

{
    "serviceId":"100011597",
    "orderNo":"40245152920",
    "clientInfo":{
        "userId":"",
        "userIP":"",
        "serverName":"",
        "serverIP":""
    }
}

1
2
3
4
5
6
7
8
9
10

成功响应示例

{
    "resultCode":"0000",
    "resultMsg":"成功",
    "success":true,
    "value":{
        "serviceStep":"50",
        "serviceStepName":"完成",
        "services":true
    }
}

1
2
3
4
5
6
7
8
9
10

查询服务单详情

接口方法：/jddx-sc/jddx_sc_order/selectAfterSaleDetailInfo

请求URL示例

https://daas.jd.com/openapi/jddx-sc/jddx_sc_order/selectAfterSaleDetailInfo?appkey=6428c8c3b80d49419afa7e169162196b&timestamp=1595213754677&sign=5b286a731180b751ea495a7087af3784

根据服务单号查询服务单详情

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	必须	描述
params	Map<String,Object>	是	入参

其中map 中key和value结构

名称	类型	必须	描述
serviceId	String	是	服务单号
clientInfo	Map<String,Object>	是	需要的客户端信息
├ userId	String	是	用户唯一标识
├ userIP	String	是	用户的ip
├ serverName	String	是	服务器名称
├ serverIP	String	是	服务器ip

响应参数

名称	类型	描述
Result	java.util.Map	请求参数体
├ services	Boolean	是否可申请售后
├ service	String	售后类型code 10:退货
├ serviceName	String	售后类型
├ applyDate	String	服务单申请时间
├ orderNo	String	订单号
├ skuId	String	江湖商品ID
├ skuName	String	商品名称
├ skuNum	String	商品数量
├ serviceStep	String	服务单环节：申请阶段(10),审核不通过(20),客服审核(21),商家审核(22),京东收货(31),商家收货(32), 京东处理(33),商家处理(34), 用户确认(40),完成(50), 取消(60);
├ serviceStepName	String	服务状态
├ cancel	Boolean	是否可取消: true、false
├ questionDesc	String	售后描述信息
├ questionPic	String	售后图片（暂无）
├ freight	String	运费
├ expressCompany	String	快递公司
├ approveNotes	String	审核意见
├ delivery	String	售后配送方式code 4：上门取件 40：客户发货 7：客户送货
├ deliveryName	String	售后配送方式
├ address	String	售后地址
├ tel	String	售后电话
├ linkMan	String	售后联系人
├ postCode	String	售后邮编
├ processResult	String	处理结果code 返修换新(23),退货(40), 换货(50),维修(73),线下换新(90)
├ processResultName	String	处理结果

请求Body参数示例

{
    "serviceId":"776543354",
    "clientInfo":{
        "userId":"",
        "userIP":"",
        "serverName":"",
        "serverIP":""
    }
}

1
2
3
4
5
6
7
8
9

成功响应示例

{
    "success":true,
    "resultCode":"0000",
    "resultMsg":"成功",
    "value":{
        "serviceType":null,
        "cancel":true,
        "delivery":"4",
        "orderNo":"2100141035710843",
        "approveNotes":"尊敬的客户，商品收到之日起7天内如商品完好，我们可以提供无理由退货服务。退货周期为1-7天。京东配送将按照预约时效为您上门取件，请准备好商品全套及发票原件交给配送人员(注：如是电子发票，无需提供).如实际收货发现商品与您描述不符，我们会将商品原物返回。感谢您对京东的支持。",
        "deliveryEnum":null,
        "services":false,
        "serviceName":"退货",
        "serviceStep":"50",
        "skuName":"库博光学（coopervision）佰视明隐形眼镜月抛3片375度",
        "serviceStepName":"完成",
        "service":"10",
        "serviceStepType":null,
        "applyDate":"2020-04-30 04:12:51",
        "serviceId":"776543354",
        "deliveryName":"上门取件",
        "skuId":"1836622414987",
        "skuNum":1
    },
    "pageBean":null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

消息回调

回调URL定义

回调 url：{域名}/message/vopCallback

1、商城订单状态变化。可查询订单详情，同步订单；

2、退款状态同步；

3、商品状态同步，可查询商品详情，同步商品。

注意：

1、商品信息变更，包含：商品名称，介绍，规格参数和商品图变更；

2、回调域名由渠道商提供

请求方式

POST

Content-Type

application/json

请求参数

名称	类型	描述
id	String	消息ID
time	String	消息时间
result	Json	回调内容
type	Integer	消息类型：1、商城订单回调（1：订单拆分；5：订单妥投； 10：订单取消；12：发货； 14：支付失败；15：7天未支付取消/未确认取消（1.七天2.未确认）；18：订单等待确认收货；23：订单配送退货；25：新订单消息；26：预定订单消息；31：订单完成；108：混合支付微信个人支付成功；110：新售后服务单状态变更） 2、退款完成回调（109：退款） 3、商品回调（2：商品价格变更 4：商品上下架变更 16：商品信息变更 6：商品添加、删除）

响应参数

名称	类型	描述
success	Boolean	调用是否成功
resultCode	String	返回码，见附录
resultMsg	String	返回消息描述
value	String	返回内容

请求Body参数示例

商品类

{
   "id":"6111459090011598",
   "result":{
       "skuId":"1833696333826",
       "groupCode":"3674"
   },
   "time":"2021-01-20 20:32:19",
   "type":16
}

1
2
3
4
5
6
7
8
9

订单类

{
  "id":"6111401770019571",
  "result":{
      "orderNo":"3000593759183934"
  },
  "time":"2021-01-20 18:56:32",
  "type":25
}

1
2
3
4
5
6
7
8

售后

{
   "id":"6111401770019571",
   "result":{
       "orderNo":"3000593759183934",
       "refundType":1,
       "serviceId":1
   },
   "time":"2021-01-20 18:56:32",
   "type":109
}

1
2
3
4
5
6
7
8
9
10

权益产品互动营销玩法