平台配置
平台配置是 ERP 与外部审批平台之间的总开关。它做三件事：录入平台侧建应用后拿到的凭证、选择审批结果怎么回传给 ERP、决定这个平台在当前账套里启不启用。这一页没启用，后面的 用户绑定、审批模板 全都是空数据。
页面按平台分页签，当前有 钉钉 与 企业微信 两个。要强调的是「一个账套同一时刻只走一个审批平台」：服务商侧给某个账套指定的审批模式是唯一值，把模式切到钉钉之后，企业微信页签里的开关即使能保存也不会真正生效。
功能路径：系统 → 第三方平台 → 平台配置
一、功能概述
1. 核心用途
- 录凭证：把平台开放平台后台生成的应用参数填进 ERP，ERP 才有资格调用平台接口；
- 选回传方式：HTTP 回调与 Stream 推送二选一，决定要不要给 ERP 配公网回调地址；
- 启用/停用：用页面顶部的开关决定该平台是否参与本账套的业务；
- 取回调地址：把 ERP 生成的回调地址复制到平台后台去填，不用自己拼。
2. 整体结构
页面自上而下：标题 审批平台配置 + 平台页签、授权状态提示区、启用状态 开关、应用凭证 分组（各凭证输入框）、回调模式 单选、回调地址 只读框与 复制 按钮、右下角 保存配置。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 平台页签 | 钉钉、企业微信；切换页签会重新加载该平台的配置 |
| 授权状态 | 已开通显示 已授权，下方一行小字 参数随时可保存，启用后生效；未开通整页被遮罩 该平台尚未开通 + 请联系服务商开通审批功能 |
| 启用状态 | 一个开关，右侧文字 已启用 / 未启用 |
| 应用凭证 | 钉钉为 AgentId、CorpId、AppKey、AppSecret、Token、AES Key；企业微信为 AgentId、CorpId、CorpSecret、Token、AES Key |
| 回调模式 | 单选 HTTP回调模式 / Stream模式推送（仅钉钉提供两种） |
| 回调地址 | 只读文本框 + 复制 按钮，提示文字 将此地址复制到平台后台的回调配置中 |
| 保存 | 保存配置，成功提示 保存成功，失败提示 保存失败 |
密钥类输入框（AppSecret、AES Key、Token、CorpSecret）默认以密文显示，右侧的眼睛图标可以临时切换明文，便于核对是否填错。
三、业务操作步骤
步骤 1：在平台侧建应用
到钉钉开放平台创建企业内部应用，拿到 AppKey、AppSecret、AgentId、CorpId；同时给应用开通「工作流实例读权限」等审批相关权限，并在事件订阅里配置回调。这一步在平台侧完成，ERP 只是接收方。
步骤 2：填凭证
在 钉钉 页签逐个粘贴参数。四个必填项（AgentId、CorpId、AppKey、AppSecret）决定 ERP 能不能调通接口；Token 与 AES Key 决定回调消息能不能验签，只有走 HTTP 回调时才必须成对填写。
步骤 3：选回调模式
- HTTP回调模式：平台把审批事件 POST 到 ERP 的回调地址。需要 ERP 有公网可访问域名，且要把页面上的回调地址原样填到平台后台。
- Stream模式推送：由 ERP 侧的常驻进程主动与平台建立长连接接收事件，不需要公网回调地址，适合没有独立域名或内网部署的场景。选这个模式时回调地址一栏可以忽略。
步骤 4：复制回调地址
走 HTTP 模式时点 复制，提示 已复制到剪贴板，到平台后台的回调配置里粘贴。地址里带了本账套的标识，不同账套、不同平台互不相同，不要手抄或跨账套复用。
步骤 5：启用
最后打开 启用状态 开关再点 保存配置。顺序是有意的：凭证没填对就先启用，接口调用会持续报错；先保存凭证、确认无误，再启用。
四、字段详细说明
| 字段 | 含义 | 说明 |
|---|---|---|
| AgentId | 平台应用内的微应用/agent 标识 | 钉钉必填，用于消息与工作流接口 |
| CorpId | 企业在平台侧的唯一标识 | 与钉钉后台「企业 ID」一致 |
| AppKey / AppSecret | 应用身份与密钥 | 用于换取调用凭证，泄露等同交出应用权限 |
| CorpSecret | 企业微信应用密钥 | 企业微信页签下替代 AppKey/AppSecret |
| Token | 回调消息签名校验令牌 | 与平台后台事件订阅里的 Token 必须完全一致 |
| AES Key | 回调消息加解密密钥 | 与平台后台的 EncodingAESKey 对应，成对配置 |
| 回调模式 | 审批结果的回传通道 | HTTP回调模式 需要公网地址；Stream模式推送 不需要 |
| 启用状态 | 本平台是否参与本账套 | 关闭后绑定页与模板页不再取数 |
五、典型使用场景
首次开通钉钉审批。 平台侧建应用 → 复制四个必填参数填入 → 事件订阅里把 ERP 的回调地址粘过去，同时把平台后台的 Token、AES Key 回填到本页 → 保存 → 启用 → 到 用户绑定 点 同步钉钉信息 验证链路是否通。
没有公网域名。 回调模式选 Stream模式推送，凭证里 Token、AES Key 可以留空，保存并启用后由服务端长连接接收审批事件。
换应用或换密钥。 修改 AppKey/AppSecret 后先点 保存配置，再回 审批日志 看新提交的实例是否正常；旧实例的回调仍会按旧地址送达，不影响已经走完的审批。
六、权限控制与前置条件
- 页面入口在 系统 → 第三方平台 分组下，属于系统管理岗功能，普通业务岗看不到。
- 两级启用：本页的开关只是租户级。平台是否可用还取决于服务商侧为该账套开通的审批模式，未开通时强行启用会提示
系统管理员未开通该平台，请联系服务商。 - 页签里没有飞书的配置入口。用户绑定 顶部虽然有飞书页签，但没有凭证可配，因此无法在此配出可用状态。
- 凭证属于敏感信息，不要把本页截图外发，也不要贴在工单里。
七、常见问题
填完保存后开关自己回关了？ 说明服务商侧没为该账套开通这个平台，启用动作被拦下。按提示联系服务商开通审批模式，不是页面故障。
HTTP 和 Stream 选哪个？ 有稳定公网域名、要求审批事件秒级回传选 HTTP；账套在纯内网、或不想暴露回调地址选 Stream。两者只影响回传通道，业务效果一致。
回调验签失败会怎样？ 平台推送的加密消息校验不过时，ERP 不会更新审批状态，表现为「钉钉里已经审批通过，单据还在审批中」。九成是 Token 或 AES Key 与平台后台不一致，逐字符重填即可。
为什么企业微信启用了还是不能发起审批？ 企业微信侧当前只打通了组织架构与消息通道，不具备从 ERP 发起审批实例的能力。需要外部审批请走钉钉。
改动能立即生效吗？ 参数保存即落库，但生效以启用开关为准；已经提交出去的审批实例仍按提交时的配置走完，改配置只影响之后新提交的业务。