Appearance
功能概述
保存租赁合同接口
- 在业主点击创建并发送订单按钮时，生成对应的订单信息
接口访问
接口地址
rental/order/insert
请求方式 Method
POST
Header - Authorization Type : Bearer Token
| 属性 | 类型 | 长度 | 必填 | 默认值 | 说明 | 访问版本 |
|---|---|---|---|---|---|---|
| token | string | 32 | true | 用户身份标识令牌 | - |
请求参数
| 属性 | 类型 | 长度 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| propertyID | int | 64 | true | 0 | 物业编号 |
| propertyBuildingHouseID | int | 64 | true | 0 | 物业楼栋房产编号 |
| usersPropertyID | int | 64 | true | 0 | 用户物业编号 |
| usersPropertyBuildingHouseID | int | 64 | true | 0 | 用户物业楼栋房产编号 |
| commencementDate | string | 256 | true | "" | 起租日 |
| leaseTerm | int | 64 | true | 0 | 租期(数字)，单位取决于租期类型 |
| leaseTermType | int | 64 | true | 0 | 租期类型 1. 日租 2. 月租 3. 年租 |
| rent | int | 64 | true | 0 | 租金 |
| paymentMethod | int | 64 | true | 0 | 支付方式 1.微信 2.支付宝 |
| isDeposit | int | 64 | true | 0 | 是否在线收取押金 0.否 1.是 |
| depositFee | int | 64 | true | 0 | 押金金额（分/总数） |
| depositType | int | 64 | true | 0 | 押金类型 1. 押一 2. 押二 3. 押三 以此类推 |
| rentType | int | 64 | true | 0 | 租金类型 1. 付一 2. 付二 3. 付3 4. 半年 5. 一年 |
| waterFee | int | 64 | true | 0 | 水费（分/吨） |
| electricityFee | int | 64 | true | 0 | 电费（分/度） |
| propertyFee | int | 64 | true | 0 | 物业费（分/平方米） |
| parkingFee | int | 64 | false | 0 | 汽车停车费（分/月/辆） |
| electricBikeFee | int | 64 | false | 0 | 电动车停车费（分/月/辆） |
| isSublease | int | 64 | true | 0 | 是否可以转租 0.否 1.是 |
| isChangeHouse | int | 64 | true | 0 | 是否可以在同业主下换租 0.否 1.是 |
请求示例
{
"propertyID":106,
"propertyBuildingHouseID":1068,
"usersPropertyID":131,
"usersPropertyBuildingHouseID":1086,
"commencementDate":"2025-10-01",
"leaseTerm":12,
"leaseTermType":2,
"rent":10000,
"paymentMethod":1,
"isDeposit":1,
"depositFee":20000,
"depositType":2,
"rentType":1,
"waterFee":600,
"electricityFee":60,
"propertyFee":200,
"parkingFee":5000,
"electricBikeFee":2000,
"isSublease":0,
"isChangeHouse":0
}返回值
| 属性 | 类型 | 必填 | 描述 |
|---|---|---|---|
| response | object | true | 响应内容 |
| rentalOrderID | int | true | 订单ID |
返回示例
{
"response": {
"rentalOrderID": 2
},
"requestId": "6f3f6bd2-d906-4fc7-8f09-90a7582a9704"
}错误码
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 91001 | 物业编号不能为空 | 检查传入参数 |
| 91002 | 物业楼栋房产编号必须大于0 | 检查传入参数 |
| 91003 | 用户物业编号必须大于0 | 检查传入参数 |
| 91004 | 用户物业楼栋房产编号必须大于0 | 检查传入参数 |
| 91005 | 业主用户编号必须大于0 | 检查传入参数 |
| 91006 | 起租日不能为空 | 检查传入参数 |
| 91007 | 起租日格式错误，需符合YYYY-MM-DD（如2024-10-01） | 检查传入参数 |
| 91008 | 租期必须大于0 | 检查传入参数 |
| 91009 | 租期类型错误，仅支持1（日租）、2（月租）、3（年租） | 检查传入参数 |
| 91010 | 租金必须大于0（单位：分） | 检查传入参数 |
| 91011 | 支付方式错误，仅支持1（微信）、2（支付宝） | 检查传入参数 |
| 91012 | 是否收取押金标识错误，仅支持0（否）、1（是） | 检查传入参数 |
| 91013 | 押金金额必须大于0（单位：分） | 检查传入参数 |
| 91014 | 押金类型错误，仅支持1（押一）及以上整数 | 检查传入参数 |
| 91015 | 租金类型错误，仅支持1(付一)、2(付二)、3(付三)、4(半年)、5(一年) | 检查传入参数 |
| 91016 | 水费必须大于0（单位：分/吨） | 检查传入参数 |
| 91017 | 电费必须大于0（单位：分/度） | 检查传入参数 |
| 91018 | 物业费必须大于0（单位：分/平方米） | 检查传入参数 |
| 91019 | 是否可转租标识错误，仅支持0（否）、1（是） | 检查传入参数 |
| 91020 | 是否可换租标识错误，仅支持0（否）、1（是） | 检查传入参数 |
| 404 | Fail | 代码报错 |