1.登录:cgjr/backstage/login.json
输入参数:
参数名 |
参数类型 |
说明 |
mobile |
string |
手机号(新增参数) |
account |
string |
登录账号 |
password |
string |
密码 |
输出参数:
参数名 |
参数类型 |
说明 |
name |
string |
用户名 |
token |
string |
token |
userId |
int |
用户id |
companyName |
string |
加盟商名称 |
roleList |
array |
角色列表 |
id |
int |
角色id |
roleNo |
string |
角色编码 |
name |
string |
角色名称 |
备注: 产品的设计图上面,一个用户即可用是业务员也可用是外访员,所以角色列表里面要过滤掉业务员和外访员以外的角色。
后面查询任务完成个数和处理中、已完成任务的接口,都应该多加一个角色id的参数.
2.查询任务个数 :cgjr/order/getorderortaskcount.json
输入参数:
参数名 |
参数类型 |
说明 |
roleNo |
string |
角色编码 |
productCode |
string |
产品码 |
输出参数:
参数名 |
参数类型 |
说明 |
taskWorkCount |
int |
处理中的任务个数 |
taskOverCount |
int |
已完成的任务个数 |
备注:
- 接口新增参数roleNo;
- 原来返回的数据是list,可以优化下。
3.接单:cgjr/order/createorder.json
输入参数:
参数名 |
参数类型 |
说明 |
productCode |
string |
产品码 |
name |
string |
姓名 |
phoneNo |
string |
手机号 |
address |
string |
地址 |
loanAmount |
string |
借款金额 |
creditDates |
string |
借款期限 |
useFor |
string |
借款用途 |
输出参数:
参数名 |
参数类型 |
说明 |
productCode |
string |
产品码 |
orderNo |
string |
订单号 |
taskId |
string |
任务id |
processInstanceId |
string |
流程实例ID |
dataStage |
int |
流程节点 |
备注:
- 原业务逻辑dataStage=1对应业务员 2对应外访员 3总经理
- 接单成功需要跳转订单详情页面,上面返回的参数都是订单详情页面需要的。
- 借款金额和期限需要新增一个接口返回:返回结果data里面放两个数组就可以吧。
4.处理中或已完成任务:cgjr/activiti/query_task.json
输入参数:
参数名 |
参数类型 |
说明 |
roleNo |
string |
角色编码-用来确定是业务还是外访 |
status |
string |
1处理中 2审核中 3已放款 |
targetPage |
string |
第几页 |
pageSize |
string |
每页返回个数 |
输出参数:data里面返回一个数组
参数名 |
参数类型 |
说明 |
taskName |
string |
任务结点名称 |
startTime |
long |
任务开始时间 |
memberPhone |
string |
手机号码 |
orderNo |
string |
订单号 |
address |
string |
地址 |
memberName |
string |
姓名 |
备注:
5.订单详情:cgjr/order/getorderforapp.json
输入参数:
参数名 |
参数类型 |
说明 |
orderNo |
string |
订单号 |
dataStage |
string |
流程节点 |
输出参数:
参数名 |
参数类型 |
说明 |
loanAmount |
string |
借款金额 |
loanDay |
string |
借款天数 |
used |
string |
借款用途 |
backMsg |
string |
流程被回退的审批信息 |
msg |
string |
模块信息完整性校验(备注有详解) |
backMsg |
string |
流程被回退的审批信息 |
resourcesJson |
array |
大json |
备注:
- 之前的信息完整性校验是在后端处理的,每当用户上传完一个模块的信息,回到订单详情页会再次调用本接口去获取msg。用户提交的时候,会通过msg来提示用户信息输入是否完整。
- resourcesJson下面的数据结构
参数名 |
参数类型 |
说明 |
name |
string |
标题 |
children |
array |
模块列表 |
参数名 |
参数类型 |
说明 |
name |
string |
模块组标题 |
children |
array |
模块分组列表 |
isCheck |
int |
0没有限制 1至少选填一项 |
isCheck是新增的字段:
参数名 |
参数类型 |
说明 |
hasData |
boolean |
是否有数据 |
name |
string |
模块标题 |
englishName |
string |
模块英文标题 |
uri |
string |
模块图标url |
templateId |
int |
模块id |
isMust |
int |
是否必填 1必填 0选填 |
isMust页面标记是否必填。
6.提交审核:cgjr/order/approval.json
输入参数:
参数名 |
参数类型 |
说明 |
type |
int |
通过1 拒绝2 |
memo |
string |
审核内容 |
isNext |
int |
是否到下个节点 |
orderNo |
string |
订单号 |
备注:
- type原来有通过和拒绝,现在没有拒绝,统一改成了提交。
- isNext 业务员和外访员为1,总经理为0。
输出参数:
返回成功的标识即可,不需要返回任何数据。
7.上传图片文件: cgjr/fileupload/upload_file.json
建议改成直接上传file文件。
8.添加或更新模块数据cgjr/order/updatetemplatedata.json
输入参数:
参数名 |
参数类型 |
说明 |
type |
int |
通过1 拒绝2 |
orderNo |
int |
订单号 |
groupId |
int |
groupId |
json |
array |
表单数据 |
备注:
json里面的内容格式:
参数名 |
参数类型 |
说明 |
type |
int |
通过1 拒绝2 |
sourceValue |
string |
值 |
infoEnglishName |
string |
key |
listNum |
int |
列表的第几项 |
nextListNum |
int |
下一个索引 |
- listNum:如果是新增 listNum是在前面的基础上+1,如果是更新listNum保持不变。
- nextListNum:如果sourceValue是图片,nextListNum是图片数组的索引。如果是文本,nextListNum=0。
9.获取页面的数据cgjr/order/gettemplatedata.json
输入参数:
参数名 |
参数类型 |
说明 |
orderNo |
int |
订单号 |
templateId |
int |
templateId |
groupId |
int |
groupId |
输出参数:data是List<List<SourceInfo>>结构
SourceInfo的字段类型如下:
参数名 |
参数类型 |
说明 |
infoEnglishName |
int |
字段的英文key |
infoName |
int |
字段的中文key |
sourceValue |
int |
字段值 |
infoType |
int |
字段的类型 |
isNotNull |
int |
0不能为空 1可以为空 |
viewType |
int |
0文字 1图片 |
options |
string |
选项列表值 |
备注:
- infoEnglishName 提交表单信息的参数
- infoName 页面动态显示的key值
- sourceValue 没有数据的时候就是空 有的时候就返回
- infoType 的类型 :
0:文本输入框 1:数字输入框 2:地址框 3:时间输入框
4:选项框 5:固定值 6:大文本框
-options:当viewType=4的时候 options不为空,格式例如:农业,非农业。
客户端通过逗号分隔转化为数组。
10.删除数据cgjr/order/deletetemplatedata.json
输入参数:
参数名 |
参数类型 |
说明 |
orderNo |
int |
订单号 |
listNum |
int |
列表第几项 |
groupId |
int |
groupId |
只有家庭成员列表、车辆列表、商品房、自建房列表有删除功能。
输出参数:
返回成功标识即可。
11.外访评价 cgjr/evaluate/evaluate.json
输入参数:
参数名 |
参数类型 |
说明 |
orderNo |
int |
订单号 |
输出参数:
data里面直接放一个string类型的文本即可。
需要新增的接口:
- 业务接单:获取该业务员对应的加盟商配置的借款期间和借款金额。理论上传参只用userid就可以了。
- 修改密码: 参数 userid password
- 查询任务接口(按姓名或手机号查询任务列表)