首页>促销API>jingdong.seller.coupon.write.create

促销API

jingdong.pop.market.write.promotion.gift.reject
对应需要人工审核的促销,执行审核驳回操作(赠品促销)
jingdong.pop.market.write.promotion.sum.approve
对应需要人工审核的促销,执行审核通过操作(总价促销)
jingdong.interactive.cakebaker.getUserCakeLevel
叠蛋糕互动活动获取用户蛋糕层数
jingdong.seller.promotion.prop.list
根据促销编号获取促销的道具列表
jingdong.seller.coupon.write.create
新建优惠券
jingdong.seller.coupon.write.commit
提交
jingdong.seller.promotion.v2.reject
人工审核驳回
jingdong.seller.promotion.v2.unit.prop.create
创建送道具促销
jingdong.seller.promotion.v2.order.discount.create
创建折扣促销
jingdong.seller.promotion.v2.deletePromoSku
删除促销中商品
jingdong.decryCode
解密token
jingdong.decryptCode
解密token
jingdong.seller.promotion.samclub.create
Sam店设置会员价
jingdong.seller.promotion.prop.add
null
jingdong.seller.promotion.sku.add
添加参加促销的sku
jingdong.pop.market.retrieve.promotion.getPromotion
单品促销详情查询
jingdong.pop.market.retrieve.promotion.getPromoUserList
查询指定令牌促销的用户列表
jingdong.seller.promotion.check
null
jingdong.seller.coupon.write.pushCoupon
发券-(grantType为3时,仅支持发公开券)
jingdong.promo.unit.get
根据促销编号获取单品促销信息
jingdong.api.SmsModelConfigWriteService.sendSceneSms
模版短信发送接口,支持自定义模板
jingdong.pop.market.write.promotion.sum.reject
对应需要人工审核的促销,执行审核驳回操作(总价促销)
jingdong.seller.coupon.write.addSkus
追加SKU
jingdong.seller.coupon.write.createActivity
创建商家券
jingdong.pop.market.write.promotion.sum.remove
删除总价促销
jingdong.seller.promotion.delete
null
jingdong.seller.promotion.resume
null
jingdong.seller.promotion.suspend
null
jingdong.seller.promotion.activitymode.add
null
jingdong.seller.promotion.activitymode.get
null
jingdong.seller.promotion.ordermode.add
新建总价促销订单规则
jingdong.seller.promotion.ordermode.list
根据促销编号获取促销的订单规则
jingdong.seller.promotion.add
新建促销信息
jingdong.seller.promotion.commit
null
jingdong.seller.promotion.get
null
jingdong.seller.promotion.list
促销列表查询接口
jingdong.seller.promotion.sku.list
促销sku列表查询
jingdong.seller.coupon.write.close
关闭优惠券
jingdong.seller.coupon.read.getCouponCount
统计满足条件的优惠券个数
jingdong.seller.coupon.read.getCouponList
根据指定条件(分页)查询商家创建的优惠券
jingdong.pop.market.write.promotion.gift.approve
对应需要人工审核的促销,执行审核通过操作(赠品促销)
jingdong.promo.token.tokenuser.add
促销令牌写服务
jingdong.promo.token.tokenuser.del
促销令牌写服务
jingdong.promotion.updateLineationPrice
调划线价接口
jingdong.api.SmsModelConfigReadService.getSmsModelConfigByParams
查询短信模版列表
jingdong.api.SmsModelConfigWriteService.sendSms
模版短信发送接口
jingdong.api.SmsModelConfigReadService.countSmsModelConfigByParams
查询可用的短信模版总数
jingdong.seller.coupon.write.lockCoupon
锁券
jingdong.seller.promotion.deleteSkuInPromo
单品促销删除促销中的sku
jingdong.pop.market.retrieve.promotion.getPromotionList
单品促销列表查询
jingdong.pop.market.write.promotion.sum.deleteSkus
pop促销总价删除sku主商品
jingdong.pop.market.read.inner.getPromotionByRfid
根据erp促销id查询pop促销详情
jingdong.seller.promotion.v2.get
查询促销详情
jingdong.seller.promotion.v2.list
查询促销列表
jingdong.seller.promotion.v2.count
查询促销个数
jingdong.seller.promotion.v2.sku.list
查询促销SKU列表
jingdong.seller.promotion.v2.sku.count
查询促销SKU个数
jingdong.seller.promotion.v2.getPromoLimit
获取指定类目的促销阈值
jingdong.seller.promotion.v2.approve
人工审核通过
jingdong.seller.promotion.v2.remove
删除促销
jingdong.seller.promotion.v2.unit.limit.create
创建限购促销
jingdong.seller.promotion.v2.unit.beanrequired.create
创建京豆优惠购促销
jingdong.seller.promotion.v2.unit.full.create
创建单品促销
jingdong.seller.promotion.v2.resume
重启促销
jingdong.seller.promotion.v2.suspend
暂停促销
jingdong.seller.coupon.read.getByUserCouponIdAndPin
根据用户优惠券id和pin获取优惠券信息
jingdong.seller.coupon.read.getCouponById
根据优惠券编号查询优惠券
jingdong.seller.coupon.retrieve.listAll
已下线
jingdong.adword.createAndDel
广告词创建和删除
jingdong.seller.coupon.write.addCouponLimitItems
添加优惠券限制sku

jingdong.seller.coupon.write.create      新建优惠券

API功能描述

新建优惠券

授权类型

需要

应用场景

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

应用级别输入参数

名称 类型 是否必须 示例值 描述
ip  String  127.0.  调用方IP 
port  String  80  调用方端口 
name  String  测试券001  优惠券名称(长度小于30) 
type  Number  优惠券类型 0京券 1东券 
bindType  Number  绑定类型 1全店参加 2指定sku参加 
grantType  Number  发放类型 3免费领取 5互动平台 【仅允许这两种】 
num  Number  优惠券数量(限制:(0,1000000000]) 
discount  Number  优惠券面额(限制:[1,5000)) 
quota  Number  10000  优惠限额(限制:[1,100000)),京券无门槛传0 
validityType  Number  有效期类型 1相对时间 5绝对时间(非小时券绝对时间的结束时间默认为设置结束时间当天的23:59:59,注:jos平台申请的目前都是非小时券) 
days  Number  有效期(validityType为1时必填) 
beginTime  Number  1586342986000  有效期开始时间(validityType为5时必填) 
endTime  Number  1586429386000  有效期结束时间(validityType为5时必填),有效期开始结束时间是券使用时间,必须包含在活动时间内,且小于 90 天 
password  String  null  发放密码,(不用赋值) 
batchKey  String  null  批次key(不赋值) 
member  Number  50  会员等级 50注册会员 56铜牌 61银牌 62金牌 105钻石 110VIP 90企业会员 
takeBeginTime  Number  1586342986000  领券开始时间(晚于当前) 
takeEndTime  Number  1586429386000  领券结束时间(活动时间最长90天) 
takeRule  Number  领券规则 5活动期间限领一张 4活动内每天限领一张 
takeNum  Number  限制条件内可以领取张数 
display  Number  是否公开 1不公开 3公开(grantType如设值5此参数必须为3) 
platformType  Number  -1:全平台(体系:不限,应用:全部) 1:京东全平台(体系:京东商城,应用:京东商城) 3:京东限平台(体系:京东商城,应用:京东商城,平台:限平台) 4:京东到家(体系:京东到家,应用:全部,平台:京东客户端) 5:开普勒(体系:开普勒体系,应用:实际应用) 7:一号店(体系:一号店体系,应用:不限) 9:拍拍二手(体系:拍拍二手7,应用:不限) 15:特价街(体系:特价街体系,应用:不限) 18:药京采(体系:药京采,应用:不限) 24:医药店送(体系:医药店送体系,应用:不限) 26:区区购(体系:区区购体系,应用:不限) 
platform  String  []  优惠券使用平台 0主站专享 1手机专享 3M版京东 4手Q专享 5微信专享 7京致衣橱(此参数需根据platformType设值,如限平台必填) 
shareType  Number  分享类型 1分享 2不分享(如设置京券type=0,此参数必填2不分享) 
activityLink  String  www.jd.com  活动返回链接 
userClass  Number  20000  会员类别 20000-普通会员,30000-付费会员,60000-新付费会员,70000-店铺粉丝会员 
paidMembers  String  []  userClass=30000时(101-试用会员,201-正式会员) 
skuId  Number[]  3254235  商品sku编号(如设置bindType为2,此参数必填,需是有效sku,bindType为1时不需要) 

返回结果

名称 类型 示例值 描述
couponId  Number  1212435   新建优惠券编号  

返回示例值

错误码

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

API测试工具

FAQ