# 接口说明
调用本接口,对待办任务进行办理,办理完成后,任务进入已办
# 权限
要调用此API,需要申请poa能力,获取poa token,接口请求头中添加 Authorization 值为token
# 请求方法
报文样例
POST /apis/ttc/v1/transaction/poa/taskHandle
Host: poa地址
Authorization:String
Content-Type:application/json
[
{
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"handler": "smartadmin",
"previousTaskId": "TASK0001",
"handleOpinions": "",
"handleStatus": "",
"handleTime": "",
"handlerName": "",
"status": "none"
}
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# Header参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
Authorization | String | 是 | 接口访问凭证 |
# Body参数
名称(1级) | 名称(2级) | 类型 | 是否必填 | 描述 |
---|---|---|---|---|
appId | String | 是 | 应用id | |
handler | String | 是 | 办理人账号(必须为待办的办理人) | |
status | String | 是 | 办理状态 none:办理当前待办 end:当前为最终节点,事务办结 | |
previousTaskId | String | 是 | 刚办理完成任务的taskId | |
handleOpinions | String | 否 | 办理意见 | |
handleStatus | String | 否 | 办理状态 | |
handleTime | String | 否 | 处理时间(格式:yyyy-MM-dd HH:mm:ss) | |
handlerName | String | 否 | 办理人姓名,如果不想要展示办理人真实信息可以用这个字段代替办理人姓名 | |
previousActions | Array | 否 | 办理完当前待办,给已办添加自定义操作 | |
name | String | 是 | 按钮名称 | |
method | String | 是 | 调用接口方式 | |
url | String | 是 | 请求地址 | |
optType | String | 是 | 操作类型 1:page,页面 0:api,接口(表示快速处理) | |
type | String | 是 | 类型, HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作 | |
allowMerge | Integer | 否 | 是否允许并行,默认0 0:不允许合并 1:允许合并处理 | |
nextNodeKey | String | 否 | 调用接口携带参数 |
支持批量办理传参,批量中异常数据不影响正常数据的办理,接口响应会返回异常数据,请自行获取处理
如果当前待办任务办理完,任需创建下一条待办任务,则需要调用任务创建接口,入参中
previousTaskId
需要传当前被办理的待办任务的taskId(ps:也就是上面参数中的previousTaskId)
# 接口调用成功返回
接口返回code值0为成功返回
{
"took": 6089,
"timestamp": 1688956011462,
"code": 0,
"message": "办理成功",
"data": {
"errorIds": []
}
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 接口调用失败返回
- 接口支持批量,批量操作中的每条数据独立运行,批量中有失败的数据接口整体响应code为0 (成功),data中返回出现错误的数据
- 外层响应code不为0时为未知的错误,请自行设计重试机制
{
"took": 285,
"timestamp": 1688712485963,
"code": 0,
"message": "办理中有异常数据",
"data": {
"errorIds": [
{
"code": 400,
"taskId": "TTT20230703-002-001",
"message": "transTypeCode is null"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
- data.errorIds.code说明:
code | message | 说明 |
---|---|---|
400 | xxx is null | 参数校验不合法 |
500 | * | 业务逻辑异常 |
2004 | this task is not exist | 当前任务不存在 |
2005 | this task has been finished | 当前任务已办理 |
← 任务创建 任务办理-办理同时创建下一条待办 →