医疗保险定点医院接口设计方案

荆州普爱康复医院 医保定点医院接口设计方案
【摘要】本文主要介绍了医疗保险定点接口医院的医保信息系统的与院内HIS 系统的接口设计方案。

引言 为了更好的加快金保工程医保信息系统统一应用软件的实施，制定医疗保险定点医院院内HIS 系统与医保系统的对接接口。

医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，医保接口方案采用了联机、脱机相结合的处理方案，社保卡全部采用Memory 卡.
一、总体设计 1、软件体系结构
医保接口系统主要由医保交易、社保卡交易、圈存、数据传输等子系统组成，如下图所示：
2、系统运行体系
医保接口系统主要由医保接口交易、社保卡交易、圈存系统、数据传输系统、数据库系统组成。

医院客户端医院客户端医院客户端
◆ 脱机方案
医院客户端医院客户端医院客户端
脱机方案
⏹ 软件环境
操作系统：服务端为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)，之间用-分隔
例：20060101083030-10011001-0001
业务周期号说明：
说明：医院编号(8)＋操作员编号(最大8位)＋时间(14)+流水号(4)，之
间用-分隔
例：10011001-99999999-20060101083030-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、交易功能
该类交易主要完成接口部分只向动态库公开，不向开发商公开的交易。

交易卡密码的输入参数为动态库截取后传给后台。

B、交易设计
开发商调用所有需要动态库读卡的交易时，动态库先调用校验卡密码的交易，校验成功再调
用正常的业务。

输入参数：
编号说明类型约束备注
1 密码VARCHAR2(20)
四、故障处理说明：
本系统采用的基本错误处理方法和原则：统一采用C++
try-catch错误方法，所有错误最终必须以界面形式向用户
说明。

用一览表方式说明各类可能的错误或故障出现时系统
的处理方法和补救措施。