大家好，我是从事会博通应用开发的开发工程师。今天记录一次人事档案系统对接会博通·龟仔妈妈的实战过程，分享一些实际开发中的细节和踩坑经验。

背景

客户现有人事档案系统：Java + Spring Boot + MySQL，部署在统信UOS上。

需求：实现干部人事档案的批量扫描建档、OCR识别、元数据推送。

对接方案

龟仔妈妈通过会博通系统提供标准HTTP API接口，采用JSON数据格式。对接分为两个阶段：会博通推送配置与第三方回调接口开发。

第一步：会博通配置推送参数

技术支持工程师编辑配置文件，添加第三方系统的推送规则，包括第三方平台名称标识和回调接口地址。这里要注意，OtherName是第三方系统的唯一标识，CallBlackUrl必须支持POST请求且网络可达。

第二步：人事档案系统开发回调接口

人事档案系统需开发一个HTTP接口，用于接收会博通推送的文件元数据。以下是我们实际项目中的核心逻辑：

java

@PostMapping("/api/v1/hr/archives/callback")

public ResponseEntity<String> handleArchiveCallback(@RequestBody ArchiveMetadata metadata) {

// 1. 验证Token

if (!tokenService.validate(metadata.getToken())) {

return ResponseEntity.status(401).body("Invalid token");

}

// 2. 保存元数据（文件名、MD5、人员ID、文件ID、顺序号、操作类型、扩展属性等）

archiveService.saveMetadata(metadata);

// 3. 更新人事档案系统档案状态

hrService.updateArchiveStatus(metadata.getEmployeeId(), "DIGITIZED");

return ResponseEntity.ok("Success");

}

重点提醒：回调接口仅接收文件元数据，不传输文件内容。文件内容需第三方后续通过Bearer Token认证，主动调用会博通文件下载接口获取。这个设计的好处是解耦，回调轻量，文件按需拉取。

第三步：测试验证

身份证刷卡登录：操作者将身份证置于读卡区完成登录验证，系统记录操作人身份。

批量扫描：放入档案，自动双面扫描，OCR生成双层PDF。

元数据推送：处理完自动推送到人事档案系统回调接口。

第四步：失败处理与重试

实际生产中，网络抖动或接口异常难免发生。会博通的机制是：推送失败自动记录错误并定时重试。我们也在人事档案系统侧做了兜底，主动调用会博通的失败推送查询接口，获取未成功记录数量并触发重推。双重保障，数据不会丢。

扩展思考

如果客户没有人事档案系统怎么办？这种情况下，我们团队通常推荐会博通人事档案管理系统配合龟仔爸爸。龟仔爸爸与会博通系统深度直连，无需开发回调接口，数字化采集与档案审核、借阅、变更管理原生一体，部署更快，性能更优。