1. 审批
睿人事OpenAPI
  • 睿人事开放接口
    • OAuth2
      • 获取token
    • 花名册
      • 查询待入职员工列表
      • 查询待入职员工详情
      • 添加待入职员工(简单数据版)
      • 添加待入职员工(完整数据通用版)
      • 待入职员工取消入职
      • 获取待入职记录元数据
      • 获取企业员工列表
      • 获取企业员工详情
      • 修改员工基本信息
      • 查询单个工作信息
      • 新增人员入职花名册
      • 新增工作信息
      • 修改指定工作信息
      • 删除指定工作信息
      • 新增离职工作信息
      • 获取花名册元数据
      • 根据证件号码获取empId
      • 员工搜索
      • 批量获取员工详情
      • 批量查询任职信息
      • 根据证件号批量查询 empId
      • 新增转正工作信息
    • 组织
      • 批量获取指定的组织
      • 获取指定的组织
      • 查询下级组织的组织数据
      • 根据部门获取部门关联的职位
      • 根据部门获取编制信息
      • 搜索组织节点
      • 获取组织节点字段定义
      • 单个创建组织
      • 停用指定的组织节点
      • 获取指定组织的历史记录列表(时间轴)
      • 在指定组织上添加新的历史记录
      • 删除指定的组织历史记录
      • 更新指定的组织历史记录
      • 设置组织关联钉钉通讯录部门
      • 取消组织关联钉钉通讯录部门
    • 成本中心
      • 查询下级成本中心数据 (一级一级给)
      • 创建成本中心
      • 获取成本中心详情
      • 更新成本中心
      • 停用成本中心
    • 生态对接
      • 使用userId置换绑定的empId
      • 使用deptId置换绑定的orgId
      • 使用empId置换绑定的userId
      • 使用orgId置换绑定的deptId
      • 同步员工的生态对接信息
    • 合同
      • 合同列表查询
    • 岗职体系
      • 查询职位详情
      • 查询职位
      • 查询序列
      • 查询职级类别
      • 查询职级
      • 查询职等
      • 查询职务
    • 兼岗
      • 查询员工兼岗信息
      • 批量获取员工兼岗记录 ID
      • 批量新增员工兼岗记录
      • 批量修改员工兼岗记录
      • 批量删除员工兼岗记录
      • 批量查询员工兼岗信息
    • 薪酬
      • 发薪活动
        • 发薪活动列表
        • 获取发薪活动详情
        • 发薪活动 - 添加算薪人员
        • 发薪活动 - 移除算薪人员
        • 获取人员范围
        • 解锁/锁定发薪活动
        • 批量创建发薪活动
        • 批量删除发薪活动
      • 薪资项
        • 获取企业薪资项
      • 薪资数据
        • 获取算薪数据
      • 薪资档案
        • 获取企业薪资档案字段
        • 获取员工适用薪资包
        • 获取薪资包详情
      • 核算组
        • 创建核算组
        • 核算组列表
      • 算薪结果
        • 算薪结果
        • 分段算薪结果
        • 提交智能校验
        • 查询智能校验结果
      • 算税
        • 生成算税人员
        • 查询算税人员生成结果
        • 批量报送算税人员
        • 查询批量报送算税人员结果
        • 更新算税人员信息
        • 查询算税人员信息
        • 提交算薪算税
        • 获得算薪算税反馈
        • 获取扣缴义务人列表
        • 获取6万减除费用人员列表
      • 薪资方案列表
    • 社保
      • 获取参保公司
      • 获取参保方案
      • 获取参保方案详情
    • datart
      • 通过仪表盘获取视图id
      • 通过仪表图表id获取数据定义&数据
    • 人员子集
      • 查询人员子集字段信息
      • 查询人员子集数据
      • 创建人员子集数据
      • 修改人员子集数据
      • 删除人员子集数据
    • 字段选项
      • 查询花名册选项类型字段中的选项值
      • 增加花名册选项类型字段中的选项
      • 启用/停用花名册选项类型字段中的选项
      • 修改花名册选项类型字段中的选项值
    • 表单平台
      • 查询表单id和名称
      • 查询表单字段信息
      • 数据查询接口
      • 新增数据
      • 更新数据
      • 删除数据
    • 审批
      • 获取审批实例ID列表
        POST
      • 获取单个审批实例详情的数据值
        POST
      • 查询审批记录(已经审批和当前审批节点)
        POST
      • 提交审批评论
        POST
      • 获取审批表单详情
        POST
      • 发起审批流程实例
        POST
    • 黑名单
      • 获取黑名单列表
    • 合同公司
      • 合同公司列表
    • 审批角色
      • 获取审批角色分组列表
      • 创建审批角色分组
      • 更新审批角色分组
      • 删除审批角色分组
      • 获取审批角色列表
      • 获取审批角色详情
      • 创建审批角色
      • 更新审批角色
      • 删除审批角色
      • 添加角色成员
      • 更新角色成员
      • 批量移除角色成员
      • 获取审批管理员列表
    • 其他模块接口
      • 绩效模块开放接口
      • 培训模块开放接口
      • 招聘模块开放接口
  • 需客户开放接口
    • 事件消息通知
      POST
  1. 审批

获取单个审批实例详情的数据值

生产环境
https://app91651.eapps.dingtalkcloud.com
生产环境
https://app91651.eapps.dingtalkcloud.com
POST
https://app91651.eapps.dingtalkcloud.com
/tduck-api/open/api/v1/approval/processes/dataValue
scope: tduck:processes:dataValue

Body参数#

名称类型是否必填描述
corpIdString是企业ID
processInstanceIdString是审批实例ID

返回参数#

名称类型描述
codeint接口是否响应成功。(200->成功)
msgString错误提示原因
dataObject返回结果

data数据结构解释#

字段名称类型描述
processInstanceIdString审批实例 id
formKeyString审批模版 id
formVenusTemplateString审批模版类型。入职、离职等
createUserIdString创建该审批实例的用户 id
actualEmpIdString实际提交审批的员工 id
statusInteger审批实例状态(0->未发起, 1->处理中, 2->审批通过, 3->审批拒绝, 4->已撤回, 5->待重新提交)
approvalResultString审批结果。未发起 (notInitiated), 审批处理中 (processing), 审批已完成 (completed), 审批已拒绝 (reject), 审批已撤回 (cancel), 退回到发起人 (revertForResubmit)
createTimeDate审批实例的创建时间
updateTimeDate审批实例的最后更新时间
finishTimeDate审批实例的结束时间
nowApprovalFlowTaskOpenFlowTaskVO当前审批节点
approvalDataMapMap<String, Object>当前节点数据。(对应节点的字段结构进行构建)
fieldItemListArray of FieldItemVO节点的字段
OpenFlowTaskVO 类字段描述#
字段名类型描述
taskNameString任务名称
multipleApprovalTypeInteger1 会签 2 或签
commentFlowCommentVO任务意见
createTimeDate任务创建时间
finishTimeDate任务完成时间
FlowCommentVO 类字段描述#
字段名类型描述
typeString意见类别 0 正常意见 1 退回意见 2 驳回意见
commentString意见内容
commentExtendedInformationMap<String, Object>意见内容的扩展信息,用于解析内容并扩展信息
FieldItemVO 字段描述#
字段名类型描述
typeIdString字段类型。单行文本(INPUT),数字(NUMBER),多行文本(TEXTAREA),下拉框(SELECT),级联选择(CASCADER),排序(SORT),滑块(SLIDER),单选框(RADIO),多选框(CHECKBOX),日期选择(DATE),日期范围(DATE_RANGE),评分(RATE),图片上传(IMAGE_UPLOAD),文件上传组件(UPLOAD),图片展示(IMAGE),图片选择(IMAGE_SELECT),图片轮播(IMAGE_CAROUSEL),文字描述(DESC_TEXT),手写签名(SIGN_PAD),分页(PAGINATION),分割线(DIVIDER),省市联动(PROVINCE_CITY),手机号验证(PHONE_VERIFICATION),子表单(SUB_FORM),地理位置(INPUT_MAP),矩阵填空(MATRIX_INPUT),矩阵量表(MATRIX_SCALE),横向填空(HORIZONTAL_INPUT),矩阵选择(MATRIX_SELECT),成员选择(USER_SELECT),部门选择(DEPT_SELECT),成本中心选择(COST_CENTER_SELECT),文字识别(OCR),随机编号(RANDOM_NUMBER),函数计算(FUNCTION_CALC),商品选择(GOODS_SELECT),预约日期(RESERVE_DAY),预约时段(RESERVE_TIME_RANGE),关联审批单(ASSOCIATE_APPROVAL),说明文字(EXPLANATORY_TEXT),动态字段(DYNAMIC_ITEM),链接(URL)
fieldIdString业务字段唯一键标识
multipleboolean是否多选
configConfig主要配置
levelInteger地址字段的省市联动级别,1表示省,2表示省市,3表示省市区
typeString时间类型,如日(date)、月(month)、年(year)、日期时间(datetime)
childListArray of FieldItemVO子表单的字段定义
explanatoryTextValueString说明文字类型字段的值(最多两百字)
multiBoolean是否有多段数据
statusString状态
Config 类字段描述#
字段名类型描述
labelString标签名称(字段名)
requiredboolean是否必填
optionsArray of SelectOption下拉框值
selectOptionTypeString下拉框的值类型
numberUnitString数字类型输入框的单位
showSummationBoolean是否展示合计
SelectOption 类字段描述#
字段名类型描述
labelString选项标签
valueString选项值
statusString选项状态

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数

Body 参数application/json

示例
{
  "corpId": "",
  "processInstanceId": ""
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://app91651.eapps.dingtalkcloud.com/tduck-api/open/api/v1/approval/processes/dataValue' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "corpId": "",
  "processInstanceId": ""
}'

返回响应

🟢200getProcessesDataValue-Example
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "msg": "",
    "data": {
        "processInstanceId": "", //审批实例 id
        "formKey": "", //审批模版 id
        "formVenusTemplate": "", //审批模版类型。入职、离职等
        "createUserId": "", //创建该审批实例的用户 id
        "actualEmpId": "", //实际提交审批的员工 id
        "status": 0, //审批实例的状态
        "approvalResult": "", //审批结果
        "createTime": "", //审批实例的创建时间
        "updateTime": "", //审批实例的最后更新时间
        "finishTime": "", //审批实例的结束时间
        "nowApprovalFlowTask": { //当前审批节点
            "id": "",
            "activityExecutionId": "", //行动执行id
            "taskId": "", //任务编号
            "activityType": "", //行动类型 userTask serviceTask
            "taskDefKey": "", //任务Key
            "procDefId": "", //流程ID
            "procDefKey": "", //流程key
            "finished": false, //是否已经完成
            "candidateUserIdList": [ //任务中的人员
                ""
            ],
            "executionId": "", //执行实例的 id
            "optionalStatus": "", //操作的状态
            "taskName": "", //任务名称
            "multipleApprovalType": 0, //1 会签 2 或签
            "comment": { //任务意见
                "type": "", //意见类别 0 正常意见  1 退回意见 2 驳回意见
                "comment": "", //意见内容
                /**
                 * 意见内容的扩展信息
                 * 用于解析内容并扩展信息
                 */
                "commentExtendedInformation": {
                    "key": {}
                }
            },
            /**
             * *
             * 任务创建时间
             */
            "createTime": "",
            "finishTime": "" //任务完成时间
        },
        "approvalDataMap": { //当前节点数据
            "key": {}
        },
        "fieldItemList": [ //节点的字段
            {
                "typeId": "", //字段类型 FormItemTypeOutEnum
                "defaultField": false, //是否是默认的字段
                "business": false, //true=>业务字段 false=>非业务字段
                "source": "", //字段来源 venus  salary
                "fieldId": "", //业务字段唯一键标识
                "fixedField": false, //是否固定字段,不能删除 true 不能移除
                "multiple": false, //是否多选
                "config": { //主要配置
                    "label": "", //标签名称(字段名)
                    "required": false, //是否必填
                    "options": [ //下拉框值
                        {
                            "label": "",
                            "value": "",
                            "status": "", //选项状态
                            "markValue": ""
                        }
                    ],
                    "selectOptionType": "", //下拉框的值
                    "associateAll": false, //关联审批单是否指定范围 true 所有 false指定范围
                    "numberUnit": "", //数字类型输入框的单位
                    "showAdjustVariation": false, //是否展示调整率调整值
                    "showSummation": false, //是否展示合计
                    "ext": "", //扩展字段,存放字段的扩展信息
                    "salaryFieldsConfig": {} //前端使用这个字段来存储数据,结构体的内容太多了,先用一个对象承接一下
                },
                "placeholder": "", //其余的为可直接写在组件标签上的属性
                "fieldPermissions": "", //权限控制字段 对应 FieldPermissionsEnum
                "level": 0, //地址字段 省市联动 1=>省   2=>省市 3=>省市区
                "disabled": false, //置灰
                "type": "", //时间类型 日(date) 月(month) 年(year) 日期时间(datetime)
                "childList": [ //子表单
                    {
                        "typeId": "", //字段类型 FormItemTypeOutEnum
                        "defaultField": false, //是否是默认的字段
                        "business": false, //true=>业务字段 false=>非业务字段
                        "source": "", //字段来源 venus  salary
                        "fieldId": "", //业务字段唯一键标识
                        "fixedField": false, //是否固定字段,不能删除 true 不能移除
                        "multiple": false, //是否多选
                        "config": { //主要配置
                            "label": "", //标签名称(字段名)
                            "required": false, //是否必填
                            "options": [ //下拉框值
                                {
                                    "label": "",
                                    "value": "",
                                    "status": "", //选项状态
                                    "markValue": ""
                                }
                            ],
                            "selectOptionType": "", //下拉框的值
                            "associateAll": false, //关联审批单是否指定范围 true 所有 false指定范围
                            "numberUnit": "", //数字类型输入框的单位
                            "showAdjustVariation": false, //是否展示调整率调整值
                            "showSummation": false, //是否展示合计
                            "ext": "", //扩展字段,存放字段的扩展信息
                            "salaryFieldsConfig": {} //前端使用这个字段来存储数据,结构体的内容太多了,先用一个对象承接一下
                        },
                        "placeholder": "", //其余的为可直接写在组件标签上的属性
                        "fieldPermissions": "", //权限控制字段 对应 FieldPermissionsEnum
                        "level": 0, //地址字段 省市联动 1=>省   2=>省市 3=>省市区
                        "disabled": false, //置灰
                        "type": "", //时间类型 日(date) 月(month) 年(year) 日期时间(datetime)
                        "childList": [], //子表单
                        /**
                         * 说明文字类型字段的值(最多两百字)
                         * 富文本内容的包含了前端的标签
                         * <p><span class="ql-size-small">你好!</span></p><p><span class="ql-size-small">你好!</span>
                         * </p><p><span class="ql-size-small" style="color: rgb(230, 0, 0);">你好!</span></p><p><span style="color: rgb(255, 255, 0);">你好</span></p>
                         */
                        "explanatoryTextValue": "",
                        "multi": false, //是否有多段数据
                        "status": "",
                        "tableIdList": [ //前端转化表单结构使用
                            ""
                        ],
                        "valueSourceType": "",
                        "selectField": "", //人事合同联动字段
                        "atLeastOne": false, //是否至少添加一条
                        "selectLinks": [
                            {
                                "value": "",
                                "targets": [
                                    {
                                        "fieldId": "",
                                        "multi": false
                                    }
                                ]
                            }
                        ]
                    }
                ],
                /**
                 * 说明文字类型字段的值(最多两百字)
                 * 富文本内容的包含了前端的标签
                 * <p><span class="ql-size-small">你好!</span></p><p><span class="ql-size-small">你好!</span>
                 * </p><p><span class="ql-size-small" style="color: rgb(230, 0, 0);">你好!</span></p><p><span style="color: rgb(255, 255, 0);">你好</span></p>
                 */
                "explanatoryTextValue": "",
                "multi": false, //是否有多段数据
                "status": "",
                "tableIdList": [ //前端转化表单结构使用
                    ""
                ],
                "valueSourceType": "",
                "selectField": "", //人事合同联动字段
                "atLeastOne": false, //是否至少添加一条
                "selectLinks": [
                    {
                        "value": "",
                        "targets": [
                            {
                                "fieldId": "",
                                "multi": false
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
修改于 2025-03-24 10:10:21
上一页
获取审批实例ID列表
下一页
查询审批记录(已经审批和当前审批节点)
Built with