首页>促销API>jingdong.seller.promotion.add

促销API

jingdong.pop.market.write.promotion.gift.reject
对应需要人工审核的促销,执行审核驳回操作(赠品促销)
jingdong.pop.market.write.promotion.sum.approve
对应需要人工审核的促销,执行审核通过操作(总价促销)
jingdong.seller.promotion.list
促销列表查询接口
jingdong.seller.promotion.ordermode.list
根据促销编号获取促销的订单规则
jingdong.seller.coupon.write.close
关闭优惠券
jingdong.seller.coupon.write.create
新建优惠券
jingdong.seller.coupon.read.getCouponList
根据指定条件(分页)查询商家创建的优惠券
jingdong.seller.promotion.v2.suspend
暂停促销
jingdong.seller.promotion.v2.resume
重启促销
jingdong.seller.promotion.v2.unit.beanrequired.create
创建京豆优惠购促销
jingdong.seller.promotion.v2.reject
人工审核驳回
jingdong.seller.promotion.v2.approve
人工审核通过
jingdong.seller.promotion.v2.unit.limit.create
创建限购促销
jingdong.seller.promotion.v2.remove
删除促销
jingdong.seller.promotion.v2.sku.count
查询促销SKU个数
jingdong.seller.promotion.v2.list
查询促销列表
jingdong.seller.promotion.v2.get
查询促销详情
jingdong.seller.promotion.v2.count
查询促销个数
jingdong.promotion.updateLineationPrice
调划线价接口
jingdong.seller.promotion.add
新建促销信息
jingdong.seller.promotion.activitymode.add
添加活动规则
jingdong.pop.market.retrieve.promotion.getPromoUserList
查询指定令牌促销的用户列表
jingdong.seller.promotion.commit
null
jingdong.seller.promotion.check
null
jingdong.seller.promotion.suspend
暂停促销,使促销暂不生效,只能对已生效的促销进行暂停
jingdong.seller.promotion.resume
重启促销,使暂停的促销重新生效,只能对暂停的促销进行重启操作。
jingdong.seller.promotion.delete
删除促销,只能删除未审核、已驳回、已生效、已暂停等状态的促销
jingdong.pop.market.write.promotion.sum.reject
对应需要人工审核的促销,执行审核驳回操作(总价促销)
jingdong.pop.market.write.promotion.gift.approve
对应需要人工审核的促销,执行审核通过操作(赠品促销)
jingdong.seller.promotion.sku.list
促销sku列表查询
jingdong.pop.market.write.promotion.sum.remove
删除总价促销
jingdong.seller.promotion.v2.sku.list
查询促销SKU列表
jingdong.seller.promotion.v2.unit.full.create
创建单品促销
jingdong.seller.promotion.prop.add
添加促销道具
jingdong.seller.promotion.sku.add
添加参加促销的sku
jingdong.seller.promotion.activitymode.get
根据促销编号获取促销的活动规则
jingdong.seller.promotion.prop.list
根据促销编号获取促销的道具列表
jingdong.seller.promotion.ordermode.add
添加订单规则
jingdong.seller.coupon.read.getCouponCount
统计满足条件的优惠券个数
jingdong.seller.promotion.v2.unit.prop.create
创建送道具促销
jingdong.seller.promotion.v2.order.discount.create
创建折扣促销

jingdong.seller.promotion.add      新建促销信息

API功能描述

创建促销,支持单品促销(商品价格直降优惠)、套装促销(商品组合优惠)、赠品促销(买商品送赠品)、总价促销(订单满足一定条件时,支持多种优惠方式,如:直减、送赠品、折扣等),添加促销信息如名称、时间、类型等。建促销接口调用顺序为:1、添加促销信息,2、添加活动规则(适用于单品促销或者赠品促销且可选)或总价规则(适用于总价促销),3、添加道具(只适用于单品促销且可选)、4、分批次添加SKU,5、提交保存促销命令。注意,只有提交保存命令后促销才可查询。建议在30分钟内完成促销创建,否则数据有可能丢失

授权类型

需要

应用场景

商家应用 通用应用 百度微购 口袋限制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

应用级别输入参数

名称 类型 是否必须 示例值 描述
name  String  优惠促销  促销名称,字符串长度小于等于10 
type  Number  促销类型,可选值:单品促销(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  促销范围,总价促销为必填项,其它促销类型无效,可选值:部分商品参加(1)、全场参加(2)、部分商品不参加(3),注:M元任选N件只支持部分商品参加 
member  Number  50  会员限制,默认值:注册会员(50),可选值:注册会员(50)、铜牌(56)、银牌(61)、金牌(62)、钻石(105)、VIP(110) 
slogan  String  广告语  广告语,字符串长度小于等于50 
comment  String  活动备注  活动备注,不超过200字节 
favor_mode  Number  null  总价促销订单规则类型(总价促销时为必填项,orderMdoe需要和此值保持一致),满赠(0),满减(1),每满减(2),满赠加价购(5),满M件减N件(6),M元任选N件(13),M件N折(15),满减送(元)(16) 

返回结果

名称 类型 示例值 描述
promo_id  Number  654321   促销编号  

返回示例值

错误码

错误码 错误描述 解决方案
没有符合的记录

API测试工具

FAQ