更新时间:2022-05-24 GMT+08:00
分享

查询代金券额度的发放回收记录

功能介绍

华为云伙伴能力中心(一级经销商)可以查看给精英服务商(二级经销商)发放或回收代金券额度的操作记录。

一级经销商可以登录伙伴中心,进入“客户业务 > 代金券管理”,选择“代金券额度”页签,单击“操作记录”查看代金券额度的发放和回收记录。

伙伴也可以单击代金券额度所在行的“操作记录”,查看该代金券额度对应的操作记录日志。

接口约束

该接口只允许使用华为云伙伴能力中心的AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口。

URI

GET /v2/partners/coupon-quotas/records
表1 查询参数

参数

是否必选

参数类型

取值范围

描述

indirect_partner_id

String

最大长度:64

精英服务商ID。获取方法请参见查询精英服务商列表

  • 为空表示查询所有的代金券额度发放回收记录。
  • 不为空表示仅查询与该精英服务商相关的代金券额度发放回收记录。

默认查询所有精英服务商的代金券额度发放回收记录。

quota_id

String

最大长度:64

精英服务商的代金券额度ID。获取方法请参见查询优惠券额度

即华为云伙伴能力中心给精英服务商发放代金券额度时,产生的精英服务商的代金券额度ID,或者从精英服务商回收代金券额度时,精英服务商的代金券额度ID。

operation_time_begin

String

最大长度:20

查询条件:操作起始时间。

UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。

operation_time_end

String

最大长度:20

查询条件:操作截止时间。

UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。

parent_quota_id

String

最大长度:64

父额度ID。

这即华为云伙伴能力中心给精英服务商发放代金券额度时,华为云伙伴能力中心的额度ID,或者从精英服务商回收代金券额度时,回收的华为云伙伴能力中心的额度ID。

operation_type

String

最大长度:8

操作类型。

  • 10:发放额度
  • 11:回收额度

limit

Integer

最大值:100

每次查询的数目。默认值为10。

offset

Integer

[0-最大整数]

偏移量,从0开始,默认值为0。

说明:

offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。

例如,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。

请求消息

请求参数

无。

请求示例

GET https://bss.myhuaweicloud.com/v2/partners/coupon-quotas/records?quota_id=2020061803084311&indirect_partner_id=051a8a834180d3fb0f25c006b1998800&operation_time_begin=2020-06-17T03:08:22Z&operation_time_end=2020-06-19T03:08:22Z&parent_quota_id=2019071108095202&operation_type=10&offset=0&limit=10 HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ   

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

状态码。具体请参见状态码。只有失败才会返回这个参数。

error_msg

String

最大长度:2000

错误描述信息。只有失败才会返回这个参数。

total_count

Integer

-

返回总条数。

records

List<QuotaRecord>

-

记录列表。

具体请参见表2

表2 QuotaRecord

参数

参数类型

取值范围

描述

id

String

最大长度:64

记录ID。

operator

String

最大长度:128

操作员的账号名称。

operation_type

String

最大长度:8

操作类型。

  • 10:发放额度
  • 11:回收额度

quota_id

String

最大长度:64

精英服务商的代金券额度ID。

即华为云伙伴能力中心给精英服务商发放代金券额度时,产生的精英服务商的代金券额度ID,或者从精英服务商回收代金券额度时,精英服务商的代金券额度ID。

parent_quota_id

String

最大长度:64

父额度ID。

这即华为云伙伴能力中心给精英服务商发放代金券额度时,华为云伙伴能力中心的额度ID,或者从精英服务商回收代金券额度时,回收的华为云伙伴能力中心的额度ID。

amount

BigDecimal

-

发放回收的金额。

取值大于0且精确到小数点后2位,单位:元。

operation_time

String

最大长度:20

操作时间,UTC时间,UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。

result

String

最大长度:20

操作结果。

  • 0:成功
  • -1:失败

indirect_partner_account_name

String

最大长度:64

精英服务商的账号名。

indirect_partner_id

String

最大长度:64

精英服务商ID。

indirect_partner_name

String

最大长度:256

精英服务商的公司名称。

remark

String

最大长度:256

备注。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
    "total_count": 1,
    "records": [
        {
            "id": "2d3030bdfde74794900ebd6386feb536",
            "operator": "cbc_admin_betam",
            "operation_type": "10",
            "quota_id": "2020061803084311",
            "parent_quota_id": "2019071108095202",
            "amount": 1.11,
            "operation_time": "2020-06-18T03:08:22Z",
            "result": "0",
            "indirect_partner_account_name": "jing_echannel_son",
            "indirect_partner_id": "051a8a834180d3fb0f25c006b1998800",
            "indirect_partner_name": "Partner1945",
            "remark": null
        }
    ]
}

状态码

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

HTTP状态码

错误码

描述

400

CBC.0100

请求非法。

400

CBC.99000037

您没有操作该精英服务商的权限。

403

CBC.0151

拒绝访问

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品

close