查询伙伴月度消费账单
接口约束
该接口只允许使用合作伙伴账号AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/bills/partner-bills/postpaid-bill-summary
参数说明请参见下表。
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
bill_cycle |
是 |
String |
最大长度:10 |
账单所归属的月份。 格式:YYYY-MM。 |
请求消息
请求参数
无。
请求示例
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
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
error_code |
String |
最大长度:16 |
状态码,具体请参考状态码。只有失败才会返回这个参数。 |
error_msg |
String |
最大长度:1024 |
错误描述信息。只有失败才会返回这个参数。 |
bill_cycle |
String |
最大长度:10 |
账单所归属的月份。只有成功才返回这个参数。 格式:YYYY-MM |
initial_amount_due |
BigDecimal |
- |
账单中的应还金额(含税)。 应还金额(包含销项税)=消费金额+退款金额+调账金额 |
consume_amount |
BigDecimal |
- |
账单中的消费金额。 |
refunds |
BigDecimal |
- |
账单中的退款金额。 |
adjustments |
BigDecimal |
- |
账单中的调账金额,即伙伴在账期内的调账信息如:欠款核销金额等。 |
tax_amount |
BigDecimal |
- |
账单中的销项税金额,销项税不计入应还金额。 |
currency |
String |
最大长度:8 |
只有成功才返回这个参数。 美金:USD |
响应示例
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" }