审批流加签
- 接口：common/workflow/endorsement
- Method：POST
- 数据格式：JSON
接口说明：此接口用于审批流加签，类似标准产品加签功能。
1.sequence_target 加签方式 1:后加签 -1:前加签 0:并签
2.sequence_array: 加签人对象集合
3.type代表工作节点流类型支持 P审批 Q询问,如果类型为Q,question必须有值
4.多语言环境：实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
5.加签人数一次性不能超过20条
6.添加询问时数据结构变更为approve_list员工号集合,type为Q,询问时问题question必填
请求参数
| 字段名称 | 字段类型 | 字段描述 | 是否必填 |
|---|---|---|---|
| bizId | String | 当前次接口同步的唯一标识 | true |
| timestamp | long | 当前次接口同步时间对应的时间戳 | true |
| path_id | long | 工作流步骤id | true |
| sequence_target | String | 加签类型 | true |
| type | String | 审批类型 | true |
| question | String | 问题 | false |
| sequence_array | Array | 加签人集合 | true |
| employee_number | String | 当前工作流对应员工号 | true |
sequence_array 说明
| 字段名称 | 字段类型 | 字段描述 | 是否必填 |
|---|---|---|---|
| employee_number | String | 加签员工号 | true |
| type | String | 加签类型 | true |
| reason | String | 加签原因 | false |
注意：sequence_array 的格式,eg：请求参数事例
approve_list 说明
注意：approve_list 为询问员工号集合 List
的格式,eg：请求参数事例 返回参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| resCode | Integer | 响应状态码（见附录） |
| resMsg | String | 响应描述信息 |
| bizId | String | 请求唯一标识码 |
| data | boolean | 成功或失败 |
示例：
加签请求数据
{
"bizId": "d162175f-5bdf-43c8-a245-a013dc219ffd",
"timestamp": 1591261960559,
"data": {
"sequence_target": 1,
"path_id": 731612,
"type": "P",
"sequence_array":[[{"employee_number":"39","type":"P"}]],
"employee_number":39
}
}
询问请求数据
{
"bizId": "d162175f-5bdf-43c8-a245-a013dc219ffd",
"timestamp": 1591261960559,
"data": {
"path_id": 12618398,
"type": "Q",
"question": "ABCD",
"approve_list": [
"1111"
],
"employee_number": "cw5"
}
}
返回数据
执行成功
{
"resCode": 200000,
"resMsg": "success",
"bizId": "5f282bbb-7c80-4117-863f-a5fd775e0309",
"data": true
}