帮助中心
进入EZR

1323-外部拉粉并上传优惠券

2021-12-02

接口编号 1323

接口说明

  • 场景：第三方系统调用接口对EZR消费者（粉丝或会员）发放优惠券；

  • 券号必须唯一，一券号不可重复发放

  • 券号和外部业务编号二选一，优先券号

  • 如果已关注公众号的消费者，则会通过微信模板推送用户

  • OldCode、WxOpenID、MobileNo、WxUnionID必须至少传递一个，如品牌已开通小程序，通过WxOpenID传输时必须传入WxUnionID。

  • 给粉丝发券，不存在会创建粉丝，给会员发券，会员不存在则券不会与会员绑定（会员比券晚2小时也不会绑定会员）

  • 这个接口是券先落库，后与粉丝，会员绑定

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：api/CVip/CoupSendAsync

请求参数

字段类型是否允许为空长度描述
OldCodeString是1~20会员线下卡号
WxOpenIDString是1~32会员微信  openID
MobileNoString是1~11手机号必须是格式正确的手机号，按手机号发券的情况，手机号可以是在EZR系统未注册的会员。
WxUnionIDString是1~32微信开放平台唯一标识
CoupGrpIdInt否
ezr电子券库编号
CoupNoString否1~20券号（唯一，不可重复）
SerialNoString否1~32外部业务编号
BegDateString否10有效开始日期（yyyy-MM-dd格式）
EndDateString否10有效结束日期（yyyy-MM-dd格式）
ValidTypeString否2有效期类型：FV，代表永久有效（异业券不能永久有效），TS，代表固定时间段
RegShopString是1~16消费者邀请门店，如果通过openID或unionID进行发券，则此字段必填
CoupGrpCodeString否
券库code 、与CoupGrpId选一


请求参数示例代码（json对象）

{

   "ValidType":"TS",

   "BegDate":"2019-06-18",

   "WxOpenID":"o8cXPv4qiYF9WiGT39VQea2rGoSw",

   "WxUnionID":"ABCDPv4qiYF9WiGT39VQea2rGoSw",

   "CoupGrpId":1774454,

   "EndDate":"2019-06-30",

   "CoupNo":"TEST00000006",

   "RegShop":"8888"

}

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

{

  "Status": true,

  "StatusCode": 200,

  "Msg": "成功",

  "Timestamp": "20150622093101",

  "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",

  "Result": 成功

}


2023