医保前台软件接口系统说明(医院接口)

医保前台软件接口系统说明(医院接口)
南京市医保前台软件接口系统说明
一．网络连接方式：
在医院运行的医保前台软件,是和医保中心的应用服务器(中间件服务器)实时连接的，必须保证每一台使用医保前台软件的计算机都能连接到医保中心的应用服务器网络上，医院操作人员操作的所有数据都保存在医保中心的数据库中和医院本地HIS系统数据库中。

二．医院基础数据准备：
在使用医保前台软件之前，医院必须将基础数据准备好，主要有如下几方面的数据：
1．医院药品数据：由医保中心提供一套基本的医保药品库（中心药品库），同时医保中心为每家医院建立一个药品对照库（机构药品库），医院必
须按医保中心的要求提供医院的药品明细库，由医保中心相关部门将
药品对照数据审批维护到机构药品库中。

同时医院可下载对照库到HIS
系统中供查询打印等。

2．医院诊疗项目数据：同医院药品数据类似处理
3．医院就诊科室对照表:各医院将本字所有的科室基本信息数据上报到医保中心，由医保信息科维护到中心数据库中。

4．医院医生基本信息库：各医院应将本院的医生基本信息（医生编号，姓名等）上报到医保中心，由医保信息科维护到中心数据库中。

三、医院前台软件运行方案的选择：
针对不同定点医院现有的HIS系统的实施、运行状况、在充分保证医保中心业务管理和数据要求的基础上，尽可能利用定点医院的HIS系统的数据和功能，对前台的业务主要有以下两种方案：
1.完全使用医保提供的前台软件：该方案主要针对无HIS系统或
对现行HIS系统改造比较困难的定点医院，医保业务完全由医保前台软件与医保中心中间件应用服务器实时联网来完成。

该方案医保的数据和医院HIS系统的数据相互较独立。

2.使用医保提供的嵌入式接口系统：该方案主要针对有较完善的HIS系统并对HIS系统有改造能力的定点医院，嵌入式接口系统采用WINDOWS动态连接库的标准，将医保业务的主要功能封装在接口系统中，可以由医院HIS系统连接调用，并实时返回业务的输出数据，使医保数据和HIS系统的数据达到最大的共享。

四、HIS系统与医保嵌入式接口系统的总结构图
五、主要业务流程接口调用简表
医疗保险嵌入式数据接口系统说明
业务接口部分:
一.门诊挂号:
医院HIS系统在本系统门诊挂号确认之前，调用门诊挂号接口服务功能实现医保病人的挂号，调用成功后将返回的单据号保在HIS系统中。

接口服务名称:MZGH
输入参数：
返回参数:
二.门诊退号：
门诊退号功能，将取消医保病人未收费的挂号单据
接口服务名称:MZTH
输入参数：
返回参数:
三.门诊收费：
在医院HIS系统中，将医保病人的就诊信息和药品诊疗项目信息输入完毕后，调用费用明细上传服务将费用上传到医保中心系统,后调用收费计算接口服务计算医保费用的各项支付，确认计算费用无误后，调用费用提交接口服务最终结算并将返回的单据号等信息保存在HIS系统中。

1.费用上传
接口服务名称:MZSF_SC
本服务将处方明细上传到医保中心,输入参数可多条数据(参见参数的传递方法) 输入参数：
返回参数（暂无）
2.费用计算
接口服务名称:MZSF_JS
本服务根据医保政策实时计算各费用支付分滩情况输入参数：
返回参数:
3.最终结算提交
接口服务名称:MZSF_QR
本服务根据医保政策实时计算各费用支付分滩情况
输入参数：
返回参数:
注:调用本服务前,HIS系统应再次调用刷卡函数,判断医保病人的卡是否读卡器中
四.门诊冲帐:
门诊冲帐将医保病人已收费单据作废，并恢复个人帐户到本单据就诊前的状态（建议从最后一张收费单冲起）,退现金给病人。

接口服务名称:MZCZ
输入参数：
返回参数:
五.住院登记:
医保病人入院登记，在HIS系统入院登记确认之前，调用登记接口服务，成功后将返回的住院序号保存在HIS系统中，为医保病人住院的唯一标记。

接口服务名称:ZYDJ
输入参数：
返回参数:
六.住院人员病区床位登记:
给住院人员分配病区和床位接口服务名称:ZYBQCW
输入参数：
返回参数（暂无）
七.住院每日费用明细上传:
将医保在院病人每天发生的费用上传（建议在HIS系统录入费用确认时上传），每次上传的费用明细将全覆盖同一费用时间的已上传费用。

接口服务名称:ZYMX_SC
输入参数：
基本参数:
明细参数:
返回参数(暂无):
八.住院特殊费用审批上报:
对医保在院病人发生的特殊费用(血液蛋白制品等)，需要医保中心相关科室审批,该服务实现上报审批数据的功能。

接口服务名称:ZYSP_SC
输入参数：
基本参数:
明细参数:
返回参数
九.获取住院特殊费用审批结果:
对医保在院病人发生的特殊费用(血液蛋白制品等)，需要医保中心相关科室审批,该服务用来获取审批结果。

接口服务名称:ZYSP_JG
输入参数：
返回参数:
基本参数: 单行
明细参数: 多行
十.住院登记注销:
注销错误的住院登记接口服务名称:ZYDJZX 输入参数：
基本参数:
返回参数(暂无)
十一.出院结算
1.费用结算
接口服务名称:CYJS 输入参数：
返回参数:
2.出院结算确认
接口服务名称:CYQR 输入参数：
返回参数:
十二.出院结算冲帐:
将医保病人的最后一次出院结算作废，将病人的状态恢复到在院，并将结算支付的医保费用恢复。

接口服务名称:ZYCZ
输入参数：
返回参数:
十三.已出院病人ICD10病种确定:
对于已出院病人，出院结算时没有确定ICD10病种的，对该病人的病种重新确认。

接口服务名称:ZYBZ_SC
输入参数：
返回参数（暂无）
系统功能维护接口部分:
一: 医保中心应用服务器连接控制函数
医院HIS系统要调用接口功能服务之前，系统必须已经连接登录到医保中间件应用服务器中
连接登录:
Function int conn_ybzx(string jgm,string ryh,string mm,string res);
参数：jgm 医院在医保系统中的编号，如H0001
ryh 操作人员在医保系统中的编号。

如”H0001Y0001”
mm 操作人员的医保操作密码
res 保留暂不使用
返回0-连接成功,-1连接失败
断开与医保中心的连接:
Function int disconn_bzx();
二:医院前台操作人员维护
接口服务名称:CZRYWH
输入参数：
返回参数:
三.医保中心基础数据库对照下载服务:
1.医保中心门诊病种信息库:
服务名称:D_MZBZB
输入参数：(暂无)
返回参数:
2.医保中心住院病种信息库(ICD10病种): 服务名称:D_ICD10
输入参数：(暂无)
返回参数:
3.定点医院档案信息库: 服务名称:D_YYDA
输入参数：(暂无)
返回参数:
4.医保中心科室表
服务名称:D_YBKSB
输入参数：(暂无)
返回参数:
5.药品库对照数据下载服务名称:D_JGYPK
输入参数：
返回参数:
6.诊疗项目库对照数据下载服务名称:D_JGYLFK
输入参数：
返回参数:
四:公共查询数据接口:
1.获取医保病人基本信息：服务名称:GETCBRYXX_T 输入参数：
返回参数:
五: 医保IC读卡功能函数:(需要SURE32WC.DLL)
Function int init_ic(int com);//初始化IC读卡设备，与IC设备建立连接,参数com=0为COM1口，=1为COM口2
Function int read_ic(char* tbr,char *kxh);//读出个人编号和医保卡序号Function int exit_ic();//断开与IC设备的连接
建议在HIS系统程序启动时初始化IC设备，HIS系统程序关闭时断开与IC 设备的连接。

读卡前必须保证IC设备已正确初始化。

IC设备每次只能由一个系统使用，不能同时建立一个以上的连接,若另一个系统需要使用IC设备，要将当前使用IC设备的连接断开。

六:不完整的业务错帐处理:
接口系统与医院HIS系统是两个不同的事务范围，可能会出现单方面事务提交成功，而另一方没有处理成功。

对于医保接口处理成功但是医院HIS系统没有处理成功的情况，接口系统提供不完整业务错帐处理功能（包含在有界面的辅助功能程序中），可以对错帐进行冲帐。

（建议每个接口业务先调用医保中心的接口函数，取到正确的返回信息后，将返回信息和HIS数据一起提交到HIS数据库中）
七:接口系统的安装：
必须使用医保中心提供的接口系统安装程序将接口软件系统安装到定点医院的各个客户机上，系统主要安装以下几个功能部分：
1．Tuxedo8.01客户端环境。

2．PowerBuilder9.0运行环境。

3．接口系统辅助功能程序（IC设备DLL、系统管理、不完整单据冲帐等）。

4．嵌入式接口功能DLL（Lesybjk.dll）。

系统要求80M以上的空余磁盘空间，WINDOW98/NT/2000/XP等操作系统。

接口动态连接库的使用说明:
DLL名字: Lesybjk.dll
一:主要函数说明
1)int createparams(long sendlen,long recvlen);
创建参数缓存,sendlen为输入参数的空间大小,为输出参数的空间大小(以字节为单位)
2)int destroyparams()
销毁参数缓存
3)int setstringparam(long paramid,long row,char *value);
设置字符串参数,paramid为参数的标识号,row为参数的出现次数(以0为基数),基本参数一般为0,
明细参数可多行,value为参数的值
4)int setlongparam(long paramid,long row,long value);
设置整型参数
5)int setdoubleparam(long paramid,long row,double value);
设置浮点参数
6)int jkcall(string svcname);
调用接口服务功能,svcname为服务名
7)int getstringparam(long paramid,long row,char * value);
取参数值,value为返回值
8)int getlongparam(long paramid,long row,long *value);
取整型参数
9)int getdoubleparam(long paramid,long row,double *value);
取浮点参数
10)long getrowcount(long paramid)
取返回参数的行数，对于调用服务返回多条记录的参数进行循环取数据时，用此函数返回记录总行数
11)char *getlasterr();
返回最近一次接口函数调用出错详细的错误文本
二:调用服务的方法
一般为以下步骤调用:
1)创建参数缓存
2)设置输入参数
3)调用服务
4)取返回参数
5)销毁参数缓存
如门诊挂号:
c语言的风格:
#define P_JGM 16000001
#define P_KXH 16000002 /*具体的参数标识号的定义参见相关文件*/
……
if (createparams(1024, 1024) == -1) /*创建参数缓存*/
{
printf(‘无法创建参数缓存,出错:%s’, getlasterr());
/*失败,结束调用,返回*/
}
/*设置输入参数*/
setstringparam(P_JGM, 0, “H0001”);
setstringparam(P_KXH, 0, “12345”);
setstringparam(P_TBR, 0, “300000023”);
……
setdoubleparam(P_GHF, 0, 0.80);
…….
/*调用服务*/
if (jkcall(“MZGH”) == -1) /*调用门诊挂号服务*/
{
printf(“%s”, getlasterr());
destroyparams();/*调用失败要将参数缓存销毁,否则可能会出现内存错误*/ /*失败,结束调用,返回*/
}
/*调用成功取返回参数*/
getstringparam(P_DJH, 0, &o_djh);/*取返回参数DJH到变量o_djh中
……
destroyparams();/*销毁参数缓存*/
/*调用结束*/
…..
后续的HIS系统处理功能
……..
三，多条明细参数的转入方法：
for <循环HIS系统中已录入的明细>
i++; /*行记录的下标变量，以0为第一行*/
setstringparam(P_ZBM, i, v_zbm[i]); //循环转入多行参数
四，多条明细参数的返回接收方法：
c=getrowcount(P_BM);//首先取到返回参数的行数C
for (I=0;I<c;I++)
{
getstringparam(P_BM, 0, v_bm[I]); //循环取多行参数getstringparam(P_MCH, 0, v_mch[I]);
……
}
建议医院HIS系统结构改造部分:
接口系统要求定点医院对HIS系统的数据库结构和业务处理作相关的改造，主要针对医保数据在HIS系统中的存储，表现在以下几个方面：1．药品和诊疗项目对照关系的建立：在医院HIS系统中必须要建立机构药品和诊疗项目库，医保病人门诊和住院等业务中使用的药品和诊疗
项目以机构药品和诊疗项目库为准。

以医院自编码为关联对照。

2．就诊科室数据库：增加和医保中心科室的对照。

3．建立医保业务操作人员：对办理医保业务的操作人员要通过接口系统注册登记，医保将为每个操作人员分配唯一的用户名，医院HIS系统
必须保存操作人员的医保用户名和密码，在连接登录到医保中心系统时
要求提供操作人员的医保用户名和密码。

4．医保门诊病种数据库:医保病人在HIS系统中门诊收费时,病种编码应以医保门诊病种数据为准,所以HIS系统应调用下载接口,将病种数
据导入到HIS系统数据库中。

5．医保住院ICD10病种数据库：医保病人办理住院登记或出院结算时，病种编码应以ICD10病种数据为准，应在HIS系统中建立ICD10病种数
据库。

6．定点医院基本信息数据库：HIS系统应下载所有医疗保险定点医疗机构的编码数据库，在病人办理转院，转往其它定点医院时以该数据库
编码为准。

7．挂号单据数据库：增加医保单据号信息，HIS系统办理医保挂号时，调用挂号接口生成医保单据数据，建议保存医保生成的唯一单据号，针
对医保病人退号时，可以在HIS系统的挂号单据中找到对应于医保单据
的编号，用医保单据编号可以调用退号功能将单据作废，同时也将HIS
系统的挂号单据作废。

8．门诊收费单据数据库：增加医保门诊收费单据号，HIS系统将医保病人的处方单输入后，先调用门诊收费计算接口（预结算），确认返回
的各项费用计算无误后，然后调用门诊生成单据接口，并将返回的医保
单据号保存，作为冲帐的标识，对医保单据的冲帐，同时也要对HIS系
统中对应门诊单据进行冲帐作废。

9．住院登记信息数据库：增加医保病人的医保住院唯一序号，在医保病人住院期间的相关业务（每日明细，出院结算等）都是以医保病人的IC卡号和住院唯一序号为准。

10．住院每日费用的处理：HIS系统可以改造原住院每日费用程序，在提交病人每天费用之前，调用医保接口，将费用上传到医保中心数据库。

同一天的费用是覆盖的。