对接学工或 HIS，最常见的失败不是「接口调不通」，而是字段没对齐：人找到了却进错学院，或已退学的人仍在收测评链接。先打通身份与状态，再谈报告回写和单点登录，顺序反了返工最多。
身份主键：一人一键，冲突要有策略
学校侧常见学号；医院侧常见就诊号/病案号；企业侧常见工号。测评系统必须有且仅有一个主主键，并约定变更规则（学号变更、账号合并怎么处理）。接口要能返回明确的冲突码：主键重复、主键为空、主键已绑定其他人，而不是笼统报一个失败。对账报表每天应能列出「上游有、下游无」和「下游有、上游无」的差额人数，让信息中心一眼看到缺口。
不要用「姓名 + 出生日期」当主主键——重名会把不同人的档案拧在一起，事后极难拆开。
组织归属与在读/在职状态
学院/科室、班级/病区、年级或入职批次，决定任务下发范围和统计口径，是团报能不能分得清的前提。在读/在职/休学/离职状态决定能不能进入新任务：停用同步的优先级应高于「继续催测」——人已停用，链接就该失效或不再生成，否则退学生仍在收测评短信是很典型的投诉来源。组织变更（转专业、转科室）要明确规则：是直接覆盖，还是保留历史轨迹供追溯，两种口径对统计影响完全不同。还要约定同步延迟的容忍窗口：日批意味着当天新生、当天离职的人会有一天不同步，普查窗口紧时这一天的差就得靠人工名单补上。
最小回写：完成状态可以，完整报告要谨慎
第一期建议只回写三项：任务完成状态、完成时间、是否有效卷。完整报告、因子明细在回写到学工/HIS 之前，先过隐私与最小必要原则；很多单位其实更适合让报告留在测评系统内、按权限查看，而不是散落进多个业务库、扩大泄露面。真要回写敏感结论时，也建议只回写一个「是否需关注」的标记，具体因子分留在测评系统里凭权限调阅，既满足学工侧看到风险，又不把逐题数据铺开到人人可查的业务库里。
联调清单要写清：字段字典、同步频率（实时还是日批）、失败重试机制、对账方式。橙星云对接实施里，先把主键与停用同步跑稳，再开单点登录和报告回写，返工会少很多。对接的第一目标是「找对人、发对任务」，不是一次把所有表都打通——打通得越多，出问题时越难定位是哪一环错了。