获取餐饮行业客户会员券资产列表
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| foreignId | String | 必须 | e3oddir184931d | 商户会员id,会员唯一标识 | |
| couponType | String | 可选 | XXX | 满减券,优惠券等枚举类型 | |
| pageNo | Number | 必须 | 1 | 分页码,1开始 | |
| pageSize | Number | 必须 | 40 | 每页的数据数量 | |
| startDate | String | 可选 | 2021-12-12 12:12:!2 | 检索开始日期 | |
| endDate | String | 可选 | 2021-12-13 12:12:12 | 检索结束日期 | |
| couponId | String | 可选 | 184931234 | 优惠券id | |
| couponName | String | 可选 | 满4-1 | 优惠券名称 | |
| couponStatus | String | 可选 | 可使用 | 券状态,tims枚举为: 可使用、已过期、已使用、已转赠 | |
| status | String | 可选 | 1 | 券作废状态:(1-正常;0-作废) |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| msgCode | Number | 200 | 返回错误码,和http status保持概念相同 |
| errorSubCode | String | coupon-server-error | 错误子码 |
| errorSubMessage | String | 优惠券服务错误 | 具体错误描述 |
| result | Result | 业务接口响应结果 | |
|
{"foreignId":"e3oddir184931d","couponName":"满4-1","endDate":"2021-12-13 12:12:12","couponType":"XXX","pageNo":1,"couponStatus":"可使用","pageSize":40,"couponId":"184931234","startDate":"2021-12-12 12:12:!2","status":"1"}
{
"msgCode":200,
"errorSubCode":"coupon-server-error",
"errorSubMessage":"优惠券服务错误",
"result":{
"couponAssetsList":[
{
"couponId":"20201399391",
"couponName":"满4-1",
"couponType":"COUPON",
"getCouponDate":"2021-2-13 12:12:12",
"getCouponPrice":2000,
"isAllChannel":false,
"useWithOtherCoupon":true,
"validStartDate":"2021-2-13 12:12:12",
"validEndDate":"2021-2-14 12:12:12",
"validUseStartDate":"2021-2-12 12:12:12",
"validUseEndDate":"2021-2-13 12:12:12",
"orderId":"2020192929102931",
"isDonate":false,
"donateDate":"2021-2-13 12:12:12",
"donateMemberId":"kd913ka10do1",
"getCouponChannel":"APP",
"useCouponChannel":"APP,ALIPAY",
"useRules":"本券XXXX只能XXX不能XXX",
"voided":false,
"used":false,
"deferred":false,
"refunded":false,
"canDelay":true,
"donateReceiveMemberId":"kd913ka10do2",
"status":"1",
"couponStatus":"1"
}
],
"pageNo":1,
"pageSize":40,
"totalCount":300
}
}
{"errorSubCode":"sign-check-failure","errorSubMessage":"Illegal request","msgCode":"不等于200"}
| 错误码 | 错误描述 | 解决方案 |
|---|