功能概述

提前缴费列表接口

• 用户点击提前缴费时，获取所有已缴费和未缴费的账单

接口访问

接口地址

rental/bills/prepayment/list

请求方式 Method

GET

Header - Authorization Type : Bearer Token

属性	类型	长度	必填	默认值	说明	访问版本
token	string	32	true		用户身份标识令牌	-

请求参数

属性	类型	长度	必填	默认值	说明
usersPropertyBuildingHouseID	int	64	true	0	用户房产ID

请求示例

{
    "usersPropertyBuildingHouseID":1086
}

返回值

属性	类型	必填	描述
id	int	true	账单ID
status	int	true	账单状态，0正常
rentalID	string	true	分账01业务ID
rentalOrderID	string	true	分账01业务orderID
ownerUserId	int	true	业主用户编号
tenantUserId	int	true	租客用户编号
billNumber	int	true	账单编号
billCycleStart	date	true	账单周期起始日（如：2024-01-01）
billCycleEnd	date	true	账单周期结束日（如：2024-01-01）
dueDate	date	true	应缴日期
amount	int	true	账单总金额（单位：分，含各项费用合计）
rentAmount	int	true	房租金额（单位：分）
otherAmount	int	true	服务费金额（单位：分）
otherDesc	string	true	其他费用说明
billStatus	int	true	账单状态 1.未到期 2.待支付 3.已支付 4.逾期 5.已取消 6.已退
paymentTime	date	true	支付时间
paymentChannel	int	true	付渠道 0.未支付 1.微信 2.支付宝支
paymentOrderNumber	string	true	支付订单号（关联支付系统）
isReminded	int	true	是否已提醒 0.否 1.是
remindCount	int	true	提醒次数
overdueDays	int	true	逾期天数
isDelete	int	true	是否被删除 1为被删除
createTime	date	true	创建时间
modifyTime	date	true	更新时间

返回示例

{
    "response": [
        {
            "id": 1,
            "status": 0,
            "rentalID": 2,
            "rentalOrderID": 1,
            "ownerUserId": 38,
            "tenantUserId": 0,
            "billNumber": "BL202511124342001860",
            "billCycleStart": "2025-10-01",
            "billCycleEnd": "2025-10-31",
            "dueDate": "2025-10-01",
            "amount": 10000,
            "rentAmount": 10000,
            "otherAmount": 0,
            "otherDesc": "",
            "billStatus": 2,
            "paymentTime": null,
            "paymentChannel": 1,
            "paymentOrderNumber": "OR202511124342108797",
            "isReminded": 0,
            "remindCount": 0,
            "overdueDays": 0,
            "isDelete": 0,
            "createTime": "2025-11-12 15:59:02",
            "modifyTime": "2025-11-12 15:59:02"
        }
    ],
    "requestId": "a55620da-248c-4a26-9d1e-6e973c85606d"
}

错误码

错误码	说明	解决方案
91025	房产ID不能为空	检查参数是否正确
404	Fail	代码报错