浙江省社会保障“一卡通”异地就医接入两定单位开发手册V4.0

—1—浙江省社会保障“一卡通”异地就医两定机构接入开发手册（Version：4.0）1.概述1.1.背景为确保各地医疗机构信息系统采用统一标准的对接方式、数据格式、处理流程接入社会保障“一卡通”异地就医管理系统，顺利实现参保人员医疗保险异地就医业务，特编写此规范。1.2.目标浙江省范围内的基本医疗保险参保人员持“中华人民共和国社会保障卡”（以下简称社保卡），在全省的基本医疗保险定点医疗机构和定点零售药店（以下称“两定”机构）就医、购药，通过医疗保险网络信息系统，实现直接刷卡结算医疗费用。1.3.名词解释在本开发手册文档内，使用部分简略说明，其含义以本定义为准。序号术语所指对象或含义1浙江省“一卡通”异地就医管理系统浙江省“一卡通”异地就医管理系统，以下简称省异地就医管理系统，是全省异地就医的核心系统，承担了三大目录管理和下发、异地“两定”机构管理、异地就医费用清算以及接入节点管理等职能。在异地就医业务中，省异地就医管理系统同时承担了数据传输的核心枢纽作用，各类业务数据均需要通过省异地就医管理系统进行落地和转发，包括参保人的就诊信息、费用明细数据、就医地审核扣款信息、就医地“两定”机构结算数据和清算数据。各类数据在省异地就医管理系统固化，并作为后续业务经办和稽核的依据。2参保地人员参加医疗保险所在地。3就医地参保人在两定（定点医疗机构、定点药房）就诊所在地。4HIS全称HospitalInformationSystem，医院信息管理系统。利用电子计算机和通讯设备，为医院所属各部门提供病人诊疗信息和行政管理信息的收集、存储、处理、提取和数据交换的能力，并满足所有授权用户的功能需求5交易指具有一定业务含义的特定动作，在这里指的是对医疗业务数据的一系列收发及相应的处理动作的集合—2—2.系统架构2.1.总体架构浙江省“一卡通”异地就医管理系统以业务专网为基础，进行实时的数据交换，以支持参保人实时刷卡异地就医的数据传输要求。异地定点医疗机构通过省市业务专网直接访问省实时结算交易系统，由省实时结算交易系统根据社保卡路由到参保地进行交易验证和结算。省异地就医应用管理平台通过跨省异地接入系统，经业务专网与国家异地就医结算平台对接，实现跨省异地就医业务。2.2.实时交易数据流2.2.1.跨省异地就医实时结算—3—流程说明：1、两定机构发送异地就医请求至就医省医保系统。2、就医省平台对报文数据进行规范性检验，不符合省规范的则直接报错提示返回，符合规范的业务则判断是否为跨市异地，是则转发至参保地地市平台，如为跨省异地则省平台根据部接口规范对报文进行转换，转发请求至国家异地就医结算系统。3、国家异地就医结算系统对转发的业务数据进行规范性检验，不符合部规范的则直接返回。符合规范的业务由国家异地就医结算系统转发到参保省平台。4、参保省平台对转发的业务数据进行规范性检验，不符合部规范的则直接返回。参保省平台根据省内异地就医接口规范对报文格式进行转换，转发请求至参保地地市平台。5、参保地市平台转发请求至参保地医保系统。—4—6、参保地执行业务过程并将处理结果返回给参保地地市平台。7、参保地市平台转发请求至参保省平台。8、参保省平台数据落地存储并将返回结果转发请求至国家异地就医结算系统，由参保省结算系统往国家异地就医结算系统转发的业务数据必须符合国家异地就医结算系统的标准。9、国家异地就医结算系统数据落地存储，将处理结果转发至就医省平台。10、就医省平台数据落地存储，根据省内异地就医接口规范对报文格式进行转换，将转换后的处理结果返回至两定机构。2.2.2.跨市异地就医实时结算流程说明：1、两定机构发送异地就医请求至就医省医保系统。2、就医省平台对报文数据进行规范性检验，不符合省规范的则直接报错提示返回，符合规范的业务则判断是否为跨市异地，是则转发至参保地地市平台。3、参保地市平台转发请求至参保地医保系统。—5—4、参保地执行业务过程并将处理结果返回给参保地地市平台。5、参保地市平台转发请求至省平台。6、省平台数据落地存储，将处理结果返回至两定机构。3.接入准备3.1.接入模式1)前台首先调用嵌入模块中交易初始化函数，连接远程的交易处理服务器，进行系统运行必要的初始化处理（参考3.2）。交易初始化函数调用失败则无法进行医保其他交易调用.2)前台根据具体业务要求调用对应交易，调用时需提供用户交易类型号和交易数据包。用户交易类型号必须是接口系统定义的有效号码(参考4联机交易的业务范围)，交易数据包按照具体打包规则生成（参考3.5报文结构定义）。3)调用用户交易申请,并等待返回结果.4)医疗机构系统保存医保返回交易结果,并根据交易结果对自身数据进行处理。5)交易结束并返回结果后，如果交易涉及账户扣款等业务一般不可以回退，如果由于意外原因造成HIS端失败，需要通过对医保独立的退费交易回退接口正确的交易。—6—3.2.用户接口函数3.2.1.配置文件文件名：EPTradeCfg_YKT.ini说明：须与YKTMedInterface.DLL在同一目录下，带下划线的需要医院自行配置，其他由接口统一定义统一提供。文件内容（带下划线部分需要各医院配置）：[WEBSERVICE]IP1=10.87.0.71:8080;省异地就医联网结算服务地址IP2=10.87.0.70:8080;省异地就医上传下载类服务地址TradeVer=0400;交易版本号Timeout=30;超时响应[SYSTEM]SysHaveInit=2016/11/25TermLog=1[USERTRADE]9201=9201,16,010001010100000,30,1111,1111,0,19203=9203,34,000101111101100,30,1111,1111,1,19202=9202,34,000001111110100,30,1111,1111,0,13.2.2.交易初始化医疗机构软件每次启动时，需要调用接口系统中用户交易初始化函数，初始化接口并获得交易参数。如果用户终端需要长期运行，在跨日操作时，也需要重新调用交易初始化函数更新接口初始化数据。同样，应用软件退出时调用用户交易关闭函数释放系统资源。函数原型：Intf_Init(constchar*Data1,char*Data2,char*retMsg)功能：系统应用前初始化数据准备入参Data1--传递空值Data2--传入医疗机构编号—7—retMsg--返回的信息返回值=0--成功，没有任何警告，返回信息在retMsg中。0--成功，但是有警告信息，警告信息在retMsg。0--失败，错误信息在retMsg中。PowerBuilder中函数定义：FUNCTIONintegerf_Init(stringlpData1,stringlpData2,refstringlpMessage)libraryYKTMedInterface3.2.3.读卡函数函数原型：intf_ReadICCard(constchar*HospCode,char*retMsg)功能：选择社保卡社会保障系统环境后，通过PSAM卡或省/部加密机对社保卡进行内部认证，通过后将卡内的基本信息读出返回。入参HospCode：传入医疗机构编号retMsg：返回的信息当函数执行成功时，该输出参数为读出的社保卡基本信息各数据项，依次为：发卡地区行政区划代码（卡识别码前6位）、社会保障号码、卡号、卡识别码、姓名、卡复位信息（仅取历史字节）、规范版本、发卡日期、卡有效期、终端机编号、终端设备号。各数据项之间以“|”分割，且最后一个数据项以“|”结尾。例如：639900|111111198101011110|X00000019|639900D15600000500BF7C7A48FB4966|张三|00814E43238697159900BF7C7A|1.00|20101001|20201001|410100813475|终端设备号|。返回值=0--成功，没有任何警告，返回信息在retMsg中。0--成功，但是有警告信息，警告信息在retMsg。0--失败，错误信息在retMsg中。PowerBuilder中函数定义：FUNCTIONintegerf_ReadICCard(stringHostCode,refstringretMsg)libraryYKTMedInterface3.2.4.实时结算类交易申请函数原型：Intf_UserApply(intCode,constchar*HospCode,constchar*Data1,char*Data2,char*retMsg)功能：实现具体的业务，医疗机构通过调用该函数申请相关用户交易并获取交易结果。交易范围：4.1实时结算类交易。—8—参数说明：入参Code–用户交易类型代码HospCode–传入医疗机构编号Data1—传入报文体，格式参考3.5.2参数数据格式Data2—传入接收方行政区划和发送报文ID，中间用单波浪线‘~’分割。接收方行政区划：跟机构相关的如对账交易传省平台行政区划‘330000’；跟参保人业务相关的交易:9201传卡识别码前6位，其余交易传9201参保地返回的参保地行政区划代码；发送报文ID：医院端唯一的发送报文ID，必须保证本医院内唯一，后续交易作废需要使用到该ID进行处理。每笔交易的唯一标识，规则：医院编码（12位）+顺序号（18）；retMsg--交易返回的传出参数，格式参考3.5.3参数数据格式返回值=0--成功，没有任何警告，返回信息在retMsg中。0--成功，但是有警告信息，警告信息在retMsg。0--失败，错误信息在retMsg中。注：pb调用的时候一定要用Space函数为传出参数分配足够空间PowerBuilder中函数定义：FUNCTIONintegerf_UserApply(integernTradeTypeID,stringHospCode,stringlpData1,stringlpData2,refstringretMessage)libraryYKTMedInterface3.2.5.上传下载类交易申请函数原型：Intf_DataTransApply(intCode,constchar*HospCode,constchar*Data1,char*Data2,char*retMsg)功能：实现具体的业务，医疗机构通过调用该函数申请相关用户交易并获取交易结果。交易范围：4.2上传下载类交易。参数说明：入参Code–用户交易类型代码HospCode–传入医疗机构编号Data1—传入报文体Data2—传入接收方行政区划（默认传省平台行政区划‘330000’）retMsg--交易返回的传出参数，格式参考3.5参数数据格式—9—返回值=0--成功，没有任何警告，返回信息在retMsg中。0--成功，但是有警告信息，警告信息在retMsg。0--失败，错误信息在retMsg中。注：pb调用的时候一定要用Space函数为传出参数分配足够空间PowerBuilder中函数定义：FUNCTIONintegerf_UserApply(integernTradeTypeID,stringHospCode,stringlpData1,stringlpData2,refstringretMessage)libraryYKTMedInterface3.3.三大目录要求1．药品、诊疗项目和服务设施目录：异地就医统一执行省人力资源和社会保障厅制定的《浙江省基本医疗保险、工伤保险和生育保险药品目录》和《浙江省基本医疗保险医疗服务项目服务目录》。2．疾病目录：ICD-10疾病目录采用国家统一的代码。3.4.业务数据控制要求3.4.1.金额小数位文档里传入传出参数中类型是double、integer数值型的字段，如果没有值则默认传0。由于定点机构和医保接口分别由不同软件实现，两者间对业务数据的结算可能会出现进制误差。费用的总额以定点机构上传的总额为准，要求就医地和参保地均采用以下算法：单价