Querying Monthly Bills
Function
You can query your monthly bills that cover amount due, expenditures, refunds, and adjustments.
For details about how to query monthly bills in the Partner Center, click here.
The partner bill for each month is generated before 12:00 (Beijing Time) on the fifth day of the next month.
Constraints
This API can be invoked only by the partner account AK/SK or token.
URI
GET /v2/bills/partner-bills/postpaid-bill-summary
The following table describes the parameters.
Parameter |
Mandatory |
Type |
Value Range |
Description |
|---|---|---|---|---|
bill_cycle |
Yes |
String |
A maximum of 10 characters |
Month when a bill is generated. Format: YYYY-MM |
Request
Request parameters
None
Example Request
GET https://bss-intl.myhuaweicloud.com/v2/bills/partner-bills/postpaid-bill-summary?bill_cycle=2020-12 HTTP/1.1 Content-Type: application/json X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
Response
Response parameters
Parameter |
Type |
Value Range |
Description |
|---|---|---|---|
error_code |
String |
A maximum of 16 characters |
Error code. For details, see Returned Values. This parameter is returned only when a failure occurs. |
error_msg |
String |
A maximum of 1024 characters |
Error description. This parameter is returned only when a failure occurs. |
bill_cycle |
String |
A maximum of 10 characters |
Month when a bill is generated. This parameter is returned only when the query is successful. Format: YYYY-MM |
initial_amount_due |
BigDecimal |
- |
Amount due (tax included) in a bill. Amount due (output tax included) = Expenditures + Refunds + Adjustments |
consume_amount |
BigDecimal |
- |
Expenditures in a bill. |
refunds |
BigDecimal |
- |
Refunds in a bill. |
adjustments |
BigDecimal |
- |
Partner's adjustments in a billing cycle, for example, arrears write-offs. |
tax_amount |
BigDecimal |
- |
Output tax in a bill, which is not included in the amount due. |
currency |
String |
A maximum of 8 characters |
This parameter is returned only when the query is successful. USD |
Example Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"bill_cycle": "2020-12",
"initial_amount_due": 90,
"consume_amount": 140,
"refunds": -30,
"adjustments": -20,
"tax_amount": 10,
"currency": "USD"
}
