浙江省社会保障“一卡通”异地就医两定机构接入开发手册（Version：4.0）1.概述1.1.背景为确保各地医疗机构信息系统采用统一标准的对接方式、数据格式、处理流程接入社会保障“一卡通”异地就医管理系统，顺利实现参保人员医疗保险异地就医业务，特编写此规范。
1.2.目标浙江省范围内的基本医疗保险参保人员持“中华人民共和国社会保障卡”（以下简称社保卡），在全省的基本医疗保险定点医疗机构和定点零售药店（以下称“两定”机构）就医、购药，通过医疗保险网络信息系统，实现直接刷卡结算医疗费用。
1.3.名词解释在本开发手册文档内，使用部分简略说明，其含义以本定义为准。
2.系统架构2.1.总体架构浙江省“一卡通”异地就医管理系统以业务专网为基础，进行实时的数据交换，以支持参保人实时刷卡异地就医的数据传输要求。
异地定点医疗机构通过省市业务专网直接访问省实时结算交易系统，由省实时结算交易系统根据社保卡路由到参保地进行交易验证和结算。
省异地就医应用管理平台通过跨省异地接入系统，经业务专网与国家异地就医结算平台对接，实现跨省异地就医业务。
2.2.实时交易数据流2.2.1.跨省异地就医实时结算流程说明：1、两定机构发送异地就医请求至就医省医保系统。
2、就医省平台对报文数据进行规范性检验，不符合省规范的则直接报错提示返回，符合规范的业务则判断是否为跨市异地，是则转发至参保地地市平台，如为跨省异地则省平台根据部接口规范对报文进行转换，转发请求至国家异地就医结算系统。
3、国家异地就医结算系统对转发的业务数据进行规范性检验，不符合部规范的则直接返回。
符合规范的业务由国家异地就医结算系统转发到参保省平台。
4、参保省平台对转发的业务数据进行规范性检验，不符合部规范的则直接返回。
参保省平台根据省内异地就医接口规范对报文格式进行转换，转发请求至参保地地市平台。
5、参保地市平台转发请求至参保地医保系统。
7、参保地市平台转发请求至参保省平台。
8、参保省平台数据落地存储并将返回结果转发请求至国家异地就医结算系统，由参保省结算系统往国家异地就医结算系统转发的业务数据必须符合国家异地就医结算系统的标准。
9、国家异地就医结算系统数据落地存储，将处理结果转发至就医省平台。
10、就医省平台数据落地存储，根据省内异地就医接口规范对报文格式进行转换，将转换后的处理结果返回至两定机构。
2.2.2.跨市异地就医实时结算流程说明：1、两定机构发送异地就医请求至就医省医保系统。
2、就医省平台对报文数据进行规范性检验，不符合省规范的则直接报错提示返回，符合规范的业务则判断是否为跨市异地，是则转发至参保地地市平台。
3、参保地市平台转发请求至参保地医保系统。
5、参保地市平台转发请求至省平台。
6、省平台数据落地存储，将处理结果返回至两定机构。
3.接入准备3.1.接入模式1)前台首先调用嵌入模块中交易初始化函数，连接远程的交易处理服务器，进行系统运行必要的初始化处理（参考3.2）。
交易初始化函数调用失败则无法进行医保其他交易调用.2)前台根据具体业务要求调用对应交易，调用时需提供用户交易类型号和交易数据包。
用户交易类型号必须是接口系统定义的有效号码(参考4联机交易的业务范围)，交易数据包按照具体打包规则生成（参考3.5报文结构定义）。
3)调用用户交易申请,并等待返回结果.4)医疗机构系统保存医保返回交易结果,并根据交易结果对自身数据进行处理。
5)交易结束并返回结果后，如果交易涉及账户扣款等业务一般不可以回退，如果由于意外原因造成HIS端失败，需要通过对医保独立的退费交易回退接口正确的交易。
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.交易初始化医疗机构软件每次启动时，需要调用接口系统中用户交易初始化函数，初始化接口并获得交易参数。
如果用户终端需要长期运行，在跨日操作时，也需要重新调用交易初始化函数更新接口初始化数据。
同样，应用软件退出时调用用户交易关闭函数释放系统资源。
函数原型：Int f_Init(const char* Data1, char* Data2, char* retMsg)功能：系统应用前初始化数据准备PowerBuilder中函数定义：FUNCTION integer f_Init(string lpData1,string lpData2, ref string lpMessage) library "YKTMedInterface"3.2.3.读卡函数函数原型：int f_ReadICCard(const char* HospCode, char* retMsg)功能：选择社保卡社会保障系统环境后，通过PSAM卡或省/部加密机对社保卡进行内部认证，通过后将卡内的基本信息读出返回。
PowerBuilder中函数定义：FUNCTION integer f_ReadICCard(string HostCode,ref string retMsg) library "YKTMedInterface"3.2.4.实时结算类交易申请函数原型：Int f_UserApply(int Code, const char* HospCode, const char* Data1, char* Data2, char* retMsg)功能：实现具体的业务，医疗机构通过调用该函数申请相关用户交易并获取交易结果。
交易范围：4.1实时结算类交易。
参数说明：注：pb调用的时候一定要用Space函数为传出参数分配足够空间PowerBuilder中函数定义：FUNCTION integer f_UserApply(integer nTradeTypeID ,string HospCode,string lpData1,string lpData2, ref string retMessage) library "YKTMedInterface"3.2.5.上传下载类交易申请函数原型：Int f_DataTransApply(int Code, const char* HospCode, const char* Data1, char* Data2, char* retMsg)功能：实现具体的业务，医疗机构通过调用该函数申请相关用户交易并获取交易结果。
交易范围：4.2上传下载类交易。
参数说明：注：pb调用的时候一定要用Space函数为传出参数分配足够空间PowerBuilder中函数定义：FUNCTION integer f_UserApply(integer nTradeTypeID ,string HospCode,string lpData1,string lpData2, ref string retMessage) library "YKTMedInterface"3.3.三大目录要求1．药品、诊疗项目和服务设施目录：异地就医统一执行省人力资源和社会保障厅制定的《浙江省基本医疗保险、工伤保险和生育保险药品目录》和《浙江省基本医疗保险医疗服务项目服务目录》。
2．疾病目录：ICD-10疾病目录采用国家统一的代码。
3.4.业务数据控制要求3.4.1.金额小数位文档里传入传出参数中类型是double、integer数值型的字段，如果没有值则默认传0。
由于定点机构和医保接口分别由不同软件实现，两者间对业务数据的结算可能会出现进制误差。
费用的总额以定点机构上传的总额为准，要求就医地和参保地均采用以下算法：单价保留4位小数，每个药品诊疗明细四舍五入保留2位小数，如：费用1：0.0038×10=0.038，四舍五入后结果为0.04；费用2：0.0026×10=0.026，四舍五入后结果为0.03；总费用：0.04+0.03=0.073.4.2.日期时间格式传入参数和传出参数使用统一的日期时间格式，格式如下：3.4.3.预留字段处理原则在联机各交易的备注中有标注是预留的字段，表示本次暂不应用，为了以后的扩展而预留。
就医地和参保地不能把预留字段挪做它用，也不需要处理。
字符型的预留字段默认传空白，数值型的默认传0。
3.4.4.业务参数个数超长的处理原则发起方或接收方在处理各类交易时都必须严格按照开发手册中定义的参数个数进行传输，如果由于某些特殊原因导致传输的业务参数个数超过规定范围，发起方或接收方在处理时只需要处理规定范围内的业务参数即可，超出范围外的参数不予处理。
如9201号交易【获取异地人员信息】传入参数有16个参数，如果发起方传入了17个参数，那接收方只需要根据前16个参数进行该交易正常处理即可。
3.5.报文结构定义3.5.1.报文结构●术语解释●分隔符业务流程中传递的所有与业务有关的数据在报文头之后以特定的格式写入。
传递的参数使用了几个特殊符号作为分割符，因此，用户提供的参数数据中不能包含这些固定的分割符号，由于这些符号只可能出现在“名称”等固定字符串中，因此用户应在组装参数前过滤掉数据包中可能出现的保留字符，否则交易会出现意外错误。
目前系统保留的参数保留字符包括以下几个：●报文体报文体包括用户系统向接口系统提出的交易申请和接口系统反馈给外部用户系统的交易处理结果，不同类型的业务报文体中域的个数和含义均有所差异，具体参照联机交易中的各个业务交易。
报文体以$$做为交换数据包的开头和结束符。
报文体中若有多个域，各域之间用～分隔。
例如：$$111～22222$$，表示报文体中有两个域，第一个域111，第二个域22222。
$$111～$$，表示报文体中有两个域，第一个域111，第二个域为空。
$$111$$，表示报文体中有一个域，第一个域111。
