[TOC]
## 查看合同
~~~[api]
get:/user_contract/read
*int:id=1#房源 id
<<<
success
{
"code": 0,
"data": {
"entrust": {//原本房源相关信息
"id": 3,
"h_address": "树海",//房源详细地址
"is_settle": 0,//水电气是否结清
"water": "100",//水初始值
"electric": "200",//电初始值
"gas": "90",//气初始值
"s_phone": "13725554033",//监督电话
"facility": {//配套设施相关
"p_r": 1,//产权类型 0 住宅 1 商用
"area": 34,//房源面积
"cost": [//水电气
{
"card": "123456",//卡号
"cost": 0,//费用
"name": "水",//名字
"initial": 100,//初始值
"is_settle": 0//是否结清
},
{
"card": "123456",
"cost": 0,
"name": "电",
"initial": 200,
"is_settle": 0
},
{
"card": "123456",
"cost": 0,
"name": "气",
"initial": 90,
"is_settle": 0
}
],
"empty": 34,//空客天数
"p_r_n": "123456",//产权编号
"deduct": 50000,//抽取金
"facility": [//房间设施
{
"cd": "完好",
"id": 2,
"num": 1,
"name": "洗衣机"
}
],
"net_cost": [//物管费和网费
{
"cost": 0,
"name": "物管费",
"is_settle": 0
},
{
"cost": 10000,
"name": "网费",
"is_settle": 1
}
],
"bank_name": "中国人民银行",//开户行名
"lock_cost": 12000,//智能锁费用
"long_rent": 0,//长租租金
"short_rent": 40000,//短租租金
"manage_type": 1,//委托方式
"delivery_time": "1511798400"//交房时间
},
"other": ""//其他说明
},
"sale": {
"name": "测试账号袁",//经办人姓名
"phone": "13725554033",//经办人手机号
"title": "内光华门店",//经办人门店名
"store_name": "王大锤",//门店负责人姓名
"store_phone": "15181474781"//门店负责人手机号
},
"house": {
"h_l_rent": 1,//房源或者房间租金(单价)
"is_all_pay": 0,//是否全付 0 全付 1 不全付
"name": "全付(押一)",//支付方式名
"rent": 0,//缴纳租金月数
"bet": 1//缴纳押金月数
}
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 完善合同(长租下单)
* 请求地址: `/user_contract/save`
* 请求方式: post
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `t_name` | string | 2-16 | `是` | 租户姓名 |
| `t_phone` | string | 11 | `是` | 租户手机号 |
| `t_id_card` | string | 18 | `是` | 租户身份证号码 |
| `h_address` | string | 2-160 | `是` | 房源详细地址 |
| `r_s_time` | date | 0 | `是` | 入住时间 |
| `r_e_time` | date | 0 | `是` | 到期时间 |
| `p_time` | json | 0 | `是` | 付款时间段 |
| `is_pay` | int | 11 | `是` | 是否代付 |
| `is_settle` | int | 11 | `是` | 是否结清 |
| `life` | json | 0 | `是` | 生活数据 水、电、气 |
| `s_phone` | string | 11 | `是` | 监督电话 |
| `facility` | json | 11 | `是` | 房间设施 |
| `h_i_id` | int | 11 | `是` | 房源id |
| `r_id` | int | 11 | 是 | 房间id |
| `mode` | int | 11 | `是` | 租住方式 |
| `m_name` | string | 2-16 | `是` | 经办人姓名 |
| `m_phone` | string | 11 | `是` | 经办人手机号 |
| `m_s_phone` | sring | 11 | `是` | 经办人门店电话 |
| `m_store` | string | 2-64 | `是` | 经办人门店名 |
| `other` | string | 255 | 否 | 其他说明 |
| `people_num` | int | 11 | 入住人数 |
>[info] 租房方式 0 短租合租 1 短租整租 2 长租整租 3 长租合租
> 是否代缴水电气 0 愿意 1 不愿意
> 水电是否结清 0 已结清 1 未结清
> 房间id选填
* 成功返回:
```json
{
"code": 0,
"data": {
"id": "37",//订单id
"u_p_id": "39",//分期付款的id
"community": "光华中心",//小区名
"h_floor": "9楼/9层",//所在楼层
"unit": "9栋9单元9号",//所在单元
"rent": 6,//租金合计
"deposit": 1,//押金合计
"month": 6,//租住月数
"total": 7//合计
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 查询完善后的合同
* 请求地址: `/user_contract/getContract`
* 请求方式: get
* 请求参数:
| 字段名 | 字段类型 | 字段长度 | 必填 | 字段说明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 订单id |
* 成功返回:
```json
{
"code": 0,
"data": {
"data": {
"id": 1,
"t_name": "hhhhh",//租房人姓名
"t_phone": "15982057698",//租房人手机号
"t_id_card": "123456799012345678",//租房人身份证号码
"h_address": "树海",//房源详细地址
"r_s_time": "2017-12-02 00:00:00",//入住时间
"r_e_time": "2018-03-02 00:00:00",//到期时间
"p_time": {//付款时间段
"h_l_rent": 3600,
"r_s_time": "2017-12-02"
},
"rent": 90000,//租金
"deposit": 90000,//押金
"is_pay": 0,//是否代缴水电气
"is_settle": 0,//是否结清
"life": [//水电气初始数据
{
"card": "123456",//卡号
"cost": 0,//费用
"name": "水",//名字
"initial": 100,//初始值
"is_settle": 0//是否结清
},
{
"card": "123456",
"cost": 0,
"name": "电",
"initial": 80,
"is_settle": 0
},
{
"card": "123456",
"cost": 0,
"name": "气",
"initial": 90,
"is_settle": 0
}
],
"s_phone": "13725554033",//监督电话
"facility": [//房间设施
{
"cd": "完好",
"id": 8,
"num": 1,
"name": "电视"
}
],
"m_name": "测试账号袁",//经办人电话
"m_phone": "13725554033",//经办人手机号
"m_s_phone": "15181474781",//经办人店长电话
"m_store": "内光华门店",//经办人门店
"other": "123456799012345678",//其他说明
"sign_mode": 0,//签订方式
"img": null,//线下合同图片
"firm": null,//公司账户信息
"costs": null,//其他费用
"create_time": "2017-12-01 11:28:22"//签订时间
}
}
}
```
* 失败返回:
```json
{
"code": -1,
"msg": "参数错误!"
}
```
## 长租--去支付
~~~[api]
post:/user_order/longPay
*int:id=1#订单 id
int:payment_method=0# 付款方式 0 微信 1 支付宝
*int:is_d_deposit=0#是否抵扣押金 0 不抵扣 1 抵扣
*int:u_p_id=1# 下单返回的 u_p_id
<<<
success
//抵扣押金的时候 押金大于租金 返回
{
"code": 0,
"data": {
"id": "91"//查询支付状态需要
}
}
<<<
success
//押金小于租金返回
{
"code": 0,
"data": {//微信支付需要参数
"id":1,//查询支付状态需要
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
<<<
success
// 不抵扣押金返回
{
"code": 0,
"data": {//微信支付需要参数
"id":1,//查询支付状态需要
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 查询支付结果
~~~[api]
get:/user_order/read
*int:id=1#支付参数返回的 id
<<<
success
{
"code": 0,
"data": {
"total": 7,//支付的金额
"status": 0//付款状态 0 未支付 1 支付成功 2 支付失败
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 长租--申请退租
>[danger] 只有租房方式 为 2 和 3 的房源才可以申请退租 2 长租整租 3 长租合租
>只有状态为 [1,2,3,4] 的订单才能申请退租
>1 已支付(未入住) 2 已支付(已入住) 3 已续租 4 已逾期
~~~[api]
post:/user_order/retirement
*int:id=1#订单 id
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 长租--预订
~~~[api]
post:/user_order/booking
*int:id=1#订单 id
int:payment_method=1#付款方式 0 微信 1 支付宝
*int:is_d_deposit=0# 是否抵扣押金 0 不抵扣 1 抵扣
*int:u_p_id=1#下单返回的u_p_id
<<<
success
//抵扣押金的时候 押金大于订金 返回
{
"code":0
}
<<<
success
//押金小于订金返回
{
"code": 0,
"data": {//微信支付需要参数
"id":1,
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
<<<
success
//不抵扣押金返回
{
"code": 0,
"data": {//微信支付需要参数
"id":1,
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
## 续租月数返回
~~~[api]
get:/user_order/getMonth
*int:id=1#订单 id
<<<
success
{
"code": 0,
"data": [
{
"month": 3,
"rent": 3
}
]
}
<<<
error
{
"code": -1,
"msg": "参数错误!"
}
~~~
- 使用说明
- 后台管理
- 后台--登录注册
- 后台--共用数据
- 后台--个人相关
- 后台--管理相关
- 后台--管理角色
- 后台--常见问题
- 后台--生活缴费
- 后台--缴费订单
- 后台--面积区间
- 后台--租金区间
- 后台--户型管理
- 后台--配套设施
- 后台--长租周期
- 后台--短租周期
- 后台--支付方式
- 后台--banner
- 后台--区域管理
- 后台--省
- 后台--市
- 后台--区
- 后台--地标
- 后台--地铁线路
- 后台--地铁站点
- 后台--小区管理
- 后台--门店相关
- 后台--内部门店
- 后台--内部提现
- 后台--外部提现
- 后台--处理提现
- 后台--第三方门店
- 后台--物业相关
- 后台--物业公司
- 后台--物业人员
- 后台--物业申请提现
- 后台--物业奖励设置
- 后台--物业奖励金
- 后台--销售相关
- 后台--内部销售
- 后台--第三方销售
- 后台--配置相关
- 后台--配置信息
- 后台--销售提成
- 后台--前端相关
- 后台--前端用户
- 后台--用户提现
- 后台--申请看房
- 后台--租房订单
- 后台--站内信
- 后台--房源相关
- 后台--房源委托
- 后台--房源信息
- 后台--房源统计
- 后台--电子锁
- 后台--财务管理
- 后台--操作记录
- 后台--内部店长
- 内部--登录注册
- 内部--门店相关
- 内部--销售相关
- 内部--提现相关
- 后台--三方店长
- 三方--登录注册
- 三方--门店相关
- 三方--销售相关
- 三方--提现相关
- 前端--用户相关
- 用户--登录注册
- 用户--共用数据
- 用户--用户相关
- 用户--配置信息
- 用户--常见问题
- 用户--站内信
- 用户--资金相关
- 用户--充值缴费
- 用户--生活缴费
- 用户--房源相关
- 用户--房源委托
- 用户--房源信息
- 用户--房源收藏
- 用户--浏览记录
- 用户--订单相关
- 用户--我的订单
- 用户--短租下单
- 用户--长租下单
- 用户--开门相关
- 用户--物业开门
- 用户--扫码开门
- 前端--销售相关
- 销售--登录注册
- 销售--共用数据
- 销售--用户相关
- 销售--小区相关
- 销售--物业相关
- 销售--物业人员
- 销售--物业公司
- 销售--房源相关
- 销售--房源委托
- 销售--我的任务
- 销售--房源信息
- 销售--房源合同
- 销售--房间相关
- 销售--电子锁
- 销售--委托三方
- 销售--站内信
- 前端--物业相关
- 物业--登录注册
- 物业--共用数据
- 物业--用户相关
- 物业--站内信
- 物业--资金相关
- 物业--房源委托
- 物业--用户开门
- 前端--三方销售
- 三销--登录注册
- 三销--共用数据
- 三销--用户相关
- 三销--小区相关
- 三销--我的任务
- 三销--站内信
- 三销--房源相关