技术文档

【促销服务】接口导航

1. 创建促销信息	2. 添加活动规则
3. 添加促销道具	4. 添加参加促销的SKU
5. 提交保存促销命令	6. 促销审核（仅针对人工审核状态的促销）
7. 暂停促销	8. 重启促销
9. 删除促销	10. 根据促销编号获取促销的活动规则
11. 根据促销编号获取促销详细信息	12. 分页查询促销列表
13. 根据促销编号获取促销的道具列表	14. 分页查询促销SKU
15.添加订单规则	16.根据促销编号获取促销的订单规则

创建促销的接口调用顺序为：
1、添加促销信息；
2、添加活动规则（适用于单品促销或者赠品促销且可选）；
3、添加道具（只适用于单品促销且可选）；
4、分批次添加SKU；
5、提交保存促销命令。

（注意：只有提交保存命令后促销才可查询。建议在30分钟内完成促销创建，否则数据有可能丢失）

1. 创建促销信息

l 接口名称

jingdong.seller.promotion.add

l 功能说明

创建促销。添加促销信息如名称、时间、类型等。

目前支持的促销类型如下：

单品促销（可设置指定商品，选择京东京券（非店铺京券）进行促销）

套装促销（为扩大销量，可以将某些商品作为赠品进行赠送，对消费者实施馈赠的促销行为）

赠品促销（将几种商品组合在一起设置成套装来销售，通过促销套装可以让买家一次性购买更多的商品）

总价促销（订单满足一定条件时，支持多种优惠方式，如：直减、送赠品、折扣等）

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
name	String	是	优惠促销	促销名称，字符串长度小于等于10
type	Number	是	1	促销类型，可选值：单品促销（1）赠品促销（4）套装促销（6）总价促销（即满减、满赠）（10）
begin_time	String	是	2013-05-21 13:30:59	促销开始时间，格式为yyyy-MM-dd HH:mm:ss，精确到分钟，最长可设置为距当前时间180天之内的时间点
end_time	String	是	2013-05-21 13:40:59	促销结束时间，格式为yyyy-MM-dd HH:mm:ss，精确到分钟，必须大于开始时间至少一分钟，且晚于当前时间，建议至少晚10分钟，且和开始时间最大间隔不能超过180天
bound	Number	否	2	促销范围，总价促销为必填项，其它促销类型无效，可选值：部分商品参加（1）全场参加（2）部分商品不参加（3）注：M元任选N件只支持部分商品参加
member	Number	否	50	会员限制。默认值：注册会员（50），可选值：注册会员（50）、铜牌（56）、银牌（61）、金牌（62）、钻石（105）、VIP（110）
slogan	String	否		广告语，字符串长度小于等于50
comment	String	否		活动备注，不超过200字节

l 返回结果

promo_id

Number

23111

促销编号

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_add_response":{
  "promo_id":"23111"
  }
  }

l 错误码

错误码	错误描述	解决方案
promo.type.invalid	促销类型无效
promo.time.invalid	促销时间无效
system.exception	系统异常
promo.slogan.invalid	促销广告语无效
promo.endTime.invalid	促销结束时间无效
promo.beginTime.invalid	促销开始时间无效
promo.name.invalid	促销名称不合法
promo.member.invalid	会员无效
promo.comment.invalid	促销备注无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionAddRequest request=new SellerPromotionAddRequest();
request.setName( "jingdong" );
request.setType( 123 );
request.setBeginTime( "2013-05-21 13:30:59" );
request.setEndTime( "2013-05-21 13:40:59" );
request.setFavorMode( 123 );
request.setBound( 123 );
request.setMember( 123 );
request.setSlogan( "jingdong" );
request.setComment( "jingdong" );
SellerPromotionAddResponse response=client.execute(request);

2. 添加活动规则

l 接口名称

jingdong.seller.promotion.activitymode.add

l 功能说明

单品促销、赠品促销必须调用此接口（其他促销类型不用调取）。

单品促销时，所有参数都有效（多次调用时，最后一次规则有效）
赠品促销时，如设置“单次最少购买数量”其他参数才有效（多次调用时，最后一次规则有效）

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号
num_bound	Number	否	10	参与促销的SKU总数量。默认值为0，0：不限，或任意正整数；限时抢购时，该参数必须大于0
freq_bound	Number	否	0	是否限购一个，默认值为0。 0：不限 1：限购一个注：当设置为限购一个时，per_max_num及per_min_num的设置不起作用，系统会默认设置为1
per_max_num	Number	否	3	单次最多可购数量，默认值为0，0：不限，或任意正整数
per_min_num	Number	否	1	单次最少可购数量，默认值为0，0：不限，或任意正整数。赠品促销也可设置且不能大于10

l 返回结果

名称	类型	示例值	描述
id	Number	654321	活动规则编号，如果数据保存成功，则返回活动规则编号，否则返回null

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_activitymode_add_response":{
  "id":"654321"
  }
  }

l 错误码

错误码	错误描述	解决方案
promo.type.invalid	促销类型无效
actvitymode.invalid	活动规则无效
actvitymode.num.bound.invalid	限时抢购时，可购买数量必须大于0
param.error	参数异常
promoId.invalid	促销编号无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionActivitymodeAddRequest request=new SellerPromotionActivitymodeAddRequest();
request.setPromoId( 123 );
request.setNumBound( 123 );
request.setFreqBound( 123 );
request.setPerMaxNum( 123 );
request.setPerMinNum( 123 );
SellerPromotionActivitymodeAddResponse response=client.execute(request);

3. 添加促销道具

l 接口名称

jingdong.seller.promotion.prop.add

l 功能说明

添加促销道具，目前仅支持赠送京券。

（相同类型的道具，最后一次添加有效，只适用于单品促销）

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号
type	Number[]	是	2	道具类型，可选值：京劵（4）不支持店铺京券
num	Number[]	是	20	道具数值，必须为10的倍数。比如：类型是京券，则表示多少元
used_way	Number[]	是	2	道具使用方式，可选值：奖励（2），比如类型是京券，使用方式是奖励，则表示促销会奖励用户一定的京券

l 返回结果

名称	类型	示例值	描述
ids	List	654321	生效的促销道具编号列表

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_prop_add_response":{
  "ids":[{

  }]
  }
  }

l 错误码

错误码	错误描述	解决方案
promo.type.invalid	促销类型无效
prop.num.invalid	道具数值大小无效
prop.usedWay.invalid	道具使用方式无效
system.exception	系统异常
promoId.invalid	促销编号无效
prop.type.invalid	道具类型无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionPropAddRequest request=new SellerPromotionPropAddRequest();
request.setPromoId( 123 );
request.setType( "123,234,345" );
request.setNum( "123,234,345" );
request.setUsedWay( "123,234,345" );
SellerPromotionPropAddResponse response=client.execute(request);

4. 添加参加促销的sku

l 接口名称

jingdong.seller.promotion.sku.add

l 功能说明

添加参加促销的sku。

单次最多添加100个SKU（套装促销：最多仅支持7个商品，seq须为1-7直接自然数），一个促销最多支持1000个SKU。

当基于套装促销添加SKU时，最多可为7个商品添加SKU，并且相同商品的次序要一致。

当基于赠品促销添加SKU时，赠品SKU只能是1-5个，每个赠品只能赠送1-3个，赠品的总价应低于主商品中的最小京东价。

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	21113	促销编号
sku_ids	Number[]	是		SKU编号
jd_prices	String[]	是	20.0	京东价，以元为单位，精确到小数点后一位
promo_prices	String[]	否	18.9	促销价，以元为单位，精确到小数点后一位，且必须小于京东价。注： 1.套装促销必填 2.FBP类型商家设置赠品促销时，赠品SKU的该字段必填，将作为订单退货价使用；退货价>0，<京东价jd_prices 3.SOP类型商家设置赠品促销时，赠品SKU的该字段必填，将作为订单退货价使用；退货价>0，<京东价jd_prices 4.单品促销选填，不填时系统将默认设置为京东价，此时单品促销必须添加促销道具 5.其它促销不需要设置 6.不支持LBP、SOPL
seq	Number[]	否	1,2,3,4 或 3,1,2,4	套装商品展示次序，相同商品的SKU上次序必须一致，次序必须是1到7之间的自然数。（只对套装促销有效）
num	Number[]	否		赠品赠送数量，只能送1-3个。(只对赠品促销有效)
bind_type	Number[]	否	1	绑定类型, 可选值：主商品（1），赠品（2）。(赠品促销、满减送促销中的赠品需要设置为2，其余均设置为1)

l 返回结果

名称	类型	示例值	描述
ids	List		促销SKU编号列表，返回的SKU列表是都参加促销的SKU，无效的SKU会被剔除

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_sku_add_response":{
  "ids":[{

  }]
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
sku.jdPrice.invalid	sku的京东价无效
sku.seq.invalid	sku的次序无效
sku.skuId.invalid	sku的SKU编号无效
promoId.invalid	促销编号无效
sku.splitPrice.invalid	sku的拆分价无效
sku.venderId.invalid	sku的商家编号无效
promo.sku.invalid	促销SKU无效
sku.num.invalid	sku的数量无效
sku.promoPrice.invalid	sku的促销价无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionSkuAddRequest request=new SellerPromotionSkuAddRequest();
request.setPromoId( 123 );
request.setSkuIds( "123,234,345" );
request.setJdPrices( "123,234,345" );
request.setPromoPrices( "123,234,345" " );
request.setSeq( "123,234,345" );
request.setNum( "123,234,345" );
request.setBindType( "123,234,345" );

SellerPromotionSkuAddResponse response=client.execute(request);

5. 提交保存促销命令

l 接口名称

jingdong.seller.promotion.commit

l 功能说明

促销创建完毕，提交保存促销命令。完成创建促销，必须调用该接口，否则相关数据将会被清除

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

l 返回结果

名称	类型	示例值	描述
success	Boolean	true	执行结果，成功（true)、失败（false）

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_commit_response":{
  "success":""
  }
  }

l 错误码

错误码	错误描述	解决方案
sku.seq.invalid	sku的次序无效
gift.price.invalid	赠品总价应低于主商品中的最小京东价
sku.skuId.invalid	sku的SKU编号无效
promo.id.invalid	促销编号不合法
ware.num.invalid	商品数量无效
gift.num.invalid	赠品数量无效
promo.sku.invalid	促销SKU无效
param.null	参数不能为null
promo.vender.invalid	促销venderId无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionCommitRequest request=new SellerPromotionCommitRequest();
request.setPromoId( 123 );
SellerPromotionCommitResponse response=client.execute(request);

6. 促销审核

l 接口名称

jingdong.seller.promotion.check

l 功能说明

促销审核，只能对人工审核状态的促销进行审核

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称

类型

是否必须

示例值

描述

promo_id

Number

是

123456

促销编号（不支持多个编码）

status

Number

是

4

审核状态。可选值：

通过（4）

驳回（1）

l 返回结果

名称	类型	示例值	描述
count	Number	1	影响的（促销）条数

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_check_response":{
  "count":"1"
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
promo.non.check	促销不能审核通过/驳回
promo.non.exist	促销不存在
invalid.check.permissions	审核权限不足
promo.end	促销已结束

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionCheckRequest request=new SellerPromotionCheckRequest();
request.setPromoId( 123 );
request.setStatus( 123 );
SellerPromotionCheckResponse response=client.execute(request);

7. 暂停促销

l 接口名称

jingdong.seller.promotion.suspend

l 功能说明

暂停促销，使促销暂不生效，只能对已生效的促销进行暂停

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

l 返回结果

名称	类型	示例值	描述
count	Number	1	影响的条数

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_suspend_response":{
  "count":"1"
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
promo.non.exist	促销不存在
promo.non.suspend	促销不能暂停
promo.end	促销已结束

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionSuspendRequest request=new SellerPromotionSuspendRequest();
request.setPromoId( 123 );
SellerPromotionSuspendResponse response=client.execute(request);

8. 重启促销

l 接口名称

jingdong.seller.promotion.resume

l 功能说明

重启促销，使暂停的促销重新生效，只能对暂停的促销进行重启操作。

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

l 返回结果

名称	类型	示例值	描述
count	Number	1	影响的条数

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_resume_response":{
  "count":"1"
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
promo.non.exist	促销不存在
promo.non.delete	促销不能启用
promo.end	促销已结束

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionResumeRequest request=new SellerPromotionResumeRequest();
request.setPromoId( 123 );
SellerPromotionResumeResponse response=client.execute(request);

9. 删除促销

l 接口名称

jingdong.seller.promotion.delete

l 功能说明

删除促销，只能删除未审核、已驳回、已生效、已暂停等状态的促销

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

l 返回结果

名称	类型	示例值	描述
count	Number	1	影响的条数

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_delete_response":{
  "count":"1"
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
promo.non.exist	促销不存在
promo.non.delete	促销不能删除
promo.end	促销已结束

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionDeleteRequest request=new SellerPromotionDeleteRequest();
request.setPromoId( 123 );
SellerPromotionDeleteResponse response=client.execute(request);

10. 根据促销编号获取促销的活动规则

l 接口名称

jingdong.seller.promotion.activitymode.get

l 功能说明

根据促销编号获取促销的活动规则

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

l 返回结果

名称	类型	示例值	描述
activity_mode	ActivityModeVO		促销活动规则

ActivityModeVO属性

名称	类型	是否必须		示例值	描述
id	Number	否	654321		活动规则编号
promo_id	Number	否	123456		促销编号
num_bound	Number	否	10		参与促销的SKU总数量。默认值为0（不限)，或任意正整数；限时抢购时，该参数必须大于0
freq_bound	Number	否	0		是否限购一个。默认值为0，可选值：0（不限），1（限购一个）；当设置为限购一个时，单次最多可购数量，单次最少可够数量的设置不再起作用，系统默认会设置为1
per_max_num	Number	否	3		单次最多可购数量，默认值为0（不限），或任意正整数
per_min_num	Number	否	1		单次最少可购数量，默认值为0（不限），或任意正整数。赠品促销时不能大于10

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_activitymode_get_response":{
  "activity_mode":{
  "id":"654321",
"num_bound":"10",
"promo_id":"123456",
"per_max_num":"3",
"per_min_num":"1",
"freq_bound":"0"
  }
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
promo.non.exist	促销不存在

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionActivitymodeGetRequest request=new SellerPromotionActivitymodeGetRequest();
request.setPromoId( 123 );
SellerPromotionActivitymodeGetResponse response=client.execute(request);

11. 根据促销编号获取促销详细信息

l 接口名称

jingdong.seller.promotion.get

l 功能说明

根据促销编号获取促销详细信息

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是		促销编号

l 返回结果

名称	类型	示例值	描述
promotion_v_o	PromotionVO		促销详细信息，包括创建时所有输入的促销信息

l 属性

PromotionVO属性：

名称	类型	是否必须	示例值	描述
promo_id	Number	否	123456	促销编号
name	String	否	优惠促销	促销名称，字符串长度小于等于10
type	Number	否	1	促销类型，可选值：单品促销（1），赠品促销（4），套装促销（6），总价促销（10）
bound	Number	否	1	促销范围，总价促销为必填项，其它促销类型无效，可选值：部分商品参加（1）、全场参加（2）、部分商品不参加（3），注：M元任选N件只支持部分商品参加
begin_time	String	否	2013-11-21 13:30:59	促销开始时间，格式为yyyy-MM-dd HH:mm:ss，精确到分钟，最长可设置为距当前时间180天之内的时间点
end_time	String	否	2013-11-21 13:40:59	促销结束时间，格式为yyyy-MM-dd HH:mm:ss，精确到分钟，必须大于开始时间至少一分钟，且晚于当前时间，建议至少晚10分钟，且和开始时间最大间隔不能超过180天
member	Number	否	50	会员限制，默认值：注册会员（50），可选值：注册会员（50）、铜牌（56）、银牌（61）、金牌（62）、钻石（105）、VIP（110）
slogan	String	否		广告语，字符串长度小于等于50
comment	String	否		活动备注，不超过200字节
status	Number	否	5	促销状态，可选值：驳回（1）未审核（2）人工审核（3）审核通过（4）已生效（5）已暂停（6）强制暂停（7）

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_get_response":{
  "promotion_v_o":{
  "member":"",
"slogan":"",
"favor_mode":"",
"promo_id":"",
"begin_time":"",
"status":"",
"end_time":"",
"name":"",
"comment":"",
"type":"",
"bound":""
  }
  }
  }

l 错误码

错误码	错误描述	解决方案
promo.type.invalid	促销类型无效
promo.id.invalid	促销编号不合法
system.exception	系统异常
promo.vender.invalid	促销venderId无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionGetRequest request=new SellerPromotionGetRequest();
request.setPromoId( 123 );
SellerPromotionGetResponse response=client.execute(request);

12. 分页查询促销列表

l 接口名称

jingdong.seller.promotion.list

l 功能说明

分页查询促销列表，目前可以根据类型、状态进行查询，也支持组合查询

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
type	Number	是	1	促销类型，可选值：单品促销（1），赠品促销（4），套装促销（6），总价促销（10）
status	Number	否	4	促销状态，可选值：驳回（1），未审核（2），人工审核（3），审核通过（4），已生效（5），进行中（8）
begin_time	String	否	2013-11-21 13:30:59	促销开始时间，格式为yyyy-MM-dd HH:mm:ss，（查询促销开始时间大于等于该值的促销）
end_time	String	否	2013-11-21 13:40:59	促销结束时间，格式为yyyy-MM-dd HH:mm:ss，（查询促销结束时间小于等于该值的促销）
sku_id	Number	否	123456	商品skuId（查询sku参加的促销）
page	Number	是	1	页码（必须为正整数）
size	Number	是	10	每页记录个数（每页最少1个，最多10个）

l 返回结果

名称	类型	示例值	描述
total_count	Number	15	促销总数量
promotion_v_o_s	PromotionVO[]		促销信息列表，包含促销编号、名称、时间、类型、状态、范围、会员级别等字段。

PromotionVO[] 属性

名称	类型	是否必须	示例值	描述
promo_id	Number	否	123456	促销编号
name	String	否	优惠促销	促销名称，字符串长度小于等于10
type	Number	否		促销类型，可选值：单品促销（1），赠品促销（4），套装促销（6），总价促销（10）
bound	Number	否	1	促销范围，总价促销为必填项，其它促销类型无效，可选值：部分商品参加（1）、全场参加（2）、部分商品不参加（3），注：M元任选N件只支持部分商品参加
begin_time	String	否	2013-11-21 13:30:59	促销开始时间，格式为yyyy-MM-dd HH:mm:ss，精确到分钟，最长可设置为距当前时间180天之内的时间点
end_time	String	否	2013-11-21 13:40:59	促销结束时间，格式为yyyy-MM-dd HH:mm:ss，精确到分钟，必须大于开始时间至少一分钟，且晚于当前时间，建议至少晚10分钟，且和开始时间最大间隔不能超过180天
member	Number	否	50	会员限制，默认值：注册会员（50），可选值：注册会员（50）、铜牌（56）、银牌（61）、金牌（62）、钻石（105）、VIP（110）
slogan	String	否		广告语，字符串长度小于等于50
comment	String	否		活动备注，不超过200字节
status	Number	否		促销状态，可选值：驳回（1），未审核（2），人工审核（3），审核通过（4），已生效（5），已暂停（6），强制暂停（7）注：如查询“进行中”的促销，此处返回仍为“5”。

l 返回示例

JSON数据格式

{
"jingdong_seller_promotion_list_response": {
"promotion_v_o_s": [
{
"promotion_v_o": {
"member": "50",
"slogan": "",
"promo_id": "123456",
"begin_time": "2013-11-21 13:30:59",
"status": "",
"end_time": "2013-11-21 13:40:59",
"name": "优惠促销",
"comment": "",
"type": "",
"bound": "1"
}
}
],
"total_count": "15"
}
}

l 错误码

错误码	错误描述	解决方案
promo.type.invalid	促销类型无效
system.exception	系统异常
promo.vender.invalid	促销venderId无效

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionListRequest request=new SellerPromotionListRequest();
request.setType( 123 );
request.setStatus( 123 );
request.setBeginTime( "jingdong" );
request.setEndTime( "jingdong" );
request.setSkuId( 123 );
request.setPage( 123 );
request.setSize( 123 );
SellerPromotionListResponse response=client.execute(request);

13. 根据促销编号获取促销的道具列表

l 接口名称

jingdong.seller.promotion.prop.list

l 功能说明

根据促销编号获取促销的道具列表

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

l 返回结果

名称	类型	示例值	描述
promo_prop_v_o_s	PromoPropVO[]		促销道具列表

l 属性

PromoPropVO[] 属性：

名称	类型	是否必须	示例值	描述
promo_id	Number	否	123456	促销编号
type	Number	否	2	道具类型，可选值：京劵（4）
num	Number	否	20	道具数值，必须为10的倍数，比如类型是京券，则表示多少元
used_way	Number	否	2	道具使用方式，可选值：奖励（2），比如类型是京券，使用方式是奖励，则表示促销会奖励用户一定的京券

l 返回示例

JSON数据格式

{
  "jingdong_seller_promotion_prop_list_response":{
  "promo_prop_v_o_s":[{
  "num":"20",
"promo_id":"123456",
"type":"2",
"used_way":"2"
  }]
  }
  }

l 错误码

错误码	错误描述	解决方案
param.error	参数异常

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionPropListRequest request=new SellerPromotionPropListRequest();
request.setPromoId( 123 );
SellerPromotionPropListResponse response=client.execute(request);

14. 分页查询促销SKU

l 接口名称

jingdong.seller.promotion.sku.list

l 功能说明

分页查询指定促销下符合条件的促销SKU，最多返回10个

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

l 应用级输入参数

名称	类型	是否必须	示例值	描述
ware_id	Number	否		商品ID(可选)
sku_id	Number	否		skuId(可选)
promo_id	Number	是	21113	促销编号
bind_type	Number	否	1	绑定类型, 可选值：主商品（1），赠品（2）。(赠品促销、满减送促销中的赠品需要设置为2，其余均设置为1)
page	Number	是	1	页码（必须为正整数）
size	Number	是	10	每页记录个数（每页最少1个，最多10个）

l 返回结果

名称	类型	示例值	描述
total_count	Number		SKU总数量
promo_sku_v_o_s	PromoSkuVO[]		促销SKU列表

PromoSkuVO属性

名称	类型	是否必须	示例值	描述
ware_id	Number	否	123	商品编号
item_num	String	否	456	商品货号
sku_id	Number	否	654321	SKU编号
sku_name	String	否	红星二锅头	SKU名称
promo_id	Number	否	123456	促销编号
jd_price	String	否	20.0	京东价，以元为单位，精确到小数点后一位
promo_price	String	否	18.8	促销价，以元为单位，精确到小数点后一位，且必须小于京东价注： 1. FBP商家设置赠品促销时，添加赠品SKU时，此字段必填，将作为赠品退货价使用 2. SOP商家设置赠品促销时，添加赠品SKU时，此字段必填，将作为赠品退货价使用 3. 除赠品外的其他促销，如此字段有值，则为促销价
seq	Number	否		套装商品展示次序，相同商品的SKU上次序必须一致。（只对套装促销有效）
num	Number	否	1	赠品赠送数量，只能送1-3个。(只对赠品促销有效)
bind_type	Number	否	1	绑定类型, 可选值：主商品（1），赠品（2）。(赠品促销、满减送促销中的赠品需要设置为2，其余均设置为1)

l 返回示例

JSON数据格式

{
"jingdong_seller_promotion_sku_list_response": {
"promo_sku_v_o_s": [
{
"promo_sku_v_o": {
"promo_price": "18.8",
"item_num": "456",
"num": "1",
"jd_price": "20.0",
"promo_id": "123456",
"ware_id": "123",
"sku_name": "红星二锅头",
"seq": "",
"sku_id": "654321",
"bind_type": "1"
}
}
],
"total_count": ""
}
}

l 错误码

错误码	错误描述	解决方案
param.error	参数异常
system.exception	系统异常
promo.non.exist	促销不存在

l SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionSkuListRequest request=new SellerPromotionSkuListRequest();
request.setWareId( 123 );
request.setSkuId( 123 );
request.setPromoId( 123 );
request.setPage( 123 );
request.setSize( 123 );
SellerPromotionSkuListResponse response=client.execute(request);

15.添加订单规则

接口名称
jingdong.seller.promotion.ordermode.add 添加订单规则，支持以下几种总价促销优惠方式：满M件减N件(如：满5件减1件，M的值为3至20之间的整数，N为正整数，值最小为1，最大为M的三分之一），M元任选N件（如：99元任选3件,N的值为2-5之间的整数)，M件N折（如：2件8折，M的值为1-8之间的整数，N的值大于等于5，小于10，支持一位小数），满减送（如：满100减10元、满100赠商品、满100加10赠商品、满100减10赠商品、满100减10加5赠商品，此类促销应满足以下规则：1、送赠品或者减价格必须有一个；2、设置加价金额后必须设置赠品；3、如果设置赠品，赠品京东价必须大于加价金额，小于满金额；4、减金额必须小于等于订单额度的百分之八十；相关字段暂不支持设置多个值。）

接口应用场景

商家应用通用应用

API用户授权类型

需要

系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	21113	促销编号
favor_mode	Number	是	16	订单规则类型，可选值：满M件减N件（6），M元任选N件（13），M件N折（15），满减送（16）
quota	Number[]	是	100	订单额度；（满M件减N件或M件N折时为M的值，单位件，只支持正整数；M元任选N件时为M的值，单位元，支持小数点后一位，例：9.9元；满减送时为订单满金额，单位元，只支持正整数；）
rate	Number[]	否	10	优惠力度；（满M件减N件、M元任选N件时为N的值，单位件,只支持正整数；M件N折时为N的值，单位折，支持小数点后一位，例：8.5折；满减送不支持此字段，除满减送之外其它促销为必填项）
plus	Number[]	否	10	加价金额，只支持正整数；（只满减送有效，且为可选项，该字段设置了值，必须送赠品）
minus	Number[]	否	10	减金额，只支持正整数；（只满减送有效，且为可选项）
link	String	否	http://mall.jd.com/test-1234.html	店铺活动链接地址

返回结果

名称	类型	示例值	描述
ids	List		订单规则编号列表，返回保存成功的订单规则编号

返回示例

JSON数据格式

{
  "jingdong_seller_promotion_ordermode_add_response":{
  "ids":[{

  }]
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionOrdermodeAddRequest request=new SellerPromotionOrdermodeAddRequest();
request.setPromoId( 123 );
request.setFavorMode( 123 );
request.setQuota( "123,234,345" );
request.setRate( "123,234,345" );
request.setPlus( "123,234,345" );
request.setMinus( "123,234,345" );
request.setLink( "jingdong" );
SellerPromotionOrdermodeAddResponse response=client.execute(request);

错误码

错误码	错误描述	解决方案
promo.type.invalid	促销类型无效
ordermode.quota.invalid	订单额度无效
param.error	参数异常
promo.favorMode.invalid	促销订单规则无效
promoId.invalid	促销编号无效
ordermode.rate.invalid	优惠力度无效
ordermode.minus.invalid	减金额无效
ordermode.plus.invalid	加价金额无效
ordermode.link.invalid	活动链接地址无效

16.根据促销编号获取促销的订单规则

接口名称
jingdong.seller.promotion.ordermode.list

接口应用场景

商家应用通用应用

API用户授权类型

需要

系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

应用级输入参数

名称	类型	是否必须	示例值	描述
promo_id	Number	是	123456	促销编号

返回结果

名称	类型	示例值	描述
promo_order_mode_v_os	OrderModeVO[]		订单规则列表

OrderModeVO属性

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

promo_id Number 否 123456 促销编号

favor_mode Number 否 16 订单规则类型，可选值：满M件减N件（6），M元任选N件（13），M件N折（15），满减送（16）

quota Number 否 100 订单额度；（满M件减N件或M件N折时为M的值，单位件，只支持正整数；M元任选N件时为M的值，单位元，支持小数点后一位，例：9.9元；满减送时为订单满金额，单位元，只支持正整数；）

rate Number 否 10 优惠力度；（满M件减N件、M元任选N件时为N的值，单位件,只支持正整数；M件N折时为N的值，单位折，支持小数点后一位，例：8.5折；满减送不支持此字段，除满减送之外其它促销为必填项）

plus Number 否 5 加价金额，只支持正整数；（只满减送有效，且为可选项，该字段设置了值，必须送赠品）

minus Number 否 5 减金额，只支持正整数；（只满减送有效，且为可选项）

link String 否 http://mall.jd.com/test-1234.html 店铺活动链接地址

返回示例

JSON数据格式

{
  "jingdong_seller_promotion_ordermode_list_response":{
  "promo_order_mode_v_os":[{
  "plus":"5",
"quota":"100",
"favor_mode":"16",
"minus":"5",
"rate":"10",
"promo_id":"123456",
"link":"http://mall.jd.com/test-1234.html"
  }]
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
SellerPromotionOrdermodeListRequest request=new SellerPromotionOrdermodeListRequest();
request.setPromoId( 123 );
SellerPromotionOrdermodeListResponse response=client.execute(request);

错误码

错误码	错误描述	解决方案
param.error	参数异常
system.exception	系统异常

服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

l 错误码

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

返回示例

JSON数据格式

错误码

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

OrderModeVO属性

返回示例

JSON数据格式

错误码