1213
接口说明
1.场景:会员在EZP微信H5页面进行积分兑换或其它活动获得券后,可根据该接口实时同步券数据给第三方系统,用于第三方系统线下核销券。
2.优惠券发放推送接口
3.请求路径:callback(调用方提供支持POST方式的接口地址)
4.驿氪主动发起,重试3次
注:
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位) ,折扣券是折扣比例 | |
PriceLimit | double | 否 | 券使用门槛 0表示无门槛 | |
IsMore | bool | 否 | true:可以多张核销;false:单张核销 | |
AllowMultipleCoupons | int | 是 | 可使用券数量 | |
MaxBuyNum | int | 是 | 允许一个订单最多购买多少商品 | |
IsPositive | bool | 否 | 是否仅允许正价商品使用(false0不允许 true1允许) | |
BegDate | string | 否 | 有效开始日期(yyyy-MM-dd格式) | |
EndDate | string | 否 | 有效结束日期(yyyy-MM-dd格式) | |
Guide | string | 否 | 1024 | 使用说明 |
ApplyType | string | 否 | 2 | 组织类型:全部用户 : BD;片区用户:PQ;店群用户:GP;门店用户:SH |
ApplyBrands | string | 是 | 1024 | 适用品牌编码列表,如果是多品牌券,多个品牌Id使用逗号分隔,为空表示只可单品牌适用(发放品牌) |
CoupGrpCode | string | 是 | 64 | 券外部唯一编号 |
DiscountLimit | int | 是 | 折扣限制(0~100) | |
IsDiscountLimit | bool | 否 | 是否折扣限制 | |
Code | string | 否 | 20 | 会员电子卡号 |
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",
"IsHasConsumeShops":true,
"IsHasCoupons":false
}
系统级返回结果示例(json)
指第三方接口需要返回的结果格式
{
"Status": true,
"StatusCode": 200,
"Msg": "成功",
"Timestamp": "20150622093101",
"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
"Result": 见业务返回结果示例,
}
业务返回结果示例(json对象):