> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 专享 OpenAPI 说明
> 介绍钉钉OA审批面向智能OA客户的专享OpenAPI：适用于企业自建审批中心、流程交接、流程中心集成等场景，附开通步骤、计费规则等常见问题解答。
## 一、功能简介
为满足广大开发者在个性化应用开发方面的需求，钉钉OA审批2024年09月01日起陆续上线了一批面向智能OA客户的专享OpenAPI。这些专享OpenAPI将提供更丰富的能力，响应更个性化的业务需求，支持不同场景下的企业内部应用开发，建议开发者更合理、有效地使用OpenAPI，打造更健康的钉钉开放生态。
## 二、适用场景
钉钉可能会因法律法规或政策调整、执行监管指令所需，或者为维护钉钉服务安全性等，对以下接口的范围或具体功能进行增加、修改或删除。实际对客户开放的接口以钉钉开放平台届时公示的内容为准。
| OpenAPI名称 | OpenAPI详情 | 适用场景 |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------- |
| 查询审批中心用户待处理任务列表 | 调用本接口，可查询企业内指定用户待处理的审批任务列表（包含官方OA审批任务和三方业务系统同步到钉钉的审批任务），帮助企业自建审批中心。 | 企业自建审批中心 |
| 查询审批中心用户已处理任务列表 | 调用本接口，可查询企业内指定用户已处理的审批任务列表（包含官方OA审批任务和三方业务系统同步到钉钉的审批任务），帮助企业自建审批中心。 | 企业自建审批中心 |
| 查询审批中心用户已发起实例列表 | 调用本接口，可查询企业内指定用户已发起的审批实例列表（包含官方OA审批实例和三方业务系统同步到钉钉的审批实例），帮助企业自建审批中心。 | 企业自建审批中心 |
| 查询审批中心用户已收到的实例列表 | 调用本接口，可查询企业内指定用户已收到的审批实例列表（包含官方OA审批实例和三方业务系统同步到钉钉的审批实例），帮助企业自建审批中心。 | 企业自建审批中心 |
| 批量同意或拒绝审批任务 | 调用本接口，使用指定的userId和任务result及评论remark，对一批具有不同审批实例ID、任务节点ID的审批任务，进行批量处理。 | 企业自建审批中心 |
| 管理员查询指定员工的待处理任务列表 | 本接口为组织管理员提供待处理任务查询服务，通过管理员(managerUserId) 查询当前审批人UserId的所有待处理的OA审批任务信息，支持在职员工和离职员工的待处理任务查询。 | 流程交接解决方案 |
| 管理员批量转交指定员工的待处理任务 | 通过待转交审批任务查询接口，由管理员将任务批量转交给组织内其他在职人员，转交人支持在职人员和离职人员，被转交人必须为组织内的在职人员。 | 流程交接解决方案 |
| 创建或更新业务分组 | 调用本接口，可以将三方系统内的业务分组信息同步到钉钉OA审批，并生成对应的钉钉待办任务OA审批分类下的二级业务来源分组。后续在同步待处理任务至钉钉时，可支持指定待办任务所属的业务分组信息。 | 流程中心集成（自定义业务分组） |
| 删除业务分组 | 调用本接口，可以将三方系统同步到钉钉OA审批的分组信息进行删除，并同时删除对应的钉钉待办里OA审批分类下的二级分类，对应分类下的钉钉待办数据将移动至OA审批分类下的【其他】分组。 | 流程中心集成（自定义业务分组） |
| 保存流程中心外部集成审批模板（支持审批托管、自定义业务分组等featureConfig） | 调用本接口，可以将三方业务系统中的自有审批模板数据同步到钉钉OA审批，同时支持在模板维度进行审批托管、自定义业务分组、自定义快捷审批等多个高级功能模块自定义集成配置。 | 流程中心集成（审批页面托管模式） |
| 保存流程中心外部集成审批实例（支持审批托管、自定义业务分组等featureConfig） | 调用本接口，可以将三方业务系统中的自有审批实例数据同步到钉钉OA审批，同时支持在实例维度进行审批托管、自定义业务分组、自定义快捷审批等多个高级功能模块自定义集成配置。 | 流程中心集成（审批页面托管模式） |
| 保存流程中心外部集成审批任务（支持自定义快捷审批等featureConfig） | 调用本接口，三方系统可以配置审批任务的回调接口，这样审批人可以在钉钉审批待办中心直接进行审批操作，审批待办中心会回调三方系统，三方系统收到回调后更新任务信息，并将新的任务信息同步回审批中心，形成闭环。 | 流程中心集成（自定义业务分组） |
### 1、企业自建审批中心
客户多套业务系统（企业自研或采购的第三方系统）中的审批任务已接入钉钉审批中心，希望借助钉钉OA审批开放能力帮助企业自建审批中心，来实现分来源筛选、批量审批等功能：
### 2、流程交接解决方案
客户希望借助钉钉OA审批开放能力，在企业业务系统内实现钉钉官方OA审批流程交接功能，实现管理员批量将审批任务转交给组织内其他人员。
管理员查询指定员工的待处理任务列表：
管理员批量转交待处理任务给组织内其他人员：
### 3、流程中心集成（自定义业务分组）
客户希望把多个三方系统的审批任务都集中在钉钉审批中心，做一站式沉浸审批。同时希望在钉钉待办中心支持自定义业务分类、列表页一键审批，为用户、特别是审批事项繁多的管理层带来超级体验。
支持在待办中心自定义业务分类，查阅三方业务系统来源待办更清晰：
支持在待办中心列表页快捷审批来源于三方业务系统的待处理任务：
### 4、流程中心集成（审批页面托管模式）
客户业务系统自有流程引擎，希望以自有OA审批模式集成，但没有 H5 详情页面，希望能复用钉钉官方OA审批详情页，并可自定义审批操作区：将不同业务系统的审批单结构、样式统一，为用户提供多端（移动端/PC/平板）一致体验；审批操作区按钮可自定义（同意、拒绝、转交、打印等）。
支持三方自有OA审批使用官方详情页样式：
移动端详情页同样支持自定义审批操作区：
支持三方业务自定义配置/渲染审批操作区按钮（同意、拒绝等），且可透出三方业务执行异常报错文案详情：
## 三、操作步骤
上述专享 OpenAPI，标准版客户需要 **升级智能OA** 后才可申请使用；部分客户在2024年 9 月 1 日上线前已经参与公测，获得了这些 OpenAPI的调用权限，请按以下规则调用：
| 客户类型 | 是否参与公测 | 是否受影响 |
| ------ | ------ | -------------------------------------------- |
| 智能OA客户 | 已参与公测 | 不受影响，继续正常调用 |
| 智能OA客户 | 未参与公测 | 申请接口使用权限后，可调用 |
| 标准版客户 | 已参与公测 | 不可调用，需升级至智能OA后，申请接口调用权限后才能恢复调用；权限申请步骤请参考下方说明 |
| 标准版客户 | 未参与公测 | 不可调用，需升级至智能OA后，申请接口调用权限后才能调用；权限申请步骤请参考下方说明 |
权限申请路径：**开发者后台** > 应用开发 > 钉钉应用 > 新建应用或已有应用 > 点击应用 >【权限管理】>【OA审批】，选择申请需要的权限：
## 四、常见问题
标准版钉钉客户无法使用智能OA的专享OpenAPI，需要先 **升级智能OA** 后才能调用这些接口，专享OpenAPI使用时消耗智能OA的OpenAPI额度。
2024年 09月 01日起，开发者可在开放平台开发者文档及 **开发者后台** 中看到本次上线的专享OpenAPI。
## 五、相关文档
四种企业业务系统接入钉钉OA审批的方案总览
业务系统发起，钉钉端内打开业务系统详情页审批