查询优惠券额度

功能介绍

合作伙伴可以查看所拥有的优惠劵额度。

该接口即将下线，“查询优惠券额度”接口请参考查询优惠券额度。

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&quota_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
}

状态码
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
状态码

描述

CBC.0000

成功。

CBC.0151

访问拒绝。

CBC.0100

参数错误。

CBC.0999

其他错误。

状态码	描述
CBC.0000	成功。
CBC.0151	访问拒绝。
CBC.0100	参数错误。
CBC.0999	其他错误。

父主题： 管理优惠券

上一篇：查询优惠券列表

下一篇：发放优惠券

查询优惠券额度

功能介绍

Web UI

REST API

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

7*24

0元

专业服务

退订

建议反馈

售前咨询热线