# 回收云经销商的代金券额度-ReclaimCouponQuotas
#### 功能介绍
华为云总经销商（一级经销商）可以回收已发放给云经销商（二级经销商）的代金券额度。
一级经销商在伙伴中心回收已发放给二级经销商的代金券额度请参见[这里](https://support.huaweicloud.com/usermanual-bpconsole/dp_120206.html)。
#### 接口约束
该接口只允许使用华为云总经销商的AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ReclaimCouponQuotas)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。
接口对应的权限项如下：
| 权限项                                                      | 权限项名称                                                                                                                                                                                                                |
|:---|:---|
| BPC_ITEM_SUBCUSTSERV_030601\|BPC_ITEM_SUBCUSTSERV_030602 | - 销售-客户-券管理-已发放代金券额度-批量回收代金券额度  - 销售-客户-券管理-已发放代金券额度-回收代金券额度   |
   
#### URI
POST /v2/partners/coupon-quotas/indirect-partner-reclaim
#### 请求消息
请求参数
| 参数        | 是否必选 | 参数类型           | 取值范围     | 描述                                                                                                            |
|:---|:---|:---|:---|:---|
| quota_ids | 是    | List\<String\> | 最大个数：10  | 被回收的云经销商的代金券额度ID。获取方法请参见[查询优惠券额度](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0091566753.html)。 |
| remark    | 否    | String         | 最大长度：256 | 回收时的备注。 此参数不携带或携带值为null时，不赋值；携带值为空串时，赋值空串。                                       |
   
请求示例
```
POST https://bss.myhuaweicloud.com/v2/partners/coupon-quotas/indirect-partner-reclaim HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
      "quota_ids": [
        "2020061902584509"
      ],
      "remark": "回收代金券额度"
}
```
#### 响应消息
响应参数
| 参数                 | 参数类型                 | 描述                                                                                    |
|:---|:---|:---|
| error_code         | String               | 状态码。具体请参考[状态码]。只有失败才返回该字段。                        |
| error_msg          | String               | 错误描述信息。只有失败才返回该字段。                                                                    |
| error_details      | List\<ErrorDetail\>  | 回收失败的云经销商额度信息，具体参见[表1]，只有HTTP STATUS 200的时候才有这个结构体。 |
| simple_quota_infos | List\<QuotaReclaim\> | 回收成功的云经销商额度信息，具体参见[表2]，只有HTTP STATUS 200的时候才有这个结构体。  |
   
 表1ErrorDetail 
| 参数         | 参数类型   | 描述                                                             |
|:---|:---|:---|
| id         | String | 被回收的云经销商的代金券额度ID。                                              |
| error_code | String | 状态码。具体请参考[状态码]。只有失败才返回该字段。 |
| error_msg  | String | 错误描述信息。只有失败才返回该字段。                                             |
   
 表2QuotaReclaim 
| 参数            | 参数类型       | 取值范围     | 描述                   |
|:---|:---|:---|:---|
| quota_id      | String     | 最大长度：128 | 被回收的云经销商的代金券额度ID。    |
| quota_balance | BigDecimal | -        | 被回收额度后的代金券额度余额。单位：元。 |
   
响应示例
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
  "error_details": [],
  "simple_quota_infos": [
    {
      "quota_id": "2020061902584509",
      "quota_balance": "100"
    }
  ]
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 错误描述                                               |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。                                              |
| 400     | CBC.99000012 | 额度不存在或者额度状态不正确（如果出现error_details，HTTP STATUS为200）。 |
| 403     | CBC.0151     | 访问拒绝。                                              |
| 500     | CBC.0999     | 其他错误。                                              |