文档首页 > > API参考> 待下线接口> 管理促销> 管理优惠券> 查询优惠券发放回收记录

查询优惠券发放回收记录

分享
更新时间: 2020/06/24 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. 调试

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

  2. 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:退订回收。

    quota_id

    String

    最大长度:64

    额度ID。

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

    quota_type

    Integer

    -

    额度类型:

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

    coupon_ids

    List<String>

    -

    代金券ID列表。

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

    customer_id

    String

    最大长度:64

    客户ID。

    operate_time_begin

    String

    最大长度:64

    操作时间(开始)。

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

    operate_time_end

    String

    最大长度:64

    操作时间(结束)。

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

    result

    String

    最大长度:64

    操作结果:

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

    page_no

    Integer

    -

    页码。

    默认取值为1。

    page_size

    Integer

    -

    每页记录数。

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

  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

    状态码。

    具体请参见5

    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. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0151

    访问拒绝。

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问