# 接口说明

调用本接口,对待办任务进行办理,办理完成后,任务进入已办

# 权限

要调用此API,需要申请poa能力,获取poa token,接口请求头中添加 Authorization 值为token

详细参考-获取access 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

# 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

# 接口调用失败返回

  • 接口支持批量,批量操作中的每条数据独立运行,批量中有失败的数据接口整体响应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
  • data.errorIds.code说明:
code message 说明
400 xxx is null 参数校验不合法
500 * 业务逻辑异常
2004 this task is not exist 当前任务不存在
2005 this task has been finished 当前任务已办理