# 发放优惠券-CreatePartnerCoupons #### 功能介绍 合作伙伴可以在拥有的代金券额度范围内为客户下发优惠券。 伙伴登录合作伙伴中心为客户发放代金券请参见[这里](https://support.huaweicloud.com/usermanual-bpconsole/espp_050502.html)。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 只能给代售子客户发放优惠券。 #### 接口约束 - 该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。 - 调用该接口之前，需通过客户经理联系华为运营人员，为合作伙伴设置优惠券发放额度。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=CreatePartnerCoupons)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。 接口对应的权限项如下： | 权限项 | 权限项名称 | |:---|:---| | BPC_ITEM_SUBCUSTSERV_030102\|BPC_ITEM_SUBCUSTSERV_030103 | - 销售-客户-券管理-代金券额度-发放代金券 - 销售-客户-券管理-现金券额度-查看操作记录 | #### URI POST /v2/promotions/benefits/partner-coupons #### 请求消息 请求参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | quota_id | 是 | String | 最大长度：64 | 优惠券额度ID。该值在[查询优惠券额度-ListQuotaCoupons](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0091566753.html)接口的响应参数中获取。 | | customer_ids | 是 | List\ | 最大个数：100 | 客户账号ID。您可以调用[查询客户列表-ListSubCustomers](https://support.huaweicloud.com/api-bpconsole/mc_00021.html)接口获取customer_id。 | | face_value | 是 | BigDecimal | - | 代金券面值。 单位：元。取值大于0且精确到小数点后2位。 | | valid_time | 否 | String | 最大长度：20 | 生效时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2019-05-06T08:05:01Z"。 此参数不携带或携带值为null时，赋值为发放优惠券额度的生效时间。 | | expire_time | 否 | String | 最大长度：20 | 失效时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2019-05-06T08:05:01Z"。 此参数不携带或携带值为null时，赋值为发放优惠券额度的失效时间。 | | cloud_service_types | 否 | List\ | 最大个数：10 | 允许使用的云服务列表，您可以调用[查询云服务类型列表-ListServiceTypes](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0000001256679455.html)接口获取。 多个云服务产品以","隔开，最多支持10个。 默认：空（继承额度上的限制） 此参数不携带或携带值为空数组或携带值为null时，默认为空。 说明： - 如果额度上有限制云服务类型列表，则优惠券上的限制不能超过额度的限制。 - 如果额度上没有限制，则优惠券上可以随意指定云服务类型。 | | product_ids | 否 | List\ | 最大个数：10 | 允许使用的产品列表。 多个产品以","隔开，最多支持10个。 默认：空（继承额度上的限制） 此参数不携带或携带值为空数组或携带值为null时，默认为空。 说明： - 如果额度上有限制产品列表，则优惠券上的限制不能超过额度的限制。 - 如果额度上没有限制，则优惠券上可以随意指定产品ID。 产品ID需要合作伙伴通过线下获得。 | | memo | 否 | String | 最大长度：512 | 发券时的备注信息。 此参数不携带或携带值为null时，不赋值；携带值为空串时，赋值空串。 | | indirect_partner_id | 否 | String | 最大长度：64 | 云经销商ID。获取方法请参见[查询云经销商列表](https://support.huaweicloud.com/api-bpconsole/espp_00003.html)。 云经销商给子客户发放优惠券时，需要携带该参数。除此之外，此参数不做处理。 | 请求示例 ``` POST https://bss.myhuaweicloud.com/v2/promotions/benefits/partner-coupons HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "quota_id": "2018011615520150", "customer_ids": ["f8231a7d11484dfaaea8b70755680c7e"], "face_value": 1.11, "valid_time": "2017-12-17T10:32:02Z", "expire_time": "2017-12-17T10:32:02Z", "cloud_service_types": ["hws.service.type.vpc"], "product_ids": ["90301-316030-0--0"], "memo": "请尽快使用，防止过期。", "indirect_partner_id": "c9e731c4663646988ef4cdb3122837b6" } ``` #### 响应消息 响应参数 | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | error_code | String | 最大长度：16 | 错误码。只有出错的时返回该参数。 具体请参见[状态码]。 | | error_msg | String | 最大长度：1024 | 错误描述信息。只有出错的时返回该参数。 | | coupon_infos | List\ | 最大个数：10 | 成功的客户ID和对应的券ID列表，只有HTTP 200的时候才会返回这个结构体，具体参见[表2]。 | | error_details | List\ | 最大个数：10 | 错误的客户列表和错误信息，只有HTTP 200的时候才会返回这个结构体，具体参见[表1]。 | 表1ErrorDetail | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | id | String | 最大长度：128 | 客户账号ID。 | | error_code | String | 最大长度：20 | 状态码，具体请参见[状态码]。 | | error_msg | String | 最大长度：1000 | 错误描述信息。 | 表2CouponSimpleInfo | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | id | String | 最大长度：64 | 批量发放优惠券成功的客户ID。 | | coupon_id | String | 最大长度：64 | 发放成功的券ID。 | 响应示例 ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_details": [], "coupon_infos": [ { "id": "17a80a9f9d3949ddb60ee73a5b3c9618", "coupon_id": "2024051108584114" } ] } ``` #### 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 400 | CBC.0100 | 参数错误。 | | 200 | CBC.99000000 | 无对该客户的操作权限。 | | 400 | CBC.99000012 | 额度不存在或者额度状态不正确。 | | 200 | CBC.99000013 | 优惠券额度不足。 | | 400 | CBC.99000017 | 额度未生效或者已过期。 | | 400 | CBC.99000018 | 券面值不得小于最小值。 | | 400 | CBC.99000019 | 券面值不得大于最大值。 | | 200 | CBC.99000020 | 券数量超过最大限制。 | | 200 | CBC.99000021 | 券总面值不允许超过总面值。 | | 200 | CBC.99000022 | 该券只能发给首次关联的子客户。 | | 400 | CBC.99000023 | 券的云服务限制、产品限制超出额度的限制。 | | 200 | CBC.99000035 | 非合作伙伴子客户。 | | 400 | CBC.99000037 | 您没有操作该云经销商的权限。 | | 400 | CBC.50000020 | 该代金券只适用于指定客户。 | | 400 | CBC.50000010 | 您已是伙伴用券模式，无法发放代金券。 | | 400 | CBC.50000054 | 产品不存在。 | | 400 | CBC.50000055 | 云服务类型不存在。 | | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 |