医保接口设计方案

医保接口设计方案

目录

1引言

1.1文档编制目的

本报告主要表述了株洲金保项目中医保接口设计方案，内容包含了医保接口的部署方案以及软件接口设计等内容。

本报告的阅读对象包括软件开发人员、软件设计人员、软件实施人员以及与该项目相关的其他人员等。

1.2背景

医保接口方案采用了联机处理方案，社保卡全部采用CPU卡（当磁卡使用），不记录累计信息，只使用CPU卡的卡号）。

1.3 词汇表

1.4 参考资料

2总体设计

2.1 软件体系结构

医保接口系统主要由医保交易、社保卡交易、圈存、数据传输等子系统组成，如下图所示：

在株洲项目中，由于采用了全联机方案，因此软件体系只包括了医保交易子系统。

2.2 系统运行体系

2.2.1运行体系图

医保接口系统主要由医保接口交易、社保卡交易、圈存系统、数据传输系统、数据库系统组成。

医院客户端医院客户端医院客户端

⏹软件环境

操作系统：服务端为UNIX，客户端为WINDOWS2000以上；

应用服务器：WEBLOGIC8以上版本；

数据库：ORACLE9I以上版本；

2.4 技术路线

由医保接口动态库通过向医保接口WEB应用发送HTTP请求进行交易；医保接口的事务提交则由医保接口WEB应用管理；所有业务均通过交易体现。

动态库返回成功，开发商才能处理his系统的业务，his业务处理失败造成的事务不一致由开发商负责。如果由于线路等问题，动态库无法接收web应用返回的交易处理结果，则返回失败，由动态库保证中心业务的回退。

3系统接口设计

3.1 用户接口函数

本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过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的返回值。动态库返回给开发商的出参，去掉交易相应码

交易流水号说明：

说明：交易流水号必须是每一次交易的唯一标识，在整个系统中是唯一的，因此开发商应严格按照建议规则生成交易流水号

规则：时间(12)+医院编号(11)+流水号(4)，之间用-分隔

例： 1-0001

业务周期号说明：

说明：医院编号(11)＋操作员编号(最大8位)＋时间(12)+流水号(4)，之间不用分隔

例：123456789300001

注：4位流水号可以循环使用

交易编码说明：

3.2医院端调用接口交易序列图

4接口交易详细设计

此部分主要对医保接口交易的各具体业务作详细说明。

4.1 查询类

4.1.1交易功能

该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。

对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。

4.1.2交易设计

4.1.2.1批量数据查询下载

交易说明：批量下载中心目录等基础数据，然后对中心的药品目录和诊疗项目目录在his系统进行对照，

输入参数：

说明：

下载文件的路径为：当前文件绝对路径\YBDLOAD\文件名.txt；文件名的命名规则为：

01：YPML_下载数据开始日期；

02：ZLXM_下载数据开始日期；

03：FWSS_下载数据开始日期；

04：SFXMBM_下载数据开始日期；

05：BZML_下载数据开始日期；

06：XMPP_下载数据开始日期；

07：YLJG；（该值目前尚未更改，仍为 BZFX_下载数据开始日期，该值需要动态库的更新xihui 2008-03-05）

药品目录：

诊疗项目目录：

服务设施目录：

⏹费用类别信息：

⏹病种目录：

4.1.2.2医疗费信息汇总

说明：该请求返回医疗费总额和各项费用合计，HIS系统中要进行对帐，先医疗费信息汇总请求，当返回的费用合计与HIS系统中不符时，才有必要发送医疗费用信息查询交易。

输入参数：

4.1.2.3明细对帐请求

输入参数：