帮助中心

1307-第三方查询会员可用券

2020-10-21

接口说明:

调用接口获取指定会员的可用券列表。

请求说明:

接口:1307

HTTP请求方式:POST

返回数据格式:JSON

请求路径:api/ccoup/coupget

请求参数:

字段类型为空长度描述
OldCodestring20会员线下卡号
Codestring20会员电子卡号
MobileNostring11会员手机号
WxOpenIDstring32会员微信openId
JDPinstring32会员对应京东pin说明:线下卡号、电子卡号、手机号、微信openId、JDPin, 五填一即可
CouponTypestring 2券类型DJ=品牌代金券ZK=品牌折扣券CX=品牌促销券LP=礼品券YQ=邀请券YY=异业券传空默认查询全部类型
ShopCodestring16适用门店
ShowAllint
是否返回所有状态的券,默认为“只返回可用状态”0=返回可用状态1=返回所有状态
UseSystemstring16券所使用系统,代表为供发放系统使用;EZR-MALL  代表仅供ezr商城券使用;EZR-ALL     代表通用券,所有客户系统可使用;其它系统值,咨询客户业务系统(例如:pos代表线下pos可使用)

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

{ "OldCode": "0000123001", "ShopCode": "000021",}

返回参数:

字段类型长度描述
CouponNostring40券码
CouponTypestring2券类型DJ=品牌代金券ZK=品牌折扣券CX=品牌促销券LP=礼品券YQ=邀请券YY=异业券
CouponGrpIdint11ezr券库编号
CouponNamestring26券名称
BegDatestring
有效开始日期yyyy-MM-dd格式
EndDatestring
有效结束日期yyyy-MM-dd格式说明:为0代表永久有效
Guidestring1024使用说明
CouponValuedecimal12,2面额 (折扣券0-1 )
PriceLimitdecimal12,2使用门槛
PromotionCodestring30若是促销券,指对应的促销代码
IsMorebool
是否允许使用多张
AllowMultipleCouponsint11券可使用张数
MaxBuyNumint11允许一个订单最多购买多少商品
IsPositivebool
是否仅允许正价商品使用
Statusbool
是否可以
StatusCodeint
0=可使用,2=锁定,4=禁用,8=核销
StatusMsgstring
可用状态描述
GenDatestring
领取时间 yyyy-MM-dd HH:mm:ss
UseSystemstring
券所使用系统,代表为供发放系统使用;EZR-MALL  代表仅供ezr商城券使用;EZR-ALL     代表通用券,所有客户系统可使用;其它系统值,咨询客户业务系统(例如:pos代表线下pos可使用)

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

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

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

[{ "CouponNo": "HQ01S001", "CouponType": "ZK", "CouponName": "8折券", "BegDate": "2016-01-01", "EndDate": "2017-01-01", "Guide": "8折券8折券", "CouponValue": 0.8, "PriceLimit": 100,  "IsMore":  false}]
3955