预约挂号平台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
该参数由多个字段拼成一个字符串形成,各个字段之间用“|”符号区隔,每次交易只能传入一个患者姓名修改信息。