查询客户月度消费账单
功能介绍
合作伙伴可查询客户的消费汇总账单,消费按月汇总。
伙伴在伙伴中心查询客户月度消费账单请参见这里。
消费汇总数据仅包含前一天24点前的数据。每天16点刷新一次,更新前一天的数据,最晚不超过24点。
该接口用于合作伙伴查询其代售类客户在华为的消费情况,如果输入某个客户ID,则是查询单个客户的,否则是查询该伙伴下所有使用伙伴拨款消费的客户的消费记录(包括退订记录)。
接口约束
该接口只允许使用合作伙伴AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/bills/partner-bills/subcustomer-bills/monthly-sum
参数说明请参见下表。
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
cycle |
是 |
String |
最大长度:10 |
消费时间。 格式固定为YYYY-MM。 示例:2018-08 |
charge_mode |
是 |
String |
最大长度:4 |
计费模式。
|
bill_type |
否 |
String |
最大长度:4 |
账单类型。
此参数不携带或携带值为空时,不作为筛选条件。 |
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-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
状态码。 具体请参考状态码。 |
error_msg |
String |
错误描述信息。 |
count |
Integer |
总记录数。 |
bill_sums |
List<BillSumInfoV2> |
账单记录,具体参考表2。 |
currency |
String |
货币编码。 CNY:人民币。 |
参数 |
参数类型 |
描述 |
---|---|---|
customer_id |
String |
客户账号ID。 |
cloud_service_type |
String |
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。 |
bill_type |
String |
账单类型。
|
charge_mode |
String |
计费模式。
|
amount |
Bigdecimal |
消费的金额,即从客户账户实际扣除的金额。 对于billType=1或者2的账单,该金额为负值。 |
debt_amount |
Bigdecimal |
欠费金额,指从客户账户扣费的时候,客户账户金额不足,欠费的金额,华为核销或者退订的时候没有该字段。 |
adjustment_amount |
Bigdecimal |
核销欠款,华为核销或者退订的时候没有该字段。 |
discount_amount |
Bigdecimal |
折扣金额,华为核销或者退订的时候没有该字段。 |
measure_id |
Integer |
金额单位。
|
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的资源类型名称为“云主机”。 |
参数 |
参数类型 |
描述 |
---|---|---|
balance_type |
String |
账户类型。
|
amount |
Bigdecimal |
金额。 对于billType=1或者2的账单,该金额为负值。 |
bill_type |
String |
账单类型。
|
响应示例
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" }