驿氪帮助中心 - 12131-券批量发放推送

接口编号 12131

接口说明

1.场景：各活动场景批量发券，可根据该接口实时同步券数据给第三方系统，用于第三方系统线下核销券。

2.优惠券发放推送接口

3.请求路径：callback（调用方提供支持POST方式的接口地址）

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

5.用于批量发券，比如（总部批量营销，1313批量回推），不能代替1213场景，比如（注册送券，积分兑券...）

注：

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

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

请求说明

HTTP请求方式：POST
返回数据格式：JSON
请求路径：callback（调用方提供支持POST方式的接口地址）

请求参数

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

字段	类型	为空	长度	描述
Brand	string	否	16	所属品牌编号
OldCode	string	否	20	客户卡号，针对会员发放券（本字段可能为空-粉丝会员）
WxOpenID	string	是	32	会员微信卡号
MobileNo	string	否	20	会员手机号码
CoupGrpId	int			ezr券库编号
CoupNo	string	否	40	券号码
CoupName	string	否	26	券显示名称
CoupType	int			券类型：1=品牌代金券；2=品牌折扣券；3=品牌促销券；4=礼品券；5=邀请券；10=异业券
PromotionCode	string	是	30	促销代号
CoupValue	double			券面额(小数点2位),折扣券用0-1
PriceLimit	double			券使用门槛 0表示无门槛
IsMore	bool			true：可以多张核销；false：单张核销
MaxBuyNum	int			允许一个订单最多购买多少商品
IsPositive	bool			是否仅允许正价商品使用（0 不允许 1 允许）
BegDate	string			有效开始日期(yyyy-MM-dd格式)
EndDate	string			有效结束日期(yyyy-MM-dd格式)
Guide	string	否	1024	使用说明
ApplyType	string	否	2	组织类型：全部用户 : BD；片区用户：PQ；店群用户：GP；门店用户：SH
ApplyShops	string	是	1024	适用门店编码列表，为空表示不限制，多个门店使用逗号分隔
ApplyBrands	string	是	1024	适用品牌编码列表，如果是多品牌券，多个品牌Id使用逗号分隔，为空表示只可单品牌适用(发放品牌)
CoupGrpCode	string	是	64	券外部唯一编号
DiscountLimit	int			折扣限制（0~100）
IsDiscountLimit	bool			是否折扣限制
UseSystem	string	是	16	券所使用系统，跟随券库创建，不填写，代表为供发放系统使用；EZR-MALL 代表仅供ezr商城券使用；EZR-ALL 代表通用券，所有客户系统可使用；其它系统值，咨询客户业务系统（例如：pos代表线下pos可使用）
IsHasConsumeShops	bool			是否指定适用门店(线下)
IsHasCoupons	bool			是否限制商品
IsComposited	bool			是否允许叠加使用
AllowMinBuyNum	int	否		允许一个订单最少购买多少商品
IsAllowBuyLess	bool	否		是否限制一个订单最少购买商品数
CouponPrice	double			卖券金额

请求参数示例代码（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"},{...}]

系统级返回结果示例（json）

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

{"Status": true,"StatusCode": 200,"Msg": "成功","Timestamp": "20150622093101","Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E","Result": 见业务返回结果示例,}

业务返回结果示例（json对象）：

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