功能概述

用户服务费费账单详情接口

• 用户服务费账单详情接口

接口访问

接口地址

rental/bills/serviceDetail

请求方式 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.rentAmount	int	true	房租金额（单位：分）
billsList.paidAmount	string	true	支付金额（单位：分）
billsList.serviceFee	string	true	服务费金额（单位：分）
billsList.billCycleStart	date	true	账单周期起始日（如：2024-01-01）
billsList.billCycleEnd	date	true	账单周期结束日（如：2024-01-01）
billsList.paymentTime	date	true	支付时间
billsList.billStatus	int	true	账单状态 1.未到期 2.待支付 3.已支付 4.逾期 5.已取消 6.已退
billsSummary.totalServiceFee	int	true	服务费总数
billsSummary.serviceFeeRatio	int	true	服务费比例
billsSummary.count	int	true	总期数

返回示例

{
    "response": {
        "billsList": [
            {
                "billId": 34,
                "rentAmount": 1000,
                "paidAmount": 0,
                "serviceFee": 0,
                "billCycleStart": "2025-11-14",
                "billCycleEnd": "2025-12-13",
                "paymentTime": null,
                "billStatus": 2
            }
        ],
        "billsSummary": {
            "totalServiceFee": 0,
            "serviceFeeRatio": '3',
            "count": 12
        }
    },
    "requestId": "f48989e9-e4f9-4140-8b7f-f2064b0da0f8"
}

错误码

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