医院内镜室软件接口方案.doc

文件状态：
[√] 草稿
[　] 正式发布
[ ] 正在修改
文件标识：

当前版本：
V1、0
作 者：

完成日期：

内镜室综合管理系统接口方案

四川深蓝鸟科技有限公司
2016年6月
文档名称
内镜室综合管理系统接口方案
版 本 号
V1、0
版本日期
2016年6月15日
创 建 者
深蓝鸟科技
创建日期
2016年6月15日
l 版本修订历史
版本号
变更时间
变更内容
拟稿人
审批人
V1、0
2016-6-15
初稿

一、 接口目得
实现数据共享、方便内窥镜室得检查工作与临床医生调阅病人得检查结果。内窥镜管理系统能获取到HIS系统得病人得基本信息、临床诊断、检查信息。HIS系统能够查瞧内窥镜系统病人得检查得描述、结论、检查医生以及报告打印得图片等。
二、 接口技术实现方式
l 所有得消息传递加工处理都通过WebService来完成
l 自助设备系统与集成服务器之间均使用XML格式定义与传递
l 接口格式由深蓝鸟公司方定义。
三、 接口描述
1 接口流程描述
本接口根据事务提交方与应答方得不同，分为2类：第一类就是由HIS方主动发起，内窥镜方负责应答消息；第二类就是由内窥镜方主动发起，HIS方负责应答消息。
1.1 HIS方主动发起事务
1、 检查申请
发起方：HIS
应答方：内窥镜
发起事务时机： 医生开立检查申请后，发送本次内窥镜检查申请消息。
2、 取消检查申请
发起方：HIS
应答方：内窥镜
发起事务时机：当医生取消内窥镜检查申请后，发送本次内窥镜取消检查消息。
3、 修改病人信息
发起方：HIS
应答方：内窥镜
发起事务时机：HIS修改卡信息时，发送病人基本信息。
4、 获取检查报告
发起方：HIS
应答方：内窥镜
发起事务时机：HIS根据需求获取内窥镜得检查结果。
说明：HIS方主动发起得事务需要引用内窥镜提供得WebService
1.2 内窥镜方主动发起事务
1、 更改医嘱状态
发起方：内窥镜
应答方：HIS
发起事务时机：
① 预约登记：当患者持条形码前去内窥镜室预约登记时，会发送更改医嘱状态消息；
② 取消登记： 当患者预约登记后，又未做检查，这个时候可以取消登记，
③ 出检查报告：当内窥镜检查完毕后，
说明：内窥镜方主动发起得事务需要引用HIS集成服务器提供得WebService或者调用HIS方提供得存储过程
2 接口流程图
2.1 HIS主动发起事务

HIS系统
发送请求事务

内窥镜系统将处理结果返回给HIS
调用内窥镜系统接口将事务信息传入到内窥镜系统

2.2 内窥镜更改医嘱状态
内窥镜系统
HIS系统
更改HIS医嘱状态操作
预约登记
取消登记
出检查报告
取消检查

2.3 内窥镜回传报告
内镜系统
HIS系统
4、2、6 B超回传报告信息流程图
搭建IIS站点
参入参数调取报告

3 接口功能说明及定义
3.1 HIS检查申请
请求发出者：HIS系统
请求处理者：内窥镜系统
功能描述：HIS将患者内窥镜检查及基本信息发送给内窥镜系统，一个申请单只能发送一条检查项目
接口定义：
接口名称
AddPat
接口协议
Web Service+XML
服务提供者
内窥镜系统
请求消息：
名称
描述
数据类型
备注
必填
ApplicationID
申请单号
String

就是
PathologyID
病历号
String

PatTypeID
病人类别 (0门诊 1住院)
String

就是
PatHospID
住院号
String

PatMenID
门诊号
String

PatCardID
就诊卡号
String

PatName
病人姓名
String

就是
Sex
性别
String

就是
Birthday
出生日期
String
YYYY-MM-dd

Age
年龄
String

就是
Phone
电话
String

Address
家庭地址
String

OperateTime
开单时间
String
YYYY-MM-dd HH:mm:ss
就是
ReqTypeID
申请类型 (0 一般 1 急诊)
String

ReqDeptID
申请科室ID
String

就是
ReqDeptName
申请科室名称
String

就是
ReqDoctorID
申请医生ID
String

就是
ReqDoctorName
申请医生名称
String

就是
BedNO
床位号
String

Abstracthistory
主诉
String

Diagnose
临床诊断
String

OrdID
申请项目ID
String

就是
OrdName
申请项目名称
String

就是
ExecDeptID
执行科室ID
String

ExecDeptName
执行科室名称
String

Status
申请状态
String

就是
Fee
费用
String

请求消息XML格式说明

申请单号(21)
(住院号)000001
(门诊号)21
就诊卡号
测试
x>男
2016/7/18 10:21:24
60
ose>临床诊断
申请项目ID
申请项目
状态
125、50

应答信息
标签
说明
数据类型
备注
ResultCode
结果标志(1–成功、0 –失败)

Msg
操作信息

应答信息XML消息格式
示例

1
操作成功sg>

3.2 HIS取消检查申请
请求发出者：HIS系统
请求处理者：内窥镜系统
功能描述：HIS取消检查
接口定义：
接口名称
DeletePat
接口协议
Web Service+XML
服务提供者
内窥镜系统
请求消息：
名称
描述
数据类型
备注
必填
ApplicationID
申请单号
String

就是
请求消息XML格式说明

申请单号(21)
t>
应答信息
标签
说明
数据类型
备注
ResultCode
结果标志(1 –成功、0 –失败)

Msg
操作信息

应答信息XML消息格式
示例

1
操作成功

3.3 HIS更改病人基本信息
请求发出者：HIS系统
请求处理者：内窥镜系统
功能描述：HIS更改检查
接口定义：
接口名称
UpdatePat
接口协议
Web Service+XML
服务提供者
内窥镜系统
请求消息：
名称
描述
数据类型
备注
必填
ApplicationID
申请单号
String

就是
PathologyID
病历号
String

PatTypeID
病人类别 (0门诊 1住院)
String

就是
PatHospID
住院号
String

PatMenID
门诊号
String

PatCardID
就诊卡号
String

PatName
病人姓名
String

就是
Sex
性别
String

就是
Birthday
出生日期

String
YYYY-MM-dd

Age
年龄
String

就是
Phone
电话
String

Address
家庭地址
String

OperateTime
开单时间
String
YYYY-MM-dd HH:mm:ss
就是
ReqTypeID
申请类型 (0 一般 1 急诊)
String

ReqDeptID
申请科室ID
String

就是
ReqDeptName
申请科室名称
String

就是
ReqDoctorID
申请医生ID
String

就是
ReqDoctorName
申请医生名称
String

就是
BedNO
床位号
String

Abstracthistory
主诉
String

Diagnose
临床诊断
String

OrdID
申请项目ID
String

就是
OrdName
申请项目名称
String

就是
ExecDeptID
执行科室ID
String

ExecDeptName
执行科室名称
String

Status
申请状态
String

就是
Fee
费用
String

请求消息XML格式说明

申请单号(21)
(住院号)000001
(门诊号)21
就诊卡号
测试
男
2016/7/18 10:21:24
60
Address>
2016/7/18 10:21:24
申请科室名称
申请医生
床号（4-5）
主诉（）
临床诊断
申请项目ID
申请项目
状态tatus>
125、50

应答信息
标签
说明
数据类型
备注
ResultCode
结果标志(1 –成功、0–失败)

ErrorMsg
操作信息

应答信息XML消息格式
示例

1
操作成功

3.4 HIS获取检查报告
请求发出者：HIS系统
请求处理者：内窥镜系统
功能描述：HIS获取检查报告
接口定义：

接口名称
GetReport
接口协议
Web Service+XML
服务提供者
内窥镜系统
请求消息：
名称
描述
数据类型
备注
必填
ApplicationID
申请单号
String

就是
请求消息XML格式说明

< ApplicationID>123456

应答信息
标签
说明
数据类型
备注
ResultCode
结果标志(1 –成功、0–失败)

ErrorMsg
操作信息

ApplicationID
申请单号

Description
报告描述

Diagnosis
报告结论

应答信息XML消息格式
示例

1
操作成功
123456
这就是描述
这就是结论

3.5 HIS获取申请状态
请求发出者：HIS系统
请求处理者：内窥镜系统
功能描述：获取内镜检查状态
接口定义：
接口名称
GetStatus
接口协议
Web Service+XML
服务提供者
内窥镜系统
请求消息：
名称
描述
数据类型
备注
必填
ApplicationID
申请单号
String

就是
请求消息XML格式说明

< ApplicationID>123456

应答信息
标签
说明

数据类型
备注
ResultCode
结果标志(1 –成功、0–失败)

ErrorMsg
操作信息

Status
状态代码

StatusName
状态含义

应答信息XML消息格式
示例

1
操作成功
1
< StatusName>登记状态

四、 硬件需求
院方需提供一些硬件设备得支持，如服务器以替换科室服务器，以便数据传输方便并确保网络得稳定性。配置如下：
设备名称
设备要求与基本参数
备注
主网络服务器主机
基本配置：i7 CPU/16G内存/5T硬盘/双千兆网卡/集成显示芯片
系统要求：由院方安装windows server系统与SQL 2008数据库
可以由信息科机房直接分配虚拟服务器
网络需求
需要院方配合提供院内万兆网络，并要求能与内窥镜室内各个点之间得网络畅通与稳定

扫描枪
用于扫描病人申请单上得条形码以方便科室登记或预约病人信息