# 快速处理说明
事务中心提供了快速办理功能，业务系统可以自定义操作列表，匹配对应的操作地址；操作按钮会按照按钮权限最终显示在事务中心列表中；
为满足审核人具备足够信息，支撑其进行快速办理，额外提供待办的信息摘要；以下为摘要字段要求：
["请假天数|3天","请假类型|事假","时间|2021/06/10 - 2021/06/15"], // String[] 摘要(业务办理关键字段),完整字段标题和内容由|分隔,最终根据填写顺序依次展示；发起人看到的一直是事务摘要 **最大键值对数量为 5**
1
# 批量审批
特别注明： 所有批量操作都由事务中心循环调用处理接口,不是调用批量接口；
具备自定义操作按钮(actions 数组字段)的接口都是可以设置批量审批的；
actions 字段有如下扩充字段进行使用；提供批量审批必要信息。
actions:[ // 自定义操作按钮
{
name: "", // 按钮名称
url: "", // 请求地址
allowMerge: 1, // 是否允许批量，默认0; 允许批量的按钮，在点击批量操作时，展示出来，任务下没有可批量按钮，该任务不可进行批量操作
type: "",// 类型, HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作；对应的类型有对应的发送消息机制、以及后续的事务处理机制。可以参考下方操作接口
optType: "0", // 操作类型：1:page页面 0:api接口(表示快速处理)
method: "post", // 请求方式 ，optType为api 必填，get 、 post 、 put
nextNodeKey: "", // 导致节点变动的操作，需要传下一个节点关键词，点击按钮时，需要将该参数传过去
}
]
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
点击按钮，接口回调，会根据不同类型请求，携带参数 如下参数:
| 参数 | 说明 |
|---|---|
| nextNodeKey | 下一个节点关键词 |
| opinions | 审批意见 |
| accountName | 办理人学工号 |
| time | 办理时间（yyyy-MM-dd HH:mm:ss） |
| x-id-token | 当前人token信息(请求头中) |
| uuid | 随机uuid(请求头中) |
POST/PUT （get 不推荐使用）
会将 审批意见，当前审核人学工号，当前审批时间 放body 中传参，handleToken , uuid 设置到请求头
curl -X POST "https://transaction.dev2.supwisdom.com/ttc/api/ttc/user/getBatchQuery"
-H "accept: application/json"
-H "Content-Type: application/json"
-H "x-id-token: xxxxx"
-H "uuid: xxxxx"
-d "{ \"nextNodeKey\": \"xxxx\",\"accountName\": \"xxxx\",\"opinions\": \"xxxxx\",\"time\": \"xxxx\"}"
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
body 中参数会进行对称加密；
# 按钮权限说明
按钮对应操作权限设定如下：
待办
HANDLE办理、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、DEAL待办人操作、ALL所有人操作
已办
HANDLEDR已办人操作 ALL所有人操作；
发起
REVOKE撤回 BREAK_UP终止 PROMOTER发起人操作 ALL所有人操作；
1
2
3
4
5
6
2
3
4
5
6
# 事务回调机制（1.2.3版本及以上）
事务中心的三种回调机制
- 我的待办页面待办停留超过N小时(可配置)，点击详情跳转第三方办理页面时触发回调机制
- 事务中心定时每天2:00:00触发回调机制
- 转已办结合回调接口，在应用配置回调接口的情况下，点击转已办调用回调接口触发回调机制(事务版本1.3.8-alpha.88版本及以上)
回调接口需要注意
- 回调机制2中需要批量处理任务，考虑接口满足批量的查询功能(机制2为夜晚自动触发，不需要考虑接口响应慢等性能问题)
- 回调接口需要判断任务的状态，如果不是进行中，需要返回当前状态必须的以下信息
回调接口入参 taskIds List(String) 任务ids 回调接口期望响应值如下 数据与入参的taskIds对应
任务状态：进行中
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {},
"taskId": "f29cabebde3742d08ad37633dd52db94",
"taskStatus": "IN_PROGRESS"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
任务状态：完成，并存在下个任务
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData":{
"next": [
{
"actions": [
{
"method": "post",
"name": "催办",
"optType": 0,
"type": "REVOKE",
"url": "http://www.baidu.com"
}
],
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"canDelegate": 0,
"handlers": "smartadmin",
"initiator": "",
"mHandleUrl": "http://www.baidu.com",
"mViewUrl": "http://www.baidu.com",
"handleUrl": "http://www.baidu.com",
"viewUrl": "http://www.baidu.com",
"nodeId": "NO20220002",
"nodeName": "节点2-转办挂起激活待办",
"serialNumber": "LSH2022051508",
"taskId": "20220705001111112",
"taskName": "待办20220705001111112",
"timeOut": 0,
"transTypeCode": "CE2022001",
"transTypeName": "测试类型1"
}
],
"handler": "smartadmin",
"handleOpinions": "办理",
"handleTime": "2025-03-31 17:29:06",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"status": "next"
},
"taskId":"TT2022001",
"taskStatus": "FINISH"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
任务状态：完成，办理只办理当前待办
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {
"handler": "smartadmin",
"handleOpinions": "办理",
"handleTime": "2025-03-31 17:29:06",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"status": "none"
},
"taskId": "f29cabebde3742d08ad37633dd52db94",
"taskStatus": "FINISH"
}
]
}
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
任务状态：完成，任务办结
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {
"handler": "smartadmin",
"handleOpinions": "办结",
"handleTime": "2025-03-31 17:29:06",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"status": "end"
},
"taskId": "1e5df231b2544956b8b8de7e145721e4",
"taskStatus": "FINISH"
}
]
}
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
任务状态：终止，事务终止
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {
"handler": "smartadmin",
"handleOpinions": "STOP",
"handleTime": "2025-03-12 15:27:52",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE"
},
"taskId": "5ac0d8bf8b814281842f90eaba03a0f3",
"taskStatus": "TERMINATED"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
任务状态：转办，任务转办
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {
"handler": "smartadmin",
"handleOpinions": "TURNTODO",
"handleTime": "2024-02-01 17:12:05",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"turnHandler":"wangshuai01"
},
"taskId": "a506ce26768c4cfda0a63054a58b35bb",
"taskStatus": "TURN"
}
]
}
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
任务状态：挂起，任务挂起
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {
"handler": "smartadmin",
"handleOpinions": "HANG",
"handleTime": "2025-03-31 17:04:11",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE"
},
"taskId": "00b3bd3d10d943f3a1abcab77e440d16",
"taskStatus": "SUSPENDED"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
任务状态：撤回，任务撤回
{
"code": 0,
"message": "调用成功",
"data": [
{
"taskData": {
"next": [
{
"actions": [
{
"method": "post",
"name": "催办",
"optType": 0,
"type": "REVOKE",
"url": "http://www.baidu.com"
}
],
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"canDelegate": 0,
"handlers": "smartadmin",
"initiator": "",
"mHandleUrl": "http://www.baidu.com",
"mViewUrl": "http://www.baidu.com",
"handleUrl": "http://www.baidu.com",
"viewUrl": "http://www.baidu.com",
"nodeId": "NO20220002",
"nodeName": "节点2-转办挂起激活待办",
"serialNumber": "LSH2022051508",
"taskId": "20220705001111112",
"taskName": "待办20220705001111112",
"timeOut": 0,
"transTypeCode": "CE2022001",
"transTypeName": "测试类型1"
}
],
"handler": "smartadmin",
"handleTime": "2025-03-31 17:29:06",
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
"status": "next"
},
"taskId": "5ac0d8bf8b814281842f90eaba03a0f3",
"taskStatus": "RECALL"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
{
"code":0,
"message":"调用成功",
"data":[
{
"taskId":"TT2022001",//任务ID
"taskStatus": "FINISH", //任务状态IN_PROGRESS进行中，FINISH正常办理，TERMINATED终止，TURN转办，SUSPENDED挂起，RECALL撤回
"taskData":{//当任务不是在进行中时 需要提供任务信息
"handleTime": "yy-MM-dd hh:mm:ss",//必填 处理时间
"endTime": "yy-MM-dd hh:mm:ss",//任务状态挂起时必填 结束时间
"handleOpinions": "办理意见", //非必填 处理意见
"handler": "smartadmin", // 必填 处理人学工号
"turnHandler": "smartadmin", // 任务状态TURN转办时必填 被转办人
"status": "next", // 任务状态为正常办理时必填 next表示任务办理完成同时创建下个任务、none表示当前任务不做任务操作，只增加办理情况（适用于会签且不是最后一签，如果是最后一签，且有下一个节点使用next 或者是并行节点，且不是并行最后一个节点，都可以传none）、 end表示当前为最终节点，事务办结了
"next":[// 有下一个任务时必填
{
"actions": [ //自定义操作列表
{
"method": "post", //请求方式 ，optType为api 必填，get 、 post 、 put
"name": "催办", //名称
"optType": 0, // 1:page页面 0:api接口
"type": "REVOKE", //类型, HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作
"url": "http://www.baidu.com"
}
],
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE", //应用id；必填
"canDelegate": 0, //是否允许代理, 1允许 0不允许,默认0
"handlingGroup":"111",//处理人用户组id，工号、用户组 二选一
"handlers": "smartadmin", //处理人 学/工号，多个账号英文逗号分隔，工号、用户组 二选一；办理人、候选人都放这个字段
"initiator": "", //发起人 学/工号
"mHandleUrl": "http://www.baidu.com", //app处理地址
"mViewUrl": "http://www.baidu.com", //app查阅地址
"handleUrl": "http://www.baidu.com", //pc处理地址
"viewUrl": "http://www.baidu.com", //pc查阅地址
"nodeId": "NO20220002", //必填 节点id；同一节点 nodeId需要一致
"nodeName": "节点2-转办挂起激活待办", //节点名称，必填，同一节点 nodeName需要一致
"serialNumber": "LSH2022051508", //流水号
"taskId": "20220705001111112", //任务ID
"taskName": "待办20220705001111112", //自定义任务名称
"timeOut": 0, //任务超时时间 单位h 默认不设置超时时间
"transTypeCode": "CE2022001", //类型code
"transTypeName": "测试类型1" //类型名称
}
]
}
},
{
"taskId":"TT2022002",//任务ID
"taskStatus": "IN_PROGRESS", //任务状态IN_PROGRESS进行中，FINISH正常办理，TERMINATED终止，TURN转办，SUSPENDED挂起
"taskData":{} //当任务是在进行中时 无需提供其他信息
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
← 旧版API(不推荐) 常见问题 →