文档首页> > API参考> 账务管理> 查询客户消费记录

查询客户消费记录

分享
更新时间: 2019/08/09 14:59

功能介绍

合作伙伴可以查看并导出客户的消费记录。

REST API

合作伙伴可以查询某个垫付类客户的消费流水详单的功能。可以实时查询。

用于合作伙伴查询其垫付类客户在华为的消费情况,用于合作伙伴和其垫付类客户查看消费记录。

说明:

该接口只允许使用合作伙伴AK/SK或者Token调用。

  1. URI

    POST /v1.0/{partner_id}/partner/account-mgr/bill/query-fee-records

    参数说明请参见表1-1

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

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

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

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customerId

    String

    最大长度:256

    客户ID。

    startTime

    String

    最大长度:256

    查询起始时间。

    格式固定为YYYY-MM-DD。

    示例:2017-10-16

    endTime

    String

    最大长度:256

    查询截止时间。

    格式固定为YYYY-MM-DD。

    由于此接口不支持跨月查询,请确保查询截止时间与查询起始时间在同一个月,否则调用接口会报错“parameter error”。

    示例:2017-10-17

    cloudServiceTypeCode

    String

    最大长度:256

    云服务类型编码,例如ECS的云服务类型编码为“hws.service.type.ec2”。具体请参见云服务类型

    regionCode

    String

    最大长度:256

    云服务区。

    orderId

    String

    最大长度:256

    订单ID。

    feeAppliedObjectId

    String

    最大长度:256

    资源ID/订单ID。

    payMethod

    String

    [0-1]

    支付类型。

    • 0:表示包周期
    • 1:表示按需

    pageNo

    Integer

    大于等于1的整数

    页码。

    pageSize

    Integer

    [1-100]

    每页个数。

    请求示例

    POST /v1.0/{partner_id}/partner/account-mgr/bill/query-fee-records HTTP/1.1
    Host:Host Server  
    Content-Length:920
    Content-Type:application/json
    X-Sdk-Date: request time  
    Authorization: authorization 
    
    {
        "customerId":"9ac6a5d714ea41acbbb97c67e4794728",
        "startTime":"2017-10-16",
        "endTime":"2017-10-17",
        "cloudServiceTypeCode":"hws.service.type.ebs",
        "regionCode":"DC00101537847ED673",
        "orderId":"CS1710161125UOC0C",
        "feeAppliedObjectId":"CS1710120128V2A7O-000002",
        "payMethod":"0",
        "pageNo":1,
        "pageSize":50
    }

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参考4

    error_msg

    String

    错误描述信息。

    totalRecord

    Integer

    消费条目数。

    currency

    String

    货币单位代码(遵循ISO 4217标准)。

    CNY:人民币

    值为空代表人民币。

    totalAmount

    BigDecimal

    返回记录的消费金额总和。

    measureId

    Integer

    金额单位。

    • 1:元
    • 2:角
    • 3:分

    feeRecords

    List<FeeRecord>

    返回费用记录数据。

    具体请参见表2

    表2 FeeRecord

    参数

    参数类型

    描述

    createTime

    String

    费用创建时间。

    effectiveTime

    String

    资源生效时间。对于按需明细,该字段表示这条详单记录对应的话单使用量的开始统计时间,对于包周期明细,该字段无效。

    expireTime

    String

    资源失效时间。对于按需明细,该字段表示这条详单记录对应的话单使用量的结束统计时间。对于包周期明细,该字段无效。

    feeId

    String

    流水号。

    productId

    String

    产品ID。

    orderId

    String

    订单ID。

    amount

    Number

    消费金额。

    debtAmount

    Number

    欠款金额。该字段预留。

    measureId

    Integer

    金额单位。

    • 1:元
    • 2:角
    • 3:分

    usageAmount

    Number

    使用量。

    usageMeasureId

    Integer

    使用量的单位,目前有:

    • 0:天(时长);
    • 1:元(货币);
    • 2:角(货币);
    • 3:分(货币);
    • 4:小时(时长);
    • 5:分钟(时长);
    • 6:秒(时长);
    • 7:EB(流量);
    • 8:PB(流量);
    • 9:TB(流量);
    • 10:GB(流量);
    • 11:MB(流量);
    • 12:KB(流量);
    • 13:Byte(流量);
    • 14:个(次)(数量);
    • 15:Mbps(流量);
    • 16:Byte(容量);
    • 17:GB(容量);
    • 18:KLOC(行数);
    • 19:年(周期);
    • 20:月(周期);
    • 21:MB(容量);
    • 22:赫兹(频率);
    • 23:核(数量);
    • 24:天(周期);
    • 25:小时(周期);
    • 30:个数(个数);
    • 31:千次(数量);
    • 32:百万次(数量);
    • 33:十亿次(数量);
    • 34:bps(带宽速率);
    • 35:kbps(带宽速率);
    • 36:Mbps(带宽速率);
    • 37:Gbps(带宽速率);
    • 38:Tbps(带宽速率);
    • 39:GB-秒(容量时长);
    • 40:次(数量);
    • 41:个(数量);
    • 42:千个(数量);
    • 43:张(数量);
    • 44:千张(数量);
    • 45:每秒查询率(查询速率);
    • 46:人/天(数量);
    • 47:TB(容量);
    • 48:PB(容量)。

    cloudServiceTypeCode

    String

    云服务类型编码,例如ECS的云服务类型编码为“hws.service.type.ec2”。具体请参见云服务类型

    regionCode

    String

    云服务区编码。

    resourceTypeCode

    String

    资源类型编码,例如ECS的VM为“hws.resource.type.vm”。具体请参见资源类型

    feeAppliedObjectId

    String

    资源ID/订单ID。

    status

    Integer

    费用处理状态:

    • 1:待处理(扣费或结算)
    • 2:已处理
    • 3:部分扣除(欠费)
    • 4:已取消

    该字段预留。

    feeType

    Integer

    费用项类型。

    预留字段,请先忽略。

    payMethod

    String

    支付类型:

    • 0:表示包周期
    • 1:表示按需

    spot

    String

    2:竞价实例。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time 
    
    {
    
        "totalRecord": 1,
        "currency":"CNY",
        "totalAmount": 5100,
        "measureId": 3,
        "feeRecords": [
        {
            "createTime": "2017-10-25T17:28:57Z",
            "effectiveTime": "2017-12-10T16:00:00Z",
            "expireTime": "2017-12-30T16:00:00Z",
            "feeId": "aa2e9095-dd0a-4029-ac1d-7360ae659965",
            "productId": "17e60ac3c8c94af0838599f7d3912533",
            "orderId": "CS1710161125UOC0C",
            "amount": 5100,
            "debtAmount": 0,
            "measureId": 3,
            "usageAmount": 1,
            "usageMeasureId": 20,
            "cloudServiceTypeCode": "hws.service.type.ebs",
            "regionCode": "DC00101537847ED673",
            "resourceTypeCode": "hws.resource.type.rds.volume",
            "feeAppliedObjectId": "CS1710120128V2A7O-000002",
            "status": 2,
            "feeType": 0,
            "payMethod": "0"
            "spot":"2"
        }
        ],
        "error_code": "CBC.0000",
        "error_msg": "success"
    }

  1. 状态码

    状态码

    描述

    CBC.0000

    成功。

    CBC.0100

    输入参数校验失败。

    CBC.5001

    非合作伙伴。

    CBC.5002

    合作伙伴的客户不存在。

    CBC.0999

    其他错误。

如果您喜欢这篇文档,您还可以:

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区