更新实例状态旧版SDK
更新于 2024-01-11调用本接口更新实例状态。
例如，用户A提交待办任务，待办处理节点有3级，B1、B2、B3三级处理人，当前B1已同意，处理节点在B2，B3尚未收到待办任务。
当调用该接口后，待办状态查询路径如下图所示，状态变更如下表所示：
以上图中的审批流为例，当状态置为COMPLETED时，审批流状态如下：
提交/待办处理人 | 更新前 | 更新后 |
用户A | 工作台-待办-已发起，审批中 | 工作台-待办-已发起，已通过 |
审批节点B1 | 工作台-待办-已处理，已通过 | 工作台-待办-已处理，已通过 |
审批节点B2 | 无此条待办任务 | 无此条待办任务 |
审批节点B3 | 无此条待办任务 | 无此条待办任务 |
以上图中的审批流为例，当状态置为TERMINATED时，审批流状态如下：
提交/待办处理人 | 更新前 | 更新后 |
用户A | 工作台-待办-已发起，审批中 | 工作台-待办-已发起，已撤销 |
审批节点B1 | 工作台-待办-已处理，已通过 | 工作台-待办-已处理，已撤销 |
审批节点B2 | 无此条待办任务 | 无此条待办任务 |
审批节点B3 | 无此条待办任务 | 无此条待办任务 |
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 开发者后台申请 | 重要 暂不支持新增申请。 |
第三方企业应用 | 是 | 开发者后台申请 | 重要 暂不支持新增申请。 |
第三方个人应用 | 否 | — | — |
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/process/workrecord/update
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | Be3xxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
request | UpdateProcessInstanceRequest | 否 | 请求对象。 | |
agentid | Number | 否 | 111 | 应用的agentid。 |
process_instance_id | String | 是 | proc | 审批实例ID。 |
status | String | 是 | COMPLETED | 实例状态：
|
result | String | 是 | agree | 实例结果：
|
cancel_running_task | Boolean | 否 | true | 取消任务。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
request_id | String | 65v5c56q2wv9 | 请求ID。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | 成功 | 返回码描述。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
错误码
错误码（errorcode） | 错误码描述（errmsg） | 错误原因 | 解决方案 |
43007 | 需要授权 | access_token不正确 | 请确认access_token是否正确 |
40056 | 无效的微应用ID | 微应用ID参数错误 | 请确认微应用ID是否正确 |
40083 | 无效的suiteKey | 应用suiteKey参数错误 | 请确认应用suiteKey是否正确 |
-1 | 系统繁忙 | 系统繁忙 | 请稍后重试 |
400001 | 系统繁忙 | 系统繁忙 | 请稍后重试 |
8100017 | 无操作审批流的权限，请检查审批实例或者模板是否正确 | 实例ID（process_instance_id）参数不正确 | 实例ID（process_instance_id）必须是创建实例接口返回的process_instance_id值，不能使用官方审批流的实例值 |
810003 | 审批流的表单格式错误 | 审批流的表单格式错误 | 请参照创建实例中「支持的表单参数」部分进行传值 |
820008 | 审批系统错误，原因为【审批表单已被管理员修改】 | 没有传result参数 | 更新审批单实例时，请传入result值后，再尝试 |
