单据审批历史查询
- 接口:common/workflow/workflowHistory
- Method:POST
- 数据格式:JSON
- 接口说明:查询单据的审批历史记录,包含每个审批节点的状态、操作人、时间等信息
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
| document_num |
String |
外部系统单据号或云简单据号 |
TRUE |
64 |
请求数据
POST common/workflow/workflowHistory
{
"bizId": "2495b566-2070-4e30-8fcb-eb9b8d9d824b",
"timestamp": 1586829400810,
"data": {
"document_num": "EXP0000239948"
}
}
响应数据
响应结构
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
| resCode |
Long |
响应状态码 |
TRUE |
6 |
| resMsg |
String |
响应消息 |
TRUE |
100 |
| bizId |
String |
业务ID |
TRUE |
36 |
| data |
Array |
审批历史记录列表 |
TRUE |
/ |
审批历史节点结构
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| pathId |
Long |
审批路径ID |
TRUE |
10 |
| sourceId |
Long |
单据ID |
TRUE |
10 |
| status |
String |
审批状态 |
TRUE |
20 |
| type |
String |
节点类型(P=人员,A=自动步骤,W=撤回) |
TRUE |
1 |
| function |
String |
功能类型(U=用户,P=职位,AU=授权用户,W=撤回) |
FALSE |
2 |
| workflowStep |
String |
工作流步骤名称 |
FALSE |
50 |
| positionId |
Long |
职位ID |
FALSE |
10 |
| userId |
Long |
用户ID |
FALSE |
10 |
| positionUsers |
Array |
职位用户列表 |
FALSE |
/ |
职位用户结构
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| userId |
Long |
用户ID |
TRUE |
10 |
| userName |
String |
用户名 |
TRUE |
100 |
| fullName |
String |
用户全名 |
TRUE |
100 |
| emailAddress |
String |
邮箱地址 |
TRUE |
200 |
审批状态说明
| 状态值 |
描述 |
| open |
待审批 |
| approved |
已同意 |
| rejected |
已拒绝 |
| aborted |
已终止 |
| withdrawed |
已撤回 |
| approving |
审批中 |
节点类型说明
| 类型值 |
描述 |
| P |
人员节点 |
| A |
自动步骤节点 |
| W |
撤回节点 |
功能类型说明
| 类型值 |
描述 |
| U |
用户审批 |
| P |
职位审批 |
| AU |
授权用户审批 |
| W |
撤回 |
响应示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "2495b566-2070-4e30-8fcb-eb9b8d9d824b",
"data": [
{
"pathId": 992426,
"sourceId": 19299761,
"status": "rejected",
"type": "P",
"function": "P",
"workflowStep": "ApprovE",
"positionId": 7011,
"userId": 320741,
"positionUsers": [
{
"userId": 320741,
"userName": "zhaixuwen@tom.com",
"fullName": "翟绪文(邮件测试)",
"emailAddress": "zhaixuwen666@163.com"
},
{
"userId": 320742,
"userName": "xuwen.zhai@cloudpense.com",
"fullName": "翟绪文(发送邮件)",
"emailAddress": "xinrui.jia@cloudpense.com"
}
]
},
{
"pathId": 992427,
"sourceId": 19299761,
"status": "open",
"type": "A",
"workflowStep": "finance audit"
}
]
}
审批流示例说明
基于上述响应数据,该单据的审批流程如下:
第一步 - 职位审批节点:
- 节点ID:992426
- 审批职位:ApprovE
- 审批状态:rejected(已拒绝)
- 涉及用户:翟绪文(邮件测试)、翟绪文(发送邮件)
第二步 - 自动财务审核:
- 节点ID:992427
- 节点类型:A(自动步骤)
- 工作流步骤:finance audit
- 当前状态:open(待处理)
常见错误码
| 错误码 |
描述 |
| 200000 |
请求成功 |
| 400001 |
参数错误 |
| 403001 |
无权限访问 |
| 404001 |
单据不存在 |
| 500001 |
系统内部错误 |