总览看板
发放状态分布
8月工资条
已确认
已查看
已送达未读
未送达
本轮应发合计
--
本轮实发合计
--
待办提醒
近 6 个月发放趋势
实发合计（万元）部门人均实发
工资条管理
查看历史发放记录，按状态与员工筛选，支持撤回与重发
| 员工 | 工资年月 | 部门 / 岗位 | 应发合计 | 实发工资 | 发放状态 | 发放时间 | 查看时间 | 操作 |
|---|
发放工资条
上传工资表 → 确认匹配 → 预览表格数据 → 设置工资条 → 发送工资条
1上传工资表
2确认匹配
3预览表格数据
4设置工资条
5发送工资条
上传工资表 对应钉钉智能工资条「导入并预览」的第 1 步
点击「选择工资表」，或将 .xlsx / .xls / .csv 文件拖到此处
系统将智能解析表头与数据，自动生成工资条
必填姓名
与钉钉通讯录姓名匹配，定位收件员工
必填实发工资
系统识别后显示在员工工资条上方醒目位置
推荐工号 / UserID
唯一标识，可精确匹配且不受重名影响
支持任意格式的 Excel 工资表，无需与模板完全一致。表头中出现的「姓名」「实发工资」为必需字段，其余列将自动识别为薪资项目。单文件建议不超过 50MB。
准备工资表 不知道 UserID / 工号？先拿到员工标识再填表
「下载员工信息」包含姓名、工号、UserID、部门，填入工资表即可精确匹配
没有现成文件时，可先用示例数据跑通全流程
定时发送
设定发薪日自动发放，节假日无需守在电脑前
到时间后系统会自动发放，准点发出：应用开着时精确到秒，没人开应用时由云端每分钟执行一次。
发送前请确保员工已同步到钉钉通讯录、且应用已开通「工作通知」权限，否则会如实记为发送失败。
发送前请确保员工已同步到钉钉通讯录、且应用已开通「工作通知」权限，否则会如实记为发送失败。
| 任务名称 | 所属月份 | 计划发送时间 | 人数 | 状态 | 操作 |
|---|
发放统计
查收状态实时反馈，及时跟进未读员工
各部门查收率
分组统计
按统计列（可多选）
未查收名单
| 员工 | 部门 | 实发工资 | 状态 / 未收到原因 | 操作 |
|---|
员工与部门
工资条发放对象来源，正式接入后同步自钉钉通讯录
部门分布
字段映射
已映射姓名name → 通讯录 name
工号jobNumber → 通讯录 jobNumber
UserIDuserId → 通讯录 userid
部门dept → 通讯录 department
手机号mobile → 通讯录 mobile
| 员工 | 工号 | 部门 | 岗位 | 手机号 | 查看密码 |
|---|
设置
工资条发放规则与钉钉应用接入配置
默认发放规则
员工首次查看需设置 4 位数字密码
超期后需联系平台处理
按发放月份计算，超期的批次会列在下方
这些设置会保存在云端、多台设备共用。五项都会真的生效：
· 匹配方式 = 导入工资表时默认用哪一列认人（向导里还能临时改）
· 发薪日 = 新建定时任务 / 定时发送时预填的计划日期
· 查看密码 = 员工首次查看需设置 4 位密码，立即生效
· 撤回窗口 = 超窗口后「撤回工资条」不可用，一键撤回会跳过并说明
· 数据保留 = 算出超期批次（列在下方，确认后才清理，系统不会自动删）
· 匹配方式 = 导入工资表时默认用哪一列认人（向导里还能临时改）
· 发薪日 = 新建定时任务 / 定时发送时预填的计划日期
· 查看密码 = 员工首次查看需设置 4 位密码，立即生效
· 撤回窗口 = 超窗口后「撤回工资条」不可用，一键撤回会跳过并说明
· 数据保留 = 算出超期批次（列在下方，确认后才清理，系统不会自动删）
钉钉应用接入
待接入以下凭证用于调用钉钉开放平台接口：免登（识别员工身份）、同步通讯录、发送工作通知。
这四项不在本页填（由服务端管理）—— 下面是「钉钉后台叫什么 ↔ 服务端哪个变量」
| 参数 | 钉钉后台里叫 | 配在哪儿 |
|---|---|---|
| AppKey | Client ID（原 AppKey 和 SuiteKey） | 环境变量 DINGTALK_CLIENT_ID |
| AppSecret | Client Secret（原 AppSecret 和 SuiteSecret） | 环境变量 DINGTALK_CLIENT_SECRET（加密存储，前端从不接触） |
| AgentId | 原企业内部应用 AgentId（纯数字） | 环境变量 DINGTALK_AGENT_ID |
| CorpId | 不在「凭证与基础信息」页 | 自动记录 —— 员工从钉钉工作台打开应用时自动记下，不用配 |
这四项由服务端管理，本页不显示、也不能修改。
部署时向导会把它们写进服务端（Cloudflare 的 Pages secrets / 自建服务器的 env.json）， 前端从不接触；本页也不提供输入框 —— 谁都不需要把它们粘进网页，也就不存在「被看到 / 被改掉」的问题。
为什么这么严：这几项一旦被改动， 会表现为「通知发不出去」或「员工点通知打不开工资条」， 而界面上看起来一切正常 —— 属于改坏了极难排查的配置。 所以只允许在部署时写一次。
需要更换（比如在钉钉后台重置了密钥）：重新跑一次部署向导， 或到 Cloudflare 环境变量 / 服务器上的 env.json 改。 本页的其它设置都不受影响。
部署时向导会把它们写进服务端（Cloudflare 的 Pages secrets / 自建服务器的 env.json）， 前端从不接触；本页也不提供输入框 —— 谁都不需要把它们粘进网页，也就不存在「被看到 / 被改掉」的问题。
为什么这么严：这几项一旦被改动， 会表现为「通知发不出去」或「员工点通知打不开工资条」， 而界面上看起来一切正常 —— 属于改坏了极难排查的配置。 所以只允许在部署时写一次。
需要更换（比如在钉钉后台重置了密钥）：重新跑一次部署向导， 或到 Cloudflare 环境变量 / 服务器上的 env.json 改。 本页的其它设置都不受影响。
AppKey / AppSecret未检测 —— 点下面的「测试连通性」
AgentId由服务端配置；缺失时发送会明确报错
CorpId未检测
网页应用：首页地址怎么填
免登入口
开发者后台「网页应用」里的移动端首页地址 / PC 端首页地址，现在默认是
https://www.dingtalk.com（钉钉的占位示例），必须改成你自己的工资条地址，
否则点开应用只会跳到钉钉官网。生效端勾选「移动端、PC 端」。
移动端首页地址
https://你的域名/index.html?corpId=$CORPID$
PC 端首页地址
https://你的域名/index.html?corpId=$CORPID$
管理后台地址
https://你的域名/index.html（可选）
生效端
移动端、PC 端
服务器出口 IP
调服务端 API 时填服务器公网 IP（纯前端免登可不填）
要点：① 必须是 https 开头且已备案/可公网访问；
② 带上 ?corpId=$CORPID$，钉钉会替换成真实 CorpId，方便做免登与数据隔离；
③ 改完地址要发布版本才生效（页头那句「版本发布后，当前修改才能生效」）。
接入所需权限
通讯录qyapi.contact.readonly
工作通知qyapi.message.send
身份验证qyapi.auth.getuserinfo
互动卡片qyapi.card.write
管理权限
工资数据是公司的敏感数据，智能工资条采用独立于钉钉的权限体系保护薪酬数据安全
HR
—
数据范围：全部员工
主管理员
有且只有 1 人智能工资条的所有权限都由工资条主管理员控制。转让主管理员后，原主管理员会立即失去所有权限，请谨慎操作。钉钉主管理员若未被添加为主/子管理员，同样只有普通员工权限，无法登录后台。
转让后你将降为普通员工
子管理员
2 人子管理员可以发工资条，并管理工资表「管理员」中包含自己的工资条数据
权限操作留痕
最近 50 条角色权限
| 权限点 | 主管理员 | 子管理员 | 普通员工 |
|---|
子管理员权限开关
决定子管理员在「工资条管理」「发放统计」里能看到多少人的数据，
以及能发给谁（发放也按这个范围挡，服务端强制）。
⚠️ 选「全公司」= 他能看到、也能发放所有人的工资条 —— 相当于一个不能改权限的管理员。
⚠️ 选「全公司」= 他能看到、也能发放所有人的工资条 —— 相当于一个不能改权限的管理员。
前两个开关服务端也会校验（不是只在界面上藏按钮）：
· 关掉「允许发放」→ 他发不了通知、也排不了定时任务；
· 关掉「允许二次编辑」→ 他改不了已经存在的工资条 （新月份 / 新员工仍可新增，那属于发放）。
两个都关 = 只能看，不能动。数据范围（上面那个）也一起生效。
· 关掉「允许发放」→ 他发不了通知、也排不了定时任务；
· 关掉「允许二次编辑」→ 他改不了已经存在的工资条 （新月份 / 新员工仍可新增，那属于发放）。
两个都关 = 只能看，不能动。数据范围（上面那个）也一起生效。
安全设置
共享屏幕 / 截图沟通时避免无意泄露同事薪资，随时可点「显示金额」展开
员工进入智能工资条前需输入 4 位数字密码
关闭后刷新页面将回到默认权限矩阵
员工端预览
以员工视角查看工资条在钉钉中的呈现效果
钉钉工作通知
工
智能工资条
刚刚
您好，您本月工资条已生成，请点击查看详情。
钉钉工作通知会在手机锁屏预览、群聊引用、会话列表里露出正文。金额一旦写进正文，就可能被同事或旁人看到，因此默认不在通知正文展示任何薪资数据，员工点击后经密码二次验证才可见。正式接入后，此通知由钉钉工作通知（message/send）推送，员工点击直达 H5 工资条页面。