向云经销商发放代金券额度-UpdateCouponQuotas

功能介绍

华为云总经销商（一级经销商）可以向云经销商（二级经销商）发放代金券额度。

一级经销商在伙伴中心向二级经销商发放代金券额度请参见这里。

接口约束

该接口只允许使用华为云总经销商的AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见为组织人员分配权限。

接口对应的权限项如下：

权限项	权限项名称
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。获取方法请参见查询优惠券额度。

参数

是否必选

参数类型

取值范围

描述

indirect_partner_ids

是

List<String>

最大个数：100

云经销商ID列表。

quota_amount

是

BigDecimal

华为云总经销商向云经销商发放的代金券额度值。

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

quota_id

是

String

最大长度：64

华为云总经销商发放的代金券额度的ID。获取方法请参见查询优惠券额度。

请求示例

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的时候才有这个结构体。

表1 ErrorDetail
参数	参数类型	描述
id	String	云经销商ID。
error_code	String	状态码。具体请参考状态码。只有失败才返回该字段。
error_msg	String	错误描述信息。只有失败才返回该字段。

表2 SimpleQuotaInfo
参数	参数类型	取值范围	描述
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"
    }
  ]
}

状态码

状态码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	其他错误。