查询优惠券额度
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_type
是
Integer
-
额度类型:
- 0:代金券额度
- 1:现金券额度
quota_ids
否
List<String>
最大长度:50
额度ID列表。
quota_status_list
否
List<Integer>
最大长度:5
额度状态列表。
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 }
