医院内镜室软件接口方案

1、文件状态：V草稿正式发布 正在修改文件标识：当前版本：作 者：完成日期：内镜室综合管理系统接口方案四川深蓝鸟科技有限公司2016年6月文档名称内镜室综合管理系统接口方案版本号版本日期2016年6月15日创建者深蓝鸟科技创建日期2016年6月15日版本修订历史版本号变更时间变更内容拟稿人审批人2016-6-15初稿一、接口目的实现数据共享、方便内窥镜室的检查工作和临床医生调阅病人的检查结果。内窥镜管理系统能获取到HIS系统的病人的基本信息、临床诊断、检查信息。HIS 系统能够查看内窥镜系统病人的检查的描述、结论、检查医生以及报告打印的图片等。二、接口技术实现方式所有的消息传递加工处理都通过 We

2、bService来完成自助设备系统与集成服务器之间均使用 XML式定义和传递接口格式由深蓝鸟公司方定义。三、接口描述1接口流程描述本接口根据事务提交方与应答方的不同，分为2类：第一类是由HIS方主动发起，内窥镜方负责应答消息；第二类是由内窥镜方主动发起，HIS方负责应答消息。1.1 HIS方主动发起事务1、检查申请发起方：HIS应答方：内窥镜发起事务时机： 医生开立检查申请后，发送本次内窥镜检查申请消息。2、 取消检查申请发起方： HIS应答方：内窥镜发起事务时机：当医生取消内窥镜检查申请后，发送本次内窥镜取消检查消息。3、 修改病人信息发起方： HIS应答方：内窥镜发起事务时机： HIS 修

3、改卡信息时，发送病人基本信息。4、 获取检查报告发起方： HIS应答方：内窥镜发起事务时机： HIS 根据需求获取内窥镜的检查结果。说明 ： HIS 方主动发起的事务需要引用内窥镜提供的WebService1.2 内窥镜方主动发起事务1、 更改医嘱状态发起方：内窥镜应答方： HIS发起事务时机： 预约登记：当患者持条形码前去内窥镜室预约登记时，会发送更改医嘱状态消 取消登记：当患者预约登记后，又未做检查，这个时候可以取消登记， 出检查报告：当内窥镜检查完毕后，说明：内窥镜方主动发起的事务需要引用HIS集成服务器提供的 WebService或者调用HIS方提供的存储过程2接口流程图2.1 HIS

4、主动发起事务内窥镜系统将处理结果返回给HIS2.2 内窥镜更改医嘱状态内窥镜系统更改HIS医嘱状态操作预约登记取消登记出检查报告取消检查HIS系统2.3 内窥镜回传报告3接口功能说明及定义3.1 HIS检查申请请求发出者：HIS系统请求处理者：内窥镜系统功能描述：HIS将患者内窥镜检查及基本信息发送给内窥镜系统，一个申请单只能发送一条检查项目接口定义：接口名称 AddPat接口协议Web Service+XML服务提供者内窥镜系统请求消息:名称描述数据类型备注必填ApplicationID申请单号String是PathologylD病历号StringPatTypelD病人类别（0门诊1住院）S

5、tring是PatHospID住院号StringPatMenlD门诊号StringPatCardID就诊卡号StringPatName病人姓名String是Sex性别String是Birthday出生日期StringYYYY-MM-ddAge年龄String是Phone电话StringAddress家庭地址StringOperateTime开单时间StringYYYY-MM-ddHH:mm:ss是ReqTypeID申请类型（0 一般1急诊）StringReqDeptID申请科室IDString是ReqDeptName申请科室名称String是ReqDoctorID申请医生IDString是Re

6、qDoctorNam e申请医生名称String是BedNO床位号StringAbstracthistory主诉StringDiagnose临床诊断StringOrdID制#项目IDString是OrdName申请项目名称String是ExecDeptID执行科室IDStringExecDeptName执行科室名称StringStatus申请状态String是Fee费用String请求消息XML格式说明<xml version=""><Request><ApplicationID>申请单号（20）</ApplicationID>

7、;<PatHospID>（住院号）000001</PatHospID><PatMenID>（门诊号）20</PatMenID><PatCardID> 就诊卡号 </PatCardID><PatName> 测试 </PatName><Sex> < </Sex><Birthday>2016/7/18 10:21:24</Birthday><Age>60</Age><Address> 家庭地址 </Addres

8、s><OperateTime>2016/7/18 10:21:24</OperateTime><ReqDeptName> 申请科室名称 </ReqDeptName><ReqDoctorName> 申请医生 </ReqDoctorName><BedNO>床号（4-5 ） </BedNO><Abstracthistory> 主诉（）</Abstracthistory><Diagnose> 临床诊断 </Diagnose><OrdID> 申

9、请项目 ID</OrdID><OrdName> 申请项目 </OrdName><Status> 状态 </Status><Fee></Fee></Request>应答信息标签说明数据类型备注ResultCode结果标志（1 -成功、0 -失败）Msg操作信息应答信息XML消息格式示例<xml version=""><Request><ResultCode>1</ResultCode><Msg>操作成功</Msg&g

10、t;</Request>3.2 HIS取消检查申请请求发出者：HIS系统请求处理者：内窥镜系统功能描述：HIS取消检查接口定义：接口名称DeletePat接口协议Web Service+XML服务提供者内窥镜系统请求消息:名称描述数据类型备注必填ApplicationID申请单号String是请求消息XML格式说明<xml version=""><Request><ApplicationID> 申请单号（20）</ApplicationID></Request>标签说明数据类型备注ResultCode结

11、果标志（1 -成功、0 -失败）Msg操作信息应答信息XML消息格式示例<xml version=""><Request><ResultCode>1</ResultCode><Msg>操作成功</Msg></Request>3.3 HIS更改病人基本信息请求发出者：HIS系统请求处理者：内窥镜系统功能描述：HIS更改检查接口定义：接口名称UpdatePat接口协议Web Service+XML服务提供者内窥镜系统请求消息:名称描述数据类型备注必填ApplicationID申请单号String

12、是PathologyID病历号StringPatTypeID病人类别（0门诊1住院）String是PatHospID住院号StringPatMenlD门诊号StringPatCardID就诊卡号StringPatName病人姓名String是Sex性别String是Birthday出生日期StringYYYY-MM-ddAge年龄String是Phone电话StringAddress家庭地址StringOperateTime开单时间StringYYYY-MM-ddHH:mm:ss是ReqTypeID申请类型（0 一般1急诊）StringReqDeptID申请科室IDString是ReqDept

13、Name申请科室名称String是ReqDoctorID申请医生IDString是ReqDoctorNam e申请医生名称String是BedNO床位号StringAbstracthistory主诉StringDiagnose临床诊断StringOrdID制#项目IDString是OrdName申请项目名称String是ExecDeptID执行科室IDStringExecDeptName执行科室名称StringStatus申请状态String是Fee费用String请求消息XML格式说明<xml version=""><Request><App

14、licationID>申请单号（20）</ApplicationID><PatHospID>（住院号）000001</PatHospID><PatMenID>（门诊号）20</PatMenID><PatCardID> 就诊卡号 </PatCardID><PatName> 测试 </PatName><Sex> < </Sex><Birthday>2016/7/18 10:21:24</Birthday><Age>60&

15、lt;/Age><Address> 家庭地址 </Address><OperateTime>2016/7/18 10:21:24</OperateTime><ReqDeptName> 申请科室名称 </ReqDeptName><ReqDoctorName> 申请医生 </ReqDoctorName><BedNO>床号（4-5 ） </BedNO><Abstracthistory> 主诉（）</Abstracthistory><Diagnos

16、e> 临床诊断 </Diagnose><OrdID> 申请项目 ID</OrdID><OrdName> 申请项目 </OrdName><Status> 状态 </Status><Fee></Fee></Request>应答信息标签说明数据类型备注ResultCode结果标志（1 -成功、0-失败）ErrorMsg操作信息应答信息XML消息格式示例<xml version=""><Request><ResultCode&g

17、t;1</ResultCode><Msg>操作成功</Msg></Request>3.4 HIS获取检查报告请求发出者：HIS系统请求处理者：内窥镜系统功能描述：HIS获取检查报告接口定义：接口名称GetReport接口协议Web Service+XML服务提供者内窥镜系统请求消息:名称描述数据类型备注必填ApplicationID申请单号String是请求消息XML格式说明<xml version=""><Request>< ApplicationID>123456</ Applic

18、ationlD ></Request>应答信息标签说明数据类型备注ResultCode结果标志（1 -成功、0-失败）ErrorMsg操作信息ApplicationID申请单号Description报告描述Diagnosis报告结论应答信息XML消息格式示例<xml version=""><Request><ResultCode>1</ResultCode><Msg>操作成功</Msg><ApplicationID>123456</ApplicationID>Description>这是描述/DescriptionDiagnosis 这是结论 </Diagnosis></Request>3.5 HIS获取申请状态请求发出者：HIS系统请求处理者：内窥镜系统功能描述：获取内镜检查状态接口定义：接口名称GetStatus接口协议Web Service+XML服务提供者内窥镜系统请求消息:名称描述数据类型备注必填ApplicationID申请单号String是请求消息XML格式说明<xml version="">