接口说明:
调用接口获取指定会员的可用券列表。
请求说明:
接口:1307
HTTP请求方式:POST
返回数据格式:JSON
请求路径:api/ccoup/coupget
请求参数:
字段 | 类型 | 为空 | 长度 | 描述 |
---|---|---|---|---|
OldCode | string | 否 | 20 | 会员线下卡号 |
Code | string | 否 | 20 | 会员电子卡号 |
MobileNo | string | 否 | 11 | 会员手机号 |
WxOpenID | string | 否 | 32 | 会员微信openId |
JDPin | string | 否 | 32 | 会员对应京东pin说明:线下卡号、电子卡号、手机号、微信openId、JDPin, 五填一即可 |
CouponType | string | 否 | 2 | 券类型DJ=品牌代金券ZK=品牌折扣券CX=品牌促销券LP=礼品券YQ=邀请券YY=异业券传空默认查询全部类型 |
ShopCode | string | 否 | 16 | 适用门店 |
ShowAll | int | 否 | 是否返回所有状态的券,默认为“只返回可用状态”0=返回可用状态1=返回所有状态 | |
UseSystem | string | 是 | 16 | 券所使用系统,代表为供发放系统使用;EZR-MALL 代表仅供ezr商城券使用;EZR-ALL 代表通用券,所有客户系统可使用;其它系统值,咨询客户业务系统(例如:pos代表线下pos可使用) |
请求参数示例代码(json对象):
{ "OldCode": "0000123001", "ShopCode": "000021",}
返回参数:
字段 | 类型 | 长度 | 描述 |
---|---|---|---|
CouponNo | string | 40 | 券码 |
CouponType | string | 2 | 券类型DJ=品牌代金券ZK=品牌折扣券CX=品牌促销券LP=礼品券YQ=邀请券YY=异业券 |
CouponGrpId | int | 11 | ezr券库编号 |
CouponName | string | 26 | 券名称 |
BegDate | string | 有效开始日期yyyy-MM-dd格式 | |
EndDate | string | 有效结束日期yyyy-MM-dd格式说明:为0代表永久有效 | |
Guide | string | 1024 | 使用说明 |
CouponValue | decimal | 12,2 | 面额 (折扣券0-1 ) |
PriceLimit | decimal | 12,2 | 使用门槛 |
PromotionCode | string | 30 | 若是促销券,指对应的促销代码 |
IsMore | bool | 是否允许使用多张 | |
AllowMultipleCoupons | int | 11 | 券可使用张数 |
MaxBuyNum | int | 11 | 允许一个订单最多购买多少商品 |
IsPositive | bool | 是否仅允许正价商品使用 | |
Status | bool | 是否可用 | |
StatusCode | int | 0=可使用,2=锁定,4=禁用,8=核销 | |
StatusMsg | string | 可用状态描述 | |
GenDate | string | 领取时间 yyyy-MM-dd HH:mm:ss | |
UseSystem | string | 券所使用系统,代表为供发放系统使用;EZR-MALL 代表仅供ezr商城券使用;EZR-ALL 代表通用券,所有客户系统可使用;其它系统值,咨询客户业务系统(例如:pos代表线下pos可使用) | |
IsComposited | bool | 是否支持叠加 | |
AllowMinBuyNum | int | 否 | 允许一个订单最少购买多少商品 |
IsAllowBuyLess | bool | 否 | 是否限制一个订单最少购买商品数 |
CouponPrice | decimal | 12,2 | 卖券金额 |
系统级返回结果示例(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}]