[TOC]
## 查看合同
* 請求地址: `/user_contract/read`
* 請求方式: get
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 房源id |
* 成功返回:
```json
{
"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//繳納押金月數
}
}
}
```
* 失敗返回:
```json
{
"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_order/longPay`
* 請求方式: post
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 訂單id |
| `payment_method` | int | 11 | 否 | 付款方式 |
| `is_d_deposit` | int | 11 | `是` | 是否抵扣押金 |
| `u_p_id` | int | 11 | `是` | 下單返回的u_p_id |
* 成功返回:
>[info] 抵扣押金的時候 押金大于租金 返回
```json
{
"code": 0,
"data": {
"id": "91"//查詢支付狀態需要
}
}
```
>[info] 押金小于租金返回
```json
{
"code": 0,
"data": {//微信支付需要參數
"id":1,//查詢支付狀態需要
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
```
>[info] 不抵扣押金返回
```json
{
"code": 0,
"data": {//微信支付需要參數
"id":1,//查詢支付狀態需要
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
```
>[danger] 注：現在只做有微信支付 所以只會返回微信的支付參數
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 查詢支付結果
* 請求地址: `/user_order/read`
* 請求方式: get
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 支付參數中返回的id |
* 成功返回:
```json
{
"code": 0,
"data": {
"total": 7,//支付的金額
"status": 0//付款狀態 0 未支付 1 支付成功 2 支付失敗
}
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 長租--申請退租
>[danger] 只有租房方式 為 2 和 3 的房源才可以申請退租 2 長租整租 3 長租合租
>只有狀態為 [1,2,3,4] 的訂單才能申請退租
>1 已支付(未入住) 2 已支付(已入住) 3 已續租 4 已逾期
* 請求地址: `/user_order/retirement`
* 請求方式: post
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 訂單id |
* 成功返回:
```json
{
"code": 0
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 長租--預訂
* 請求地址: `/user_order/booking`
* 請求方式: post
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 訂單id |
| `payment_method` | int | 11 | 否 | 付款方式 |
| `is_d_deposit` | int | 11 | `是` | 是否抵扣押金 |
| `u_p_id` | int | 11 | `是` | 下單返回的u_p_id |
* 成功返回:
>[info] 抵扣押金的時候 押金大于訂金 返回
```json
{
"code":0
}
```
>[info] 押金小于訂金返回
```json
{
"code": 0,
"data": {//微信支付需要參數
"id":1,
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
```
>[info] 不抵扣押金返回
```json
{
"code": 0,
"data": {//微信支付需要參數
"id":1,
"appid": "",
"partnerid": "",
"prepayid": "",
"noncestr": "",
"timestamp": ,
"package": "",
"sign": ""
}
}
```
>[danger] 注：現在只做有微信支付 所以只會返回微信的支付參數
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
## 續租月數返回
* 請求地址: `/user_order/getMonth`
* 請求方式: get
* 請求參數:
| 字段名 | 字段類型 | 字段長度 | 必填 | 字段說明 |
| --- | --- | --- | --- | --- |
| `id` | int | 11 | `是` | 訂單id |
* 成功返回:
```json
{
"code": 0,
"data": [
{
"month": 3,
"rent": 3
}
]
}
```
* 失敗返回:
```json
{
"code": -1,
"msg": "參數錯誤!"
}
```
