功能概述

用户房租账单详情接口

• 用户账单详情接口，账单详情页使用

接口访问

接口地址

rental/bills/rentDetail

请求方式 Method

GET

Header - Authorization Type : Bearer Token

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

请求参数

属性	类型	长度	必填	默认值	说明
rentalID	int	64	true	0	合同ID

请求示例

{
    "rentalID":2
}

返回值

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

返回示例

{
    "response": {
        "billsList": [
            {
                "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"
            }
        ],
        "billsSummary": {
            "currentMonthDueAmount": 10000,
            "paidHistoryAmount": 0,
            "remainingContractAmount": 120000
        }
    },
    "requestId": "207b6053-43cb-42a1-aea4-191cc75a17fb"
}

错误码

错误码	说明	解决方案
91021	订单ID不能为空	检查参数是否正确
91026	账单类型错误	检查参数是否正确
404	Fail	代码报错