帮助中心

1213-优惠券发放推送

2021-06-02

接口编号 1213

接口说明

1.场景:会员在EZP微信H5页面进行积分兑换或其它活动获得券后,可根据该接口实时同步券数据给第三方系统,用于第三方系统线下核销券。

2.优惠券发放推送接口

3.请求路径:callback(调用方提供支持POST方式的接口地址)

4.驿氪主动发起,重试3次

注:

  1>第三方成功处理需要返回{ "Status": true, "StatusCode": 200, ... },见返回结果示例;

  2>推送失败自动重试3次。

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:callback(调用方提供支持POST方式的接口地址)

请求参数

指驿氪推送给第三方接口的数据格式

字段类型为空长度描述
Brandstring16所属品牌编号
OldCodestring20客户卡号,针对会员发放券(本字段可能为空-粉丝会员)
WxOpenIDstring32会员微信卡号
MobileNostring20会员手机号码
CoupGrpIdint
ezr券库编号
CoupNostring40券号码
CoupNamestring26券显示名称
CoupTypeint
券类型:1=品牌代金券;2=品牌折扣券;3=品牌促销券;4=礼品券;5=邀请券;10=异业券
PromotionCodestring30促销代号
CoupValuedouble
券面额(小数点2位) ,折扣券是折扣比例
PriceLimitdouble
券使用门槛 0表示无门槛
IsMorebool
true:可以多张核销;false:单张核销
AllowMultipleCouponsint
可使用券数量
MaxBuyNumint
允许一个订单最多购买多少商品
IsPositivebool
是否仅允许正价商品使用(false0不允许 true1允许)
BegDatestring
有效开始日期(yyyy-MM-dd格式)
EndDatestring
有效结束日期(yyyy-MM-dd格式)
Guidestring1024使用说明
ApplyTypestring2组织类型:全部用户 : BD;片区用户:PQ;店群用户:GP;门店用户:SH
ApplyBrandsstring1024适用品牌编码列表,如果是多品牌券,多个品牌Id使用逗号分隔,为空表示只可单品牌适用(发放品牌)
CoupGrpCodestring64券外部唯一编号
DiscountLimitint
折扣限制(0~100)
IsDiscountLimitbool
是否折扣限制
Codestring20会员电子卡号
UseSystemstring16券所使用系统,跟随券库创建,不填写,代表为供发放系统使用;EZR-MALL  代表仅供ezr商城券使用;EZR-ALL     代表通用券,所有客户系统可使用;其它系统值,咨询客户业务系统(例如:pos代表线下pos可使用)
IsHasConsumeShopsbool
是否指定适用门店(线下)
IsHasCouponsbool
是否限制商品
IsCompositedbool
是否允许叠加使用
AllowMinBuyNumint
允许一个订单最少购买多少商品
IsAllowBuyLessbool
是否限制一个订单最少购买商品数
CouponPricedouble

卖券金额

请求参数示例代码(json对象)

{

 "OldCode": "EZ00001230",

 "CoupNo": "0000123001",

 "CoupName": "50元代金券",

 "CoupType": 1,

 "PromotionCode": "ez123123",

 "CoupValue": 50,

 "BegDate": "2015-10-17",

 "EndDate": "2015-11-17",

 "Guide": "这是一个使用说明",

 "ApplyShops": "SH0001,SH0002",

"IsHasConsumeShops":true,

 "IsHasCoupons":false

}

系统级返回结果示例(json)

指第三方接口需要返回的结果格式

{

 "Status": true,

 "StatusCode": 200,

 "Msg": "成功",

 "Timestamp": "20150622093101",

 "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",

 "Result": 见业务返回结果示例,

}

业务返回结果示例(json对象):

指第三方接口需要返回的结果格式


10846