# 向云经销商发放代金券额度-UpdateCouponQuotas
#### 功能介绍
华为云总经销商（一级经销商）可以向云经销商（二级经销商）发放代金券额度。
一级经销商在伙伴中心向二级经销商发放代金券额度请参见[这里](https://support.huaweicloud.com/usermanual-bpconsole/dp_120206.html)。
#### 接口约束
该接口只允许使用华为云总经销商的AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=UpdateCouponQuotas)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。
接口对应的权限项如下：
| 权限项                                                | 权限项名称                                                                                                                                                                                                               |
|:---|:---|
| BPC_ITEM_SALES_020106\|BPC_ITEM_SUBCUSTSERV_030104 | - 销售-云经销商-云经销商管理-我的二级经销商列表-发放代金券额度  - 销售-客户-券管理-代金券额度-发放额度   |
   
#### URI
POST /v2/partners/coupon-quotas/indirect-partner-adjust
#### 请求消息
请求参数
| 参数                   | 是否必选 | 参数类型           | 取值范围     | 描述                                                                                                              |
|:---|:---|:---|:---|:---|
| indirect_partner_ids | 是    | List\<String\> | 最大个数：100 | 云经销商ID列表。                                                                                                       |
| quota_amount         | 是    | BigDecimal     | -        | 华为云总经销商向云经销商发放的代金券额度值。 单位：元。取值大于0且精确到小数点后2位。                                       |
| quota_id             | 是    | String         | 最大长度：64  | 华为云总经销商发放的代金券额度的ID。获取方法请参见[查询优惠券额度](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0091566753.html)。 |
   
请求示例
```
POST https://bss.myhuaweicloud.com/v2/partners/coupon-quotas/indirect-partner-adjust HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "quota_id": "2018011615520150",
  "indirect_partner_ids": ["62a*****d30"],
  "quota_amount": "1.11"
}
```
#### 响应消息
响应参数
| 参数                 | 参数类型                    | 描述                                                                                    |
|:---|:---|:---|
| error_code         | String                  | 状态码。具体请参考[状态码]。只有失败才返回该字段。                          |
| error_msg          | String                  | 错误描述信息。只有失败才返回该字段。                                                                    |
| error_details      | List\<ErrorDetail\>     | 发放失败的云经销商额度信息，具体参见[表1]，只有HTTP STATUS 200的时候才有这个结构体。 |
| simple_quota_infos | List\<SimpleQuotaInfo\> | 发放成功的云经销商额度信息，具体参见[表2]，只有HTTP STATUS 200的时候才有这个结构体。  |
   
 表1ErrorDetail 
| 参数         | 参数类型   | 描述                                                           |
|:---|:---|:---|
| id         | String | 云经销商ID。                                                      |
| error_code | String | 状态码。具体请参考[状态码]。只有失败才返回该字段。 |
| error_msg  | String | 错误描述信息。只有失败才返回该字段。                                           |
   
 表2SimpleQuotaInfo 
| 参数       | 参数类型   | 取值范围     | 描述               |
|:---|:---|:---|:---|
| id       | String | 最大长度：128 | 云经销商ID。          |
| quota_id | String | 最大长度：20  | 分配给云经销商的代金券额度ID。 |
   
响应示例
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
  "error_details": [],
   "simple_quota_infos": [
    {
      "id": "096725aa7800d4530f96c011b19aeca0",
      "quota_id": "2024051602054802"
    }
  ]
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 错误描述                                                     |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。                                                    |
| 403     | CBC.0150     | 非法操作。                                                    |
| 400     | CBC.50000045 | 不能对同一个代金券额度进行频繁操作。上一次的代金券额度划拨正在进行中，不允许并行划拨，待结束后再进行下一次操作。 |
| 200     | CBC.50010105 | 无法给退出中的云经销商发放代金券额度。                                      |
| 400     | CBC.99000013 | 优惠券额度不足。                                                 |
| 400     | CBC.99000015 | 此状态的额度不支持发放。                                             |
| 400     | CBC.99000017 | 额度未生效或者已过期。                                              |
| 400     | CBC.99000037 | 您没有操作该云经销商的权限。                                           |
| 400     | CBC.50000021 | 该代金券额度指定客户非云经销商子客户，不支持发放给云经销商。                           |
| 403     | CBC.0151     | 访问拒绝。                                                    |
| 500     | CBC.0999     | 其他错误。                                                    |