当前位置：
体检系统和his系统的对接要点
核心对接目标：一套患者档案、统一收费、数据互通、财务一体化对账，杜绝重复建档、重复收费、数据割裂。
一、对接前必须统一基础主数据（重中之重，80%对接故障根源）
1. 患者基础信息标准
- 统一身份标识：身份证号 / 院内就诊卡号作为唯1主键；
- 姓名、性别、出生日期、联系电话字段长度、字符编码统一（建议UTF-8）；
- 禁止两套系统独立建档，避免同一人体检档案、门诊档案两条数据。
方案：优先由HIS作为患者主索引，体检系统新增人员时先调用HIS接口查询，存在则直接复用档案。
2. 收费项目字典统一
- 体检套餐内所有单项（检验、放射、内外科等）项目编码必须两边完全一致；
- 统一单位、收费标准、医保属性、项目分类；
- 新增收费项目，要求同步维护HIS、PEIS两套字典，建立项目新增审批流程。
3. 科室、操作员权限编码统一
两边科室编号、工号保持一致，方便日志追溯、权限联动。
二、标准双向接口业务清单（主流两种对接模式）
模式A：一体化同厂商
不需要复杂webservice接口，共享同一数据库或者内部消息通道，稳定性蕞高。
1. PEIS系统→HIS系统（正向）
- 体检开单信息推送HIS生成收费记录
- 体检收费、退费单据回写HIS财务流水
2. HIS系统→ PEIS系统（反向）
- 读取HIS患者档案
- 获取缴费状态：已缴费方可启动体检流程
- 体检异常患者支持转诊至HIS门诊
模式B：不同厂商异构对接（WebService/Http接口）
【接口1】患者信息查询接口（HIS提供）
PEIS建档前调用，查询患者是否存在院内档案。
【接口2】体检费用推送接口（PEIS→HIS）
体检登记开套餐后，自动推送收费项目，在HIS产生待收费账单。
可选两种模式：
① PEIS只开单，收费窗口全部在HIS完成。
② PEIS内完成收费，缴费结果回传给HIS。
【接口3】缴费状态同步接口（HIS→PEIS）
患者缴费成功后，HIS推送缴费标记；体检系统收到标记后，打印条码、允许参加体检。
【接口4】退费接口（双向）
体检退费操作同步两边系统，保证财务数据一致。
【接口5】转诊接口（PEIS→HIS）
体检重大阳性人员，一键发起门诊转诊，自动在HIS建立门诊预约。
三、条码体系对接要点（极易忽略）
1. 体检条码规则全局统一；
2. 如果体检同时对接LIS检验系统：PEIS条码 = LIS采样条码；
3. 条码信息至少包含：唯1编号、体检编号、患者ID。
故障现象：条码不统一 → 检验结果无法自动回入体检报告。
四、网络与部署对接要求
1. 两套服务器部署在医院内网，接口通讯仅在内网交互，禁止接口对公网开放；
2. 服务器固定静态IP，防火墙开放接口通讯端口；
3. 接口服务设置开机自启动；
4. 建议单独划分内网VLAN，避免广播风暴导致接口消息丢失。
五、实施上线关键控制点
1. 先静态主数据核对，再调试动态接口
不要直接调试接口！先导出两边收费项目表比对编码，清理不匹配项目。
2. 搭建测试环境先行联调
测试环境完全复刻正式库，模拟：开单、缴费、退费、团体套餐、转诊全流程。
3. 接口增加消息重试机制
网络波动会导致消息丢失，接口必须支持失败重推；同时记录完整接口日志。
4. 上线初期开启双日志
保留接口推送日志、HIS收费流水，方便每日对账。
六、高频对接故障与解决方案
1. 体检开单后，HIS看不到收费记录
原因：项目编码不一致、接口服务停止、网络中断、消息推送超时。
解决：查看接口日志；核对项目编码；重启接口服务，手动触发重推。
2. 患者缴费成功，体检系统仍然显示未缴费，无法打印条码
HIS缴费状态推送丢失；排查接口日志；手动同步缴费状态。
3. 财务对账不平（PEIS营收 ≠ HIS营收）
- 退费流程不同步；
- 部分单据推送失败；
- 存在作废单据未同步；
解决：每日利用接口日志进行双向对账。
4. 同一患者重复建立档案
未调用HIS患者查询接口；强制体检登记先检索HIS档案。
5. 团检批量导入人员无法正常收费
导入人员缺少身份证号，无法匹配HIS患者主索引。
七、业务流程规范（避免接口没问题，业务操作出问题）
推荐标准流程（财务合规首选）
1. 体检窗口PEIS录入信息、选择套餐，生成待收费信息；
2. 患者前往收费处（HIS）完成缴费；
3. HIS缴费成功推送状态至PEIS；
4. PEIS收到缴费标记，打印体检条码，开始体检。
八、验收核心检查项（实施完成逐项确认）
1. 新客户登记：优先读取HIS患者档案，无档案才新建；
2. 个人套餐、团体套餐开单，均可正常推送HIS；
3. 缴费成功状态实时回传；
4. 退费操作两边系统同步；
5. 接口中断恢复后，消息能够自动补推，不会丢单；
6. 支持重大阳性体检人员一键转诊HIS门诊；
7. 保留完整接口交互日志，至少保存6个月；
8. 每日导出数据，双向对账无差额。
九、安全管控要点
1. 接口增加身份验证、密钥校验，防止非法调用；
2. 禁止直接通过数据库视图、触发器实现对接（后期升级极易崩溃，优先标准API接口）；
3. 重大版本升级前，暂停接口，完整备份两套数据库；
4. 不允许直接在数据库层面修改收费、体检业务数据。
上一篇 
