荆州普爱康复医院 医点医院接口设计案
【摘要】本文主要介绍了医疗保险定点接口医院的医保信息系统的与院HIS 系统的接口设计案。
引言 为了更好的加快金保工程医保信息系统统一应用软件的实施，制定医疗保险定点医院院HIS 系统与医保系统的对接接口。
医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，医保接口案采用了联机、脱机相结合的处理案，社保卡全部采用Memory 卡.
一、总体设计 1、软件体系结构
医保接口系统主要由医保交易、社保卡交易、圈存、数据传输等子系统组成，如下图所示：
2、系统运行体系
医保接口系统主要由医保接口交易、社保卡交易、圈存系统、数据传输系统、数据库系统组成。
小型定点医疗机构也建议采用宽带网，但可以采用ISDN或普通拔号上网。
医院客户端医院客户端医院客户端
◆ 脱机案
医院客户端医院客户端医院客户端
脱机方案
⏹ 软件环境
操作系统：服务端为UNIX ，客户端为WINDOWS2000以上； 应用服务器：WEBLOGIC8以上版本；
数据库：ORACLE10.2；
4、技术路线
⏹联机时：
由医保接口动态库通过向医保接口WEB应用发送HTTP请求进行交易；
医保接口的事务提交则由医保接口WEB应用管理；所有业务均通过交易体现。
⏹脱机时：
由医保接口动态库通过OCI接口，向数据库发送数据操作请求，医保接口的事务提交是用接口部来实现的，它需要HIS有医保前置机，所有业务均通过交易体现，与联机式的交易格式是相同的。
⏹脱机/联机时：
在中心网络畅通时使用联机交易，在网络不通时走脱机模式，在读卡和登记两个交易判断是否联机，并返回给HIS联机标识，之后的业务(费用录入)需要按照这个联机标识,建议只在不使用医保基金的业务才使用脱机，其他必须联机.
联机交易注意事项：
动态库返回成功，开发商才能处理，否则容易造成中心和医院事务不一致。
如果由于线路等问题，动态库无法接收web应用返回的交易处理结果，则返回失败，由动态库保证中心业务的冲正。
脱联结合时各地市业务脱机情况：
城市: , , 宿迁
只使用帐户,没有基金支出的业务(只有普通门诊),可以使用脱机或联机, 对于有基金支出的业务和其他查询类业务都要求使用联机,联机不通的情况下不允做业务处理. 特殊情况在联机做住院登记后,再录入费用明细网络不通时,要求HIS对费用明细信息保存在HIS数据库中, 在网络畅通时再将本地的HIS数据上传到中心,最后在联机时做出院结算,完成整个的住院就医流程.
对这种式只对帐户及其帐户支出累计做写卡操作,其它数据以中心的为准. 二、用户接口函数
本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过DLL 完成。
程序文件名：SiInterface.dll
对外提供的接口函数：
⏹初始化函数:
int INIT(char * pErrMsg)
功能描述：
检查整个运行环境：包括网络环境、运行所需文件、参数等的检查
返回值：成功：返回0 ；失败：返回-1
⏹交易函数：
int BUSINESS_HANDLE( char* inputData, char* outputData)
输入参数：inputData
输出参数：outputData char*
返回值：成功=0 失败<0
输入参数是以“^、$、|”分割的字符串
输出也是以“^、$、|”分割的字符串
参数说明：
入参格式: inputData
业务编号^医疗机构编号^操作员编号^业务期号^医院交易流水号^中心编码^入参^联机标志^动态库参数^
出参格式: outputData char*
中心交易流水号^业务期号^输出参数^联机标志^
返回值说明:
0 –成功，表示此次交易请求成功，业务处理也正常
< 0 －错误，包括系统级别错误（网络、主机、数据库）和业务级别
错误，系统级别错误由动态库将错误信息写入输出参数，业务级别错误由后台通过输出参数提示错误信息。
错误输出机制说明:
Web应用返回给动态库的返回参数格式为：中心交易流水号^业务期号^输出参数^交易相应码^，动态库接收到返回参数后，根据交易相应码判断交易处理成功与否，交易处理成功，则动态库返回值为0，否则，将交易相应码转换为小于0的返回值。
动态库返回给开发商的出参，去掉交易相应码交易流水号说明：
规则：时间(14)+医院编号(8)+流水号(4)，之间用-分隔
例：1-0001
业务期号说明：
说明：医院编号(8)＋操作员编号(最大8位)＋时间(14)+流水号(4)，之
间用-分隔
例：100119-030-0001
注：4位流水号可以循环使用
交易编码说明：
交易编码为四位编码，第一位标志交易性质，后面三位表示流水号
三、接口交易设计
1、查询类
A、交易功能
该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。
对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。
B、交易设计
1）、批量数据查询下载
交易说明：批量下载中心目录等基础数据，然后对中心的药品目录和诊疗项目目录在his系统进行对照，上传处时，根据对照结果，同时上传医院编码名称和中心编码。
输入参数：
输出参数:
01：YPML_下载数据开始日期；
02：ZLXM_下载数据开始日期；03：SFXMBM_下载数据开始日期；
04：BZXX_下载数据开始日期；
05：XMDYGX_下载数据开始日期；
2）、医疗费信息汇总
说明：该请求返回医疗费总额和各项费用合计，HIS系统中要进行对帐，先医疗费信息汇总请求，当返回的费用合计与HIS系统中不符时，才有必要发送医疗费用信息查询交易。
输入参数：
输出参数:
3)、明细对帐请求输入参数：
输出参数:
4）、医疗费信息查询
说明：当汇总医疗费用信息查询结果与HIS不同时，发起该交易，由HIS提供程序进行对帐。
下载文件的路径为：当前文件绝对路径\YBDLOAD\ YLFY_下载数据开始日期.txt
输入参数：
输出参数:
5）、医疗费用明细信息查询
当明细对帐结果与HIS不同时，发起该交易，由HIS提供程序进行对帐。
下载文件的路径为：当前文件绝对路径\YBDLOAD\ FYMX_住院流水号.txt。
输入参数：
输出参数:
6）、医疗待遇封锁信息查询输入参数：
输出参数：
注：
封锁类别：0表示没有封锁，
1表示全封锁，
2表示部分封锁，
3表示卡封锁。
在录入信息前进行封锁控制，避免录入挂号信息后再提示封锁。
7）、个人审批信息
输入参数：
输出参数：
8）、个人参加险种信息输入参数：
输出参数：
9）、查询系统时间
输入参数：
无。
输出参数：
10）、将卡中密码存入数据库输入参数：
输出参数：
无
11）、从数据库获取卡密码
输入参数：无
输出参数：
12)、医疗类别变更
输入参数：
说明：原医疗类别只能为普通门诊、药店购药、未定住院. 对原医疗类别为普通门诊、药店购药，可以选择新医疗类别为门诊慢性病，门诊特殊病，门诊特定项目。
输出参数：无
2、认证类
A、交易功能
签入签出是为了验证客户端为合法的用户，一台客户端可以正常进行交易处理，必须要签入，不签入不允交易。
为了满足联机案下合理控制客户端的用户数，在签入时由动态库向医保接口的数据库里插入机器的物理MAC地址和用户数目做为交易的入参，并检索该医院的物理地址数量是否超过限制数量；在签出时由动态库更新该表的该医院连接信息。
说明：认证交易开发商直接调用，不需要传入入参。
动态库获取客户端的MAC地址和授权用户数目后做为入参传给接口。
B、交易设计
1）、签到
输入参数：无
输出参数:
2）、签退
输入参数：无
输出参数:无
3、交易功能
该类交易主要完成参保患者挂号登记、处上报、结算及撤销结算等的各项业务处理。
在有关事务提交面，不管是联机情况还是脱机案，都是由医保接口自动控制事务，而不是由客户端控制事务。
如果客户端需要取消事务，则可以发起撤销交易请求。
4、动态库交易类
A、交易功能
该类交易主要完成接口部分只向动态库公开，不向开发商公开的交易。
. . .
z 交易卡密码的输入参数为动态库截取后传给后台。
B、交易设计
开发商调用所有需要动态库读卡的交易时，动态库先调用校验卡密码的交易，校验成功再调用正常的业务。
输入参数：
输出参数:无
四、故障处理说明：
本系统采用的基本错误处理法和原则：统一采用C++ try-catch错误法，所有错误最终必须以界面形式向用户说明。
用一览表式说明各类可能的错误或故障出现时系统的处理法和补救措施。
