亿家健康对接接口方案0.docx

R 川业软件 []初稿 [√]发布 []修订 编撰： 张爱民 编撰日期： 2017-12-08 保密级别： 机密 文档版本： 1.0 文件编号： Q/BS-QH-3-08 亿家健康对接 接口方案 创业软件集团 项目组版本历史 日期 版本 说明 作者 2018-02-18 V1.0 初稿 张爱民 1.概述 1.1.编写目的 HI-云HIS(以下简称HIS)与亿家健康APP(以下简称APP)进行对接接口开发，系 统设计过程中需满足亿家健康诊疗业务实时性要求。 1.2.术语和定义 略 1.3.注意事项 1、每个业务接口分为服务提供者、调用方、服务名、方法名、传入参数、返回参数。 2、考虑接口方法并发性问题，防止主键冲突。 3、HIS接受一次请求的最大数据条数为200条。 2.概述 2.1.业务场景 个人：个人登录APP端，选择科室或医生，能够选择医生进行签约操作，签约效期内在线期间能够实时向签约医生发起就诊申请；也能够查看医生的排班信息并操作预约，预约成功后，在预约效期内登录APP,确认待诊后等待医生发起就诊。通过视频通 话、语音、在线聊天等完成在线诊疗，等待医生完成病历书写和医嘱开立，能够查看 HIS端推送的本次诊疗的费用以及医嘱，并通过APP完成支付。 医生：医生登录HIS端，查看待诊病人列表，选择病人就诊，通过视频通话、语音、 在线聊天等完成在线诊疗，书写病历，开立医嘱后结束就诊。 阶段 阶段 2.2.业务流程 云门诊业务流程 云门诊业务流程 个人医生第三方外包服务 个人 医生 登录APP端 预约签约 预约 接诊准备就诊 接诊 在线诊疗 病历书写 医嘱开立 费用结束就诊 费用 在线支付信息推送 在线支付 2.3.数据流程 APP所需的数据，按流转时效来分，分为两部分：1、需要实时交换的，2、不需要实时交换的。所有实时的数据交换都采用消息中间件或WEB服务来实现；所有非实时的数据交 换采用消息中间件、WEB服务或数据交换平台来实现。 APP端 APP端 开始 获取数据 预约请求 预约成功 待诊申请 保存数据 付费结果推送 排班数据提交 保存数据 HIS端 请求应答 厂提交排班查询] 请求 诊疗数据推送 保存数据 获取数据 返回结果 接诊 具体的数据接口类型以及实现方式详见3.1接口清单。 2.4.网络拓扑 云平台 请 求 请 求 个人 PC嘴 医生定 医生 HI-云HS散据库服务图 HI-云HS 散据库服务图 应用服务器 MAC熵 2.5.验证机制 暂不考虑。 2.6.实时数据质控 2.6.1.实时数据交换的质控 因通过接口产生交互数据实时进入HIS库，对于上传的数据，特别是不使用通用字典 的数据，需进行一定的质控，以避免上传无效数据，影响系统整体运转的情况。 主要需考虑以下几个问题： ●每一个数据接口的数据质量要求(必填项、允许值范围等)。 ●不合格数据的处理反馈机制。 ●不合格数据的修改、重报机制。 以上问题需结合实际业务进行分析解决。 2.6.2.应用系统的质控 初步考虑同上。 2.7.传输效率验证 因接口设计阶段尚未考虑和涉及较为复杂的网络环境，该问题尚未考虑，建议考虑搭建 一个简易测试环境进行测试。 2.8.数据交换日志 ●对每一笔数据交换均进行详细的日志记录； ●日志记录允许APP、HIS端查询； ●为减少数据量，对超出一定时间的日志进行归档。 2.9.网络或应用接口故障 应用系统接口应具备容错性，当发生网络故障或第三方应用故障时，能保证系统在一定 范围内的正常运转，并在故障恢复后尽快恢复系统正常运转。 ●无法获取数据时，显示相对应的提示消息，如不影响业务的开展，允许继续执行业务操作； ●无法传输数据时，对待传输数据进行标记，并在系统恢复后续传； ●发生故障时均需记录详细日志以便排查错误原因。 3.接口设计 3.1.接口清单 序号 名称 数据类型 实现方式 说明 1 排班 实时 2 预约 实时 3 接诊 实时 4 诊疗信息 实时 3.2.排班 3.3.预约 3.4.就诊 3.5.诊疗信息 4.附录 无