请登录后查看
ListIssuedCouponQuotas
查询已发放的代金券额度
华为云总经销商(一级经销商)可以查看发放给云经销商(二级经销商)的代金券额度列表。
一级经销商登录伙伴中心,进入“客户业务** **> 代金券管理”,选择“已发放代金券额度”可查看代金券额度列表。
说明: 调用该接口之前,需通过客户经理联系华为运营人员,为合作伙伴设置代金券发放额度。
该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
X-Auth-Token | string | header | 是 | 合作伙伴Token调用 |
limit | integer | query | 否 | 每次查询记录数。默认值为10。 |
offset | integer | query | 否 | 偏移量,从0开始。默认值为0。 说明: offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。例如,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。 |
parent_quota_id | string | query | 否 | 父额度ID,即华为云总经销商用于发放给云经销商代金券额度的额度ID。此参数不携带时,不作为筛选条件;携带值为空或携带值为空串时,作为筛选条件。 |
indirect_partner_id | string | query | 否 | 云经销商ID。获取方法请参见查询云经销商列表。如果需要查询云经销商伙伴的代金券额度,必须携带该字段。除此之外,此参数不做处理。 |
quota_id | string | query | 否 | 云经销商的代金券额度ID。获取方法请参见查询优惠券额度。此参数不携带或携带值为空时,不作为筛选条件。 |
查询已发放的代金券额度响应
| 名称 | 类型 | 描述 |
|---|---|---|
total_count | integer | 查询的记录总数。 |
quotas | Array of IssuedCouponQuota objects | 额度记录列表。 具体请参见表2。 |
| 名称 | 类型 | 描述 |
|---|---|---|
quota_id | string | 已发放的代金券额度ID。 |
quota_type | integer | 额度类型: 0:代金券额度 |
create_time | string | 创建时间。 UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。 |
last_update_time | string | 最后一次更新时间。 UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。 |
quota_value | number | 代金券额度的值,精确到小数点后2位。 |
quota_status | integer | 代金券额度的状态: 0:正常3:失效(包括过期失效和人工设置失效)4:额度调整中(伙伴可以查看该额度,但不能使用该额度发放代金券)5:冻结6:回收 |
balance | number | 剩余的代金券额度,精确到小数点后2位。 |
measure_id | integer | 代金券额度的单位。 1:元。 |
currency | string | 币种。 CNY:人民币 |
effective_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”。 |
limit_infos | Array of QuotaLimitInfo objects | 代金券额度上的限制属性,具体参见表3。 |
indirect_partner_id | string | 云经销商ID。 |
indirect_partner_account_name | string | 云经销商账号名。 |
indirect_partner_name | string | 云经销商名称。 |
parent_quota_id | string | 父额度ID,即华为云总经销商用于发放给云经销商代金券额度的额度ID。 |
| 名称 | 类型 | 描述 |
|---|---|---|
limit_key | string | 属性key值。 |
limit_values | Array of LimitValue objects | 属性值,具体参见表3。 |
| 名称 | 类型 | 描述 |
|---|---|---|
value1 | string | 属性值1。 |
value2 | string | 属性值2。 |
|CBC.0100:输入参数校验失败。|
"GET https://bss.myhuaweicloud.com/v2/partners/issued-coupon-quotas?quota_id=2020061902584509&indirect_partner_id=05bad7a90700d5bf0ff6c00ae40d0ca0&parent_quota_id=2020010206413502&offset=0&limit=10"查询已发放的代金券额度响应
"total_count": 1,
"quotas": [
{
"quota_id": "2020061902584509",
"quota_type": 0,
"create_time": "2020-06-19T02:58:54Z",
"last_update_time": "2020-06-19T02:59:25Z",
"quota_value": 0.01,
"quota_status": 6,
"balance": 0.01,
"measure_id": 1,
"currency": "CNY",
"effective_time": "2020-01-01T16:00:00Z",
"expire_time": "2020-12-31T15:59:59Z",
"limit_infos": [
{
"limit_key": "associationType",
"limit_values": [
{
"value1": "3",
"value2": null
}
]
},
{
"limit_key": "couponFaceValueMax",
"limit_values": [
{
"value1": "-1.00",
"value2": null
}
]
},
{
"limit_key": "couponFaceValueMin",
"limit_values": [
{
"value1": "-1.00",
"value2": null
}
]
},
{
"limit_key": "couponNumMax",
"limit_values": [
{
"value1": "-1",
"value2": null
}
]
},
{
"limit_key": "couponSummaryValueMax",
"limit_values": [
{
"value1": "-1.00",
"value2": null
}
]
},
{
"limit_key": "isFirstAssociated",
"limit_values": [
{
"value1": "0",
"value2": null
}
]
},
{
"limit_key": "minBaseValueRatio",
"limit_values": [
{
"value1": "-1",
"value2": null
}
]
},
{
"limit_key": "minConsumeDiscount",
"limit_values": [
{
"value1": "-1.00000",
"value2": null
}
]
},
{
"limit_key": "simultaneousUseWithEmpowerDiscount",
"limit_values": [
{
"value1": "0",
"value2": null
}
]
},
{
"limit_key": "canSetValidTime",
"limit_values": [
{
"value1": "0",
"value2": null
}
]
},
{
"limit_key": "simultaneousUseWithDiscountCoupon",
"limit_values": [
{
"value1": "0",
"value2": null
}
]
},
{
"limit_key": "chargeScene",
"limit_values": [
{
"value1": "1",
"value2": "1"
},
{
"value1": "5",
"value2": "-1"
},
{
"value1": "2",
"value2": "-1"
}
]
},
{
"limit_key": "simultaneousUseWithPromotionDiscount",
"limit_values": [
{
"value1": "0",
"value2": null
}
]
},
{
"limit_key": "simultaneousUseWithPromotionProduct",
"limit_values": [
{
"value1": "0",
"value2": null
}
]
}
],
"indirect_partner_id": "05bad7a90700d5bf0ff6c00ae40d0ca0",
"indirect_partner_account_name": "d_1945",
"indirect_partner_name": "Partner1945",
"parent_quota_id": "2020010206413502"
}
]
}