> 接口的排序方式大概是按照設計稿的去排序
## 合同列表
+++
Api/Contract/getContractList/
state=合同狀態# //0為合同生效 1審核未通過 2草稿 3待簽署 4已經成交 5為已發傭金 6為已收傭金
<<<
success
返回參數說明:
{
"data": [
{
"_id": {
"$id": "58cb9757fc21da2ec2bf7a78"
},
"time": "2017-03-07 18:47:13",
"state": "生效",
"step": 0,
"number": "2017030718471380"
}
],
"info": "獲取成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "查無合同",
"code": 996,
"state": 2
}
可能返回的錯誤:
代號 錯誤
996 查無合同
+++
## 創建合同(報合同)
+++
Api/Contract/create/
guest_id=客戶來源 0為用戶自己的私客。否則為競拍或合作ID 默認為0#
private_state=判斷客源來源 0為用戶自己的私客,1為競拍,2為合作 默認為0#
<<<
success
返回參數說明:
{
"data": {
"contract_id": {
"$id": "58be5d93b15c806008000033" //合同ID
}
},
"info": "創建合同成功",
"code": 1000,
"state": 1
}
<<<
error
{
"data": "",
"info": "需要賬號認證成功后才可添加合同",
"code": 1026,
"state": 2
}
可能返回的錯誤:
代號 錯誤
1026 需要賬號認證成功后才可添加合同
1025 您的磚石不夠,請先充值
998 創建合同失敗
+++
## 傭金支付人
>注意:傭金支付人信息是寫死在代碼里面的,沒有從數據庫獲取。需要修改的話要在代碼里面修改
+++
Api/Contract/defray/token/用戶token
<<<
success
返回參數說明:
{
"data": {
"defray_id": 1,
"name": "小馬快租有限公司",
"phone": "155*****678",
"portrait": "http://xmkz-v3.oss-cn-shenzhen.aliyuncs.com/defray.jpg"
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
+++
## 傭金接收人
+++
Api/Contract/receive/token/用戶token
<<<
success
返回參數說明:
{
"data": {
"card_id": "450*********6135", //傭金接收人身份證
"_id": "261", //傭金接收人ID
"name": "鄒優貴", //傭金接收人姓名
"phone": "155*****135", //傭金接收人電話
"type": "自己" //傭金接收人角色
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
+++
## 分步驟查詢合同信息
>說明:因為合同有暫存功能,用戶在填寫合同的時候可能填寫到第三步的時候暫時保存起來。下次用戶想填寫完整的時候。該接口可以獲取用戶之前已經填寫的信息。
+++
Api/Contract/showContract//token/用戶token
*step=步驟 說明:下面有4個步驟,步驟1對應的值為1,步驟2對應的值為2,于此類推#
*contract_id=合同ID 每個步驟都必須存在#
<<<
success
返回參數說明:
參數“step”為1時,有數據的情況下返回
{
"data": {
"receive_name": "鄒優貴", //傭金接收人名稱
"receive_id": "261", //傭金接收人ID
"money": "10", //傭金金額
"defray_name": "小馬快租有限公司", //付傭人名稱
"defray_id": 1 //付傭人編號(固定)
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
參數“step”為2時,有數據的情況下返回
{
"data": {
"room": { //戶型信息
"_id": { //戶型ID
"$id": "58bce03e30fc0fd7e85f40c9"
},
"source_name": "軟件產業基地", //盤源名稱
"room_title": "軟件產業基地戶型", //戶型標題
"floor": "6", //樓層
"doorplate": "1314", //門牌號
"area": 300, //面積
},
"con_tel": "15512345678", //業主電話
"con_name": "讀訂單", //業主姓名
"property": "58" //物業費
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
參數“step”為3時,有數據的情況下返回
{
"data": {
"client_con_name": "反反復", //客戶代表姓名
"client_con_tel": "15512345678", //客戶代表電話
"company_name": "小馬快租", //客戶公司名稱
"industry_id": "222" //公司行業ID
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
參數“step”為4時,有數據的情況下返回
{
"data": {
"total_money": "1233", 合同總金額#
"rent_start": "2017-03-07", 租賃開始日期#
"rent_end": "2017-06-07" 租賃結束日期#
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
+++
## 添加合同信息
>合同中的客戶來源有兩個,1為競拍或合作中獲取的客戶。2為自己的私客。
說明:當客戶是競拍和合作的時候,簽合同時不需要第三步驟。客戶的信息在競拍和合作里面有。
+++
post:Api/Contract/addContractInformation/token/用戶token
*step=步驟 說明:下面有4個步驟,步驟1對應的值為1,步驟2對應的值為2,于此類推#
*contract_id=合同ID 每個步驟都必須存在#
______=步驟1 //步驟1(這個不是參數,添加合同信息要分幾個步驟來添加,每個步驟用的都是同個接口) #
*receive_id=傭金接收人ID#
*defray_id=付傭人ID#
*money=傭金金額#
______=步驟2 //步驟2(這個不是參數,添加合同信息要分幾個步驟來添加,每個步驟用的都是同個接口) #
*room_id=戶型ID#
*con_tel=戶型業主電話#
*con_name=戶型業主姓名#
*property=物業費#
______=步驟3 //步驟3(這個不是參數,添加合同信息要分幾個步驟來添加,每個步驟用的都是同個接口) #
*client_con_name=客戶姓名#
*client_con_tel=客戶電話#
*company_name=客戶企業名稱#
*industry_id=可以企業行業ID#
______=步驟4 //步驟4(這個不是參數,添加合同信息要分幾個步驟來添加,每個步驟用的都是同個接口) #
*total_money=合同總金額#
*rent_start=租賃開始日期#
*rent_end=租賃結束日期#
<<<
success
返回參數說明:
{
"data": {
"card_id": "450*********6135", //傭金接收人身份證
"_id": "261", //傭金接收人ID
"name": "鄒優貴", //傭金接收人姓名
"phone": "155*****135", //傭金接收人電話
"type": "自己" //傭金接收人角色
},
"info": "查詢成功",
"code": 1000,
"state": 1
}
<<<
error
可能返回的錯誤:
代號 錯誤
997 參數有誤【或缺少必須參數】
1036 該合同不可修改
996 操作失敗
1001 其他錯誤原因
+++