(完整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（失败） 输出参数：
如果交易成功：。