查询优惠券额度
功能介绍
合作伙伴可以查看所拥有的优惠劵额度。
Web UI
一、伙伴可以登录合作伙伴中心查看所拥有的代金券额度。
- 在伙伴中心左侧的导航栏中选择“客户业务 > 代金券管理”。
- 单击“代金券额度”页签，查看代金券相关信息。
- 单击“操作”列的“详情”，查看该代金券额度初始额度、剩余余额、适用产品等相关信息及已发放回收代金券的操作记录。
二、伙伴可以登录合作伙伴中心查看所拥有的现金券额度。
- 在伙伴中心左侧的导航栏中选择“客户业务 > 现金券管理”。
- 单击“现金券额度”页签，查看现金券相关信息。
- 单击“操作”列的“详情”，查看该现金券额度信息及已发放回收现金券的操作记录。
REST API
伙伴在伙伴销售平台查询华为云为其发放的优惠券额度信息。
- 该接口只能给合作伙伴使用，调用的时候必须传递合作伙伴的AK/SK或者Token。
- 调用该接口之前，需通过客户经理联系华为运营人员，为合作伙伴设置优惠券发放额度。
- URI
GET /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons/quato
参数说明请参见下表。
表1 路径参数 参数
是否必选
取值范围
描述
partner_id
是
最大长度：64
合作伙伴ID（华为分配）。
获取方法请参见如何获取合作伙伴ID（partner_id）。
表2 查询参数 参数
是否必选
参数类型
取值范围
描述
quota_ids
否
List<String>
最大长度：50
额度ID列表。
quota_status_list
否
List<Integer>
最大长度：5
额度状态列表。
quota_type
是
Integer
-
额度类型：
- 0：代金券额度；
- 1：现金券额度。
create_time_begin
否
String
最大长度：64
创建时间（开始）。
输入这个条件，会查询出创建时间大于这个时间的记录。
create_time _end
否
String
最大长度：64
创建时间（结束）。
输入这个条件，会查询出创建时间小于这个时间的记录。
valid_time_begin
否
String
最大长度：64
生效时间（开始）。
输入这个条件，会查询出生效时间大于这个时间的记录。
valid_time_end
否
String
最大长度：64
生效时间（结束）。
输入这个条件，会查询出生效时间小于这个时间的记录。
expire_time_begin
否
String
最大长度：64
失效时间（开始）。
输入这个条件，会查询出失效时间大于这个时间的记录。
expire_time_end
否
String
最大长度：64
失效时间（结束）。
输入这个条件，会查询出失效时间小于这个时间的记录。
page_no
否
Integer
-
页码。
默认取值为1。
page_size
否
Integer
最大值：100
每页记录数。
默认取值为10。
- 请求消息
请求参数
无。
请求示例
GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/promotion-mgr/partner-coupons/quato?page_no=1&page_size=10"a_type=0 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
- 响应消息
响应参数
参数
参数类型
取值范围
描述
error_code
String
最大长度：20
状态码。
具体请参见4。
error_msg
String
最大长度：1000
错误描述信息。
total_num
Integer
-
查询总数。
quotas
List<CouponQuota>
-
额度记录列表。
具体请参见表3。
表3 CouponQuota 参数
参数类型
取值范围
描述
quota_id
String
最大长度：64
额度ID。
quota_type
Integer
-
额度类型：
- 0：代金券额度；
- 1：现金券额度。
limits
CouponLimits
-
代金券额度限制信息。
具体请参见表4。
create_time
String
最大长度：64
创建时间。
UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。
last_update_time
String
最大长度：64
最后一次更新时间。
UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。
表4 CouponLimits 参数
是否必选
参数类型
描述
quota_value
否
Double
代金券额度的值，精确到小数点后2位。
quota_status
否
Integer
状态：
- 0：正常；
- 3：失效（过期失效和人工设置失效）；
- 4：额度调整中（伙伴可以查看该额度，但不能使用该额度发放代金券）。
used_value
否
Double
已使用的代金券额度，精确到小数点后2位。
measure_id
否
Integer
面额单位。
1：元。
currency
否
String
币种。
当前仅有CNY。
valid_time
否
String
生效时间。
UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。
expire_time
否
String
失效时间。
UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。
use_with_empower_discount
否
Integer
代金券是否可以和授权折扣同享：
- 0：否
- 1：是
cycle_type
否
String
适用周期类型：
- 0：包周期-不限；
- 1：包周期-年；
- 2：包周期-月；
- 3：包周期-天；
- 4：包周期-小时；
- 5：按需；
- 6：通用。
coupon_face_value_max
否
Double
使用该额度发券时，券的最大值，精确到小数点后2位。
当取值为“-1”时，表示不限制最大值。
coupon_face_value_min
否
Double
使用该额度发券时，券的最小值，精确到小数点后2位。
当取值为“-1”时，表示不限制最小值。
coupon_num_max
否
Integer
限制给一个客户发放的券的数量。
发放的数量以客户当前的券数量为准。例如发放了100张券，又回收了20张券，则该客户当前的券数量为80。
当取值为“-1”时，表示不限制数量。
coupon_summary_value_max
否
Double
限制给一个客户发放的券总额。
当取值为“-1”时，表示不限制总额。
service_type
否
String
云服务类型限制。
多个云服务类型以“,”隔开。
当取值为空时，表示不限制云服务类型。
具体参考附录云服务类型。
service_type_display_name
否
String
云服务类型展示名称。
多个以“,”隔开，展示名称与“service_type”取值对应。
product_id
否
String
产品限制。
多个产品以“,”隔开。
当取值为空时，表示不限制产品。
product_display_name
否
String
产品展示名称。
多个以“,”隔开，展示名称与“product_id”取值对应。
whether_can_set_valid_time
否
Integer
是否可设置券的有效期：
- 0：不可设置；
- 1：可设置。
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "quotas": [ { "limits": { "currency": "CNY", "quota_value": 10000, "quota_status": 0, "used_value": 0, "measure_id": 1, "valid_time": "2018-01-15T16:00:00Z", "expire_time": "2018-01-17T15:59:59Z", "use_with_empower_discount": 0, "cycle_type": "0", "coupon_face_value_max": -1, "coupon_face_value_min": -1, "coupon_num_max": -1, "coupon_summary_value_max": -1, "service_type": "hws.service.type.ebs,hws.service.type.ec2", "service_type_display_name": "云硬盘,弹性云服务器", "product_id": null, "product_display_name": null, "whether_can_set_valid_time": 1 }, "quota_id": "2018011620580156", "create_time": "2018-01-16T12:58:14Z", "last_update_time": "2018-01-16T12:58:14Z", "quota_type": 0 }, { "limits": { "currency": "CNY", "quota_value": 100000, "quota_status": 0, "used_value": 1010, "measure_id": 1, "valid_time": "2018-01-15T16:00:00Z", "expire_time": "2018-01-17T15:59:59Z", "use_with_empower_discount": 0, "cycle_type": "0", "coupon_face_value_max": -1, "coupon_face_value_min": -1, "coupon_num_max": -1, "coupon_summary_value_max": -1, "service_type": null, "service_type_display_name": null, "product_id": "00301-101004-0--1", "product_display_name": "10人_自动化套餐 包年 华北区1", "whether_can_set_valid_time": 0 }, "quota_id": "2018011615520153", "create_time": "2018-01-16T07:52:38Z", "last_update_time": "2018-01-16T07:52:38Z", "quota_type": 0 }, { "limits": { "currency": "CNY", "quota_value": 100000, "quota_status": 0, "used_value": 502, "measure_id": 1, "valid_time": "2018-01-12T16:00:00Z", "expire_time": "2018-06-30T15:59:59Z", "use_with_empower_discount": 0, "cycle_type": "0", "coupon_face_value_max": 13, "coupon_face_value_min": 12, "coupon_num_max": -1, "coupon_summary_value_max": 12, "service_type": null, "service_type_display_name": null, "product_id": null, "product_display_name": null, "whether_can_set_valid_time": 0 }, "quota_id": "2018011316580130", "create_time": "2018-01-13T08:58:11Z", "last_update_time": "2018-01-13T08:58:11Z", "quota_type": 0 } ], "error_code": "CBC.0000", "error_msg": "success", "total_num": 3 }
相关文档
相关产品
