江苏金保医保接口方案

江苏金保医保接口方案社保事业部文件编号：TD202文件版次：QMS2007文档编号TD202-SBH107053-JK-03版本号分册名称江苏金保医保接口方案第1册/共1册总页数46正文43附录编制王春山审批茹彩辉生效日期2007-9-3沈阳东软软件股份有限公司修改记录版本号变更控制报告编号更改条款及内容更改人审批人更改日期讨论稿王春山2007-8-27确认稿王春山2007-8-29修改稿邱伟2009-1-19修改稿邱伟2009-2-27修改稿邱伟2009-6-18目录1引言文档编制目的本报告主要表述了江苏金保项目中医保接口设计方案，内容包含了医保接口的部署方案以及软件接口设计等内容。本报告的阅读对象包括软件开发人员、软件设计人员、软件实施人员以及与该项目相关的其他人员等。背景江苏金保项目涵盖了5地市社会保险五个险种（养老、医疗、失业、工伤、生育）以及劳动力市场管理，其中也包括了其他接口，如银行接口、医保接口等。医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，医保接口方案采用了联机处理方案.词汇表词汇名称词汇含义备注交易医保接口客户端向接口发出的一种请求消息，接口需要作出应答医保接口是架在医保中心和定点医疗机构之间的一个接口系统，完成两者之间的信息传递，使定点医疗机构具备医保患者业务处理功能参考资料编号参考资料备注1《江苏金保软件规格说明书_医疗待遇分册》2总体设计软件体系结构医保接口系统主要由医保交易、数据传输等子系统组成，如下图所示：在江苏金保项目中，由于采用了联机方案，并且没有加密机所以暂不用使用圈存服务。系统运行体系2.2.1运行体系图医保接口系统主要由医保接口交易、社保卡交易、圈存系统、数据传输系统、数据库系统组成。联机方案2.3系统物理结构硬件物理环境联机方案医保中心大型定点医疗机构要求以太网10兆以上局域网或宽带网。小型定点医疗机构也建议采用宽带网，但可以采用ISDN或普通拔号上网。软件环境操作系统：服务端为UNIX，客户端为WINDOWS2000以上；应用服务器：WEBLOGIC9以上版本；数据库：；技术路线联机时：由医保接口动态库通过向医保接口WEB应用发送HTTP请求进行交易；医保接口的事务提交则由医保接口WEB应用管理；所有业务均通过交易体现。联机交易注意事项：动态库返回成功，开发商才能处理，否则容易造成中心和医院事务不一致。如果由于线路等问题，动态库无法接收web应用返回的交易处理结果，则返回失败，由动态库保证中心业务的冲正。3系统接口设计用户接口函数本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过DLL完成。程序文件名：对外提供的接口函数：初始化函数:intINIT(char*pErrMsg)功能描述：检查整个运行环境：包括网络环境、运行所需文件、参数等的检查返回值：成功：返回0；失败：返回-1交易函数：intBUSINESS_HANDLE(char*inputData,char*outputData)输入参数：inputData输出参数：outputDatachar*返回值：成功=0失败0输入参数是以“^、$、|”分割的字符串输出也是以“^、$、|”分割的字符串参数说明：入参格式:inputData业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^联机标志^动态库参数^业务编号（4位）宏定义,分别对应后台的一项业务操作医院编号(8位)操作员编号(8位)医院分配给操作员的唯一标识业务周期号(最大36位)签到时的返回的业务周期号医院交易流水号(发送方交易流水号)(最大30位)建议规则：时间(14)+医院编号(8)+流水号(4)中心编码固定为0000入参以“|”分隔，详见每个交易的参数表,分项之间使用管道分割符‘|’分割，最后必须要以管道分割符号‘|’结尾，不以‘|’开始。如果入参为多条记录，记录之间以‘$’分割，不同数据项之间以‘|’分割联机标志0：脱机1:联机。注意：在做读卡和门诊挂号这两个交易时，联机标识必须传1。动态库入参签到交易为：客户端MAC地址|用户数目|其他交易为：客户端MAC地址|出参格式:outputDatachar*中心交易流水号^业务周期号^输出参数^联机标志^中心交易流水号中心交易流水号(最大30位)中心返回业务周期号中心根据操作员和中心时间，生成业务周期号输出参数（该参数为输出参数，客户程序必须在调用本函数之前分配足够长的空间，其最小值为1024字节，如果未给本参数分配空间或分配的空间长度小于实际返回的长度，客户程序将会出现内存保护错误），最后以管道分割符号’|’结尾。联机标志在读卡和门诊挂号时，从动态库的返回参数中取该笔业务是联机还是脱机交易，HIS需要保存，后续的明细录入和结算交易时，需要传入该标识。返回值说明:0–成功，表示此次交易请求成功，业务处理也正常0－错误，包括系统级别错误（网络、主机、数据库）和业务级别错误，系统级别错误由动态库将错误信息写入输出参数，业务级别错误由后台通过输出参数提示错误信息。错误输出机制说明:Web应用返回给动态库的返回参数格式为：中心交易流水号^业务周期号^输出参数^交易相应码^，动态库接收到返回参数后，根据交易相应码判断交易处理成功与否，交易处理成功，则动态库返回值为0，否则，将交易相应码转换为小于0的返回值。动态库返回给开发商的出参，去掉交易相应码交易流水号说明：规则：时间(14)+医院编号(8)+流水号(4)，之间用-分隔业务周期号说明：说明：医院编号(8)＋操作员编号(最大8位)＋时间(14)+流水号(4)，之间用-分隔注：4位流水号可以循环使用交易编码说明：交易编码为四位编码，第一位标志交易性质，后面三位表示流水号序号交易码功能简介交易性质1110医疗费用信息汇总查询1210明细对帐请求查询1100医疗费用信息查询查询1200费用明细信息查询查询1300信息批量下载查询1400参保人员基本信息及其医保个人帐户查询查询1500医疗待遇封锁信息查询查询1600个人审批信息查询9100签到认证交易9110签退认证交易2100读卡主体交易2110修改卡密码主体交易2120校验卡密码动态库交易2210门诊/住院登记主体交易2230登记(挂号)信息修改主体交易2240登记(挂号)撤销主体交易2310费用明细上报主体交易2320费用明细撤销主体交易2410结算主体交易2420预结算主体交易2430结算撤销/取消报销主体交易2610药店收费预结算主体交易2620药店收费结算主体交易2510中心报销保存处方主体交易3110医院审批信息上报申报业务3120医院审批信息上报撤销申报业务3130个人参加险种信息查询4300结算信息冲正主体交易4500查询系统时间查询5100将卡中密码存入数据库主体交易5110从数据库获取卡密码查询6100医疗类别变更主体交易5200医院端卡封锁主体交易7100撤销结算冲正交易主体交易7010医院项目对照上报(徐州)申报业务7020医院项目对照上报撤销(徐州)申报业务医院端调用接口交易序列图4接口交易详细设计此部分主要对医保接口交易的各具体业务作详细说明。4.1查询类4.1.1交易功能该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。4.1.2交易设计4.1.2.1批量数据查询下载(1300)交易说明：批量下载中心目录等基础数据，然后对中心的药品目录和诊疗项目目录在his系统进行对照，上传处方时，根据对照结果，同时上传医院编码名称和中心编码。项目编码项目名称说明01药品目录02诊疗项目信息03费用类别信息04病种信息05项目和一次性材料对应关系此交易为了HIS对项目与一次性材料的控制。06项目对照信息(徐州)输入参数：编号名称长度约束说明1项目编码VARCHAR2(3)NOTNULL确定需要下载信息的种类2开始日期VARCHAR2(14)NOTNULLYYYYMMDDHH24MISS开始时间之后维护和发生变化的时间.3审核标志VARCHAR2(3)0未审核1审核通过2审核未通过输出参数:编号名称长度约束说明1文件路径及文件名称VARCHAR2(200)参见配置信息说明：下载文件的路径为：当前文件绝对路径\YBDLOAD\文件名.txt；文件名的命名规则为：01：YPML_下载数据开始日期；02：ZLXM_下载数据开始日期；03：SFXMBM_下载数据开始日期；04：BZXX_下载数据开始日期；05:：XMDYGX_下载数据开始日期；06：XMDZXZ_下载数据开始日期；药品目录：编号名称长度约束说明药品编码VARHCAR2(20)主键通用名称VARCHAR2(100)通用名拼音码VARCHAR2(8)通用名五笔码VARCHAR2(8)通用名编码VARCHAR2(8)开始时间VARCHAR2(14)主键YYYYMMDDHH24MISS为目录使用的开始时间，与入参的开始时间不同品名编码VARHCAR2(20)商品名VARCHAR2(100)商品名拼音码VARCHAR2(8)商品名五笔码VARCHAR2(8)英文名称VARCHAR2(100)12收费类别VARCHAR2(3)11——西药12——中成药13——中草药13处方药标志VARCHAR2(3)0——非处方药（default）1——处方药14收费项目等级VARCHAR2(3)1甲类、2乙类、3自费15标注剂型VARCHAR2(20)001——口服常释剂型002——缓释控释剂型003——口服液体剂004——丸剂005——颗粒剂006——口服散剂007——外用散剂008——软膏剂009——贴剂010——外用液体剂011——硬膏剂012——凝胶剂013——涂剂014——栓剂015——滴眼剂016——滴耳剂017——滴鼻剂018——吸入剂019——注射剂020——种子源999——自制剂16实际剂型VARCHAR2(20)001——片剂002——肠溶片003——包衣片004——薄膜衣片005——糖衣片006——浸膏片007——分散片008——划痕片009——硬胶囊010——软胶囊（胶丸）011——肠溶胶囊012——缓释片013——缓释包衣片014——控释片015——缓释胶囊016——控释胶囊017——含片018——舌下片019——咀嚼片剂021——阴道泡腾片剂022——阴道片剂023——口服溶液剂024——口服混悬剂025——口服乳剂026——胶浆剂027——口服液028——乳液029——乳剂030——胶体溶液031——合剂032——酊剂033——滴剂034——混悬滴剂035——糖浆剂036——丸剂037——滴丸038——颗粒剂039——肠溶颗粒剂040——干混悬剂041——散剂042——药粉043——粉剂044——散剂045——粉剂046——撒布剂047——撒粉048——软膏剂049——乳膏剂050——霜剂051——糊剂052——油膏剂053——贴剂054——贴膏剂055——膜剂056——透皮贴剂057——外用溶液剂058——洗剂059——漱口剂060——含漱液061——胶浆剂062——搽剂063——酊剂064——油剂065——灌肠剂067——溶液剂068——外用冻干粉069——硬膏剂070——亲水硬膏剂071——乳胶剂072——凝胶剂073——涂剂074——涂膜剂075——涂布剂076——栓剂077——肛门栓078——阴道栓079——滴眼剂080——滴眼液081——眼膏剂082——滴耳剂083——滴耳液084——滴鼻剂085——滴鼻液086——喷剂087——气雾剂088——喷鼻剂089——喷粉剂090——喷雾剂091——雾化吸入剂092——雾化混悬液093——雾化溶液剂094——雾化吸入剂095——吸入性粉剂096——干粉剂097——干粉吸入剂098——粉末吸入剂099——干粉吸剂100——吸入性溶液