查询优惠券发放回收记录
Web UI
一、合作伙伴发放和回收代金券均会记录日志,伙伴可以登录伙伴中心查看、导出代金券操作日志。
- 在伙伴中心顶部的导航栏中选择“销售 > 客户业务 > 代金券管理”。
- 选择“代金券额度”页签。
- 单击页面左上角的“操作记录”。
伙伴也可以单击代金券额度所在行的“操作记录”,查看该代金券额度对应的操作记录日志。
- 设置查询条件,筛选出待查询的操作记录。
伙伴可以根据“操作时间”,“操作类型”,“操作结果”,“客户名称”、“额度编号”或者“操作员”等查询操作记录。
- 查看、导出操作记录日志。
- 在操作记录列表中,单击“代金券ID”,可以进入“代金券详情”页面,查看代金券的基本信息和使用记录。
- 在操作记录列表上方,单击“导出”,可以导出操作记录。
二、合作伙伴发放和回收现金券均会记录日志,伙伴可以登录伙伴中心查看、导出现金券操作日志。
- 在伙伴中心顶部的导航栏中选择“销售 > 客户业务 > 现金券管理”。
- 选择“现金券额度”页签。
- 在现金券列表中,单击“操作”列的“操作记录”。
- 选择“发放记录”或“回收记录”页签。
- 设置查询条件,筛选出待查询的操作记录。
伙伴可以根据“发放时间”,“客户名称”,“账号名”,“额度编号”或者“现金券ID”等查询操作记录。
- 查看、导出操作记录。
- 在操作记录列表中,单击“现金券ID”,可以进入“现金券详情”页面,查看现金券信息和使用记录。
- 在操作记录列表上方,单击“导出”,可以导出操作记录。
REST API
伙伴在伙伴销售平台查看给客户发放和回收优惠券的操作记录。
该接口只能给合作伙伴使用,调用的时候必须传递合作伙伴的AK/SK或者Token。
- 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;不支持携带值为空串。
- 请求消息
无。
请求示例
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-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
- 响应消息
参数
参数类型
取值范围
描述
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 }