查询单据任务接口文档
接口信息
- 接口路径:
/form/{formType}/tasks
- 请求方法:
POST
- 接口描述: 根据单据类型和单据号列表，查询对应的流程任务信息
请求参数
路径参数
| 参数名 |
类型 |
必填 |
说明 |
| formType |
String |
是 |
单据类型，支持以下值：
- REIMBURSE：报销单
- PRECONSUME：申请单
- LOAN：借款单
- CONTRACT：合同
- PAYMENT：付款单
- REPAYMENT：还款单 |
请求头
| 参数名 |
类型 |
必填 |
说明 |
| entCode |
String |
是 |
企业编码（通过 @AuthCode 注解自动注入） |
请求体
[
"FORM001",
"FORM002",
"FORM003"
]
| 参数名 |
类型 |
必填 |
说明 |
| formCodes |
List |
是 |
单据号列表，数组格式 |
返回参数
返回结构
{
"code": "ACK",
"message": "",
"data": [
{
"entCode": "EC2002459AGU3",
"employeeId": "USER001",
"employeeName": "张三",
"taskType": "APPROVAL",
"taskId": "2f0736c5-92ab-11f0-9f48-8254757b1f18",
"taskName": "审批任务",
"parentTaskId": "6f6ddc8b-819b-11f0-9729-0a580af43f6f",
"procInstId": "6f6ddc8b-819b-11f0-9729-0a580af43fb9",
"completedAt": "1767838958491",
"createdAt": "1767838953743",
"unanimous": false,
"handleResult": "AUTO_PASS"
}
]
}
返回字段说明
OpenApiResultDto 结构
| 字段名 |
类型 |
说明 |
| code |
String |
响应码，ACK 表示成功，NACK 表示失败 |
| message |
String |
响应消息 |
| data |
List |
任务列表数据 |
| requestId |
String |
请求ID |
| 字段名 |
类型 |
说明 |
| entCode |
String |
企业编码 |
| employeeId |
String |
任务处理人工号 |
| employeeName |
String |
任务处理人姓名 |
| taskType |
ProcessNodeCategory |
任务类型 |
| taskId |
String |
任务ID |
| taskName |
String |
任务名称 |
| parentTaskId |
String |
父任务ID |
| procInstId |
String |
流程实例ID |
| completedAt |
Date |
任务完成时间（未完成时为 null） |
| createdAt |
Date |
任务创建时间 |
| unanimous |
Boolean |
是否一致通过 |
| handleResult |
HandleResultTypeEnum |
处理结果类型（枚举值） |
枚举说明
HandleResultTypeEnum（处理结果类型枚举）
| 枚举值 |
说明 |
| APPROVE |
通过 |
| REJECT |
驳回 |
| REJECT_DIRECT |
驳回直达 |
| REJECT_TO_ANY_NODE |
驳回至任意节点 |
| RECALL |
召回 |
| COUNTER_SIGN |
加签 |
| COUNTER_SIGN_APPROVE |
加签并通过 |
| SKIP |
跳过 |
| AUTO_PASS |
自动通过 |
| SKIP_BY_NO_REVIEW |
免审自动通过 |
| CC |
抄送（暂时 formTask 不会有抄送节点） |
| APPROVE_FOR_DELEGATED |
代审批通过 |
| REJECT_FOR_DELEGATED |
代审批驳回 |
| REJECT_DIRECT_FOR_DELEGATED |
代驳回直达 |
| REJECT_TO_ANY_NODE_FOR_DELEGATED |
代驳回至任意节点 |
| RECALL_FOR_DELEGATED |
代审批召回 |
| FORWARD |
转交 |
| FORWARD_FOR_DELEGATED |
代转交 |
| DEFAULT |
默认 |
| REVERT_FORWARD |
撤回转交 |
| REVERT |
撤回 |
| MANUAL_DISPATCH |
手动分派 |
ProcessNodeCategory（流程节点类别枚举）
| 枚举值 |
说明 |
| APPROVAL |
审批 |
| FINANCE_AUDIT |
审核 |
| CASHIER_SETTLE |
支付 |
| NOTICE |
消息通知节点 |
| WEB_HOOK |
外部节点 |
| CC |
抄送节点 |
| VOUCHER_PAYABLE |
凭证应付节点 |
| SIGN |
签收节点 |
| SMART_SIGN |
智能签收节点 |
| SIGN_WAIT |
签收等待节点 |
| SIGN_START |
签收发起 |
| MK_ROBOT |
MK机器人节点 |
| ABANDON |
作废 |
| SELF_DEFINING |
自定义节点（这个节点类型不在流程编辑显示，代表是自定义写入的一些节点） |
| DATA_HUB_HOOK |
数据枢纽节点 |
| SHARE_PLATFORM |
共享 |
| CONTRACT_SIGNING |
签章 |
| SUB_PROCESS |
子流程 |
修改记录
2026-01-15 初始化