请登录后查看
CreatePartnerCoupons
发放优惠券
说明:
只能给代售子客户发放优惠券。该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token。调用该接口之前,需通过客户经理联系华为运营人员,为合作伙伴设置优惠券发放额度。
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
X-Auth-Token | string | header | 是 | 合作伙伴Token调用 |
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
quota_id | string | 是 | 优惠券额度ID。该值在查询优惠券额度接口的响应参数中获取。 |
customer_ids | Array of strings | 是 | 客户账号ID。您可以调用查询客户列表接口获取customer_id。 |
face_value | number | 是 | 代金券面值。 单位:元。取值大于0且精确到小数点后2位。 |
valid_time | string | 否 | 生效时间。 UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。 此参数不携带或携带值为null时,赋值为发放优惠券额度的生效时间。 |
expire_time | string | 否 | 失效时间。 UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。 此参数不携带或携带值为null时,赋值为发放优惠券额度的失效时间。 |
cloud_service_types | Array of strings | 否 | 允许使用的云服务列表,您可以调用查询云服务类型列表接口获取。 多个云服务产品以“,”隔开,最多支持10个。 默认:空(继承额度上的限制) 说明: 如果额度上有限制云服务类型列表,则优惠券上的限制不能超过额度的限制。如果额度上没有限制,则优惠券上可以随意指定云服务类型。 |
product_ids | Array of strings | 否 | 允许使用的产品列表。 多个产品以“,”隔开,最多支持10个。 默认:空(继承额度上的限制) 说明: 如果额度上有限制产品列表,则优惠券上的限制不能超过额度的限制。如果额度上没有限制,则优惠券上可以随意指定产品ID。 产品ID需要合作伙伴通过线下获得。 |
memo | string | 否 | 发券时的备注信息。 此参数不携带或携带值为null时,不赋值;携带值为空串时,赋值空串。 |
indirect_partner_id | string | 否 | 云经销商ID。获取方法请参见查询云经销商列表。云经销商给子客户发放优惠券时,需要携带该参数。除此之外,此参数不做处理。 |
|参数名称:发放优惠券响应| |成功:success| |参数约束及描述: 发放优惠券响应|
| 名称 | 类型 | 描述 |
|---|---|---|
error_details | Array of ErrorDetail objects | 错误的客户列表和错误信息,只有HTTP 200的时候才会返回这个结构体,具体参见表1。 |
coupon_infos | Array of CouponSimpleInfo objects | 成功的客户ID和对应的券ID列表,只有HTTP 200的时候才会返回这个结构体,具体参见表2。 |
| 名称 | 类型 | 描述 |
|---|---|---|
error_code | string | 状态码。 |
error_msg | string | 错误描述信息。 |
id | string | 出现错误的客户ID或批量处理消息的ID。 |
| 名称 | 类型 | 描述 |
|---|---|---|
id | string | 批量发放优惠券成功的客户ID。 |
coupon_id | string | 发放成功的券ID。 |
参数错误 |CBC.0100:输入参数校验失败parameter error||CBC.99000012:额度不存在或者额度状态不正确||CBC.99000013:优惠券额度不足||CBC.99000014:该券不能发给该合作类型的客户||CBC.99000015:额度不能给BP自己发券||CBC.99000016:该子客户不存在或者不是该伙伴子客户||CBC.99000017:额度未生效或者已过期||CBC.99000018:券面值不得小于最小值||CBC.99000019:券面值不得大于最大值||CBC.99000020:券数量超过最大限制||CBC.99000021:券总面值不允许超过总面值||CBC.99000022:该券只能发给首次关联的子客户||CBC.99000023:券的云服务限制、产品限制超出额度的限制||CBC.99000024:券的使用限制条件配置(订购类型列表),不在额度配置的限制条件范围内||CBC.99000025:该类伙伴不能给自己发券|
"POST https://bss.myhuaweicloud.com/v2/promotions/benefits/partner-coupons"
{
"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"
}|参数名称:发放优惠券响应| |成功:success| |参数约束及描述: 发放优惠券响应|
"error_details": [
{
"id": "f8231a7d11484dfaaea8b70755680c7e",
"error_code": "",
"error_msg": ""
}
],
"coupon_infos": [
{
"id": "f8231a7d11484dfaaea8b70755680c7e",
"coupon_id": "2018011615520150"
}
]
}