# 办理待办任务

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

# 权限

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

详细参考-获取access token

# 请求方法

报文样例

POST /apis/ttc/v1/transaction/poa/todo/handleTask
Host: poa地址
Authorization:String
Content-Type:application/json
    
[
  {
    "appId": "xxx",
    "taskId": "TASK-01",
    "transactionId": "",
    "handler": "xxx",
    "handlerName": "xxx",
    "handleOpinions": "xxx",
    "handleTime": ""
  },
  {
    "appId": "xxx",
    "taskId": "TASK-02",
    "transactionId": "",
    "handler": "xxx",
    "handlerName": "xxx",
    "handleOpinions": "xxx",
    "handleTime": ""
  }
]
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

# Header参数

名称 类型 是否必填 描述
Authorization String 是 接口访问凭证

# Body参数

名称 类型 是否必填 描述
appId String 是 业务系统应用appId
handler String 是 办理人账号
taskId String 是 需要办理的任务ID
transactionId String 条件必填 事务ID，唯一，创建待办时传了事务参数，办理时为必填参数
handleOpinions String 否 办理意见
handleTime String 否 处理时间(格式：yyyy-MM-dd HH:mm:ss)
handlerName String 否 办理人姓名，如果不想要展示办理人真实信息可以用这个字段代替办理人姓名

# 接口调用成功返回

接口返回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 当前任务已办理

← 删除待办 →