医保接口设计方案
医保接口设计方案
目录
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）
药品目录：