功能概述

用户生活费账单详情接口

• 用户账单详情接口

接口访问

接口地址

rental/bills/lifeDetail

请求方式 Method

GET

Header - Authorization Type : Bearer Token

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

请求参数

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

请求示例

{
    "rentalID":2
}

返回值

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

返回示例

{
    "response": {
        "billsList": {
            "waterBills": {
                "billsList": [],
                "billsSummary": {
                    "currentMonthDueAmount": 0,
                    "paidHistoryAmount": 0,
                    "remainingContractAmount": 0,
                    "currentMonthUsage": 0,
                    "paidHistoryUsage": 0
                }
            },
            "electricityBills": {
                "billsList": [],
                "billsSummary": {
                    "currentMonthDueAmount": 0,
                    "paidHistoryAmount": 0,
                    "remainingContractAmount": 0,
                    "currentMonthUsage": 0,
                    "paidHistoryUsage": 0
                }
            }
        },
        "billsSummary": {
            "currentMonthWaterFee": 0,
            "currentMonthElectricFee": 0,
            "currentMonthUtilityTotal": 0,
            "currentMonthWaterUsage": 0,
            "currentMonthElectricUsage": 0,
            "currentMonthTotalUsage": 0
        }
    },
    "requestId": "bbcb8bf1-ce99-4367-ad8f-c9dafa8620b7"
}

错误码

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