文档首页/ 合作伙伴中心/ API参考/ 管理云经销商/ 管理云经销商优惠券/ 回收云经销商的代金券额度
更新时间：2023-04-13 GMT+08:00
查看PDF
分享

回收云经销商的代金券额度

功能介绍

华为云总经销商（一级经销商）可以回收已发放给云经销商（二级经销商）的代金券额度。

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

接口约束

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

调试

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

URI

POST /v2/partners/coupon-quotas/indirect-partner-reclaim

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

quota_ids

是

List<String>

最大个数：10

被回收的云经销商的代金券额度ID。获取方法请参见查询优惠券额度。

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

参数

参数类型

描述

id

String

被回收的云经销商的代金券额度ID。

error_code

String

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

错误描述信息。只有失败才返回该字段。
表2 QuotaReclaim

参数

参数类型

取值范围

描述

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"
    }
  ]
}

状态码

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

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.99000012

额度不存在或者额度状态不正确（如果出现error_details，HTTP STATUS为200）。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

相关文档