(完整word版)预约挂号平台HIS接口设计

文档编号：

密级：

预约挂号系统

接口设计说明书

（HIS部分）

编制：

审核：

批准：

2010年 10

文档修改记录

1总体设计

1.1 总体要求

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

1.2 系统拓扑

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.2HIS数据上传

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医院信息上传

2.1.2.2科室信息上传

2.1.2.3医生信息上传

2.1.2.6预约就诊情况上传

2.1.2.7 患者姓名信息修改

2.2 EbsToHis

该接口用于平台向医院HIS 提交实时交易请求，并获取HIS 方交易结果。

该接口由

HIS 提供数据库存储过程包。HIS 前置机布署了HisServer 程序，接受到平台交易任务后，调用该接口包中的存储过程来完成交易。

HIS 系统对平台提供一个数据库存储过程包，包名为：BookPackage ，存储过程名为：BizExec 。该存储过程有4个参数。

2.2.1 患者信息传送到医院并验证（HIS ）

本平台为实名使用，因此患者在平台注册时需提供个人必备的身份信息，平台在本地记

录患者信息。当该患者通过平台向某家医院预约挂号时，需将相关信息传送到医院HIS系统，如果该患者填写了本人医保卡、市民卡或就诊卡等信息时，将这些信息同步传送到医院进行校验。同一个有效证件号码只允许注册一条记录，未成年人通过此平台预约挂号，看病时需持有效证件。

交易名称：患者信息注册（医院）

功能说明：把患者在平台注册的信息传送到医院HIS系统中，同一个有效证件号码只允许注册一条记录(未成年人看病需持有效证件)，这个规则由平台实现。

交易类型：2001

输入参数：该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个患者信息。字段说明如下表：

交易结果：0（成功）或者1（失败）

输出参数：

如果交易成功：

如果交易失败：

His交易处理逻辑：

当前置机调用本交易时，接口首先根据患者ID查找HIS内是否存在患者记录，如果存在，则修改；否则插入新的记录。

2.2.2预约挂号

患者在与平台对接的服务商处进行医院、科室、医生、排班（何时就诊）的选择，确定某一排班后提交预约挂号请求，由平台将该预约请求提交医院His系统。

交易名称：预约挂号

功能说明：患者在与平台对接的服务商处进行预约挂号，由平台将预约请求提交医院His 系统。

交易类型：2002

输入参数：该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个预约信息。字段说明如下表：

交易结果：0（成功）或者1（失败）

输出参数：

His交易处理逻辑：

当前置机调用本交易时，接口应判断患者预约的号源是否可用。

2.2.3取消预约

该交易为“预约挂号”交易的反向交易，即对原交易进行取消。

注意：业务约定，就诊当天7点开始后不能取消预约

交易名称：预约挂号取消

功能说明：患者在与平台对接的服务商处进行预约挂号的取消，由平台将预约取消请求提交医院His系统。

交易类型：2003

输入参数：该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次

交易结果：0（成功）或者1（失败）

输出参数：

2.2.4查询预约结果

该交易查询某笔预约交易在HIS的交易状态，在特殊情况下（如网络异常）当不确定双方交易状态是否一致的时候，用来确认His方的交易状态。

交易名称：查询预约结果

功能说明：平台发起向His 查询某笔预约交易的结果。 交易类型：2004

输入参数：该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个预约取消信息。字段说明如下表：

交易结果：0（成功：该号源已经被预约，不可再次预约）或者1（失败：该号源未被预约，可以被预约） 输出参数：

如果交易失败：

2.2.5 患者姓名信息修改

因平台为实名使用，当患者在平台登记的姓名信息有误时，

将无法正常就诊。若患者在平台登记信息时将姓名信息登记错误，则可发起此交易，修改平台患者姓名信息并传送到医院。

交易名称：查询预约结果

功能说明：平台发起向His 提交修改患者姓名的交易请求。 交易类型：2005

输入参数：该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次

交易结果：0（成功）或者1（失败） 输出参数：

如果交易成功：