信创环境下,如何用标准API将数字化采集终端接入现有OA/ERP系统(附代码)
最近接到一个需求:单位信创环境已全面运行——统信UOS + 达梦数据库 + 信创版OA。现在要在办公区部署一台数字化采集终端,将纸质合同、票据经高速馈送式扫描或书本式拍摄后,自动同步至OA系统。
约束条件很明确:不改现有信创架构,不动OA核心代码,不引入额外中间件。
调研后选定了会博通·龟仔妈妈信创版。本文记录对接全过程,供有类似需求的同行参考。
一、设备侧:开箱即用的信创终端
龟仔妈妈信创版已通过麒麟软件、统信UOS、达梦数据库互认证测试。设备出厂预装国产操作系统与数据库,上电即用,无需额外搭建运行环境。
硬件配置:国产CPU / 32GB RAM / 512GB SSD + 2TB HD / 23.6寸电容触控屏。集成高速馈送式扫描模块(不低于20页/分钟,如果是单层PDF,可达40页以上)、书本式高拍模块(2500万像素/300DPI)、RFID阅读器、条码识别器、双目摄像头、指纹模块、身份证阅读器。
二、接口架构:回调推送 + 主动下载,零侵入
核心对接逻辑:
- 用户在龟仔妈妈上完成高速馈送式扫描或书本式拍摄,文件上传至会博通服务器;
- 服务器自动生成文件元数据(FileName、MD5、CardID、CatID、Sequence、Type、Prop字典等);
- 会博通向第三方系统的回调接口(CallBlackUrl)发送POST请求,推送元数据;
- 第三方系统接收并处理,返回 {"success": true};
- 第三方系统按需调用文件下载接口获取文件二进制内容;
- 推送失败时系统自动重试,第三方亦可主动查询失败记录触发重推。
设计要点:回调接口只推元数据,不传文件内容。信息流与数据流解耦,第三方系统的回调接口极其轻量。
三、第三方侧:一个Controller方法搞定
ASP.NET Core示例(Java Spring同理):
csharp
编辑
1[HttpPost(Name = "PushMsg"), ActionName("PushMsg")]
2public Results PushMsg(PushData pushData)
3{
4_logger.Log(LogLevel.Debug,
5$"接收文件元数据: {JsonConvert.SerializeObject(pushData)}");
6// 业务处理:写入本地数据库、触发OA流程等
7return new Results { success = true };
8}
PushData结构:FileName、MD5、CardID、CatID、Sequence、Type、Prop(字典,含主题、责任者、日期、编号、密级、保管期限、档号等字段)。
文件内容获取:Bearer Token认证,调用 Module/ReadFile/FileDownLoad.aspx,传入CID、Sequence、Suffix,返回文件流。
四、安全机制
- 登录接口:RSA加密传输用户名/密码;
- 接口认证:Bearer Token校验;
- 权限控制:接口账户专户专用,权限可按文件分类框架精细配置;
- 设备端认证:人脸、指纹、身份证、密码、微信扫码,支持组合验证,满足等保要求。
五、部署配置
会博通工程师配置 SingleUpLoadOtherSystem.json,填入第三方系统名称与回调URL,即完成推送规则配置。全程不需要修改OA/ERP的任何代码。
总结
这套方案的优雅之处在于——信创架构不动,OA代码不改,数据库不碰。龟仔妈妈信创版作为一个"旁路式"数字化采集节点,通过标准API无感接入现有信创体系。对于正在做信创适配的同行,这种"零侵入"集成方式,值得参考。
全域无界,全场景无碍。
用一种设备,一套标准,实现机构的全域、全场景数字化,应选择龟仔妈妈。