审批日志
每一笔从 ERP 提交出去的审批，都会在这里留下一行记录：谁在什么时候提交、平台侧现在是什么状态、审批结束后系统替你做的那步动作成功没有。它是排查「钉钉里明明通过了，单据怎么还没生效」这类问题的唯一权威台账。
这一页是只读的：不能新增、不能修改、不能删除。页面上仅有的两个动作是 同步（主动去平台查一次最新状态）和 重新审核（重跑一次失败的后置动作）。
功能路径：系统 → 第三方平台 → 审批日志
一、功能概述
1. 核心用途
- 查状态：按单据号或审批实例找到那一笔审批，看它卡在哪个环节；
- 看流程：打开审批详情抽屉，看当前环节、历史审批人、表单原文；
- 校准状态：回调没送到时点 同步 主动查一次平台；
- 补救后置动作：审批通过但单据没生效时点 重新审核。
2. 整体结构
标准列表页：顶部筛选区（日期范围、状态、平台、单据类型四个筛选器 + 搜索框），下方表格，表头右上显示 68 个中 0 个被选 一类的计数。列表按提交时间倒序。
二、界面布局说明
| 列 | 含义 |
|---|---|
| 单据号 | 提交审批时那张 ERP 单据的编号，同一张单可能有多行（撤销后重提、驳回后重提） |
| 单据类型 | 单据类型的数字编号，与 审批模板 里的「单据类型ID」同一套 |
| 审批平台 | 平台代码，钉钉显示为 dingtalk |
| 审批状态 | 待审批 / 已同意 / 已拒绝 / 已撤销 |
| 提交时间 / 审批时间 | 前者是 ERP 发出请求的时间，后者是平台侧到终态的时间；未结束时审批时间为空 |
| 钉钉审批 | 查看 链接，新窗口打开钉钉侧的审批实例 |
| 审批详情 | 详情 链接，在本页右侧打开占屏约八成的抽屉 |
| 同步状态 | 同步 按钮，主动回查平台并校准 |
| 操作 | - / 审核 / 重新审核，见下文 |
详情抽屉里自上而下是 基本信息、当前审批环节、审批流程信息、审批历史、表单内容 五块，加载时显示 正在加载审批详情...；平台接口不可用时该块降级为 ⚠️ API不可用，其余部分仍按本地缓存展示。
三、业务操作步骤
步骤 1：定位记录
搜索框支持按单据号或审批实例 ID 模糊查。只知道大概时间就用日期范围筛选器，再叠加状态、平台、单据类型三个筛选器。
步骤 2：判断卡在哪
| 看到的状态 | 说明 | 下一步 |
|---|---|---|
待审批 且审批时间为空 | 正常在流程中 | 去钉钉催办，或点 详情 看当前环节是谁 |
待审批 但钉钉里已通过 | 回调没送到 | 点 同步 |
已同意 而单据仍未生效 | 后置动作问题 | 看操作列，见步骤 4 |
已撤销 | 提交人在平台侧撤回，或 ERP 侧撤销 | 单据的「审批中」标志已清除，可重新提交 |
已拒绝 | 审批人驳回 | 单据回到可修改状态，改完重提 |
步骤 3：需要时用同步校准
点行内 同步，按钮变 同步中...，成功后恢复并提示 同步成功，失败提示 同步失败: 加原因。同步不只是刷新这一行：如果状态从待审批变成终态，系统会顺带把单据上的「审批中」标志清掉，让单据回到正常状态。返回消息有两种口径——状态一致(已同意)，标志已校准 表示状态没变但补做了标志清理，状态已同步: 待审批 -> 已同意 表示确实取到了新状态。
步骤 4：操作列的三种取值
操作列是这一页唯一的「补救入口」，规则很明确：只有状态为 已同意 的记录才可能出按钮。
| 操作列 | 含义 | 动作 |
|---|---|---|
- | 后置动作已经成功执行过 | 无需处理 |
| 审核 | 审批通过，但系统没有记录到后置执行结果 | 点击执行一次审核 |
| 重新审核 | 后置动作执行失败，记录里带着失败原因 | 点击重跑，确认框 确认重新执行审核？ |
点 重新审核 成功后提示 审核成功: 加结果，失败提示 审核失败: 加原因；处理结果会追加写回这条记录的状态说明里，所以重跑一次之后再看这一行，操作列会变成 -。
四、字段详细说明
| 字段 | 含义 |
|---|---|
| 审批状态 | 平台侧实例的终态，与钉钉的事件一致：terminate 记为已撤销、agree 记为已同意、refuse 记为已拒绝 |
| 转交 | 钉钉里的「转交」在 ERP 侧按已同意记录，不会单独出现「已转交」状态 |
| 状态说明 | 详情抽屉与失败原因的真身，后置动作的成功/失败以 [OK]、[FAIL]、[ERROR] 前缀写在里面 |
| 审批人信息 | 各节点的审批人及其操作类型（正常执行、代理执行、前加签、后加签、转交、抄送、退回等） |
| 回调原文 | 平台推送过来的报文，用于与平台侧对账，一般只在技术支持要求时提供 |
五、典型使用场景
单据一直显示「审批中」。 按单据号搜出记录 → 状态是 已同意 → 操作列 重新审核 → 提示 审核失败: 本期间已经结账,不能记账! 之类，原因就清楚了：不是审批没通过，是后置动作被业务规则拦住。先把业务处理掉再重跑。
多人排查同一笔。 把这一行的 审批实例ID 给技术支持，比描述「上周那张销售订单」准确得多。需要看钉钉侧原文时点 查看 直接跳平台。
月底核对哪些单还挂着。 状态筛选 待审批 + 日期范围选本月，一眼看到所有未闭环的审批；对确实不再需要的，去钉钉侧撤销，回本页点 同步 让 ERP 状态跟上。
六、权限控制与前置条件
- 只读台账，无新增/修改/删除入口，因此不存在误改风险；能看到这一页的人默认可见全部记录，包括别人提交的审批。
- 记录由系统自动写入：单据提交审批成功即建行，之后由平台回调或 同步 更新。手工「补一条日志」是做不到的。
- 前置是 审批模板 已绑定并启用，未启用审批的单据不会出现在这里。
- 重新审核 会真的改动单据状态（生效、记账），与在单据上点一次审核等效，不要当成「刷新按钮」反复点。
七、常见问题
同一张单据号出现好几行，哪一行算数？ 以时间最新的一行为准。每次提交都会新建一条记录，撤销、驳回后重提都会留下新行，旧行保留作为历史。
审批状态显示的是英文？ 不会。状态列是中文的 待审批/已同意/已拒绝/已撤销；显示成 dingtalk 的是「审批平台」列，那是平台代码，界面上未做中文映射。
为什么有的记录操作列显示「审核」、有的显示「重新审核」？ 前者是审批通过但系统没记到后置结果（多为回调中断），后者是明确记到了失败。两者都是重跑同一个动作，颜色不同只为提示严重程度。
点同步报 钉钉API查询失败？ 通常是钉钉应用的「获取审批实例详情」权限没开通，或者 平台配置 里的凭证被改过。按提示里的权限名去平台后台补权限再同步。
这里能撤销审批吗？ 不能。撤销要在钉钉侧或由提交人在单据上操作，本页只负责记录和补救。
内部审批的记录也在这里吗？ 不在。本页只记第三方平台的实例；ERP 内部审批的流转记录在 审批管理 的「我已审批」页签。