管理优惠券-华为云

客户运营能力-查询优惠券列表:URI

URI GET /v2/promotions/benefits/coupons 参数说明请参见下表。表1 查询参数参数是否必选参数类型取值范围描述 coupon_id 否 String 最大长度：64 优惠券ID。此参数不携带或携带值为空时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。此参数不携带或携带值为空时，不作为筛选条件。 promotion_plan_id 否 String 最大长度：64 促销计划ID。此参数不携带或携带值为空时，不作为筛选条件。 coupon_type 否 Integer [1-4] 优惠券类型： 1：代金券 2：折扣券 4：现金券此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-5] 客户优惠券实例状态： 2：待使用 3：已使用 4：已过期 5：已回收此参数不携带或携带值为空时，不作为筛选条件。 active_start_time 否 String 最大长度：64 激活开始时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 active_end_time 否 String 最大长度：64 激活结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 查询的优惠券数量，默认值为10。 source_id 否 String 最大长度：255 发券来源，如果是合作伙伴发送的券，此处为伙伴ID。如果需要查询某个伙伴发放的券，可以在此处输入该伙伴ID。此参数不携带或携带值为空或携带值为null时，不作为筛选条件；携带值为空串时，作为筛选条件。

客户运营能力管理优惠券

合作伙伴中心-查询优惠券列表:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

合作伙伴中心管理优惠券

合作伙伴中心-查询优惠券列表:URI

URI GET /v2/promotions/benefits/coupons 参数说明请参见下表。表1 查询参数参数是否必选参数类型取值范围描述 coupon_id 否 String 最大长度：64 优惠券ID。此参数不携带或携带值为空时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。此参数不携带或携带值为空时，不作为筛选条件。 promotion_plan_id 否 String 最大长度：64 促销计划ID。此参数不携带或携带值为空时，不作为筛选条件。 coupon_type 否 Integer [1-4] 优惠券类型： 1：代金券此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-5] 客户优惠券实例状态： 2：待使用 3：已使用 4：已过期 5：已回收此参数不携带或携带值为空时，不作为筛选条件。 active_start_time 否 String 最大长度：64 激活开始时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 active_end_time 否 String 最大长度：64 激活结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 查询的优惠券数量，默认值为10。 source_id 否 String 最大长度：255 发券来源，如果是合作伙伴发送的券，此处为伙伴ID。如果需要查询某个伙伴发放的券，可以在此处输入该伙伴ID。此参数不携带或携带值为空或携带值为null时，不作为筛选条件；携带值为空串时，作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商（二级经销商）ID。华为云总经销商（一级经销商）查询云经销商名下的优惠券时，需要携带该参数；除此之外，此参数不做处理。否则只能查询自己的优惠券列表。

合作伙伴中心管理优惠券

合作伙伴中心-查询已发放的优惠券:请求消息

请求消息请求参数无。请求示例 GET https://bss.myhuaweicloud.com/v2/promotions/benefits/partner-coupons?coupon_id=CP190912081601OJDA&customer_id= CS 19040119281JMYC&order_id=promotionPlanId5322584&coupon_type=1&status=2&create_time_begin=2017-12-17T10:32:02Z&create_time_end=2017-12-17T10:32:02Z&effective_time_begin=2017-12-17T10:32:02Z&effective_time_end=2017-12-17T10:32:02Z&expire_time_begin=2017-12-17T10:32:02Z&expire_time_end=2017-12-17T10:32:02Z&offset=0&limit=10&indirect_partner_id=5c2ec3bd80c9462aad432f5566e9feb1 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

合作伙伴中心管理优惠券

合作伙伴中心-查询已发放的优惠券:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

合作伙伴中心管理优惠券

合作伙伴中心-查询已发放的优惠券:URI

URI GET /v2/promotions/benefits/partner-coupons 参数说明请参见下表。表1 查询参数参数是否必选参数类型取值范围描述 coupon_id 否 String 最大长度：64 优惠券ID。此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 order_id 否 String 最大长度：64 订单ID。此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 coupon_type 否 Integer - 优惠券类型。 1：代金券 4：现金券此参数不携带或携带值为空或携带值为null时，不作为筛选条件。 status 否 Integer - 客户优惠券实例状态： 2：可使用 3：已使用 4：已过期 5：已回收此参数不携带或携带值为空或携带值为null时，不作为筛选条件。 create_time_begin 否 String 最大长度：20 创建时间（开始）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。输入这个条件，会查询出创建时间大于这个时间的记录。此参数不携带或携带值为空时，不作为筛选条件。 create_time_end 否 String 最大长度：20 创建时间（结束）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。输入这个条件，会查询出创建时间小于这个时间的记录。此参数不携带或携带值为空时，不作为筛选条件。 effective_time_begin 否 String 最大长度：20 生效时间（开始）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。输入这个条件，会查询出生效时间大于这个时间的记录。此参数不携带或携带值为空时，不作为筛选条件。 effective_time_end 否 String 最大长度：20 生效时间（结束）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。输入这个条件，会查询出生效时间小于这个时间的记录。此参数不携带或携带值为空时，不作为筛选条件。 expire_time_begin 否 String 最大长度：20 失效时间（开始）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。输入这个条件，会查询出失效时间大于这个时间的记录。此参数不携带或携带值为空时，不作为筛选条件。 expire_time_end 否 String 最大长度：20 失效时间（结束）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。输入这个条件，会查询出失效时间小于这个时间的记录。此参数不携带或携带值为空时，不作为筛选条件。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 查询的每页数量。默认值为10。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。华为云总经销商（一级经销商）查询云经销商发放给子客户的优惠券时，需要携带该参数；除此之外，此参数不做处理。否则只能查询发放给自己子客户的优惠券。

合作伙伴中心管理优惠券

合作伙伴中心-发放优惠券:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 400 CBC.0100 参数错误。 200 CBC.99000000 无对该客户的操作权限。 400 CBC.99000012 额度不存在或者额度状态不正确。 200 CBC.99000013 优惠券额度不足。 200 CBC.99000014 该券不能发给该合作类型的客户。 400 CBC.99000017 额度未生效或者已过期。 400 CBC.99000018 券面值不得小于最小值。 400 CBC.99000019 券面值不得大于最大值。 200 CBC.99000020 券数量超过最大限制。 200 CBC.99000021 券总面值不允许超过总面值。 400 CBC.99000022 该券只能发给首次关联的子客户。 400 CBC.99000023 券的云服务限制、产品限制超出额度的限制。 400 CBC.99000024 券的使用限制条件配置（订购类型列表），不在额度配置的限制条件范围内。 400 CBC.99000025 该类伙伴不能给自己发券。 200 CBC.99000035 非合作伙伴子客户。 400 CBC.99000037 您没有操作该云经销商的权限。 400 CBC.50000020 该代金券只适用于指定客户。 200 CBC.50000034 无法给财务托管企业子发券。 400 CBC.50000010 您已是伙伴用券模式，无法发放代金券。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

合作伙伴中心管理优惠券

合作伙伴中心-查询优惠券的发放回收记录:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

合作伙伴中心管理优惠券

合作伙伴中心-查询优惠券额度:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

合作伙伴中心管理优惠券

合作伙伴中心-查询优惠券列表:URI

URI GET /v1.0/{domain_id}/common/promotion-mgr/coupons 参数说明请参见下表。表1 路径参数参数是否必选取值范围描述 domain_id 是最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。表2 查询参数参数是否必选参数类型取值范围描述 coupon_id 否 String 最大长度：64 优惠券ID。此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 order_id 否 String 最大长度：64 订单ID。此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 promotion_plan_id 否 String 最大长度：64 促销计划ID。此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 coupon_type 否 Integer [1-3] 优惠券类型： 1：代金券此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-4] 客户优惠券实例状态： 1：未激活 2：待使用 3：已使用 4：已过期此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 active_start_time 否 String 最大长度：64 激活时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 active_end_time 否 String 最大长度：64 结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 page_no 是 Integer [1-2147483647] 当前页。 page_size 是 Integer [1-100] 每页数量。 coupons_scope 否 Integer [1-2] 优惠券的范围： 1：仅华为优惠券 2：仅合作伙伴促销券此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 bp_id 否 String 最大长度：64 合作伙伴ID。只有coupons-scope为2的时候，该字段必填，否则该字段不论是否填写都忽略。当coupons-scope不为2时，此参数不携带或携带值为空或携带值为空串或携带值为null。

合作伙伴中心管理优惠券

合作伙伴中心-查询优惠券列表:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 200 CBC.0000 成功。 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 404 CBC.0160 请求的资源没有找到。 200 CBC.5001 非合作伙伴。 500 CBC.0999 其他错误。

合作伙伴中心管理优惠券

合作伙伴中心-查询优惠券列表:请求消息

请求消息请求参数无。请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/promotion-mgr/coupons?page_no=1&page_size=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

合作伙伴中心管理优惠券

云服务器内容精选

管理优惠券

7*24

备案

专业服务

退订

建议反馈

售前咨询热线