接口路径
https://api.unicloud.com/expense
接口名
QueryBill
描述
查询用户某个账期内结算账单。
请求参数
| 名称 | 类型 | 是否必填 | 说明 |
|---|
| Action | String | 是 | 要执行的操作，取值：QueryBill |
| BillPeriod | String | 是 | 账期，YYYY-MM。样例：2019-06 |
| ProductCategory | String | 否 | 产品类型 |
| BillingStatus | String | 否 | 状态PAID，PAID_PART，NO_SETTLE |
| PageNum | Integer | 是 | 页码,默认值为1 |
| PageSize | Integer | 是 | 每页数量，默认值为20，最大值200 |
返回参数
| 名称 | 类型 | 说明 |
|---|
| TotalCount | Integer | 总记录数 |
| PageNum | Integer | 页码 |
| PageSize | Integer | 每页数量 |
| Items | Item | 账单详情 |
Item:
| 名称 | 类型 | 说明 |
|---|
| ConsumeTime | String | 消费时间 |
| BillPeriod | String | 账期 |
| ProductCategory | String | 产品类型 |
| BillCategory | String | 账单类型 |
| PayType | String | 计费方式 |
| BillNo | String | 账单号 |
| AmountPayable | String | 账单金额 |
| AmountPaid | String | 实付金额 |
| BillStatus | String | 支付状态 |
| AmountFinal | String | 应付金额 |
| AmountUncleared | String | 欠款金额 |
请求示例
Action=QueryBill
&BillingCycle=2019-06
&其他公共参数
返回示例
"Items": { "Item": [
{ " ConsumeTime ": "2019-06-06 12:12:23 —2019-08-06 12:12:23 ", " BillPeriod ": "2019-04", " ProductCategory ": "BANDWIDTH_PUBLIC", " BillCategory ": “POSTPAID”, " PayType ": "YEAR_MONTH", " BillNo ": "2019032513418973", " AmountPayable": "10.5600", " AmountPaid": "58.2500", " BillStatus ": "NO_SETTLE", " AmountFinal": "0.0000", " AmountUncleared": "0.0000"
}
]
}, "TotalCount":300, "Page":1, "Size":20错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|
| 400 | MissingParameter | The specified parameter xx is mandatory for this request. | 指定的参数未设置。 |
| 400 | InvalidParameter | The specified moduleCode is not valid. | 指定的参数不合法。 |
| 500 | SystemError | System Error | 系统错误 |
