查询汇总账单
接口约束
- 该接口只允许使用客户AK/SK或者Token调用。
- 当请求参数不传递“cloud_service_type_code”时，查询的账单是以云服务类型为维度的月度消费账单，即总条数“total_count”是以云服务类型进行统计 ，每条账单记录一种云服务类型的月度消费汇总。此时响应参数中返回的资源类型“resource_type_code”为“null”。
- 当请求参数传递“cloud_service_type_code”时，查询的账单是以资源类型为维度的月度消费账单，即总条数“total_count”是具体云服务类型下以资源类型进行统计，每条账单记录该云服务类型下的一种资源类型的月度消费汇总。此时响应参数中返回的资源类型“resource_type_code”返回具体的资源类型。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v1.0/{domain_id}/customer/account-mgr/bill/monthly-sum
参数说明请参见下表。
|
参数 |
是否必选 |
取值范围 |
描述 |
|---|---|---|---|
|
domain_id |
是 |
最大长度：64 |
客户账号ID。 |
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
cycle |
是 |
String |
最大长度：7 |
查询消费汇总账单所在的账期，东八区时间，格式为YYYY-MM。 |
|
cloud_service_type_code |
否 |
String |
最大长度：256 |
云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
|
|
type |
否 |
String |
[0|1] |
不传此参数默认查询华为云账户下的消费汇总。 此参数不支持携带传空或携带值为空串或携带为null。 |
|
enterpriseProjectId |
否 |
String |
- |
企业项目标识（企业项目ID）。
此参数不携带或携带值为空时，不作为筛选条件。携带值为null时，作为筛选条件。不支持携带值为空串。 |
请求消息
请求参数
无。
请求示例
GET https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/bill/monthly-sum?cycle=2018-05&type=0 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
状态码。具体请参考状态码。 只有失败才会返回这个参数。 |
|
error_msg |
String |
错误描述信息。 只有失败才会返回这个参数。 |
|
currency |
String |
币种。 USD：美元。 值为空代表美元。 |
|
total_count |
Integer |
总条数，必须大于等于0。 |
|
bill_sums |
List<BillSumRecordInfo> |
账单记录，具体参考表3。 |
|
total_amount |
Bigdecimal |
总金额（包含退订）。 |
|
debt_amount |
Bigdecimal |
总欠费金额。 |
|
coupon_amount |
Bigdecimal |
代金券金额。 |
|
cashcoupon_amount |
Bigdecimal |
现金券金额，预留。 |
|
storedcard_amount |
Bigdecimal |
储值卡金额，预留。 |
|
debit_amount |
Bigdecimal |
现金账户金额。 |
|
credit_amount |
Bigdecimal |
信用账户金额。 |
|
measure_id |
Integer |
金额单位。
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
customer_id |
String |
客户账号ID。 |
|
resource_type_code |
String |
资源类型编码，例如ECS的VM为“hws.resource.type.vm”。  说明：
当请求参数不传递“cloud_service_type_code”时，响应参数“bill_sums”返回的是以云服务类型为维度的账单记录，资源类型编码的返回值无效。 |
|
region_code |
String |
云服务区，该字段预留，先不使用。 |
|
cloud_service_type_code |
String |
云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。 |
|
consume_time |
String |
消费统计的时期。 东八区时间，格式为YYYY-MM。 示例：2018-05。 |
|
pay_method |
String |
消费类型。
|
|
consume_amount |
Bigdecimal |
消费的金额，即从客户账户实际扣除的金额。包含代金券支付的金额。 |
|
debt |
Bigdecimal |
欠费金额，即从客户账户扣费的时候，客户账户金额不足，欠费的金额。 |
|
discount |
Bigdecimal |
折扣金额。 |
|
measure_id |
Integer |
金额单位。
|
|
bill_type |
Integer |
账单类型。
|
|
account_details |
List<BalanceTypePay> |
按不同账户消费类型和付费方式区分的支付总金额。 具体请参见表4。 |
|
discount_detail_infos |
List<DiscountDetailInfo> |
折扣金额详情。 具体请参见表5。 当bill_type为1时，不返回此参数。 |
|
enterpriseProjectId |
String |
企业项目标识（企业项目ID）。
当请求参数中传递了“enterpriseProjectId”，响应参数“bill_sums”返回以企业项目ID为维度的账单记录。 说明：
当请求参数不传递“enterpriseProjectId”时，响应参数“bill_sums”返回的是以非企业项目ID为维度的账单记录，该字段仅供参考。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
balance_type_id |
String |
账户类型。
|
|
deduct_amount |
Bigdecimal |
支出金额。 单位：分 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
promotion_type |
String |
折扣类型。 500：代理订购指定折扣 501：代理订购指定减免 502：代理订购指定一口价 600：合同折扣返利 （商履折扣） 601：渠道框架合同折扣 602：专款专用合同折扣（特殊商务合同折扣） 603：线下直签合同折扣 604：电销授权合同折扣 605：商务合同折扣 606：渠道商务合同折扣 607：合作伙伴授权折扣 608：严选商品折扣 610：免单金额 611：节省计划 700：促销折扣 （促销，只有包年/包月场景） 800：赠送奖励金 |
|
discount_amount |
BigDecimal |
折扣金额。 |
|
promotion_id |
String |
折扣类型对应的标识，可为合同ID或商务ID。 |
|
measure_id |
Integer |
金额单位。
默认值为3。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"error_code": "CBC.0000",
"error_msg": "success",
"currency": "USD",
"total_count": 1,
"total_amount": 10212,
"debt_amount": 56,
"coupon_amount": 0,
"cashcoupon_amount": 0,
"storedcard_amount": 0,
"debit_amount": 10156,
"credit_amount": 0,
"measure_id": 3,
"bill_sums": [
{
"customer_id": "7b47a4c7ec764e1a94c5c2eb1a578e77",
"resource_type_code": "",
"region_code": null,
"cloud_service_type_code": "hws.service.type.ebs",
"consume_time": "2019-12",
"pay_method": "",
"consume_amount": 10212,
"debt": 56,
"discount": 0,
"measure_id": 3,
"bill_type": 0,
"account_details": [
{
"balance_type_id": "BALANCE_TYPE_DEBIT",
"deduct_amount": 10156
},
{
"balance_type_id": "BALANCE_TYPE_CREDIT",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_BONUS",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_COUPON",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_DEBIT_RATE",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_FOREGIFT",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_BE_AVAILABLE",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_OTHER",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_RCASH_COUPON",
"deduct_amount": 0
},
{
"balance_type_id": "WRITEOFFDEBT",
"deduct_amount": 0
},
{
"balance_type_id": "BALANCE_TYPE_STORED_VALUE_CARD",
"deduct_amount": 0
}
],
"discount_detail_infos": [],
"enterpriseProjectId": "0"
}
]
}
