[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": "參數錯誤!" } ~~~