文档首页 > > API参考> 管理账单> 客户账单> 查询客户月度消费账单

查询客户月度消费账单

分享
更新时间: 2020/06/28 GMT+08:00

查询客户月度消费账单。

功能介绍

合作伙伴可查询客户的消费汇总账单,消费按月汇总。

消费汇总数据仅包含前一天24点前的数据。

Web UI

合作伙伴可以登录伙伴中心查看客户的消费汇总数据并导出客户的消费清单。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 客户消费”。
  2. 单击“消费汇总”页签。
  3. 根据需要设置查询条件,查看客户的消费汇总信息。

    伙伴可以根据“消费时间”、“客户名称”、“客户经理姓名”以及“关联类型”查询客户的消费汇总信息。
    • 查看客户的消费金额、本月已优惠金额、退款金额、调账金额等。

      • 单击“本月已优惠”对应的金额值,可以进入“优惠详情”页面,查看本月优惠的详细信息。
      • 伙伴可以选择“按支付方式”查看消费信息,也可以选择“按关联类型”查看消费信息。
    • 查看客户的账单。
      • 消费账单

        选择“客户消费汇总”页签,可以查看客户相应月份的所有消费账单。

      • 退款账单

        选择“客户退款汇总”页签,可以查看客户相应月份的所有退款账单。

      • 调账账单

        选择“客户调账汇总”页签,可以查看客户相应月份的所有调账账单。

  4. 导出消费汇总清单。

    • 导出客户消费清单

      单击“导出 > 导出客户消费清单”,填写导出条件后单击“确定”,页面提示“导出任务创建成功”。

    • 查看导出记录
      1. 单击“导出 > 查看导出记录”,进入“导出记录”页面。
      2. 单击“操作”列的“下载”,下载并查看导出状态为“已完成”的消费清单。

REST API

伙伴在伙伴销售平台查询所有垫付类客户或者某个垫付类客户的消费汇总账单,消费按月汇总。每天刷新一次,更新前一天的数据。

该接口用于合作伙伴查询其垫付类客户在华为的消费情况,如果输入某个客户ID,则是查询单个客户的,否则是查询该伙伴下所有使用伙伴拨款消费的客户的消费记录(包括退订记录)。

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

  1. 调试

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

  2. URI

    GET /v2/bills/partner-bills/subcustomer-bills/monthly-sum

    参数说明请参见下表。

    表1 查询参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    cycle

    String

    最大长度:10

    消费时间。

    格式固定为YYYY-MM。

    示例:2018-08

    charge_mode

    String

    最大长度:4

    支付方式。

    • 1:包年/包月
    • 3:按需

    bill_type

    String

    最大长度:4

    账单类型。

    • 0:消费
    • 1:退订
    • 2:华为核销

    indirect_partner_id

    string

    最大长度:64

    精英服务商ID。

    customer_id

    String

    最大长度:64

    客户ID。

    cloud_service_type

    String

    最大长度:256

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

    offset

    Integer

    [0-最大整数]

    偏移量,从0开始。默认值为0。

    limit

    Integer

    [1-100]

    每页个数。默认值为10。

  1. 请求消息

    请求参数

    无。

    请求示例

    GET https://bss.myhuaweicloud.com/v2/bills/partner-bills/subcustomer-bills/monthly-sum?customer_id=c890j7gkj94ijgCoII...&cycle=2018-08&cloud_service_type=hws.service.type.ec2&charge_mode=1&offset=0&limit=10&bill_type=0&indirect_partner_id=c890j7gkj94ijgCoIIDgzCCXXXXXX HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参考5

    error_msg

    String

    错误描述信息。

    count

    Integer

    总记录数。

    bill_sums

    List<BillSumInfoV2>

    账单记录,具体参考表2

    currency

    String

    货币编码。

    目前只支持CNY。

    表2 BillSumInfoV2

    参数

    参数类型

    描述

    customer_id

    String

    客户ID。

    cloud_service_type

    String

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

    bill_type

    String

    费用类型。

    • 0:消费
    • 1:退订
    • 2:华为核销

    charge_mode

    String

    消费类型。

    • 1:包年/包月
    • 3: 按需

    amount

    Bigdecimal

    消费的金额,即从客户账户实际扣除的金额。

    对于billType=1或者2的账单,该金额为负值。

    debt_amount

    Bigdecimal

    欠费金额,指从客户账户扣费的时候,客户账户金额不足,欠费的金额,华为核销或者退订的时候没有该字段。

    adjustment_amount

    Bigdecimal

    核销欠款,华为核销或者退订的时候没有该字段。

    discount_amount

    Bigdecimal

    折扣金额,华为核销或者退订的时候没有该字段。

    measure_id

    Integer

    金额单位。

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

    account_details

    List<BalanceTypeDeductSumV2>

    按不同账户消费类型和付费方式区分的支付总金额。

    具体请参见表3

    表3 BalanceTypeDeductSumV2

    参数

    参数类型

    描述

    balance_type

    String

    账户类型。

    • BALANCE_TYPE_DEBIT:余额
    • BALANCE_TYPE_CREDIT:信用
    • BALANCE_TYPE_BONUS:奖励
    • BALANCE_TYPE_COUPON:代金券
    • BALANCE_TYPE_RCASH_COUPON 现金券
    • BALANCE_TYPE_STORED_VALUE_CARD:储值卡消费

    amount

    bigdecimal

    金额。

    对于billType=1或者2的账单,该金额为负值。

    bill_type

    String

    费用类型。

    • 0:正常
    • 1:退订
    • 2:华为核销

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time
    {
        "bill_sums": [
            {
                "customer_id": "051b9c187500d5340f0cc00f45000440",
                "cloud_service_type": "hws.service.type.ebs",
                "bill_type": "0",
                "charge_mode": "1",
                "amount": 3500.0,
                "debt_amount": 0.0,
                "adjustment_amount": 0.0,
                "discount_amount": 0.0,
                "measure_id": 3,
                "account_details": [
                    {
                        "balance_type": "BALANCE_TYPE_DEBIT",
                        "amount": 3500.0,
                        "bill_type": "0"
                    },
                    {
                        "balance_type": "BALANCE_TYPE_BONUS",
                        "amount": 0.0,
                        "bill_type": "0"
                    },
                    {
                        "balance_type": "BALANCE_TYPE_CREDIT",
                        "amount": 0.0,
                        "bill_type": "0"
                    },
                    {
                        "balance_type": "BALANCE_TYPE_COUPON",
                        "amount": 0.0,
                        "bill_type": "0"
                    },
                    {
                        "balance_type": "BALANCE_TYPE_RCASH_COUPON",
                        "amount": 0.0,
                        "bill_type": "0"
                    },
                    {
                        "balance_type": "BALANCE_TYPE_STORED_VALUE_CARD",
                        "amount": 0.0,
                        "bill_type": "0"
                    }
                ]
            }
        ],
        "count": 1,
        "currency": "CNY"
    }

  1. 状态码

    HTTP状态码

    错误码

    描述

    400

    CBC.0100

    参数错误。

    400

    CBC.5001

    非合作伙伴。

    403

    CBC.0151

    访问拒绝。

    500

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问