文档首页 > > API参考> 管理促销> 管理优惠券> 查询优惠券额度

查询优惠券额度

分享
更新时间: 2019/11/15 GMT+08:00

功能介绍

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

Web UI

一、伙伴可以登录合作伙伴中心查看所拥有的代金券额度。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 代金券管理”。
  2. 单击“代金券额度”页签,查看代金券相关信息。

  3. 单击“操作”列的“详情”,查看该代金券额度初始额度、剩余余额、适用产品等相关信息及已发放回收代金券的操作记录。

二、伙伴可以登录合作伙伴中心查看所拥有的现金券额度。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 现金券管理”。
  2. 单击“现金券额度”页签,查看现金券相关信息。

  3. 单击“操作”列的“详情”,查看该现金券额度信息及已发放回收现金券的操作记录。

REST API

伙伴在伙伴销售平台查询华为云为其发放的优惠券额度信息。

  • 该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token。
  • 调用该接口之前,需通过客户经理联系华为运营人员,为合作伙伴设置优惠券发放额度。

  1. 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。

  1. 请求消息

    请求参数

    无。

    请求示例

    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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    取值范围

    描述

    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
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0151

    访问拒绝。

    CBC.0100

    输入参数校验失败。

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区