预约挂号平台HIS接口设计Word文件下载.docx
《预约挂号平台HIS接口设计Word文件下载.docx》由会员分享，可在线阅读，更多相关《预约挂号平台HIS接口设计Word文件下载.docx（22页珍藏版）》请在冰豆网上搜索。
一．HIS向预约挂号平台上传预约挂号系统所需的基本信息（如：
医院信息、科室信息、医生信息、排班信息、停诊信息等）和其他交易信息（如：
患者预约后的实际就诊情况、患者投诉情况、患者注册信息等）。
该类交易平台为服务端，HIS为客户端。
平台方提供DLL函数接口，供HIS调用。
二．
三．平台向HIS发起的实时交易请求（如：
预约挂号、预约取消、患者信息向医院传送等）。
该类交易平台为客户端，HIS为服务端。
HIS提供存储过程供平台调用。
四．
五．详细业务部分请参阅《省预约挂号平台业务操作规范.doc》
六．
平台与医院HIS接口
3
平台与医院HIS前置之间采用TCP/IP通讯协议，建立两对SOCKET端口（互为客户/服务端）：
一对用于医院HIS系统发起的交易（HisToEbs），一对用于平台发起的交易（EbsToHis）。
其中客户端作为发送数据端口，服务端作为接收数据端口。
HIS作为客户端时，通过调用平台提供的DLL函数发起交易请求；
HIS作为服务端时，向平台开放存储过程。
交易方式采用短链接的方式。
在一个TCP/IP连接上完成数据包的发送和接收，在成功发送了一个数据包，并收到成功应答后，即中断该连接。
HisToEbs和EbsToHis均采用同步方式。
文件传输采用FTP方式。
HisToEbs
3.1
该接口主要用于HIS系统向平台传输院方相关基础及变更信息，如：
医院介绍、科室设置、医生、排班等。
该接口的实现采用HIS调用Dll函数的方式，Dll函数接口由平台提供。
函数封装了底层通讯协议和交易逻辑。
初始化服务器设置
3.1.1
IntSetIpAndPort（char*szHospitalID,char*szIp,intnPort）
函数说明：
设置医院编号、HisServer（HIS前置）的ip和端口号。
在HIS系统启动（初始化）时加载调用，必须先调用该函数进行初始化，否则会提示调用失败。
输入参数：
szHospitalID医院ID，由省平台统一分配（6位字符）
szIpHIS前置服务器的ip，如192.168.1.202，具体到实施时确定
nPortHIS前置服务器的port，如8098（最大65535），具体到实施时确定
输出参数：
无
返回值：
0成功
1连接服务器失败
HIS数据上传
3.1.2
IntSendPack（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的取值格式：
3.1.2.1医院信息上传
序号
字段
类型/长度
备注
必填
变更类型
Char/1
1：
修改；
y
医院名称
Varchar2/50
医院全称
医院机构代码
Varchar2/6
医院介绍
Varchar2/1000
4
地址
Varchar2/100
5
医院等级
Char/4
三甲;
三乙…
6
医院性质
公立;
民营;
合资;
外资;
其他
7
医院类别
综合;
专科
n
8
公开电话
加区号
9
网址
3.1.2.2科室信息上传
0:
新增；
2：
删除
科室编号
Varchar2/20
科室在医院内的ID
科室名称
科室描述
Varchar2/200
对应标准码
科室对应的标准科室代码（到群共享里找）
年龄限制
char/1
无限制1:
14周岁以上
2:
18周岁以下
变更时间
datetime
Yyyymmdd24hhmmss
医生信息上传
3.1.2.3
医生是跟排班相关联的，没有相应的排班是看不到医生信息的。
医生编号
医生在HIS中的主键
医生名称
Y
医生性别
Char/2
男;
女
医生职称
Varchar（30）
医生学历
Varchar2（10）
医生简历
医生介绍
N
照片
照片文件名称
10
Yyyymmddhhmmss（小时是24小时制，如20110401235800）
排班信息上传
3.1.2.4
第一次新增排班则立即生效,修改排班要下一周期生效。
修改排班须由His先做判断,若影响到已预约患者,则不允许修改
排班ID
Long
排班在HIS中的主键
星期
1:
星期一。
。
7:
星期天
科室代码
医生工号
可以为空
挂号类别
Char
（2）
00：
普通，11：
专家
挂号费
Varchar2/10
诊疗费
上午号源
例如：
1,8:
30&
3,9:
00&
5,9:
或者：
10-20，8:
30-9:
00&
50-60,10:
00-10:
62:
00
上下午号源至少有一个不为空
下午号源
11
Datetime
12
变更生效日期
Date
为了尽量避免影响已经预约出去的排班，请医院尽可能提前制定排班变更计划，而不是立即更新排班。
（yyyymmdd）
13
变更失效时间
Yyyymmdd
14
人均就诊时间
int
以分钟为单位
3.1.2.5停诊信息上传
0：
增加1：
修改2：
删除
停诊计划ID
停诊计划在HIS系统的主键
排班在HIS系统中的主键
停诊/恢复标志
停诊（将正常排班置为停诊）
开始日期
排班停诊开始日期
yyyymmdd
结束日期
排班停诊结束日期
上午停诊标志
Int
-1：
停诊1：
不停诊
下午停诊标志
停诊原因
Varchar2（100）
3.1.2.6预约就诊情况上传
取号代码
Char/8
预约取号代码
是否取号
违约未取号1：
取号2：
取号后退号3:
未取号但不违约
取号时间
就诊时间
DateTime
医嘱时间
最后收费时间
取药时间
不违约原因
仅在“是否取号”状态为3时使用
卡类型
本次就诊使用何种卡:
0省医保1市医保2市民卡3农保。
卡号码
Varchar2/25
本次就诊卡号
3.1.2.7患者姓名信息修改
患者编号
varchar/10
患者姓名
varchar/20
EbsToHis
3.2
该接口用于平台向医院HIS提交实时交易请求，并获取HIS方交易结果。
该接口由HIS提供数据库存储过程包。
HIS前置机布署了HisServer程序，接受到平台交易任务后，调用该接口包中的存储过程来完成交易。
HIS系统对平台提供一个数据库存储过程包，包名为：
BookPackage，存储过程名为：
BizExec。
该存储过程有4个参数。
输入/输出
参数名称
类型
说明
输入参数
交易类型
交易参数
Varchar2/4000
根据交易类型拼装的字符串
输出参数
交易结果
交易成功
交易失败
交易输出
如果交易成功的话，根据交易类型返回不同的交易结果，如果交易失败的话，返回交易失败的原因
患者信息传送到医院并验证（HIS）
3.2.1
本平台为实名使用，因此患者在平台注册时需提供个人必备的身份信息，平台在本地记录患者信息。
当该患者通过平台向某家医院预约挂号时，需将相关信息传送到医院HIS系统，如果该患者填写了本人医保卡、市民卡或就诊卡等信息时，将这些信息同步传送到医院进行校验。
同一个有效证件号码只允许注册一条记录，未成年人通过此平台预约挂号，看病时需持有效证件。
交易名称：
患者信息注册（医院）
功能说明：
把患者在平台注册的信息传送到医院HIS系统中，同一个有效证件号码只允许注册一条记录（未成年人看病需持有效证件），这个规则由平台实现。
交易类型：
2001
该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个患者信息。
字段说明如下表：
患者ID
varchar2/10
患者在平台的ID
性别
男女
证件类型
身份证1:
军官证2:
驾驶证3:
其他（护照、台胞证、港澳证）
证件号码
Varchar2/30
医保卡类型
省医保1：
市医保2：
市民卡
3：
农保
医保卡号
电话号码
Varchar2/12
联系地址
Varchar2/255
联系邮编
交易结果：
0（成功）或者1（失败）
如果交易成功：
校验结果
在HIS中找到医保卡信息，且与姓名匹配
找到卡号但姓名不匹配
没有找到卡号
如果交易失败：
错误原因
His交易处理逻辑：
当前置机调用本交易时，接口首先根据患者ID查找HIS内是否存在患者记录，如果存在，则修改；
否则插入新的记录。
预约挂号
3.2.2
患者在与平台对接的服务商处进行医院、科室、医生、排班（何时就诊）的选择，确定某一排班后提交预约挂号请求，由平台将该预约请求提交医院His系统。
患者在与平台对接的服务商处进行预约挂号，由平台将预约请求提交医院His系统。
2002
该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个预约信息。
就诊日期
上午/下午
上午1：
下午
Char/10
在医院的排班ID
取号凭证代码
char/8
8位（在1周时间内）不可重复。
随机编码，可0开头，不可字母。
预约序号
预约在（上午/下午）的第几位就诊
服务商编码
工号
Varchar2/15
若为电话服务商，则为操作员工号；
若为网络服务商，则为用户IP
空
当前置机调用本交易时，接口应判断患者预约的号源是否可用。
取消预约
3.2.3
该交易为“预约挂号”交易的反向交易，即对原交易进行取消。
注意：
业务约定，就诊当天7点开始后不能取消预约
预约挂号取消
患者在与平台对接的服务商处进行预约挂号的取消，由平台将预约取消请求提交医院His系统。
2003
该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个预约取消信息。
查询预约结果
3.2.4
该交易查询某笔预约交易在HIS的交易状态，在特殊情况下（如网络异常）当不确定双方交易状态是否一致的时候，用来确认His方的交易状态。
平台发起向His查询某笔预约交易的结果。
2004
0（成功：
该号源已经被预约，不可再次预约）或者1（失败：
该号源未被预约，可以被预约）
患者姓名信息修改
3.2.5
因平台为实名使用，当患者在平台登记的姓名信息有误时，将无法正常就诊。
若患者在平台登记信息时将姓名信息登记错误，则可发起此交易，修改平台患者姓名信息并传送到医院。
平台发起向His提交修改患者姓名的交易请求。
2005
该参数由多个字段拼成一个字符串形成，各个字段之间用“|”符号区隔，每次交易只能传入一个患者姓名修改信息。
升级会员 