更新时间:2023-12-13 GMT+08:00
分享

查询优惠券发放回收记录

功能介绍

合作伙伴可查看给客户发放和回收优惠券的操作记录。

该接口即将下线,“查询优惠券发放回收记录”接口请参考查询优惠券的发放回收记录

Web UI

一、合作伙伴发放和回收代金券均会记录日志,伙伴可以登录伙伴中心查看、导出代金券操作日志。

  1. 在伙伴中心顶部的导航栏中选择“销售 > 客户业务 > 代金券管理”。
  2. 选择“代金券额度”页签。
  3. 单击页面左上角的“操作记录”。

    伙伴也可以单击代金券额度所在行的“操作记录”,查看该代金券额度对应的操作记录日志。

  4. 设置查询条件,筛选出待查询的操作记录。

    伙伴可以根据“操作时间”,“操作类型”,“操作结果”,“客户名称”、“额度编号”或者“操作员”等查询操作记录。

  5. 查看、导出操作记录日志。

    • 在操作记录列表中,单击“代金券ID”,可以进入“代金券详情”页面,查看代金券的基本信息和使用记录。
    • 在操作记录列表上方,单击“导出”,可以导出操作记录。

二、合作伙伴发放和回收现金券均会记录日志,伙伴可以登录伙伴中心查看、导出现金券操作日志。

  1. 在伙伴中心顶部的导航栏中选择“销售 > 客户业务 > 现金券管理”。
  2. 选择“现金券额度”页签。
  3. 在现金券列表中,单击“操作”列的“操作记录”。

  4. 选择“发放记录”或“回收记录”页签。

  5. 设置查询条件,筛选出待查询的操作记录。

    伙伴可以根据“发放时间”,“客户名称”,“账号名”,“额度编号”或者“现金券ID”等查询操作记录。

  6. 查看、导出操作记录。

    • 在操作记录列表中,单击“现金券ID”,可以进入“现金券详情”页面,查看现金券信息和使用记录。
    • 在操作记录列表上方,单击“导出”,可以导出操作记录。

REST API

伙伴在伙伴销售平台查看给客户发放和回收优惠券的操作记录。

该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token。

  1. URI

    GET /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons/records

    参数说明请参见下表。

    表1 路径参数

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

    表2 查询参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    operation_types

    List<String>

    8

    操作类型:

    • 1:发放
    • 2:手动回收
    • 3:解绑自动回收
    • 4:过期回收
    • 5:退订回收

    此参数不携带时,不作为筛选条件;携带值为空或携带值为null时,作为筛选条件;不支持携带值为空串。

    quota_id

    String

    最大长度:64

    额度ID。

    请从“查询优惠券额度(已废弃)”接口的响应参数中获取。

    此参数不携带或携带值空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。

    quota_type

    Integer

    -

    额度类型:

    • 空:所有
    • 0:代金券额度
    • 1:现金券额度

    此参数不携带或携带值为空或携带值为null时,不作为筛选条件;不支持携带值为空串。

    coupon_ids

    List<String>

    -

    代金券ID列表。

    请从“发放优惠券”接口的响应参数中获取。

    此参数不携带时,不作为筛选条件;携带值为空或携带值为null时,作为筛选条件;不支持携带值为空串。

    customer_id

    String

    最大长度:64

    客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

    此参数不携带或携带值空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。

    operate_time_begin

    String

    最大长度:64

    操作时间(开始)。

    输入这个条件,会查询出操作时间大于这个时间的记录。

    此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串或携带值为null。

    operate_time_end

    String

    最大长度:64

    操作时间(结束)。

    输入这个条件,会查询出操作时间小于这个时间的记录。

    此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串或携带值为null。

    result

    String

    最大长度:64

    操作结果:

    • 0:成功
    • -1:失败(非0的记录)

    此参数不携带或携带值为空或携带值为空串或携带值为null时,不作为筛选条件。

    page_no

    Integer

    [1-9999]

    页码。

    默认取值为1。

    此参数不携带或携带值为空或携带值为null时,取值为1;不支持携带值为空串。

    page_size

    Integer

    [1-100]

    每页记录数。

    默认取值为10,最大值为100。

    此参数不携带或携带值为空或携带值为null时,取值为10;不支持携带值为空串。

  1. 请求消息

    请求参数

    无。

    请求示例

    GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/promotion-mgr/partner-coupons/records?page_no=1&page_size=2 HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:16

    状态码。

    具体请参见4

    error_msg

    String

    最大长度:1024

    错误描述信息。

    total_num

    Integer

    -

    查询记录总数。

    records

    List<CouponRecord>

    -

    日志记录列表。

    具体请参见表3

    表3 CouponRecord

    参数

    参数类型

    描述

    id

    String

    唯一ID。

    operation_type

    String

    操作类型:

    • 1:发放
    • 2:手动回收
    • 3:解绑自动回收

    quota_id

    String

    额度ID。

    quota_type

    Integer

    额度类型:

    • 0:代金券额度
    • 1:现金券额度

    coupon_id

    String

    代金券ID。

    customer_id

    String

    客户ID。

    face_value

    Double

    代金券操作对应的值。

    创建时为代金券面值;回收时,为回收的剩余额度值。

    operate_value

    Double

    操作的面额值。

    发放时,等于面额值;回收时,指每次回收的具体值。

    operate_time

    String

    操作时间。

    result

    String

    操作结果:

    • 0:成功
    • 其他:失败(直接记录错误码)

    remark

    String

    描述信息。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time
    
    {
        "records": [
            {
                "id": "iahwX3YFcZAuRgqsgpq",
                "result": "0",
                "remark": null,
                "operation_type": "2",
                "quota_id": "2018011615520153",
                "quota_type": 0,
                "coupon_id": "CP180117115414HB5I",
                "customer_id": "f8231a7d11484dfaaea8b70755680c7e",
                "face_value": 100,
                "operate_value": 100,
                "operate_time": "2018-01-17T04:02:18Z"
            },
            {
                "id": "x3phmuH3sTitk9W4VJw",
                "result": "0",
                "remark": null,
                "operation_type": "1",
                "quota_id": "2018011615520153",
                "quota_type": 0,
                "coupon_id": "CP180117115414HB5I",
                "customer_id": "f8231a7d11484dfaaea8b70755680c7e",
                "face_value": 100,
                "operate_value": 100,
                "operate_time": "2018-01-17T03:54:15Z"
            }
        ],
        "error_code": "CBC.0000",
        "error_msg": "success",
        "total_num": 6
    }

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

    HTTP状态码

    错误码

    描述

    200

    CBC.0000

    成功。

    400

    CBC.0100

    参数错误。

    403

    CBC.0151

    访问拒绝。

    500

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品