单据审批历史查询

  • 接口: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"
        }
    ]
}

审批流示例说明

基于上述响应数据,该单据的审批流程如下:

  1. 第一步 - 职位审批节点

    • 节点ID:992426
    • 审批职位:ApprovE
    • 审批状态:rejected(已拒绝)
    • 涉及用户:翟绪文(邮件测试)、翟绪文(发送邮件)
  2. 第二步 - 自动财务审核

    • 节点ID:992427
    • 节点类型:A(自动步骤)
    • 工作流步骤:finance audit
    • 当前状态:open(待处理)

常见错误码

错误码 描述
200000 请求成功
400001 参数错误
403001 无权限访问
404001 单据不存在
500001 系统内部错误

results matching ""

    No results matching ""