审批模板
审批模板是钉钉审批与 ERP 单据之间的翻译层。钉钉侧的审批表单有它自己的一套控件，ERP 的单据有它自己的字段，两边必须逐字段对上，审批通过后系统才知道该把哪张单据置为生效、把哪些值写回哪里。这一页就是做这件事的：先同步模板，再按单据类型绑定，最后核对字段映射。
页面以单据类型为主表，所以 100 多行里绝大多数是 ✗ 未启用 的空行——这是正常的，只有你真的要在钉钉里审批的那几类单据才需要配置。
功能路径：系统 → 第三方平台 → 审批模板
一、功能概述
1. 核心用途
- 同步模板：把钉钉后台建好的审批表单模板拉到 ERP 里来；
- 绑定单据类型：一张钉钉模板对应一类 ERP 单据；
- 字段映射：把钉钉表单控件一一对到 ERP 的表头字段与明细列；
- 控制金额门槛与后置动作：多少钱以下不必审批、审批通过后自动生效还是人工确认。
2. 整体结构
页面自上而下：标题 审批模板管理、工具栏（同步钉钉模板 + 提示文字）、三张统计卡、所有单据类型 列表（九列）。行内两个操作按钮 绑定 与 映射。
二、界面布局说明
| 列 | 含义 |
|---|---|
| 单据类型ID / 名称 | ERP 的单据类型，与单据管理里的分类一致 |
| 审批状态 | ✓ 已启用 / ✗ 未启用，即这一类单据是否走钉钉审批 |
| 钉钉模板CODE | 平台侧模板的唯一编号（PROC- 开头），同步后自动带出 |
| 钉钉模板名称 | 模板在钉钉后台的表单名称 |
| 最小审批金额 | 低于该金额的单据不必审批；填 0 表示全部需要审批 |
| 审批后动作 | 自动审核（绿）/ 手工审核（橙） |
| 字段映射 | 匹配率，形如 90% (26/29)，未配置时显示 - |
| 操作 | 绑定 打开绑定弹窗，映射 打开字段映射弹窗（该行还没有模板时 映射 是灰的） |
三张统计卡分别是 单据类型总数、已启用审批、已绑定模板。后两个数字不相等是正常现象：绑定过但关掉了审批的模板，会占「已绑定」而不占「已启用」。
三、业务操作步骤
步骤 1：同步钉钉模板
点 同步钉钉模板，确认框 确定要同步钉钉审批模板吗？此操作将从钉钉获取所有审批模板并保存到本地数据库。。确认后按钮进入 同步中...，页面提示 ⏳ 正在同步中，请稍候...，完成后给出 同步完成！新增: 3个 更新: 1个 失败: 0个。
页面上那句常驻提示 首次使用请先同步钉钉模板,然后才能选择绑定 就是这一步的必要性说明：没有同步，绑定弹窗里的模板下拉是空的。
同步是幂等的：已存在的模板只更新名称，你配好的绑定关系与字段映射不会被冲掉。
步骤 2：绑定单据类型
在目标行点 绑定，弹窗标题 审批绑定配置：
| 字段 | 说明 |
|---|---|
| 单据类型 | 只读，显示你点进来的那一行，如 1 - 销售订单 |
| 选择审批模板 | 必填下拉，选项为已同步的模板；已被别的单据用过的模板会标成 销售订单 (已被 1 - 销售订单 使用) |
| 模板CODE / 模板名称 | 选中模板后自动带出，只读 |
| 最小审批金额 | 占位提示 0表示全部需要审批 |
| 审批通过后动作 | 自动审核（审批通过后立即生效） / 手工审核（审批通过后需人工确认生效） |
| 启用审批 | 勾选后这一类单据才真正走审批 |
选到已被占用的模板时，页面会提示 ⚠ 该模板已被 XXX 使用，确认后将会共用该模板——共用是允许的，两张单据会走同一张钉钉表单。没选模板就保存会提示 请选择审批模板。
步骤 3：核对字段映射
回到列表点 映射，弹窗标题 字段映射，右上角有 查看单据列表 ↗ 可以跳去核对 ERP 字段。表格四列：钉钉控件、类型、必填（是/否）、映射 ERP 字段。
同步下来的模板系统已经按关键词自动匹配过一轮（金额、客户、仓库、日期这类通用字段命中率很高），匹配率直接显示在列表的「字段映射」列。你要做的是把没匹配上的补掉：
| 按钮 | 作用 |
|---|---|
| 下拉选择 | 每个钉钉控件对应一个 ERP 字段下拉，首项是 -- 不映射 --，允许留空 |
| 刷新字段 | 从钉钉重新取一次模板字段清单，确认框 从钉钉重新获取模板字段列表？手动调整的映射会被保留。 |
| 重新匹配 | 只对未匹配项再自动跑一次，确认框 确定要重新执行自动匹配吗？手动调整的字段会被保留。 |
| 保存映射 | 保存后提示 映射已保存，匹配率 96% (28/29) |
明细区的控件用 ▸ 与 └ 标出父子关系（▸ 商品明细 下面挂 └ 数量、└ 单价），表头字段则在 表头字段 分组里。
步骤 4：关掉审批
不想再走钉钉审批时，进 绑定 弹窗取消勾选 启用审批 保存，提示 禁用成功。绑定关系与映射都保留，重新勾选即恢复，不必再同步一次。
四、字段详细说明
审批通过后动作是这一页最容易踩坑的开关：
| 取值 | 界面显示 | 审批通过后的效果 |
|---|---|---|
| 自动审核 | 自动审核 | 单据直接生效，无需再操作 |
| 手工确认 | 手工审核 | 单据状态不变，审批日志里留下 审批通过，等待人工确认后生效，需要有人再执行一次审核 |
最小审批金额只在单据总额大于 0 且该值大于 0 时参与判断：总额低于门槛即「金额未达到审批阈值」，单据不提交审批直接按正常流程走。填 0 表示所有金额都要审批。
字段映射里还有十种取值转换方式（日期转字符串、布尔转「是/否」、用户与部门转平台侧 ID、外键取名称、固定值、生成单据详情链接等），系统按字段类型自动选择，一般不需要人工干预；只有当钉钉里显示出来的值格式不对（例如日期显示成一串时间戳）时，才需要找实施核对转换方式。
五、典型使用场景
只让大额销售订单走审批。 同步模板 → 销售订单行绑定「销售订单」模板 → 最小审批金额填 5000 → 勾选 启用审批 → 保存 → 映射里核对金额、客户、仓库三项是否对上。此后 5000 元以下的销售订单照常生效，大额单自动发起钉钉审批。
审批通过但要人工复核再生效。 把 审批通过后动作 选成 手工审核（审批通过后需人工确认生效）。钉钉侧显示已通过，ERP 里单据仍是待审核，由内勤在单据上再点一次审核。适合金额大、涉及改价的场景。
钉钉后台改了表单。 表单加了新控件后，回本页点 刷新字段 把新字段拉下来，旧映射不动，只补新增那几行，再 保存映射。
映射率一直上不去。 打开 映射 弹窗看 必填 列为「是」却选了 -- 不映射 -- 的行——钉钉侧必填控件不映射，提交时会被平台直接拒绝，这是最常见的失败原因。
六、权限控制与前置条件
- 前置一：平台配置 已启用钉钉；前置二：用户绑定 已完成，否则提交时报
当前用户未配置钉钉账号映射，请先在组织同步中完成用户映射。 - 钉钉后台的应用需要开通「获取审批实例详情」等权限。缺权限时页面会给出精确指引（提示需要开通
工作流实例读权限），并把详情区降级为⚠️ API不可用+ 本地缓存数据。 - 本页只对系统管理岗开放；单据本身能不能被某个人提交，仍由 角色管理 里的单据权限决定。
- 切回 ERP 内部审批后，本页配置不再参与审批流转，但绑定与映射会保留。
七、常见问题
列表里 107 行，只有两行有模板，是不是没同步成功？ 不是。列表以 ERP 的单据类型为主表，未绑定的行本来就显示 -。看统计卡的 已绑定模板 才反映真实进度。
同步会不会把我改好的映射冲掉？ 不会。同步只更新模板名称和控件清单，绑定关系与手工调整过的映射都保留；要清掉手工调整只能进映射弹窗逐行改。
匹配率 90% 能用吗？ 能。匹配率只是提示有多少控件找到了对应字段，未匹配的会走 -- 不映射 --。只要钉钉侧的必填控件都映射到了，业务就能正常提交。
为什么审批通过了单据没生效？ 先看这一行的 审批后动作 是不是 手工审核；再看 审批日志 里该笔记录的操作列，出现 重新审核 按钮说明后置动作执行失败，点它重试并看失败原因。
能不能两类单据共用一张钉钉模板？ 可以，绑定时选同一个模板即可，页面会提示「将会共用该模板」。注意共用意味着表单字段一致，映射需要各自维护。
没有的单据类型能不能新增模板？ 模板本身在钉钉后台创建，ERP 只负责同步与绑定；钉钉里没有的表单，这里凭空造不出来。