预约挂号平台HIS接口设计

文档编号： 密 级：

预约挂号系统

接口设计说明书 （HIS部分）

编制： 审核： 批准：

2010年 10

文档修改记录

编号 1 2

版本号 V1.0.0 V1.0.1 修订日期 2010-11-1 2010-12-10 创建 修订说明 编写者 汪凌 汪凌 审核者 1 总体设计

1.1 总体要求

预约挂号系统平台与各医院HIS之间是一对多的接入关系，因医院HIS系统各不相同：建设厂家不同，版本不同，环境不同；与平台间的网络连接方式也存在差异。为保证平台的兼容性和可扩展性，要求该接口规范具备高通用性，可跨平台、跨语言实现，且适用于不同的网络环境和硬件设备。

1.2 系统拓扑

VPN专线管理后台前置服务器WEB服务器数据库主数据库备预约挂号平台服务商统一接口12580VPN专线114VPN专线预约挂号服务平台线N专浙江在线VPN专线VP96365医院医院HIS前置医院HIS系统管理后台数据库主数据库备

1.3 模块说明

本文档涉及的接口应用布署于拓扑图中的“医院His前置”上。 预约挂号系统包括两大类应用：

一． HIS向预约挂号平台上传预约挂号系统所需的基本信息（如：医院信息、科室

信息、医生信息、排班信息、停诊信息等）和其他交易信息（如：患者预约后

二．

三．

的实际就诊情况、患者投诉情况、患者注册信息等）。该类交易平台为服务端，HIS为客户端。平台方提供DLL函数接口，供HIS调用。

平台向HIS发起的实时交易请求（如：预约挂号、预约取消、患者信息向医院传送等）。该类交易平台为客户端，HIS为服务端。HIS提供存储过程供平台调用。

详细业务部分请参阅《省预约挂号平台业务操作规范.doc》

2 平台与医院HIS接口

平台与医院HIS前置之间采用TCP/IP通讯协议，建立两对SOCKET端口（互为客户/服务端）：一对用于医院HIS系统发起的交易（HisToEbs），一对用于平台发起的交易(EbsToHis)。其中客户端作为发送数据端口，服务端作为接收数据端口。HIS作为客户端时，通过调用平台提供的DLL函数发起交易请求；HIS作为服务端时，向平台开放存储过程。

交易方式采用短链接的方式。在一个TCP/IP连接上完成数据包的发送和接收，在成功发送了一个数据包，并收到成功应答后，即中断该连接。

HisToEbs和EbsToHis均采用同步方式。 文件传输采用FTP方式。

2.1 HisToEbs

该接口主要用于HIS系统向平台传输院方相关基础及变更信息，如：医院介绍、科室设置、医生、排班等。

该接口的实现采用HIS调用Dll函数的方式，Dll函数接口由平台提供。函数封装了底层通讯协议和交易逻辑。

2.1.1 初始化服务器设置

Int SetIpAndPort(char*szHospitalID,char *szIp,int nPort)

函数说明：设置医院编号、His Server（HIS前置）的ip和端口号。在HIS系统启动（初始化）时加载调用，必须先调用该函数进行初始化，否则会提示调用失败。 输入参数：szHospitalID 医院ID，由省平台统一分配（6位字符）

szIp HIS前置服务器的ip，如192.168.1.202，具体到实施时确定

nPort HIS前置服务器的port，如8098（最大65535），具体到实施时确定 输出参数：无 返回值：0 成功

1 连接服务器失败

2.1.2 HIS数据上传

Int SendPack(char *szTradeCode,char *szOperNo,char *szSendContent,char *szRet); 函数说明：向中心服务器发送数据通讯包

输入参数：szTradeCode （字符串） 交易代码（4位字符） szOperNo （字符串） his系统中的操作员号 szSendContent （字符串）本次发送的数据报文

输出参数：szRet （字符串） 调用成功返回交易定义的返回结果，调用失败则为调用失败的具体原因，如报文格式不正确等。 返回值：0 调用成功

1 调用失败

附：szTradeCode 的取值说明 1101 医院信息上传处理 1102 科室信息上传处理 1103 医生信息上传处理 1104 排班信息上传处理 1105 停诊信息上传处理 1106 预约就诊情况上传处理 1108 患者姓名信息修改

szSendContent 的取值格式：各字段间以“|”分隔，如内容为空则直接加“|”。

处理结果存放在szRet中，szRet的取值格式：各字段间以“|”分隔，如内容为空则直接加“|”。

2.1.2.1 医院信息上传

序号 字段 1 1 2 3 4 5 6 7 8 9 变更类型 医院名称 医院机构代码 医院介绍 地址 医院等级 医院性质 医院类别 公开电话 网址 类型/长度 Char/1 Varchar2/50 Varchar2/6 Varchar2/1000 Varchar2/100 Char/4 Char/4 Char/4 Varchar2/50 Varchar2/50 1：修改； 医院全称 备注 必填 y y y y y y y n n n 三甲;三乙? 公立;民营;合资;外资;其他 综合;专科 加区号

本文来源：https://www.bwwdw.com/article/sndv.html