> 接口的排序方式大概是按照设计稿的去排序
## 合同列表
+++
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 其他错误原因
+++