主题
钉钉审批集成
更新日期：2026-08-28（基线 v1.229.0）
一、功能简介
把钉钉的审批能力接进系统，一共三个页面，各管一件事：
| 页面 | 管什么 |
|---|---|
| 审批模板配置 | 把钉钉那边已有的审批模板同步进来，告诉系统「钉钉的『报销审批』对应我们这边的哪种流程」 |
| 审批类型配置 | 维护我们自己的审批类型（名称、审批人、表单字段），并按业务类型 + 金额自动判定该走哪一档 |
| 审批回调记录 | 只读的排查视图：看钉钉推回来的审批结果都收到了没有、是通过还是驳回 |
⚠️ 前两个是两套独立的东西，别混：
- 审批模板配置 面向外部钉钉模板（模板由钉钉那边定义，我们只是建立映射）；
- 审批类型配置 是我们自己定义的审批类型（表单字段、审批人都在我们这边配）。
二、什么时候用它
- 企业本来就在钉钉里跑审批，希望审批结果能回到项目/费用数据上；
- 想让不同金额的采购走不同的审批档位（小额一个人批、大额会签）；
- 排查「钉钉里明明批了，系统里状态没变」。
三、开始之前（前置条件）
| 项 | 说明 |
|---|---|
| 企业已接入钉钉 | 需要企业的 corpId。同步模板时要填。 |
| 管理员权限 | 三个页面都是管理配置页，普通员工用不到。 |
| organId 不用填 | 当前登录的企业由后端从会话里取，页面上没有这个输入项。 |
四、操作步骤
第 1 步 同步钉钉模板（审批模板配置）
进入 审批模板配置 页 → 填 企业 corpId → 点同步。
同步完成会提示「同步完成，共 N 个模板」，列表里出现钉钉那边的模板，每行是：
| 列 | 说明 |
|---|---|
| 模板名称 | 钉钉侧的名字，如「报销审批」「采购申请」「借款审批」「立项申请」「采购合同审批」 |
| 模板 Code | 钉钉的 processCode，是这条模板的唯一标识 |
| 内部流程类型 | ⭐ 要你来选 —— 把这个钉钉模板对上我们系统里的哪种流程 |
| 图标 / 描述 | 展示用 |
| 启用 | 开关。关掉后该模板不再参与 |
| 创建时间 | —— |
选好「内部流程类型」后保存，提示「保存成功」。
删除映射会二次确认：「确认删除模板映射「xxx」?」，删掉提示「删除成功」。
**同步是把钉钉的模板拉过来，不会往钉钉写东西。**改错了重新同步即可。
第 2 步 配置自有审批类型（审批类型配置）
这一页维护的是我们自己的审批类型。每个类型包含：
基本信息：名称 / 编码 / 图标 / 排序 / 启用开关。
审批人设置：
| 项 | 可选值 |
|---|---|
| 审批人方式 | 人员（直接指定谁）／主管级别（按汇报线往上找） |
| 审批方式 | 单人审批（NONE）／会签（AND） —— 会签要所有人都通过 |
表单字段：给这个审批类型定义要填哪些字段，每个字段有：
| 项 | 说明 |
|---|---|
| 字段名称 | 显示给填表人看的名字 |
| 字段标识 | 程序用的 key |
| 字段类型 | 单行文本 / 多行文本 / 单选 / 多选 |
字段可以删，删前确认「确认删除字段「xxx」?」。
保存后提示「创建成功」或「更新成功」；删整个类型确认「确认删除审批类型「xxx」?」。
配好的类型可以同步到钉钉，成功时提示「同步成功，processCode: xxx」——这一步是把我们定义的类型推到钉钉去生成对应模板。
第 3 步 按业务类型 + 金额自动定档
审批类型可以绑定业务类型和金额区间。发起审批时系统按这两个条件自动判断走哪个审批类型，不用发起人自己挑。
⚠️ 金额档位规则具体存在哪张表、与既有《工作流审批》的关系如何，目前尚未核实。配置前建议先小范围试一条，确认走的是你预期的那一档。
第 4 步 排查：看回调记录
钉钉那边审完会把结果推回来，审批回调记录 页把每一条推送都记下来了。这是只读页面，不能在这里改任何东西。
筛选条件：审批状态 / 模板 Code / 企业 corpId。
列表列：
| 列 | 说明 |
|---|---|
| 序号 | —— |
| 审批实例 ID | 钉钉那一次审批的唯一编号，去钉钉里对账用这个 |
| 模板 Code | 哪个模板 |
| 内部流程类型 | 对应我们这边的什么流程 |
| 发起人 | 谁发起的 |
| 审批状态 | 审批中 / 已通过 / 已驳回 / 已终止 |
| 审批结果 | —— |
| 企业 corpId | —— |
| 回调时间 / 完成时间 | 什么时候收到的、什么时候审完的 |
| 操作 | 看原始报文 |
「原始报文」是钉钉推过来的原始内容，出问题时贴给开发最有用。
五、常见问题与注意事项
- 钉钉里批了，系统状态没变？ 先来「审批回调记录」查这个审批实例 ID 在不在列表里：
- 不在 → 回调根本没到（网络/回调地址问题），找运维；
- 在，但状态是「审批中」 → 钉钉侧还没终审完；
- 在且已通过，但业务数据没动 → 是我们这边的处理环节问题，把原始报文给开发。
- 「审批模板配置」和「审批类型配置」到底用哪个？ 审批流程本来就在钉钉里跑 → 用模板配置做映射；想在我们系统里定义表单和审批人 → 用类型配置。
- 同步模板需要什么？ 只需要企业 corpId，organId 后端自己取。
- 回调记录会保留多久？失败会自动重推吗？ ⚠️ 尚未核实，请勿依赖它做长期审计留档。
- 会签怎么算通过？ 选了「会签（AND）」就得所有审批人都通过才算通过。
六、相关功能
- 系统自带的审批流程，见《工作流审批 - 我的审批》《工作流审批 - 流程配置》。
- 采购与付款的审批场景，见《财务 - 付款采购与预算》。