文档首页/ 合作伙伴中心/ API参考/ 管理账单/ 查询客户月度消费账单
更新时间:2024-07-26 GMT+08:00
分享

查询客户月度消费账单

功能介绍

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

伙伴在伙伴中心查询客户月度消费账单请参见这里

消费汇总数据仅包含前一天24点前的数据。每天16点刷新一次,更新前一天的数据,最晚不超过24点。

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

接口约束

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

调试

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

URI

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

参数说明请参见下表。

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

cycle

String

最大长度:10

消费时间。

格式固定为YYYY-MM。

示例:2018-08

charge_mode

String

最大长度:4

计费模式。

  • 1:包年/包月
  • 3:按需
  • 11:节省计划

bill_type

String

最大长度:4

账单类型。

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

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

indirect_partner_id

String

最大长度:64

云经销商ID。获取方法请参见查询云经销商列表

如果需要查询云经销商伙伴的子客户的消费汇总账单,必须携带该字段。除此之外,此参数不做处理。

customer_id

String

最大长度:64

客户账号ID。您可以调用查询客户列表接口获取customer_id。

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

cloud_service_type

String

最大长度:256

云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。

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

offset

Integer

[0-最大整数]

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

说明:

offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。

示例1,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。

示例2,查询总数20条,期望每页返回10条数据,则获取第一页数据,入参offset填写0,limit填写10;获取第二页数据,入参offset填写10,limit填写10。

limit

Integer

[1-100]

每页个数。默认值为10。

请求消息

请求参数

无。

请求示例

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

响应消息

响应参数

参数

参数类型

描述

error_code

String

状态码。

具体请参考状态码

error_msg

String

错误描述信息。

count

Integer

总记录数。

bill_sums

List<BillSumInfoV2>

账单记录,具体参考表2

currency

String

货币编码。

CNY:人民币。

表2 BillSumInfoV2

参数

参数类型

描述

customer_id

String

客户账号ID。

cloud_service_type

String

云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。

bill_type

String

账单类型。

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

charge_mode

String

计费模式。

  • 1:包年/包月
  • 3:按需
  • 11:节省计划

amount

Bigdecimal

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

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

debt_amount

Bigdecimal

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

adjustment_amount

Bigdecimal

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

discount_amount

Bigdecimal

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

measure_id

Integer

金额单位。

  • 1:元

account_details

List<BalanceTypeDeductSumV2>

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

具体请参见表3

resource_type_code

String

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

cloud_service_type_name

String

云服务类型名称。例如ECS的云服务类型名称为“弹性云服务器”。

resource_type_name

String

资源类型名称。例如ECS的资源类型名称为“云主机”。

表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": 1,
            "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"
                }
            ],
          "resource_type_code": "hws.service.type.vm"
        }
    ],
    "count": 1,
    "currency": "CNY"
}

状态码

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

HTTP状态码

错误码

描述

400

CBC.0100

参数错误。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

相关文档