张家港医保中心系统与医院系统实时联接接口规范

张家港医保中心系统与医院系统实时联接接口规范 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 2012 张家港医疗保险费用结算审核 苏州嘉华计算机系统工程有限公司 张家港市劳动和社会保障局计算机信息中心 2012-06-06 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 历 史 版 本 版本日期 作者 修改原因 1.0 2009-04-01 王锋伟 初始化版本 1.0 2009-07-01 王锋伟 正式发布第一版 2.02010 -11-01 王锋伟 社会保障(市民)卡切换 2.0 2011-08-24 王锋伟 附录E -1.1 2.02011 -09-06 王锋伟 附录E -1.2 2.12012 -01-01 王锋伟 文档模板重新整理(2012) 3.0 2012-01-09 王锋伟 新增个人账户拓展(健康运动刷卡) 4.0 2012-06-06 王锋伟 新增住院单病种交易 第 1 页 共 105 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 目 录 第1章. 概述 ..................................................................................................................................... 5 第2章. 医院系统的环境与通信接口方式 ....................................................................................... 6 第3章. 调用医保接口程序的操作步骤 ........................................................................................... 7 3.1. 客户端配置文件格式............................................................................................................. 7 第4章. 调用医保接口程序的操作步骤 ........................................................................................... 9 4.1. 系统交互图 ............................................................................................................................ 9 4.2. 一般交易流程详解 ................................................................................................................ 9 () ..................................................................................................................... 9 4.2.1. 登记撤消 4.2.1.1. 业务流程 ............................................................................................................................... 10 4.2.1.2. 业务流程描述 ....................................................................................................................... 10 4.2.2. 医保报销结算(退费) .................................................................................................... 10 4.2.2.1. 业务流程 ............................................................................................................................... 11 4.2.2.2. 业务流程描述 ....................................................................................................................... 11 第5章. 消息规范 ........................................................................................................................... 13 5.1. BUSINESSXML ...................................................................................................................... 13 5.2. BUSINESSXML简介 .............................................................................................................. 13 5.2.1. 请求和响应的参数 ....................................................................................................... 14 5.2.2. RowsetXML类型 ........................................................................................................... 15 5.2.3. ListXML类型 ................................................................................................................ 17 5.3. 交易类型定义 ...................................................................................................................... 19 5.4. 参数指标体系 ...................................................................................................................... 20 5.4.1. 参保人员信息(SIMESSAGE) ........................................................................................ 20 5.4.2. 个人医保卡冻结信息(FREEZE) ................................................................................... 21 5.4.3. 个人医保登记信息(REGISTER) ................................................................................... 21 5.4.4. 个人医保年度住院(INHOSPITALREC)................................................................. 21 5.4.5. 个人医保年度门诊记录(CLINICREC) ......................................................................... 22 5.4.6. 目录对照(COMPARISION) ........................................................................................... 23 5.4.7. 对照项目(CATALOGITEM) .......................................................................................... 23 5.4.8. ...................................................................................................................... 24 药品目录 5.4.9. ...................................................................................................................... 26 费用目录 5.4.10. 病种目录 .................................................................................................................... 27 5.4.11. 科室目录 .................................................................................................................... 27 5.4.12. 结算结果(BALANCE) ................................................................................................. 27 5.4.13. 门诊收费单项目(TOLL ITEM) ................................................................................... 28 5.4.14. 门诊收费单项目列表(TOLL ITEMLIST) .................................................................... 28 5.4.15. 门诊收费单(TOLL)..................................................................................................... 28 第 2 页 共 105 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 5.4.16. (CLINIC).............................................................................................. 29 门诊收费信息 5.4.17. (INHOSPITAL) ............................................................................................ 29 入院信息 5.4.18. 转科信息(REINHOSPITAL) ........................................................................................ 30 5.4.19. 住院记帐项目(BILLITEMS) ....................................................................................... 30 5.4.20. 住院记帐项目的医保属性(YBBILLITEMS) ................................................................ 31 5.4.21. 出院病历(MEDICALRECORD) .................................................................................. 31 5.4.22. 结算控制字 (CONTROLWORD) ................................................................................ 32 5.4.23. 费用分类信息(CHARGE) ........................................................................................... 32 5.4.24. 分段信息(SUB) .......................................................................................................... 35 5.4.25. (BALANCEITEM) ........................................................................................ 35 结算明细 5.4.26. (BALANCELIST) .................................................................................. 36 结算明细信息 5.4.27. (SUSPENDBALANCE) ..................................................................... 36 未提交结算明细 5.4.28. (ICCHANGE) ........................................................................... 38 帐户及累计信息变化 (fwxmrowset) ............................................................................................... 38 5.4.29. 服务项目 5.4.30. (BEARINGMESSAGE) ................................................................................. 39 生育信息 5.4.31. 结算结果信息 ............................................................................................................ 39 第6章. 基本概念和数据精度说明 ................................................................................................ 42 6.1. 基本概念 ............................................................................................................................. 42 6.2. 数据精度说明 ...................................................................................................................... 43 第7章. 交易手册 ........................................................................................................................... 44 7.1. 读医保病人信息 .................................................................................................................. 44 7.2. 目录对照 ............................................................................................................................. 45 7.3. 对照查询 ............................................................................................................................. 45 7.4. 通用查询(分时) ................................................................................................................... 47 7.5. 门诊预结算 .......................................................................................................................... 48 7.6. 入院登记 ............................................................................................................................. 49 7.7. 住院转科登记 ...................................................................................................................... 50 7.8. 住院记帐 ............................................................................................................................. 51 7.9. 住院费用查询 ...................................................................................................................... 52 7.10. 出院预结算........................................................................................................................ 53 7.11. 中心报销预结算 ................................................................................................................ 56 7.12. 退费 ................................................................................................................................... 57 7.13. 撤消入院登记 .................................................................................................................... 58 7.14. 撤消住院转科登记 ............................................................................................................ 59 7.15. 结算 ................................................................................................................................... 60 7.16. 提交 ................................................................................................................................... 61 7.17. 回退 ................................................................................................................................... 62 7.18. 异常处理1......................................................................................................................... 63 7.19. 住院结算单打印 ................................................................................................................ 64 7.20. 通用查询(实时) ................................................................................................................. 65 第8章. 附录A 程序员函数参考手册 ............................................................................................ 68 8.1. 医保接口DLL动态连接库API函数手册 .......................................................................... 68 第 2 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 8.1.1. ....................................................................................................... 68 医保交易接口函数 , Init........................................................................................................................................... 68 , OpenBuffer ............................................................................................................................... 68 , Service ..................................................................................................................................... 69 , CloseBuffer ............................................................................................................................. 69 8.1.2. 消息缓冲区处理函数 ................................................................................................... 70 , CreateXML ................................................................................................................................. 70 , Add ............................................................................................................................................ 70 , AddHandle ................................................................................................................................. 72 , InsertRow ................................................................................................................................. 72 , AddIn ......................................................................................................................................... 73 , AddInHandle ............................................................................................................................. 74 , AddOut ....................................................................................................................................... 75 , AddOutHandle ........................................................................................................................... 76 , SetH........................................................................................................................................... 76 , SetBusinessNo.......................................................................................................................... 77 , SetBusinessTimeOut ................................................................................................................ 78 , SetCardFlag ............................................................................................................................. 78 , ChildSize ................................................................................................................................. 79 , ChildRows ................................................................................................................................. 79 , FirstChild ............................................................................................................................... 80 , NextChild ................................................................................................................................. 80 , Get ............................................................................................................................................ 81 , GetH........................................................................................................................................... 81 , GetErrorFlag ........................................................................................................................... 82 , GetErrorMessage ...................................................................................................................... 83 , GetOfIndex ............................................................................................................................... 83 , GetOfName ................................................................................................................................. 84 , GetOut ....................................................................................................................................... 85 , ToString ................................................................................................................................... 86 , ToSave ....................................................................................................................................... 86 8.1.3. 配置函数 ...................................................................................................................... 87 , SetComm ..................................................................................................................................... 87 , SetTimeout ............................................................................................................................... 87 , SetServerIP ............................................................................................................................. 88 , SetServerPort.......................................................................................................................... 88 , GetComm ..................................................................................................................................... 89 , GetTimeout ............................................................................................................................... 89 , GetServerIP ............................................................................................................................. 90 , GetServerPort.......................................................................................................................... 90 8.1.4. 其他函数 ...................................................................................................................... 91 8.2. 医保接口DLL动态连接库API函数使用参考................................................................... 91 8.2.1. Delphi开发 ................................................................................................................... 91 8.2.2. PowerBuilder开发 ........................................................................................................ 93 第 3 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 8.2.3. Java ...................................................................................................................... 93 开发 第9章. 附录B 科室编码表 ........................................................................................................... 94 第10章. 附录C 2011年社会保障(市民)卡切换医院端 ................................................... 97 10.1. 医院信息管理系统改造要求 ............................................................................................. 97 10.2. 社会保障(市民)卡上线，医院的工作 .......................................................................... 99 第11章. 附录D 常见问题集 ....................................................................................................... 100 问题1:提示“因为与社保中心的网络不通,医保卡【****】年度没圈存或者存在异常读写，无法刷卡!” ............................................................................................................................... 100 ” .......... 100 问题2:提示“医保卡出现异常，请回上次就诊医疗机构【*****】做异常恢复! 问题3:提示“当前医疗机构【*****】与医保中心网络不通，请回上次就诊医疗机构【*****】做异常恢复～” .......................................................................................................................... 100 问题4:提示“出现不可知异常，请回社保中心处理医保卡的异常! ” ................................. 101 问题5:提示“与医保中心的网络不通已经有【**】小时，请务必尽快修复。如果网络不通达到72小时将自动关闭医保交易! ” .......................................................................................... 101 问题6:提示“与医保中心的网络不通,无法提供医保交易服务!” ....................................... 101 第12章. 附录E 修改记录 ........................................................................................................... 102 12.1. 时间:2011年8月24日 ................................................................................................ 102 12.1.1. 内容1:读卡时返回“人员通讯地址”(取人员表) ............................................. 102 12.1.2. 内容2:医保暂停定点标志(hos_yljg.yljgksqtbz=0)提示“取消定点”修改成“暂 ” ................................................................................................................................. 102 停定点 12.1.3. 内容3:读卡返回“冻结记录”按个人编号或卡号取冻结记录，因为卡号可能对应 (身份证号相同)，所以造成错误提示，取消“卡号”条件。 ................... 102 不同的个人编号 12.2. 时间:2011年9月6日 .................................................................................................. 102 12.2.1. 内容1:读卡时返回“人员通讯地址”(修改取地址的方法:默认人员表的，若制卡 ............................................................................ 102 文件的通讯地址不空，用该地址取代。) 12.2.2. 内容2:读卡时返回“人员通讯电话”(取制卡信息)和“单位名称”(取单位表) .............................................................................................................................................. 102 12.2.3. 内容3:提交交易pub02升级，临时表的删除工作不在交易中执行，由数据库job 定时晚上12点定时来执行删除，提高交易的性能。 ......................................................... 103 第 4 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第1章. 概述 张家港市城镇基本医疗保险制度实施以来，现行承担医保刷卡支付的“银行小系统(医保费用分时刷卡结算系统)”为医疗保险费用的结算审核发挥了良好的作用。从建立与完善医保制度的长效管理机制的目标出发，对医保费用的结算审核要求趋向于更为合理具体，对医保政策的实施要求更为安全、及时和准确。为了进一步完善结算审核计算机管理系统，有必要对现有的“银行小系统(医保费用分时刷卡结算系统)”进行改造升级、细化调整。特提出以下医保中心系统与医院系统的接口规范。要求各医疗机构严格执行。 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第2章. 医院系统的环境与通信接口方式 根据目前已了解到的情况，现有的医院系统的环境有以下几种: 1(WinNT/Win2000局域网 + Windows客户端,网络为TCP/IP。 2(Windows环境的单机系统。 为了在医院系统与中心系统之间传递医疗费用实时支付数据(以下简称为数据传((((((((((((((((((((((( 输)，实现对医保的实时交易，针对上述2种情况，采用下述二种配置设备的方案。 其一，对于上述第1种情况，即医院系统已具备局域网环境的情况下，增配一台PC服务器，作为通信专用服务器挂在医院系统的局域网上。局域网上的其他各台客户端设备通过此通信专用服务器与中心系统进行数据传输。以下，简称此机为前置机。该前置机的操作系统为Windows 2000 Professional或Windows 2003 Professional版;前置机安装分时数据库、分时医保应用软件、数据传输应用软件;医院系统的其他各台客户端安装嵌入式DLL模块，医院系统通过调用嵌入式DLL模块中的API函数实现医保交易。 嵌入式DLL模块: 以函数的参数方式传递要发送的消息，并以参数方式获取返回消息。消息的格式使用XML。 其二，对于上述第2种情况，即医院仅使用单机(而不是局域网)的情况中，必须在Windows环境下运行(而不能在DOS环境下运行)，所以此类单机的操作系统必须为Windows，并安装浏览器Internet Explorer(版本6.0以上)，以上网的方式实现医保刷卡;单机系统必须带Ukey安全钥匙，必须将Ukey安全钥匙插在计算机上才能上网操作。 上网地址由张家港市劳动和社会保障局信息中心发布;Ukey安全钥匙需要自行向指定的商家购买，在购买时，由商家负责在医保系统中注册后才能使用。关于Ukey安全钥匙的使用方法见使用手册说明。 第 6 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第3章. 调用医保接口程序的操作步骤 医院系统的客户端通过调用医保接口程序(以下简称通信模块)，实现医保刷卡客(((((( 户端与医保主机系统之间的数据传输。具体操作步骤如下: 1)嵌入式DLL名:Business2.dll; 2)每次启动医院系统时要调用医保初始化函数。每次启动业务系统时，调用一次。 函数名:Init; 该函数的主要功能:检查嵌入式模块的版本，初始化医保接口环境; 3)调用每个医保交易的过程，分以下四步: ? 创建消息缓冲区，打开交易; 函数名:OpenBuffer; ? 设置交易类型和交易超时时间; ? 设置交易参数; ? 发送消息，执行医保交易; 函数名:Service; ? 返回响应消息后，取返回结果，并处理。 ? 关闭消息缓冲区，关闭交易; 函数名:CloseBuffer; 嵌入式DLL的函数原型以及“设置交易参数”和“取返回结果”的函数原型详见“附 录 A”; 3.1. 客户端配置文件格式 , 配置文件名为:zjgyb20.ini，存放在嵌入式DLL模块所在目录下。 , 文件内容如下: [URL] sSERVERIP = 10.2.1.158 sSERVERPORT = 7001 [CARDREADER] iCOMM = 1 iTIMEOUT =30 其中，sSERVERIP为前置机的IP地址; sSERVERPORT为前置机的通讯端口; 第 7 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) iCOMM为保障卡读写POS机所连接的COM口(可为COM1~COM9); iTIMEOUT为保障卡读写POS机密码键盘输入密码的等待时间(单位:秒)。 , 配置文件会自动生成;配置文件中参数的获取和修改使用提供的函数(详见“附 录 A”)。 注:如使用社会保障卡，调用医保接口时，保障卡必须插在保障卡机具内，((((((((((((((保证保障卡读写的正确性。 ((((((((((( 第 8 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第4章. 调用医保接口程序的操作步骤 4.1. 系统交互图 医院系统嵌入式DLL通讯模块前置医保应用服务器中心医保应用服务器 XML + API?XML + HTTP?XML + HTTP ? ? ? ? ? 医院系统设置消息缓冲区(消息规范详见第五部分;各个医保交易的消息内容详见第七部分)，调用嵌入式DLL中的API函数; ? 嵌入式DLL的API函数将消息通过HTTP协议传送到前置机; ? 前置机根据交易的类型(分时交易或实时交易)、网络的情况(通或不通)，将实时医保交易的消息通过HTTP协议转发到中心医保应用服务器，若网络不通，实时交易返回网络错误;分时医保交易直接在前置机中执行; ? 医保应用服务器(前置机或中心医保应用服务器)，根据交易的类型，调用相应的医保业务，并做出响应; ? 医保交易的同步响应消息通过HTTP协议返回到医院系统;医院系统根据返回的消息做后续相应处理。 4.2. 一般交易流程详解 4.2.1. 登记(撤消) 登记包括:各类住院登记(基本医疗住院、生育住院等); 第 9 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 4.2.1.1. 业务流程 开始 登记医院本地数据库 (状态:医保未登记) 登记1.写卡:住院登记标志; ??? 失败成功 更新医院本地数据库 (状态:医保登记) 结束 4.2.1.2. 业务流程描述 1) 调用“读取医保病人信息”交易。 2) 准备登记数据(详见各个交易的参数说明); 3) 医院本地数据库先登记成功(状态:医保住院未登记); 4) 调用通信模块，发送“登记”交易; 5) 若4)成功，则继续6);若4)失败，则回到4); 6) 更新登记状态(医保住院登记)，退出。 4.2.2. 医保报销结算(退费) 医保结算包括:门诊(挂号/收费)结算、住院结算、生育结算和中心报销等; 第 10 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 4.2.2.1. 业务流程 开始 预结算(退费) 成功失败 暂存医院本地数据库(标志:未决) 结算 ?? 失败成功 更新医院本地数据库更新医院本地数据库(提交)(回退) 提交回退 ??定时发起定时发起 失败成功成功失败 更新医院本地数据库(标志:已决) 结束 医院设计的重要说明: 1).暂存医院本地数据库,在结算前做;该结算的状态为“未决”。若不继续结算，就不必要暂存本地数据库。2).若结算成功，医院数据库做提交标志; 若结算失败，医院数据库做回退标志; 必须遵守:一旦做了提交标志,意味着医院必须给医保病人完成结付,即使后续调用”提交”失败;3).提交或回退必须调用成功;所以系统还提供无卡提交和无卡回退的调用;详见交易说明。4).提交或回退的目的就是对结算做决断，如果医保病人存在未决断的记录，将锁住该医保病人继续就医，所以医疗机构系统必须做好结算的提交 和回退。否则医保病人将找医疗机构对交易做出决断。 4.2.2.2. 业务流程描述 1) 调用“读取医保病人信息”交易。 2) 准备结算数据(详见各个交易的参数说明); 3) 调用通信模块，发送“预结算(或退费)”交易。 4) 若3)成功，则继续5);若3)失败，则回到3)，重新调用。 5) 医院收到“预结算结果”后，将响应数据(医保结算流水号、结算结果)暂时存入 医院本地数据库，该结算的状态设置为“未决”。 第 11 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 响应数据包括:医保结算流水号、结算结果等;其中，“医保结算流水号”是一个 很重要的流水号，许多后续交易(结算、提交、回退等)要提供“医保结算流水号” 作为入参。 6) 调用通信模块，发送“结算”交易，将“医保结算流水号”一并上传。 7) 若6)成功，则结算成功，更新医院本地数据库(做“提交”标志)，可以对医保病 人进行报销，不管后续步骤。 若6)失败，则结算失败，更新医院本地数据库(做“回退”标志); 8) 根据7)的结果，发送“提交”交易或“回退”交易; 如果发送“提交”交易，不管提交的成功或失败，继续完成医保病人的结付。 9) 医院系统要必须保证“提交”交易或“回退”交易的成功执行。这两个交易可以是 无卡(即医保病人已经离开了医院); 如果结算不被提交或回退，会造成参保病人不能继续就医，所以医院系统必须对结 算通过“提交”交易或“回退”告知中心该结算的成功或失败。 第 12 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第5章. 消息规范 5.1. BusinessXML 消息为XML格式，即BusinessXML;它是一个自行定义的轻量级信息交换协议，并应用 于分散的、分布式医疗保险接口应用环境。在XML的基础上，BusinessXML为医疗保险接口 系统定义了一个消息传输框架。 BusinessXML描述了消息传送的内容，以及这些消息中数据表示的编码方案，并且为在 远程过程调用和响应中使用他们指定了一个规则。 注:因为XML消息区分大小写，所以参数名的大小写严格按规范定义。 (((((((((((((( 5.2. BusinessXML简介 采用BusinessXML定义的消息都是简单的XML文档。它们包含一些指定的结构，和一些 完全由应用程序(医保交易)决定的内容。 BusinessXML消息的基本结构如清单6-1所示。 清单6-1:一个BusinessXML消息 1.0 0 < /ICENVIRONMENT> BusinessXML消息的内容见表格6-1所示。 表格6-1:BusinessXML内容 BusinessXML 名称中文名 叶子 可扩展扩展类型 描述 第 13 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 业务消息根HEAD 业务消息根节点 ? ? BUSINESSBODY 节点 业务消息的第一个节点;消 息头定义了消息的处理服 VERSION 务，以及消息的响应结果， SYSTEM 包含: ROUTER VERSION METHOD SYSTEM HEAD 业务消息头 ? ? ERROR ROUTER LOG METHOD ICENVIRONMENTERROR LOG ICENVIRONMENT BusinessXML的版本号 VERSION消息版本号 ? ? BUSINESSNO 系统扩展 SYSTEM系统扩展 ? ? TIMEOUT 业务类型;不同的业务类型 编号代表不同的业务，系统 BUSINESSNO 业务类型号? ? 根据业务类型号调用对应的 业务服务。 业务超时时间，当业务执行业务超时时时间超过本超时时间时，则 TIMEOUT ? ? 抛出系统超时错误。 间 单位:秒 消息经过的路径 ROUTER路由 ?? 对应服务方法名，默认为 METHOD 方法名 ?? Default 返回业务执行结果: 0 正确 ERRORFLG错误标志 1 错误 ExceptionXML 结构 错误信息 ERROR 错误信息? ? LogXML 结构 日志信息 LOG 日志信息 ? ? CARDFLG 医保卡信息 ICENVIRONMENT医保卡信息 ? ? 0:无卡 1:医保卡 CARDFLG 卡标志? ? 2:异地人员 IN 实际的业务请求 OUT BODY 业务消息体 ? ? 包含IN(传参);OUT(出参) HELPER 包含业务请求的所有传入参具体传入参数 IN 传入参数? ? 数 包含业务响应的所有传出参具体传出参数 OUT 传出参数 ? ? 数 帮助(扩展)帮助(扩展) HELPER ? ? 结点 5.2.1. 请求和响应的参数 BusinessXML消息的业务消息体(BODY)中封装了请求参数(IN)和响应参数(OUT); 每个医保交易的请求参数作为IN的子节点，响应参数作为OUT的子节点，这些参数节 点可以采用任意的类型(通过元素的属性type来定义)。参数节点的格式如下: 第 14 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) <传入参数名称 type="传入参数类型">传入参数值 比如:383001 传入传出参数的类型见表格6-2所示。 表格6-2:参数类型 BusinessXML TYPE类型 类型名称 中文名 备注 Byte Byte类型数据 Short Short类型数据 Integer Integer类型数据 Long Long类型数据 Float Float类型数据 Double Double类型数据 BigDecimal BigDecimal类型数据 String String类型数据 串行化格式为:"M/d/yyyy Date Date类型数据 h:m:s" 串行化格式为:"M/d/yyyy Timestamp Timestamp类型数据 h:m:s" Boolean Boolean类型数据 串行化格式为:Hex编码后的InputStream InputStream类型数据 字符串 Clob Clob类型数据 串行化格式为:Hex编码后的Blob Blob类型数据 字符串 RowsetXML RowsetXML类型数据 ListXML ListXML类型数据 5.2.2. RowsetXML类型 RowsetXML是BusinessXML最重要数据结构。主要用于表达记录集; , RowsetXML结构 RowsetXML结构如表格6-3所示。ROW是它的记录，字段是记录的字段; 表格6-3:RowsetXML结构 RowsetXML 名称 中文名 叶子节点 可扩展 扩展类型 描述 ROWSET ROWSET记录 ROWSET的根节点 ROW ? ?集根节点 ROW 记录集行节记录结点 包含以下属性: ? ? 点 num: 记录集行号 字段 具体字段 包含以下属性: ?? type:参数类型 第 15 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) , RowsetXML样例 a1 b1 1 10 5/28/2008 12:0:0 test_procedure_f1 74657 a2 b2 2 9 5/21/2008 12:0:0 test_procedure_f2 746573 22.11 , 字段的类型 字段节点的格式如下: <字段名 isnull="可空否" type="字段类型">字段值 比如:a2 字段类型见表格6-4所示。 表格6-4:字段类型 RowsetXML TYPE类型 类型名称 中文名 备注 -7 BIT类型数据 -6 TINYINT类型数据 5 SMALLINT类型数据 4 INTEGER类型数据 -5 BIGINT类型数据 6 FLOAT类型数据 7 REAL类型数据 8 DOUBLE类型数据 2 NUMERIC类型数据 3 DECIMAL类型数据 第 16 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 1 CHAR类型数据 12 VARCHAR类型数据 1 LONGVARCHAR类型数据 91 DATE类型数据 串行化格式为:"M/d/yyyy h:m:s" 92 TIME类型数据 串行化格式为:"M/d/yyyy h:m:s" 93 TIMESTAMP类型数据 串行化格式为:"M/d/yyyy h:m:s" -2 TIMESTAMP类型数据 -3 VARBINARY类型数据 -4 LONGVARBINARY类型数据 0 NULL类型数据 1111 OTHER类型数据 2000 JAVA_OBJECT类型数据 2001 DISTINCT类型数据 2002 STRUCT类型数据 2003 ARRAY类型数据 2004 BLOB类型数据 串行化格式为:Hex编码后的 字符串 2005 CLOB类型数据 2006 REF类型数据 70 DATALINK类型数据 16 BOOLEAN类型数据 5.2.3. ListXML类型 ListXML是BusinessXML最重要数据结构。主要用于表达非记录型(RowsetXML)的集合 型数据; , ListXML结构 ListXML结构如表格6-5所示。每个EXLEMENT参数是它的子参数。 表格6-5:ListXML结构 ListXML 名称中文名 叶子节点可扩展 扩展类型 描述 LIST LIST根节点 ?? ELEMENT LIST的根节点 LIST中包含的所有明细 ELEMENT节点，包含以下name ELEMENT元素节点 ? ? 两个属性: type Name: 节点名称 Type: 节点数据类型 第 17 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) , ListXML样例 1 a1 b1 1 10 5/28/2008 12:0:0 test_procedure_f1 746573745f70726f6365647572 655f6731 11.22 a1 b1 1 10 5/28/2008 12:0:0 test_procedure_f1 746573745f70726f6365647572655f6731 11.22 a2 b2 2 9 5/21/2008 12:0:0 test_procedure_f2 746573745f70726f6365647572655f6732 22.11 , 参数的类型 参数节点的格式如下: 参数值 比如:a1 参数类型见表格6-6所示。 表格6-6:参数类型 ListXML Type类型 类型名称 中文名 备注 第 18 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) ByteByte类型数据 Short Short类型数据 Integer Integer类型数据 Long Long类型数据 Float Float类型数据 Double Double类型数据 BigDecimal BigDecimal类型数据 String String类型数据 串行化格式为:"M/d/yyyy Date Date类型数据 h:m:s" 串行化格式为:"M/d/yyyy Timestamp Timestamp类型数据 h:m:s" Boolean Boolean类型数据 串行化格式为:Hex编码后的InputStream InputStream类型数据 字符串 Clob Clob类型数据 串行化格式为:Hex编码后的Blob Blob类型数据 字符串 RowsetXMLRowsetXML 类型数据 ListXML ListXML类型数据 5.3. 交易类型定义 医保中心和医院系统实时联网接口提供一系列交易来实现。各种 不同类型的交易分别完成不同的功能。交易类型码表如下。 类型码 说明 YB002 读医保病人信息 SI010 目录对照 SI011 对照查询 SI030 门诊预结算 SI050 入院登记 SI052 住院转科登记 SI055 住院记帐 SI056 住院费用查询 SI057 出院预结算 SI058 单病种出院预结算 SI070 中心报销预结算 SI080 退费 SI081 撤消入院登记 SI082 撤消转科登记 第 19 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) SY002 读生育病人信息 SY030 生育门诊预结算 SY050 生育入院登记 SY057 生育出院预结算 结算 PUB02 PUB06 提交 PUB07 回退 YB201 通用查询(分时) EXP1 异常处理1 5.4. 参数指标体系 5.4.1. 参保人员信息(SIMESSAGE) 序号指标名 指标名称 类型/长度 可空否 说明 string 参保编号1 cbbh 帐号 string 2 zh string 姓名3 xm 性别 string 4 xb 身份证号 string 5sfzh 出生年月 string6csny 人员类别 string 7 rylb 用工类型 string8 yglx 待遇类别(包含标志信息) string 9 dylb string 卡登记病种10 kdjbz 圈存年度 string 11 qcnd 最近一次读卡医疗机构 string12jzyy string 住院状态13 zyzt 住院次数 number 14 zycs number 15 wnzhye 往年帐户余额 number 16dnzhye 当年帐户余额 number17mzyblj 门诊医保累计 number 18 zyyblj 住院医保累计 number19 gwybzzflj公务员补助自负累计 number 20 bczflj补充自负累计 number21 bclj 补充累计 number 22 jzlj 救助累计 number23 mzazyqflj 门诊按住院起付累计 number 24mzazyyblj 门诊按住院医保累计 number25 exzlzyqflj恶性肿瘤住院起付累计 第 20 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) number26 exzlzyyblj恶性肿瘤住院医保累计 string27 rytxdz人员通讯地址 string 28rytxdh 人员通讯电话 string 29 rydw 人员单位 5.4.2. 个人医保卡冻结信息(FREEZE) 序号指标名 指标名称 类型/长度 可空否 说明 帐号 string 1 DJZH 冻结日期 string 2DJSXQ string 冻结原因3DJYY 冻结类型 string 4DJLX 备注 string 5 DJREMARK 5.4.3. 个人医保登记信息(REGISTER) 序号 指标名 指标名称 类型/长度 可空否 说明 string 登记类型1 DJLX 登记日期 string 2 SPRQ 有效日期 string 3 YXQ 5.4.4. 个人医保年度住院记录(INHOSPITALREC) 序号 指标名 指标名称 类型/长度 可空否 说明 JSLSH 结算流水号 string 1 TFBZ 退费标志 String 2 TFLSH 退费流水号 String 3 JSRQ 结算日期 String 4 JSSJ 结算时间 String 5 JSLY 结算来源 String 6 JSYLJG 结算医疗机构 String 7 JYYLJG 就医医疗机构 String 8 ICZH 帐号 String 9 YBRQ 待遇类别 String 10 FYZE 费用总额 number 11 ZFZE 自费总额 Number 12 ZLZE 自理总额 Number 13 YBZE 医保总额 Number 14 第 21 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) WNGZ 往年个帐 Number 15 DNGZ 当年个帐 Number 16 TCZF 统筹支付 Number 17 GWYZF 公务员支付 Number 18 GJZF 共济支付 Number 19 BCZF 补充支付 Number 20 JZZF 救助支付 Number 21 KCZF1 扩充支付1 Number 22 KCZF2 扩充支付2 Number 23 GRZF 个人支付 Number 24 ZHDC 帐户抵冲 Number 25 TJBZ string 提交标志26 5.4.5. 个人医保年度门诊记录(CLINICREC) 序号 指标名 指标名称 类型/长度 可空否 说明 JSLSH 结算流水号 string 1 TFBZ 退费标志 String 2 TFLSH 退费流水号 String 3 JSRQ 结算日期 String 4 JSSJ 结算时间 String 5 JSLY 结算来源 String 6 GHBZ 挂号标志 string 7 JSYLJG 结算医疗机构 String 8 JYYLJG 就医医疗机构 String 9 ICZH 帐号 String 10 YBRQ 待遇类别 String 11 FYZE 费用总额 number 12 ZFZE 自费总额 Number 13 ZLZE 自理总额 Number 14 YBZE 医保总额 Number 15 WNGZ 往年个帐 Number 16 DNGZ 当年个帐 Number 17 TCZF 统筹支付 Number 18 GWYZF 公务员支付 Number 19 GJZF 共济支付 Number 20 BCZF 补充支付 Number 21 JZZF 救助支付 Number 22 第 22 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) KCZF1 扩充支付1 Number 23 KCZF2 扩充支付2 Number 24 GRZF 个人支付 Number 25 ZHDC 帐户抵冲 Number 26 提交标志 string TJBZ27 5.4.6. 目录对照(COMPARISION) 序号 指标名 指标名称 类型/长度 可空否 说明 医院项目编号 varchar2(12) 1 yyxmbh 不可空 医院项目名称varchar2(128) 2 yyxmmc 不可空商品名 医院项目化学名 varchar2(128) 3 yyxmhxm 药品,不可空 医院项目剂型 varchar2(32) 4 yyxmjx 药品 ,不可空 医院项目规格varchar2(64) 5 yyxmgg 药品 ,不可空 省物价编码 varchar2(32) 6 swjbm 诊疗项目不可空 医院项目计价单位 varchar2(32) 7 yyxmjjdw 不可空 医院项目最小包装单位 varchar2(32) 8yyxmzxbzdw 不可空 医院项目最小包装数量 number(4)不可空9 yyxmzxbzsl 自制药填写医院名称;否则填写生产单位varchar2(64) 医院项目生产单位10 yyxmscdw 不可空 全名。 医院项目批准文号 varchar2(32) 11 yyxmpzwh 不可空 批准文号必填 医院项目备注varchar2(512) 12 yyxmbz 费用项目类别 char(1) 13fyxmlb 不可空 1 药品 2 费用(诊疗、服务项目、材料) varchar2(12) 医保项目编号14ybxmbh 不可空 5.4.7. 对照项目(CATALOGITEM) 序号 指标名 指标名称 类型/长度 可空否 说明 ybbh医保编码 string 1 mc 项目名称 string 2 fzmc 项目辅助名称 string 3 fylb 费用类别 string 4 sfdj string 收费等级5 bzjx 标注剂型 string 6 syjx使用剂型 string 7 gg 规格 string 8 计量单位 string jldw9 第 23 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) zxjldw 最小计量单位 string 10 zxbzsl 最小包装数量 number 11 cfy 处方药 string 12 1 是处方药 mrdjxe 默认单价限额 13 number yjyydjxe一级医院单价限额 14 number ejyydjxe 二级医院单价限额 15 number sjyydjxe 三级医院单价限额 16 number mzbdjxe 门诊部单价限额17 number yddjxe 药店单价限额 18 number zlbl 自理比例(基本医疗) 19 number zlblsy自理比例(生育) 20 number zlblgs 自理比例(工伤) 21 number zlbllx自理比例 (离休) 22 number zlbley 自理比例(二乙) 23 number zlblgwy 自理比例(公务员) 24 number zlblse 自理比例(少儿) 25 number zlblnh 自理比例(农合) 26 number djfs 定价方式 27 string xzsyfw 限制使用范围 28 string xmnh 项目内涵 29 string xmcw 项目除外 30 string xmsysm 项目使用说明 31 string zxrq 执行日期 32 string zfbz 作废标志 33 string 1 作废 scqy 生产企业 34 string pzwh 批准文号(制剂文号) 35 string 有卡查询时，实际使用的报销限报销限额 36 bxxe number 额;0表示不限额 有卡查询时，实际使用的报销自理报销自理比例 37 bxzlbl number 比例; 不可报原因 38 bkbyy string 5.4.8. 药品目录 序号 指标名 指标名称 类型/长度 可空否 说明 YPBH varchar2(16) 药品医保编码 1 YPSPM 药品商品名 varchar2(64) 2 第 24 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) YPTYMBM varchar2(24) 药品通用名编码 3 YPTYZWM药品通用中文名 varchar2(64) 4 YPTYYWM varchar2(128) 药品通用英文名 5 YPBZJX varchar2(16) 药品标注剂型 6 YPSYJX 药品使用剂型 varchar2(16) 7 YPGG varchar2(64) 药品规格 8 varchar2(32) YPJLDW 药品计量单位9 YPZXJLDW varchar2(32) 药品最小计量单位 10 YPZXBZSL number(3) 药品最小包装数量 11 CFY 处方药 char(1) 12 1 处方 Varchar2(8) XMFYLB项目费用类别 13 XMSFDJ项目收费等级 char(2) 14 YPDJXE number(14,4) 药品单价限额 15 YPDJXEKC number(14,4) 药品单价限额(扩充) 16 药品单价限额 (扩充1) number(14,4) YPDJXEKC117 YPZFBL number(6,4) 药品自负比例(基本医疗) 18 YPZFBLSY number(6,4) 药品自负比例(生育) 19 YPZFBLGS 药品自负比例(工伤) number(6,4) 20 YPZFBLLX number(6,4) 药品自负比例(离休) 21 YPZFBLEY 药品自负比例(二乙) number(6,4) 22 YPZFBLGWY number(6,4) 药品自负比例(公务员) 23 YPZFBLSE number(6,4) 药品自负比例(少儿) 24 YPZFBLNH 药品自负比例(农合) number(6,4) 25 YPZFBLKC number(6,4) 药品自负比例(扩充) 26 YPZFBLKC1 number(6,4) 药品自负比例(扩充1) 27 YPXZSYFW 药品限制使用范围varchar(128) 28 YPZXRQ varchar2(10) 药品执行日期 29 YPZFBZ药品作废标志 char(1) 30 1作废 YPPYM varchar2(10) 药品拼音码 31 YPWBM varchar2(10) 药品五笔码 32 YPTYBM 药品统一编码 varchar(16) 33 YPBZBMDS varchar(16) 药品编码(地市) 34 YPBZBMS varchar(16) 药品标准编码(省) 35 YPBZBMB 药品标准编码(部) varchar(16) 36 YPWJBM varchar(32) 药品物价编码 37 XMDJFS 项目定价方式 varchar2(10) 38 药品生产企业(自制剂单位名YPSCQY varchar(64) 39 称) YPPZWH varchar(32) 药品批准文号(制剂文号) 40 第 25 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 5.4.9. 费用目录 序号 指标名指标名称 类型/长度可空否 说明 诊疗编号 varchar2(12) ZLBH1 ZLJBMC varchar2(128) 诊疗基本名称2 ZLFZMC诊疗辅助名称 varchar2(256) 3 ZLJJDWvarchar2(32) 诊疗计价单位 4 XMFYLB varchar2(8) 项目费用类别 5 XMSFDJ 项目收费等级 char(2) 6 ZLDJXE number(14,4) 诊疗单价限额 7 ZLDJXE1 number(14,4) 诊疗单价限额(1类) 8 ZLDJXE2 number(14,4) 诊疗单价限额(2类) 9 ZLDJXE3 number(14,4) 诊疗单价限额(3类) 10 ZLDJXE4 诊疗单价限额(4类) number(14,4) 11 ZLDJXE5 number(14,4)诊疗单价限额(5类) 12 ZLDJXE6 number(14,4) 诊疗单价限额(6类) 13 ZLDJXE7诊疗单价限额 (7类) number(14,4) 14 ZLDJXE8 number(14,4) 诊疗单价限额(8类) 15 ZLDJXE9 诊疗单价限额(9类) number(14,4) 16 ZLDJXE10 number(14,4) 诊疗单价限额(10类) 17 ZLZFBL number(6,4)药品自负比例(基本医疗) 18 ZLZFBLSY 药品自负比例(生育) number(6,4) 19 ZLZFBLGS number(6,4) 药品自负比例(工伤) 20 ZLZFBLLX number(6,4) 药品自负比例(离休) 21 ZLZFBLEY 药品自负比例(二乙) number(6,4) 22 ZLZFBLGWY number(6,4) 药品自负比例(公务员) 23 ZLZFBLSE 药品自负比例(少儿) number(6,4) 24 ZLZFBLNH number(6,4) 药品自负比例(农合) 25 ZLZFBLKC number(6,4) 药品自负比例(扩充) 26 number(6,4) ZLZFBLKC1 药品自负比例(扩充1)27 ZLXZSYFW varchar(128) 诊疗限制使用范围 28 ZLXMNHvarchar(128)诊疗项目内涵 29 ZLXMCW 诊疗项目除外 varchar(128) 30 ZLXMSM varchar(256) 诊疗项目说明 31 ZLZXRQ 诊疗执行日期 varchar2(10)32 ZLZFBZ char(1) 诊疗作废标志 33 1 作废 ZLPYM varchar2(10) 诊疗拼音码 34 第 26 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) varchar2(10) ZLWBM诊疗五笔码 35 ZLTYBM诊疗统一编码 varchar(16) 36 ZLBZBMDS varchar(16) 诊疗标准编码(地市) 37 ZLBZBMS varchar(16) 诊疗标准编码(省) 38 ZLBZBMB诊疗标准编码 (部)varchar(16) 39 ZLWJBM varchar(16) 诊疗物价编码 40 XMDJFS 项目定价方式 Varchar2(10) 41 ZLSCQY varchar(64) 诊疗生产企业(单位名称)42 5.4.10. 病种目录 序号 指标名 指标名称 类型/长度 可空否 说明 ICD10BM ICD10编码 VARCHAR2(12) 1 ICD10FM VARCHAR2(12) 附码 2 JBMC 疾病名称 VARCHAR2(128) 3 5.4.11. 科室目录 序号指标名 指标名称 类型 /长度 可空否 说明 yljgksdm varchar2(6) 医疗机构科室编码 1 yljgksmc 医疗机构科室名称 varchar2(64) 2 5.4.12. 结算结果(BALANCE) 序号 指标名 指标名称 长度 可空否 说明 1 zfy 总费用 number(10,2)默认0 2 zffy 自费费用 number(10,2) 默认0 3 zlfy 自理费用 number(10,2) 默认0 4 ybfy医保费用 number(10,2)默认0 5 wnzhzf 往年帐户支付number(10,2) 默认 0 6 dnzhzf当年帐户支付 number(10,2) 默认 0 7tczf 统筹支付 number(10,2) 默认0 8 gwybz 公务员补助 number(10,2) 默认 0 9 gjzf 共济支付 number(10,2) 默认 0 10bczf 补充支付 number(10,2) 默认0 11 jzzf 救助支付 number(10,2) 默认 0 12kczf1 扩充支付1 number(10,2) 默认0 第 27 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 13 kczf2 扩充支付2 number(10,2) 默认0 14grzf 个人自负 number(10,2) 默认0 15zhdc 往年账户抵冲 number(10,2) 默认 0 16 lxzf 离休支付 number(10,2) 默认0 17 cjzf 残军支付 number(10,2) 默认0 18syzf 生育支付 number(10,2) 默认 0 19 xjzf 现金支付 number(10,2) 默认0 医院用，要现金收款 20 grxjdf 个人现金垫付 number(10,2) 默认0 医院用，要现金收款;由个人到中心审核报销 21 bxje报销金额 number(10,2)默认0 中心报销用，表示报销金额 22 zhdc1 当年账户抵冲 number(10,2) 默认0 5.4.13. 门诊收费单项目(TOLL ITEM) 序号 指标名 指标名称长度 可空否 说明 sfxmlx char(1) 1 药品 2 费用 1 项目类型 不可空 yyxmbh varchar2(12) 2 医院项目编号 不可空医院的项目编号，而非医保编号 yyxmmc varchar2(128)3 医院项目名称 不可空 xmjl varchar2(64) 4 项目剂量 xmyf varchar2(64)5 项目用法 xmsl number(10,4) 6 项目数量 默认1 xmdj number(10,4) 7 项目单价 默认0 5.4.14. 门诊收费单项目列表(TOLL ITEMLIST) 序号指标名 指标名称 长度 可空否 说明 1 TOLLITEM收费单项目 ListXML 不可空 2TOLLITEM 收费单项目 ListXML 不可空 3 TOLLITEM收费单项目 ListXML 不可空 。。。。。。 5.4.15. 门诊收费单(TOLL) 序号 指标名 指标名称 长度 可空否 说明 0 综合 1 挂号 2处方 3 检查单 1 sfdlx收费单类型 char(1) 不可空 4 化验单 5治疗单6手术单 9 零售 sfdrq 2 收费单日期char(10) 不可空 格式:yyyy/mm/dd;严格的; 0 非挂号 1 挂号 ghbz 3 挂号标志 char(1)默认’ 0’ 挂号时，收费单类型1; 第 28 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) jzbz 4 急诊标志 char(1) 默认’0’ 0 非急诊 1 急诊 挂号单必须有门诊号; mzh 5 门诊号varchar2(16) 同一个挂号就医产生的其它收费单(除零售) 的门诊号必须与挂号单的门诊号一致; 0 非处方 1 处方 cfbz6 处方标志 char(1) 默认’0’ 处方单的处方标志肯定为1。 cfhm 7 处方号码 varchar2(16) cfyljg 8 处方医疗机构 varchar2(6) 处方医疗机构编号(本地医院用编号) cfyljgmc 9 处方医疗机构名称 varchar2(64) 处方医疗机构名称(非本地医院用名称) ksdm 10 科室代码 varchar2(6) 不可空 科室代码见附录B ysxm 11 医生姓名varchar2(32) 处方不可空 jbbm 12 疾病编码varchar2(12) jbmc 13 疾病名称 varchar2(64) bqms 14 病情描述varchar2(512) zd 15 诊断 varchar2(512) 16 mxsl 明细数量 number(4) 不可空 17 fyze费用总额 number(10,2) 不可空 18 TOLLITEMLIST收费单项目列表 ListXML不可空 5.4.16. 门诊收费信息(CLINIC) 序号指标名 指标名称 长度 可空否 说明 1 TOLL 收费单 ListXML 不可空 2 TOLL 收费单 ListXML 不可空 3TOLL 收费单 ListXML 不可空 。。。。。。 5.4.17. 入院信息(INHOSPITAL) 序号 指标名 指标名称 长度可空否 说明 主键， 提交住院记帐明细时，使用该住院号码;zyhm 1 住院号码varchar2(16) 不可空 必须保持唯一不重复;以医院系统为准; cwh 2 床位号varchar2(16) 不可空 0 普通入院1 老年病入院 2 外伤入院 zylb 3 住院类别 varchar2(16) 默认0 3 恶性肿瘤化放疗入院,对恶性肿瘤备案人员 有效. 4 计生/生育入院 第 29 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) ryrq4 入院日期 varchar2(10) 不可空 yyyy/mm/dd(严格) rysj 5 入院时间 varchar2(8) 不可空hh24:mi:ss (严格) ryks 6 入院科室 varchar2(6)不可空 科室代码见附录B ryys 7 入院医生 varchar2(32) 不可空 mzzd 8 门(急)诊诊断 varchar2(512) 0 一般 1 急 2危 ryqk 默认09 入院情况 char(1) rybz1 10 入院病种1 varchar2(12) 不可空 icd10(医保病种目录) rybz1zd 11 入院病种1诊断varchar2(512) 不可空 rybz2 12 入院病种2 varchar2(12) icd10(医保病种目录) rybz2zd 13 入院病种2诊断 varchar2(512) rybz3 14 入院病种3varchar2(12) icd10(医保病种目录) 15rybz3zd 入院病种3诊断 varchar2(512) 5.4.18. 转科信息(REINHOSPITAL) 序号 指标名 指标名称 长度 可空否 说明 主键， 相同住院号的转科流水号必须唯一,而zklsh varchar2(16) 1 转科流水号 不可空 且有顺序。以医院系统为准; cwh varchar2(16) 2 床位号 不可空 zkrq varchar2(10) 3 转科日期 不可空yyyy/mm/dd( 严格) zksj varchar2(8) 4 转科时间 不可空hh24:mi:ss (严格) sgkszyts number(3) 5 上个科室住院天数 默认0 zwks varchar2(6) 6 转往科室 不可空 科室代码见附录B 0非老年病 1 老年病转出lnbbz char(1)7 老年病标志 不可空 2 转入老年病 zkys varchar2(32)8 转科医生 不可空 zkbz VARCHAR2(12) 不可空icd10(医保病种目录 ) 9 转科病种 zkbzzd Varchar2(512) 10 转科病种诊断 不可空 5.4.19. 住院记帐项目(BILLITEMS) 序号 指标名 指标名称 长度 可空否 说明 主键， 相同住院号的记帐序号号必须唯一,而记帐序号 Number(6) jzxh1 不可空 且有顺序。以医院系统为准; jzrq 记帐日期 Varchar2(10) 2 不可空 jzsj 记帐时间 Varchar2(8)3 不可空 zklsh 转科流水号 Varchar2(16) 4 不可空 第 30 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) jzks 记帐科室 Varchar2(6) 5 不可空 记帐操作员 Varchar2(32) jzczy6 不可空 sfxmlx 项目类型 char(1) 7 不可空 1 药品 2 诊疗 yyxmbh 医院项目编号 varchar2(12) 8 不可空 yyxmmc 医院项目名称 varchar2(128) 不可空 9 xmjl 剂量 Varchar2(64) 10 xmyf用法 Varchar2(64) xmsl 数量 Number(10,4) 11 不可空 xmdj 单价 Number(10,4) 12 不可空 5.4.20. 住院记帐项目的医保属性(YBBILLITEMS) 序号 指标名 指标名称 长度 可空否 说明 主键， 相同住院号的记帐序号号必须唯一,而jzxh 记帐序号 Number(6) 1 不可空 且有顺序。以医院系统为准; 医院项目编号 varchar2(12) yyxmbh2 不可空 flag 记帐成功标志 char(1) 3 不可空 1 成功 其他 不成功 error记帐失败信息 string 4 ybbh对应医保项目编号 sting 5 不可空 fylb 费用类别string 6 不可空 djxe 单价限额 number 7 不可空 zlbl 自理比例 number 8 不可空 bkbyy 不可报原因 string 9 不可空 5.4.21. 出院病历(MEDICALRECORD) 序号指标名 指标名称 长度 可空否 说明 Number(3) zyts 住院天数1 不可空 cyrq 出院日期Varchar2(10) 2 不可空 yyyy/mm/dd(严格) cysj 出院时间Varchar2(8) 3 不可空hh24:mi:ss( 严格) cyks 出院科室 Varchar2(6) 4 不可空 cyys 出院医生 varchar2(32) 5 不可空 cybz1出院病种 1 VARCHAR2(12) 6 不可空icd10 cybz1zd 出院病种1诊断 Varchar2(512) 7 不可空 第 31 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 1-治愈 2-好转 3-未愈 4-转院 5-自动出院 6-cybz1zg 出院病种1转归Char(1) 8 不可空 死亡 出院病种 2VARCHAR2(12) cybz29 cybz2zd 出院病种2诊断 Varchar2(512)10 cybz2zg出院病种 2转归 Char(1) 11 cybz3出院病种 3 VARCHAR2(12) 12 cybz3zd 出院病种3诊断 Varchar2(512) 13 cybz3zg 出院病种3转归Char(1) 14 5.4.22. 结算控制字 (CONTROLWORD) 这是一个有一定规则可扩展的字符串。字符串中的每一项有固定的含义(见下表)，每一项以分隔符“|”结束; 格式示意:第一项|第二项|…|第n项|。 各项有固定的顺序和定义;医保系统和医院系统通过这个协议传递一些医院输入的信息，医保系统根据各项的顺序及含义取值来控制结算。 使用场合 顺序号 含义 说明 住院 1 用往年帐户支付起付线“用往年帐户支付起付线”标志 1 中心报销 其他 不用往年帐户支付起付线 住院1 用往年帐户支付个人自负 “用往年帐户支付个人自负”标志 2 中心报销 其他 不用往年帐户支付个人自负 住院 住院起付线减半标志;跨年度时一次住“跨年度出院结算”标志 3 中心报销 院分成两个年度各结算一次。 1 表示医保病人做门诊白内障手术; “门诊白内障手术”标志 4 门诊 其他 非白内障就医 住院在精神病医院住院，选择“精神病”住 “精神病住院”标志 5 中心报销 院，无起付线 5.4.23. 费用分类信息(CHARGE) 序号 指标名 指标名称长度 可空否 说明 1 A01 西药费自费 number(10,2) 2A02 number(10,2) 普通 3 A03 number(10,2)特殊总额 4 A04 number(10,2) 特殊自费 5B01 中药费自费 number(10,2) 6 B02 普通 number(10,2) 7 B03 number(10,2) 特殊总额 第 32 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 8 B04 number(10,2) 特殊自费 9B101 中成药费自费 number(10,2) 10 B102 number(10,2) 普通 11B103 number(10,2) 特殊总额 12B104 特殊自费 number(10,2) 13 B201 number(10,2) 中草药费自费 14B202 普通 number(10,2) 15 B203 number(10,2) 特殊总额 16B204 number(10,2) 特殊自费 17 C01 检查费自费 number(10,2) 18 C02 number(10,2) 普通 19 C03 number(10,2) 特殊总额 20C04 特殊自费number(10,2) 21 C101 number(10,2) 化验费自费 22C102 普通 number(10,2) 23 C103 number(10,2) 特殊总额 24 C104 number(10,2) 特殊自费 25 C201 放射费自费number(10,2) 26C202 number(10,2)普通 27 C203 number(10,2) 特殊总额 28 C204 特殊自费 number(10,2) 29D01 number(10,2) 治疗费自费 30 D02 普通 number(10,2) 31 D03 number(10,2) 特殊总额 32D04 number(10,2) 特殊自费 33 D101 手术费自费 number(10,2) 34 D102 number(10,2)普通 35 D103 number(10,2) 特殊总额 36 D104 特殊自费 number(10,2) 37 D201 number(10,2) 诊疗费自费 38 D202普通 number(10,2) 39 D203 number(10,2) 特殊总额 40D204 number(10,2) 特殊自费 41 D301输氧费自费 number(10,2) 42 D302 number(10,2) 普通 43 D303 number(10,2) 特殊总额 44 D304 特殊自费 number(10,2) 45D401 number(10,2) 输血费自费 46 D402 普通 number(10,2) 第 33 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 47D403 number(10,2)特殊总额 48 D404特殊自费 number(10,2) 49 E01 number(10,2)材料费自费 50E02 number(10,2) 普通 51 E03 特殊总额 number(10,2) 52 E04 number(10,2) 特殊自费 53 G01 挂号费自费 number(10,2) 54G02 number(10,2)普通 55 G03 number(10,2) 特殊总额 56 G04 特殊自费 number(10,2) 57H01 number(10,2) 床位费自费 58 H02 number(10,2) 普通 59 H03特殊总额 number(10,2) 60 H04 number(10,2) 特殊自费 61 I01 护理费自费 number(10,2) 62 I02 number(10,2) 普通 63 I03 number(10,2) 特殊总额 64 I04 特殊自费 number(10,2) 65J01 number(10,2) 监护费自费 66 J02 number(10,2) 普通 67 J03 特殊总额 number(10,2) 68J04 number(10,2)特殊自费 69 Q01其他费自费 number(10,2) 70 Q02 number(10,2) 普通 71 Q03 number(10,2) 特殊总额 72Q04 特殊自费 number(10,2) 73 X01 number(10,2)不详费用自费 74X02 number(10,2) 普通 75X03 特殊总额 number(10,2) 76 X04 number(10,2) 特殊自费 注:1.每个项目按费用类别归为其中的一类(西药费、中药费、 化验费等)，每一类分以下四部分: ? 自费(全自费) ? 普通(全保) ? 特殊总额(含自理比例部分的总额) 第 34 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) ? 特殊自费(自理比例部分) 总费用:= ? + ? + ? 自费费用:= ? 自理费用:= ? 医保费用:= ? + ? - ? 5.4.24. 分段信息(SUB) 序号 指标名指标名称 长度 可空否 说明 subid 分段号 Number(3) 1 sublower分段下限 number(10,2) 2 subupper 分段上限 number(10,2) 3 subdes分段政策说明 string 4 subvalue 分段额度 number(10,2) 5 6 wnzhzf 往年帐户支付 number(10,2) 7dnzhzf 当年帐户支付number(10,2) 8 tczf统筹支付 number(10,2) 9 gwybz 公务员补助 number(10,2) 10 gjzf共济支付 number(10,2) 11 bczf 补充支付 number(10,2) 12 jzzf救助支付 number(10,2) 13 kczf1 扩充支付1 number(10,2) 14 kczf2 扩充支付2 number(10,2) 15 grzf个人自负 number(10,2) 16 zhdc 账户抵冲 number(10,2) 17lxzf 离休支付 number(10,2) 18 cjzf 残军支付 number(10,2) 5.4.25. 结算明细(BALANCEITEM) 序号 指标名 指标名称 长度 可空否 说明 待遇对象 string dx1 dxm 对象名 string 2 待遇类别 string lb3 lbm 类别名 string 4 bz 待遇病种 string 5 第 35 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 6bzm 病种名 string 7 zfy 总费用 number(10,2) 8 zffy 自费费用 number(10,2) 9zlfy 自理费用 number(10,2) 10ybfy 医保费用number(10,2) 11 wnzhzf 往年帐户支付number(10,2) 12 dnzhzf 当年帐户支付 number(10,2) 13 tczf 统筹支付 number(10,2) 14gwybz 公务员 补助 number(10,2) 15gjzf 共济支付 number(10,2) 16 bczf 补充支付 number(10,2) 17 jzzf 救助支付 number(10,2) 18 kczf1扩充支付 1 number(10,2) 19 kczf2扩充支付 2number(10,2) 20 grzf 个人自负number(10,2) 21 zhdc账户抵冲 number(10,2) 22 lxzf 离休支付number(10,2) 23 cjzf 残军支付 number(10,2) subnumber int 分段数 24 SUB RowsetXML分段 25 description 政策计算过程 string 27 CHARGE ListXML费用归类 26 5.4.26. 结算明细信息(BALANCELIST) 序号 指标名指标名称 长度 可空否 说明 1BALANCEIT EM 结算明细ListXML 不可空 2BALANCEITEM 结算明细 ListXML 不可空 3 BALANCEITEM 结算明细ListXML 不可空 。。。。。。 5.4.27. 未提交结算明细(SUSPENDBALANCE) 序号指标名 指标名称 长度 可空否 说明 varchar2(20) jslsh结算流水号 1 tfbz 退费标志 char(1)2 tflsh varchar2(20) 被退费流水号 3 第 36 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) jsrq varchar2(10)结算日期 4 varchar2(8) jssj 结算时间5 00 正常结算 jsly char(2) 结算来源 01 账户发放 6 02 中心报销 jsyljg varchar2(6) 结算医疗机构编号 7 varchar2(6) 就医医疗机构编号 8 jyyljg fsbz char(1) 分时标志 除了医院端分时标志可以填1，其它必须保证填09 bxbz char(1) 保险标志 0 医疗保险 1 生育 10 lxbz类型标志 char(1) 11 ghbz char(1) 挂号标志 1 挂号 12 zybz 住院标志char(1) 1 住院 13 1张家港居住异地 ydbz Char(1) 异地标志 14 2异地居住张家港 15 zfy 总费用 number(10,2) 默认0 16zffy 自费费用 number(10,2) 默认0 17 zlfy 自理费用 number(10,2) 默认 0 18 ybfy医保费用 number(10,2)默认0 19 wnzhzf 往年帐户支付 number(10,2)默认0 20 dnzhzf当年帐户支付 number(10,2) 默认 0 21 tczf统筹支付 number(10,2) 默认0 22gwybz 公务员补助 number(10,2) 默认0 23 gjzf 共济支付 number(10,2) 默认0 24bczf 补充支付 number(10,2) 默认0 25 jzzf 救助支付number(10,2) 默认0 26 kczf1 扩充支付1number(10,2) 默认 0 27 kczf2 扩充支付2 number(10,2)默认0 28grzf 个人自负 number(10,2)默认0 29 zhdc 账户抵冲 number(10,2) 默认 0 30 lxzf离休支付 number(10,2) 默认0 31cjzf 残军支付 number(10,2) 默认0 32syzf 生育支付 number(10,2) 默认0 生育报销用 33 xjzf 现金支付 number(10,2) 默认0 医院用，要现金收款 34grxjdf 个人现金垫付 number(10,2) 默认 0 医院用，要现金收款;由个人到中心审核报销 35 bxje 报销金额 number(10,2)默认0 中心报销用，表示报销金额 ybnd char(4) 医保年度 36 commitflag char(2) 提交标志 37 0 未提交 1 提交 -1 回退 czy 操作员 Varchar2(32)38 第 37 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 5.4.28. 帐户及累计信息变化(ICCHANGE) 序号 指标名 指标名称 长度 可空否 说明 wnzh Number(10,2) 往年帐户 1 刷卡消费前 dnzh Number(10,2) 当年帐户 2 刷卡消费前 zycs 住院次数 Number(3)3 刷卡消费前 tdmzyblj Number(10,2) 门诊医保累计 4 刷卡消费前 zyyblj Number(10,2) 住院医保累计 5 刷卡消费前 公务员补助起付累计 Number(10,2) 刷卡消费前 gwybzqflj6 dbmzqflj大病门诊按住院起付累计 Number(10,2) 刷卡消费前 7 dbmzyblj Number(10,2) 大病门诊按住院医保累计 刷卡消费前 8 dbzyqflj 恶性肿瘤住院起付累计 Number(10,2) 刷卡消费前 9 dbzyyblj Number(10,2) 刷卡消费前 恶性肿瘤住院医保累计10 mzjzlj Number(10,2)刷卡消费前 门诊救助累计 11 mzbcqflj Number(10,2) 门诊补充起付累计 刷卡消费前 12 mzbclj Number(10,2) 门诊补充累计 刷卡消费前 13 wngz Number(10,2) 往年支付 14 dngz Number(10,2) 15 当年支付 zycsbd Number(3) 住院次数变动 16 tdmzybljbd 门诊医保累计变动 Number(10,2)17 zyybljbd Number(10,2) 住院医保累计变动 18 gwybzqfljbd Number(10,2) 公务员补助起付累计变动 19 dbmzqfljbd Number(10,2) 大病按住院起付累计变动 20 dbmzybljbd Number(10,2) 大病按住院医保累计变动 21 dbzyqfljbd 恶性肿瘤住院起付累计变动 Number(10,2) 22 dbzyybljbd Number(10,2) 恶性肿瘤住院医保累计变动 23 mzjzljbd Number(10,2) 门诊救助累计变动 24 mzbcqfljbd 门诊补充起付累计变动 Number(10,2)25 mzbcljbd Number(10,2) 门诊补充累计变动 26 5.4.29. 服务项目(fwxmrowset) 序号 指标名 指标名称 长度可空否 说明 string 1 fwxm 生育(计生)服务项目 不可空 编号 2 fwxmmc 生育(计生)服务项目名称 String 不可空 第 38 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 生育(计生)服务项目结付 3 fwxmjfbz number不可空 标准 5.4.30. 生育信息(BEARINGMESSAGE) 序号 指标名 指标名称 长度可空否 说明 生育(计生)证号 1 lxdh 生育(计生)联系单号 string 不可空 1 计生 0或其他 生育 2 jsbz 计生标志 string 不可空 yyyy/mm/dd 生育,或流产、引产,日期 3 syrq 生育(计生)日期 string不可空 ,计划生育手术日期, RowsetXML 4fwxmrowset 生育(计生)服务项目 至少一项，最多五项 编号 5sylx 生育类型 String 6 sylxmc 生育类型名称 String 默认0 7 ts胎数 Number 默认0 1并发症 8 bfz 并发症 Char Char 9 dxss多项手术 默认0 1有多项手术 string 10bz 备注 5.4.31. 结算结果信息 序号 指标名指标名称 长度 说明 可空否 jslsh 结算流水号 String 1 jsrq结算日期 String 2 jssj 结算时间String 3 fsbz 分时标志String 4 1 分时 bxbz 生育标志 String 5 1 生育 zybz 6 住院标志 String 1 住院 cbbh 7 参保编号 String ybrq 8 人员类别 String ybdydxm 9 人员类别名String 10fyze 总费用 number(10,2) 11 zfze 自费费用 number(10,2) 12 zlze 自理费用 number(10,2) 13 ybze 医保费用number(10,2) 14wngz 往年帐户 number(10,2) 15 dngz 当年帐户number(10,2) 第 39 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 16 tczf 统筹支付 number(10,2) 17 gwyzf公务员补助 number(10,2) 18 gjzf 共济支付 number(10,2) 19bczf 补充支付 number(10,2) 20 jzzf救助支付 number(10,2) 21 kczf1 扩充支付1number(10,2) 22 kczf2 扩充支付2 number(10,2) 23 grzf 个人自负number(10,2) 24 zhdc 往年账户抵冲 number(10,2) 25zhdc1 当年帐户抵冲number(10,2) 26 lxzf离休支付 number(10,2) 27cjzf 残军支付 number(10,2) syzf 生育支付number(10,2) 28 xjzf 现金支付 number(10,2) 29 grxjdf 个人现金垫付 number(10,2) 30 bxje 报销金额number(10,2) 31 医保卡号 String iczh32 tfbz退费标志 String 33 0 正常消费 1 退费记录(负记录) 2 被退记录 5.4.32. 健身运动明细信息 序号指标名 指标名称 长度 说明 可空否 所在体育馆的编码1ydcbm 运动场编码 varchar2(12)不可空 ydcmc 2 运动场名称varchar2(128) 不可空 所在体育馆的名称 ydrs 3 参加运动人数 number默认 1运动人数 rgsj 4 入馆时间 varchar2(19) 不可空 格式:yyyy-mm-dd hh:mm:ss(严格要求) cgsj 5 出馆时间 varchar2(19)不可空 格式:yyyy-mm-dd hh:mm:ss(严格要求) sfyy 6 是否预约 char(1) 默认’0’ 0 非预约 1 预约。 7xmbm 项目编码 varchar2(8) 不可空 ydcd 8 运动场地varchar2(128) 不可空 dcsf number(10,2) 9 单次收费价格 默认0 number(10,2) cs10 次数 默认1 第 40 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第 41 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第6章. 基本概念和数据精度说明 6.1. 基本概念 消息缓冲区:医院终端为调用社保交易而建立的请求/响应数据缓冲区。调用社保交易而建立的请求缓冲区，接口通过某种网络应用协议将请求缓冲区发送到社保应用服务器，社保应用服务器实时对请求做出响应，并返回响应消息缓冲区。程序员通过“附件 A”提供的API函数来创建、读、写消息缓冲区。 参数:消息缓冲区或XML参数缓冲区中有各种各样的参数;对这些参数按作用归类分:系统参数、传 入参数和传出参数;系统参数作为系统信息，比如交易类型、交易超时等;传入参数作为请求信息， 比如处方信息等;传出参数作为响应信息，比如结算结果等。 XML参数:消息缓冲区可以创建各种具体的参数，比如交易类型、交易超时时间、参保编号、处方信 息等等;有些参数是另外信息的组合参数，比如处方信息等，用XML格式来表达，称这类参数为XML 参数;有些参数表达一个独立的信息，有具体的类型，如字符串、整数、浮点数、时间、二进制流等， 比如参保编号、自负比例、照片等，称这类参数为简单参数。 句柄:在操作消息缓冲区时，将设置各种各样的参数、创建中间参数缓冲区，系统利用句柄(实际是 一个整型数)来指定操作对象(缓冲区)。消息缓冲区的句柄称之为消息缓冲区句柄;XML参数缓冲 XML参数句柄。简单参数不创建单独的缓冲区，不需要句柄。 区称之为 费用分解图:参保病人一次就医发生总费用的组成。如下图。 第 42 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 总费用? 自费费用?自理费用?医保费用? 往年帐户支付当年帐户支付统筹支付公务员补助共济支付补充支付救助支付扩充支付1扩充支付2个人自负帐户抵冲离休支付残军支付????????????? ? = ? + ? + ?关系式A: ? = ? + ? + ? + ? + ? + ? + ? + ? + ? + ? + ? + ? + ?关系式B: = ? + ? + ?现金支付: = ? + ? + ? + ? + ? + ? + ? + ? + ? + ? + ?报销金额: 自费费用:完全由参保病人现金支付的项目组成的费用;自费项目包括以下四种: ? 非医保目录内的项目; ? 没有对照的项目; ? 自负比例为1的项目; ? 由于各种原因(特定医院使用项目、用于特定人群项目、超限价等)引起 的不能提供报销的项目。 自理费用:医保项目的自负比例部分。比如一种药品单价为10.00元，自负比例为10%;则该项目的 自理费用为1.00元;剩下的9.00元进入医保费用。 医保费用:总费用减去自费费用和自理费用就是医保费用，也就是进入医保报销的金额。 帐户抵冲:指的是帐户以现金的方式发放给参保对象(一般指居外人员)，报销时首先抵冲已经发放 的帐户。居外人员冻结医保卡，所以不能在医院机构刷卡消费;帐户抵冲一般发生在中心报销过程中。 6.2. 数据精度说明 1) 为了保证医院数据和医保数据的一致性;不管门诊或住院，统一按每个 项目计算项目总额(单价*数量)，并四舍五入保持两位小数;然后各个 项目总额相加计算出就医费用总额。 第 43 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第7章. 交易手册 7.1. 读医保病人信息 交易类型码:YB002 实时特性:实时/分时交易(3) 交易功能:读医保病人信息。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’YB002’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号参数名 参数名称 参数类型/长度 可空否 说明 1 NOSHOW 是否显示卡信息 string 1 不显示 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1SIMESSAGE 参保人员信息 ListXML 2 FREEZE个人医保卡冻结信息 RowsetXML 3REGISTER 个人医保登记信息 RowsetXML 4 INHOSPITAL 个人年度住院信息 RowsetXML 5CLINIC 个人医保年度门诊信息 RowsetXML 交易调用流程图: 交易说明: 其他: 第 44 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 7.2. 目录对照 交易类型码:SI010 实时特性:分时交易(1) 交易功能:医院项目与医保项目的一一对应;在门诊处方明细和住院记帐明细中，提交到医保应 用服务器所使用的项目编号全部使用医院自身的编号，非医保项目编号。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI010’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1 COMPARISION目录对照 ListXML 不可空 2 CXBZ撤消标志 char(1) 不可空 1:表示撤消 其它:对照 3 CZY操作员姓名 varchar2(32)不可空 交易出参:无; 交易调用流程图: 交易说明:只有对照的药品目录(或其他收费项目)，才可以用于医保报销。没有对照的 项目全部按照 自费结算。 其他: 7.3. 对照查询 交易类型码:SI011 实时特性:分时交易(1) 交易功能:查询项目的限价、自理比例。 第 45 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 对照查询分“有卡对照查询”和“无卡对照查询”; 无卡对照查询:返回项目的限价、自理比例; 有卡对照查询:返回持卡医保病人使用项目的限价、自理比例和不可报原因。医保病人刷 卡就医时，使用“有卡对照查询”可以查询到项目准确的限价、自理比例和不可报原因， 因为不同待遇类别的医保病人，使用相同项目的自理比例和不可报原因是不一 样的。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI011’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //有卡对照查询，调用以下函数;否则不要调用; //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 可空序号 参数名 参数名称 参数类型/长度 说明 否 如果有卡，将与读卡的进行核对参保编1 CBBH 参保编号 string 号和帐号。 2 ZH 帐号 string 3 BXLB报销类别 string 不可空 0 默认1 中心报销(医院端全部传0) 4MZBZ 门诊标志 string 不可空0 默认1 门诊 5CFBZ 处方标志string 不可空 0 默认 1 处方 6 XMLX项目类型 string 不可空 1 药品 2 诊疗 3 大类 7 YYXMBH 项目的医院编号string 不可空 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1 CATALOGITEM 对照项目 交易调用流程图: 交易说明: 第 46 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 其他: 7.4. 通用查询(分时) 交易类型码:YB201 实时特性:分时交易(1) 交易功能:供医院查询或下载各种信息(药品目录、费用目录、病种库等等)。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’YB201’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 1 CXH 查询号 string 不可空 见清单7-1; 2CXTJ 查询条件 string 3 RC入参 ListXML 见清单 7-1; 4 MYTS 每页条数 number 默认20条/页 5 DJY 第几页number 不可空 <=0返回全部条数 清单:7-1 查询号 查询内容入参 RC 备注 无 YPML 药品目录 无 FYML 费用目录 无 BZK 病种库(ICD10) 无 KSB 科室表(标准) 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1 MYF 是否末页string 不可空1 末页 0 非末页 第 47 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 不同的查询号有不同的内容，具体见相2 CXJG查询结果 RowsetXML 不可空 应的查询号说明(清单7-1) 交易调用流程图: 交易说明: 使用查询交易时，用户应该正确理解参数MYTS和DJY;如果表中的记录上万条，在设 置两个参数要 考虑数据库的查询速度和XML的容量，目前支持的XML容量为20M。每页条数太多不仅影响 查询速度， 而且可能造成XML内存溢出;所以要正确使用这两个参数。 其他: 7.5. 门诊预结算 交易类型码:SI030 实时特性:实时/分时交易(3) 交易功能:门诊预结算。包括门诊挂号。门诊挂号时，传入的收费单(即挂号单)，不允许同时有处方 单或其他类型收费单。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI030’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 参数类型/长序号 参数名 参数名称 可空否 说明 度 如果有卡，将与读卡的进行核对参1 CBBH 参保编号 string 保编号和帐号。 2 ZH 帐号 string 3 CZY 操作员号 string 不可空 4 CLINICNUMBER 门诊收费单条数 number 第 48 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 5 CLINIC 门诊收费信息ListXML 不可空 6 CONTROLWORD 结算控制字string 交易出参: 参数名序号参数名 参数类型/长度 可空否 说明 称 1 JSLSH 结算流水号string 不可空 2 BALANCE结算结果 ListXML 不可空 结算明细条3 NUMBER int 数 结算明细一般为1条;住院结算仅有14BALANCELIST 结算明细 ListXML 条;门诊可能有多条。 帐户及医保5 ICCHANGE ListXML 累计变化 6 BEARINGMESSAGE ListXML (生育才有) 交易调用流程图: 交易说明: 其他: 7.6. 入院登记 交易类型码:SI050 实时特性:分时交易(1) 交易功能:入院登记。入院允许重复调用登记。住院号码要保证唯一，否则相同住院号码 的入院登记将被覆盖。 入院登记不区分医保和生育，所以只要设卡类型为1,出院的时候录生育信息。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI050’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 第 49 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) //设置卡标志 1 表示有医保卡 // SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号string 不可空 号和帐号。 2 ZH 帐号string 3CZY 操作员号 string 不可空 4 INHOSPITAL 入院信息 ListXML 不可空 交易出参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 交易调用流程图: 交易说明: 其他: 7.7. 住院转科登记 交易类型码:SI052 实时特性:分时交易(1) 交易功能:住院过程中的转科登记。无卡交易。 转科允许重复调用转科登记。相同住院号码的转科流水号要保证唯一，否则相同转科流水 号的转科登记将被覆盖; 转科流水号要有顺序，转科流水号越大的转科日期也越大，保持转科日期连续;转科日期 必须大于等于入院日期和上次转科日期; 有转科的住院，提交记帐明细时要提供转科流水号，以识别费用所属科别; 无转科的住院，转科流水号传0，转科流水号0表示入院登记科室。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI052’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户 第 50 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型/长度可空否 说明 如果有卡，将与读卡的进行核对参保编1 CBBH参保编号 string 不可空 号和帐号。 2 ZH 帐号string 3CZY 操作员号string 不可空 4 ZYHM 住院号码 string 不可空 5REINHOSPITAL 转科信息 ListXML 不可空 交易出参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 交易调用流程图: 交易说明: 其他: 7.8. 住院记帐 交易类型码:SI055 实时特性:分时交易(1) 交易功能:住院过程中的记帐明细上传。无卡交易。 住院过程一旦发生费用，要求即时调用记帐交易将费用项目上传到中心。 同一个记帐序号允许重复调用记帐，但是内容替换成最后一次，所以相同住院号的记帐序 号要保证唯一性。 可以同时提交多条记帐明细，提交成功返回记帐明细的医保属性(医保编号、费用类别、 限价、自理比例和不可报原因)，没有返回的明细表示该明细记帐失败。 有转科的住院，提交记帐明细时要提供转科流水号，以识别费用所属科别; 无转科的住院，转科流水号传0，转科流水号0表示入院登记科室。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI055’, pszErrorMsg); 第 51 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 不可空 号和帐号。 2ZH 帐号 string 3 ZYHM 住院号码string 不可空 4 BILLITEMS 记帐项目 RowsetXML 不可空 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否说明 1 YBBILLITEMS 记帐项目的医保属性RowsetXML 不可 空 交易调用流程图: 交易说明: 其他: 7.9. 住院费用查询 交易类型码:SI056 实时特性:实时/分时交易(3) 交易功能:到某个截止日期为止，查询住院所发生的医保费用。无卡交易。 只要医院及时上传住院发生的费用明细，医保病人每天都可以查询准确医保支付情况。 住院费用查询相当于到指定某个日期为止的住院费用预结算。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’YB002’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; 第 52 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1 CBBH 参保编号 string 不可空 号和帐号。 2 ZH 帐号 string 3ZYHM 住院号码 string 不可空 4 QZRQ 截止日期string 不可空 yyyy/mm/dd(严格) 5 ITEMNUMBER 记帐明细条数 number 不可空 6TOTAL 费用总额 number 不可空 7 CONTROLWORD 结算控制字 string 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1 BALANCE 结算结果ListXML 不可空 2NUMBER 结算明细条数 int 结算明细一般为1条;住院结算仅3 BALANCELIST 结算明细ListXML 有1条;门诊可能有多条。 交易调用流程图: 交易说明: 其他: 7.10. 出院预结算 交易类型码:SI057 实时特性:实时/分时交易(3) 交易功能:出院预结算。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’YB002’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户 第 53 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 参数类型/长序号 参数名 参数名称 可空否 说明 度 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 不可空 号和帐号。 2 ZH 帐号 string 3 ZYHM 住院号码 string 不可空 4 MEDICALRECORD出院病例 ListXML 不可空 5 ITEMNUMBER 记帐明细条数 number 不可空 6 TOTAL 费用总额number 不可空 7 CZY 操作员号string 不可空 8CONTROLWORD 结算控制字 string 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1 JSLSH 结算流水号string 不可空 2 BALANCE 结算结果 ListXML 不可空 3NUMBER 结算明细条数 int 结算明细一般为1条;住院结算仅4 BALANCELIST 结算明细 ListXML 有1条;门诊可能有多条。 帐户及医保 5 ICCHANGE ListXML 累计变化 6 BEARINGMESSAGE ListXML (生育才有) 交易调用流程图: 交易说明: 其他: 7.11. 单病种出院预结算 第 54 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 交易类型码:SI058 实时特性:实时/分时交易(3) 交易功能:单病种出院预结算。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI058’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 参数类型/长序号 参数名参数名称 可空否 说明 度 如果有卡，将与读卡的进行核对参保编1 CBBH 参保编号 string 不可空 号和帐号。 2 ZH 帐号string 3 ZYHM住院号码 string 不可空 4 MEDICALRECORD 出院病例 ListXML 不可空 5 ITEMNUMBER 记帐明细条数 number 不可空 6 TOTAL 费用总额number 不可空 7CZY 操作员号 string 不可空 8CONTROLWORD 结算控制字 string 交易出参: 序号参数名 参数名称 参数类型 /长度可空否 说明 1 JSLSH结算流水号 string 不可空 2 BALANCE 结算结果ListXML 不可空 3 NUMBER 结算明细条数 int 结算明细一般为1条;住院结算仅4 BALANCELIST结算明细 ListXML 有1条;门诊可能有多条。 帐户及医保 5 ICCHANGE ListXML 累计变化 6 BEARINGMESSAGE ListXML (生育才有) 交易调用流程图: 第 55 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 交易说明: 其他: 7.12. 中心报销预结算 交易类型码:SI070 实时特性:实时交易(2) 交易功能:医保中心报销。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI070’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号参数名 参数名称参数类型 /长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 不可空 号和帐号。 2ZH 帐号 string 3 CZY报销操作员 string 不可空 4BXLSH 报销流水号string 不可空 5 CONTROLWORD结算控制字 string 交易出参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 1 JSLSH结算流水号 string 不可空 2BALANCE 结算结果 ListXML 不可空 3NUMBER 结算明细条数 int 第 56 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 结算明细一般为1条;住院结算仅有14 BALANCELIST 结算明细 ListXML 条;门诊可能有多条。 帐户及医保 5ICCHANGE ListXML 累计变化 交易调用流程图: 交易说明: 其他: 7.13. 退费 交易类型码:SI080 实时特性:实时交易(2) 交易功能:医保退费。包括退号(挂号)、门诊退费、住院退费、中心报销退费等。 退费不区分医保和生育，所以只要设卡类型为1; 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI080’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //1 表示有医保卡 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型/长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 不可空 号和帐号。 2 ZH帐号 string 3CZY 操作员 string 不可空 4JSLSH 被退的结算流水号 string 不可空 交易出参: 第 57 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 参数类型 /长度 可空否 说明 序号 参数名 参数名称 1 JSLSH 结算流水号 string 不可空 2 BALANCE 结算结果 ListXML 不可空 交易调用流程图: 交易说明: 其他: 7.14. 撤消入院登记 交易类型码:SI081 实时特性:分时交易(1) 交易功能:撤消入院登记。同时删除入院登记对应的转科登记和住院记帐明细。可以重复撤消。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI080’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1 CBBH 参保编号 string 不可空 号和帐号。 2ZH 帐号 string 3CZY 操作员号 string 不可空 4 ZYHM 住院号码 string 不可空 交易出参: 第 58 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 序号 参数名 参数名称 参数类型 /长度 可空否 说明 交易调用流程图: 交易说明: 其他: 7.15. 撤消住院转科登记 交易类型码:SI080 实时特性:实时/分时交易(9) 交易功能:撤消住院转科登记。同时删除转科对应的住院记帐明细。可以重复撤消。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI080’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型/长度可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 不可空 号和帐号。 2ZH 帐号 string 3 ZYHM住院号码 string 不可空 4ZKLSH 转科流水号 string 不可空 交易出参: 序号参数名 参数名称 参数类型 /长度 可空否 说明 第 59 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 交易调用流程图: 交易说明: 其他: 7.16. 结算 交易类型码:PUB02 实时特性:实时/分时交易(9) 交易功能:结算。包括门诊挂号结算、门诊收费结算、住院结算、中心报销结算、生育结算等;结算 是预结算的确认。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’PUB02’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 号和帐号。 2ZH 帐号 string 3 JSLSH 结算流水号string 不可空 交易出参:无 交易调用流程图: 交易说明: 其他: 第 60 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 7.17. 提交 交易类型码:PUB06 实时特性:实时/分时交易(9) 交易功能:提交。结算成功调用提交。 医院系统的设计要求:提交交易不管成功或失败，医保病人的结付 要继续。 提交交易可以是有卡提交或无卡提交，若有卡，设置卡标志为1，若无卡，则不需要设置 卡标志，就是不能调用SetCardFlag。 无卡提交的应用场合:医保病人走了，结算交易 没有提交成功的情况,需要在无卡情况下继续做提交; 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’PUB06’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //有卡提交，调用以下函数;否则不要调用; //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号参数名 参数名称 参数类型/长度 可空否 说明 如果有卡，将与读卡的进行核对参保编1CBBH 参保编号 string 号和帐号。 2ZH 帐号string 3 JSLSH 结算流水号string 交易出参:无 交易调用流程图: 交易说明: 其他: 第 61 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 7.18. 回退 交易类型码:PUB07 实时特性:实时/分时交易(9) 交易功能:回退。结算成功调用回退。 回退交易可以是有卡回退或无卡回退，若有卡，设置卡标志为1，若无卡，则不需要设置 卡标志，就是不能调用SetCardFlag。无卡回退的应用场合:医保病人走了，结算交易 没有回退成功的情况,需要在无卡情况下继续做回退; 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’PUB07’, pszErrorMsg); //设置超时时间; //如果超时时间设置过长，在网络不通的情况下，要等待很长时间，用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //有卡提交，调用以下函数;否则不要调用; //设置卡标志 //0 无卡医保病人1 医保卡医保病人2 自费病人 10 生育就医 100 异地居住张家港 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号参数名 参数名称参数类型 /长度可空否 说明 如果有卡，将与读卡的进行核对参保编1 CBBH 参保编号 string 号和帐号。 2 ZH帐号 string 3 JSLSH 结算流水号 string 交易出参:无 交易调用流程图: 交易说明: 其他: 第 62 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 7.19. 异常处理1 交易类型码:EXP1 实时特性:实时/分时交易(9) 交易功能:第一种类型的异常处理。有卡交易。 医院系统由于各种原因(突发断电或软件的原因)，结算没有正常的提交或回退。 在这种情况下，医保病人刷卡将出现错误，提示:“存在未提交的结算”;医保病人应该 到结算的医疗机构去做异常处理。针对未提交的结算，医院系统中信息记载，以及核对 医患双方的实际支付情况，对未提交的结算重新做决断(提交或回退)。 异常处理1返回医保病人在当前医疗机构的未提交结算，供医院做决断。 建议:医院系统提供第一种类型的异常处理的功能模块。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’EXP1’, pszErrorMsg); //设置超时时间; //如果超时时间设置过长，在网络不通的情况下，要等待很长时间，用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //有卡提交，调用以下函数;否则不要调用; //设置卡标志 //1 医保卡医保病人 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 序号 参数名 参数名称 参数类型 /长度 可空否 说明 交易出参: 序号 参数名 参数名称 参数类型/长度可空否 说明 1 SUSPENDBALANCE 未提交结算明细RowsetXML 不可空 交易调用流程图: 交易说明: 第 63 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 其他: 7.20. 住院结算单打印 交易类型码:YB110 实时特性:分时交易(1) 交易功能:打印住院结算单。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’YB110’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 参数类型/长序号 参数名参数名称 可空否 说明 度 1 JSLSH 结算流水号string 不可空 2PREVIEW 预览标志string 不可空 1:预览打印 其它:直接打印 3 XM 姓名 String 不可空 4 NL 年龄 number 不可空 5 ZYH 住院号 string 不可空 6BQ 病区string 不可空 7CWH 床位号 string 不可空 8 CYZD出院诊断 string 不可空 9 ZYTS住院天数 number 不可空 10RYRQ 入院日期string 不可空 11 CYRQ出院日期 string 不可空 12 YYMC 医院名称 string 不可空 交易出参: 序号 参数名 参数名称 参数类型/长度可空否 说明 1CBBH 参保编码 String 不可空 2DYLB 待遇类别String 不可空 3 BALANCE结算结果 ListXML 不可空 第 64 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 4 CHARGE 费用分类 ListXML 不可空 5 JFFD结付分段 String 不可空 交易调用流程图: 交易说明: 其他: 7.21. 通用查询(实时) 交易类型码:YB200 实时特性:实分时交易(2) 交易功能:供医院查询或下载各种信息(等等)。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’YB200’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); 交易入参: 序号 参数名参数名称 参数类型 /长度 可空否 说明 1 CXH查询号 string 不可空 见清单7-2; 2 CXTJ 查询条件 string 3RC 入参 ListXML 见清单7-1; 4 MYTS 每页条数 number 默认20条/页 5 DJY 第几页 number 不可空 <=0返回全部条数 清单:7-2 查询号查询内容 入参RC 备注 QSRQ起始日期 yyyy/mm/dd 可以用于 ZZRQ终止日期yyyy/mm/dd JSJG 医疗机构结算结果; SYF空:全部 0:非生育 1: 生育 对帐; ZYF 空:全部 0:门诊 1:住院 第 65 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 交易出参: 序号 参数名参数名称 参数类型/长度 可空否 说明 1 MYF 是否末页 string 不可空 1 末页 0 非末页 不同的查询号有不同的内容，具体见相2 CXJG查询结果 RowsetXML不可空 应的查询号说明(清单7-1) 交易调用流程图: 交易说明: 使用查询交易时，用户应该正确理解参数MYTS和DJY;如果表中的记录上万条，在设 置两个参数要 考虑数据库的查询速度和XML的容量，目前支持的XML容量为20M。每页条数太多不仅影响 查询速度， 而且可能造成XML内存溢出;所以要正确使用这两个参数。 其他: 7.22. 健身运动消费预结算 交易类型码:SI090 实时特性:实时交易(3) 交易功能:体育运动消费预结算。 交易系统参数: //设置交易类型 SetBusinessNo(iHandle,’SI090’, pszErrorMsg); //设置超时时间 //如果超时时间设置过长，在网络不通的情况下，要等待很长时间;用户会认为死机; //设置时，最好不要超过30秒，建议10秒，不设默认60秒; SetBusinessTimeOut(iHandle,’60’, pszErrorMsg); //设置卡标志 //1 医保卡 SetCardFlag(iHandle,’1’, pszErrorMsg); 交易入参: 第 66 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 参数类型/长参数名 参数名称 序号可空否 说明 度 1 CBBH 参保编号 string 2ZH 帐号 string 3CZY 操作员号 string 不可空 4 JSXMMX 健身运动明细信息 RowsetXML 不可空 交易出参: 参数名序号参数名 参数类型/长度可空否 说明 称 1 JSLSH 结算流水号 string 不可空 2 BALANCE结算结果 ListXML 不可空 帐户及医保 3 ICCHANGE ListXML 累计变化 交易调用流程图: 交易说明: 其他: 第 67 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第8章. 附录A 程序员函数参考手册 8.1. 医保接口DLL动态连接库API函数手册 API函数主要分四类: 医保交易接口函数。实现医保交易(如:读医保卡、医保目录对照、医保, 第一类 门诊结算、住院登记、医保查询等等)调用。 , 第二类 消息缓冲区处理函数。用来操作医保交易请求消息和响应消息，实现消息 中各类参数的创建、读和写。各类参数详见“第六章 消息规范”。 , 第三类 配置函数。实现医保终端计算机硬件设备、医保应用服务器连接的配置。 , 第四类 其他函数。其他辅助函数。 8.1.1. 医保交易接口函数 , Init function Init(pszErrorMsg:pchar): Longint pszErrorMsg:pchar /* 错误信息 */ 医保接口环境的初始化; 参数: pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 第三方在调用医保接口前，必须调用该函数一次。 主要完成两个工作 ? 检查医保接口终端模块的版本，并提供自动更新; ? 检查医保接口的可用性，并初始化医保接口客户端环境。 建议:第三方系统在系统启动时，调用一次Init，调用医保交易时不必再调用该函数;另 外，第三方可以在界面上提供医保初始化功能(即Init)。 , OpenBuffer 第 68 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) function OpenBuffer(pszErrorMsg:pchar): Longint pszErrorMsg:pchar /* 错误信息 */ 创建医保交易请求消息缓冲区，打开医保交易。 参数: pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 >0 请求消息句柄。程序员通过消息句柄对消息缓冲区中各类参数进行创建、读和写，消息 中的各类参数详见“第六章 消息规范”。 说明: 调用每个医保交易，第一步就是创建请求消息缓冲区。 , Service function Service(pszErrorMsg:pchar): Longint pszErrorMsg:pchar /* 错误信息 */ 调用医保交易。 参数: pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 >0 响应消息句柄。程序员通过消息句柄对消息缓冲区中各类参数进行创建、读和写，消息 中的各类参数详见“第六章 消息规范”。 说明: 调用医保交易，并返回响应消息。通过响应消息句柄读取医保交易结果。 , CloseBuffer function CloseBuffer(pszErrorMsg:pchar): Longint pszErrorMsg:pchar /* 错误信息 */ 释放医保交易消息缓冲区，关闭医保交易。 参数: pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 第 69 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 说明: 医保交易调用结束后，调用该函数释放交易消息缓冲区和关闭交易。 8.1.2. 消息缓冲区处理函数 , CreateXML function CreateXML(iType:integer,pszErrorMsg:pchar):Longint iType:integer /* XML参数类型 */ pszErrorMsg:pchar /* 错误信息 */ 创建XML类型的参数。 参数: iType XML类型。支持的XML类型如下: 1:ListXML类型; 2:RowsetXML类型; pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 >0 XML类型的参数句柄。通过XML类型的参数句柄，增加记录、字段或子参数。 说明: 用来创建XML类型的参数。 , Add function Add(iHandle:integer; pszParameterName:pchar; iParameterType:integer; pszParameterValue:pchar; iLength:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄或XML参数句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:integer /* 参数类型 */ pszParameterValue:pchar /* 参数值 */ iLength:integer /* 参数值长度 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中增加参数、ListXML参数中增加子参数、RowsetXML参数中增加字段。 参数: iHandle 第 70 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 句柄。消息缓冲区句柄或XML参数句柄。 pszParameterName 参数(子参数、字段)名称。 iParameterType 参数(子参数、字段)类型。类型见“清单:A-1”所示。 清单:A-1 iLength 类XML 类型名称 备注 参数取值 类型 型 0 1 String 0 2 Short 0 3 Integer 0 取值true或false 5Boolean 0 对于Float类型，建议使用6Float BigDecimal(26) 0 对于Double类型，建议使用7 Double BigDecimal(26) 0 串行化格式为:"M/d/yyyy 9 Date h:m:s" 0 12Byte 实际字节二进制流 13InputStream 长度 0 23 Char 0 25Long 0 26 BigDecimal 实际字节二进制流 30 Blob 长度 0 31Clob 0 串行化格式为:"M/d/yyyy 36 Timestamp h:m:s" 0 38 ListXML XML类型 0 39RowsetXML XML类型 pszParameterValue 参数值。 iLength 参数值长度。参数值长度取值见“清单:A-1”;除了二进制流要指明长度，其 它类型的参 数长度传0即可。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 第 71 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 0 成功。 说明: 用来新增或设置参数。该函数主要用于新增或设置简单参数，而非XML类型参数;新增或设置 XML类型参数参见函数AddHandle。 , AddHandle function AddHandle(iHandle:integer; pszParameterName:pchar; iParameterType:integer; iSrcHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄或XML参数句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:integer /* 参数类型 */ iSrcHandle:integer /* 参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中增加XML参数、ListXML参数中增加XML子参数 参数: iHandle 句柄。消息缓冲区句柄或XML参数句柄。 pszParameterName 参数(子参数)名称。 iParameterType 参数(子参数)类型。类型见“清单:A-1”所示;该函数只支持有句柄参数，比如XML参 数，简单参数不使用该函数。 iSrcHandle 参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来新增或设置参数。该函数主要用于新增或设置XML参数，而非简单类型参数;新增或设置 简单类型参数参见函数Add。 , InsertRow 第 72 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) function InsertRow(iHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* RowsetXML参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ RowsetXML参数中增加记录。 参数: iHandle 句柄。RowsetXML参数句柄，不支持其他类型的XML参数。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来新增RowsetXML参数的记录。 , AddIn function AddIn(iHandle:integer; pszParameterName:pchar; iParameterType:integer; pszParameterValue:pchar; iLength:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:integer /* 参数类型 */ pszParameterValue:pchar /* 参数值 */ iLength:integer /* 参数值长度 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中增加传入参数。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName 参数名称。 iParameterType 参数类型。类型见“清单:A-1”所示。 pszParameterValue 参数值。 iLength 参数值长度。参数值长度取值见“清单:A-1”;除了二进制流要指明长度，其 第 73 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 它类型的参 数长度传0即可。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来新增消息缓冲区中的传入参数。该函数主要用于新增或设置简单传入参数，而 非XML类型 传入参数;新增或设置XML类型传入参数参见函数AddInHandle。该函数特指消息 缓冲区句柄， 不支持XML参数句柄。 , AddInHandle function AddInHandle(iHandle:integer; pszParameterName:pchar; iParameterType:integer; iSrcHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:integer /* 参数类型 */ iSrcHandle:integer /* 参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中增加XML类型传入参数。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName 参数名称。 iParameterType 参数类型。类型见“清单:A-1”所示;该函数只支持有句柄参数，比如XML参 数，简单参 数不使用该函数。 iSrcHandle 参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 第 74 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 说明: 用来新增或设置传入参数。该函数主要用于新增或设置XML类型传入参数，而非简 单类型传入 参数;新增或设置简单类型传入参数参见函数AddIn。该函数特指消息缓冲区句柄， 不支持XML 参数句柄。 , AddOut function AddOut(iHandle:integer; pszParameterName:pchar; iParameterType:integer; pszParameterValue:pchar; iLength:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:integer /* 参数类型 */ pszParameterValue:pchar /* 参数值 */ iLength:integer /* 参数值长度 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中增加传出参数。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName 参数名称。 iParameterType 参数类型。类型见“清单:A-1”所示。 pszParameterValue 参数值。 iLength 参数值长度。参数值长度取值见“清单:A-1”;除了二进制流要指明长度，其 它类型的参 数长度传0即可。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来新增消息缓冲区中的传出参数。该函数主要用于新增或设置简单传出参数，而 第 75 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 非XML类型 传出参数;新增或设置XML类型传出参数参见函数AddOutHandle。该函数特指消 息缓冲区句柄， 不支持XML参数句柄。医院系统中一般不使用该函数。 , AddOutHandle function AddOutHandle(iHandle:integer; pszParameterName:pchar; iParameterType:integer; iSrcHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:integer /* 参数类型 */ iSrcHandle:integer /* 参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中增加XML类型传出参数。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName 参数名称。 iParameterType 参数类型。类型见“清单:A-1”所示;该函数只支持有句柄参数，比如XML参 数，简单参 数不使用该函数。 iSrcHandle 参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来新增或设置传出参数。该函数主要用于新增或设置XML类型传出参数，而非简 单类型传出 参数;新增或设置简单类型传出参数参见函数AddOut。该函数特指消息缓冲区句 柄，不支持 XML参数句柄。医院系统中一般不使用该函数。 , SetH 第 76 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) function SetH(iHandle:integer; pszParameterName:pchar; pszParameterValue:pchar; iLength:integer; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszParameterName:pchar /* 参数名称 */ pszParameterValue:pchar /* 参数值 */ iLength:integer /* 参数值长度 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中设置系统参数。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName :A-2”所示。 系统参数名称。系统参数见“清单 清单:A-2 系统参数 参数含义 备注 SYSTEM/BUSINESSNO 交易类型 SYSTEM/TIMEOUT 交易超时 0 无卡医保病人 1 持医保卡病人 ICENVIRONMENT/CARDFLG 医保病人类型 2 自费病人 100 异地人员 pszParameterValue 参数值。 iLength 参数值长度。保留参数，传0即可。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来设置固定的系统参数。 , SetBusinessNo function SetBusinessNo(iHandle:integer; pszBusinessNo:pchar; 第 77 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) Longint pszErrorMsg:pchar): iHandle:integer /* 消息缓冲区句柄 */ pszBusinessNo:pchar /* 交易类型 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中设置交易类型。 参数: iHandle 句柄。消息缓冲区句柄。 pszBusinessNo 交易类型。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来设置交易类型。 , SetBusinessTimeOut function SetBusinessTimeOut(iHandle:integer; pszBusinessTimeOut:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszBusinessTimeOut:pchar /* 超时时间 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中设置交易超时时间。 参数: iHandle 句柄。消息缓冲区句柄。 pszBusinessTimeOut 交易超时时间。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来设置交易超时时间。 , SetCardFlag 第 78 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) function SetCardFlag(iHandle:integer; pszCardFlag:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszCardFlag:pchar /* 医保卡标志 */ pszErrorMsg:pchar /* 错误信息 */ 消息缓冲区中设置医保卡标志。 参数: iHandle 句柄。消息缓冲区句柄。 pszCardFlag 医保卡标志。取值: 0 无卡医保病人 1 持医保卡病人 2 自费病人 100 异地人员 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来设置医保卡标志。 , ChildSize function ChildSize(iHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* ListXML参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 获取ListXML参数中子参数个数。 参数: iHandle 句柄。ListXML参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 >=0 子参数个数。 说明: 用来返回ListXML参数中子参数的个数。 , ChildRows 第 79 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) function ChildRows(iHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* RowsetXML参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 获取RowsetXML参数中记录条数。 参数: iHandle 句柄。RowsetXML参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 >=0 记录条数。 说明: 用来返回RowsetXML参数中记录条数。 , FirstChild function FirstChild(iHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* XML参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 定位XML参数中的第一个子参数或第一条记录。 参数: iHandle 句柄。XML参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 不存在。 1 存在。 说明: 定位到XML参数中的第一个子参数或第一条记录。 , NextChild function NextChild(iHandle:integer; pszErrorMsg:pchar):Longint iHandle:integer /* XML参数句柄 */ pszErrorMsg:pchar /* 错误信息 */ 第 80 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 定位XML参数中的下一个子参数或下一条记录。 参数: iHandle 句柄。XML参数句柄。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 不存在。 1 存在。 说明: 定位到XML参数中的下一个子参数或下一条记录。 , Get function Get(iHandle:integer; var iParameterType:integer; pszParameterValue:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄或XML参数句柄 */ iParameterType:pchar /* 返回参数类型 */ pszParameterValue:pchar /* 返回参数值 */ pszErrorMsg:pchar /* 错误信息 */ 获取当前参数的值。 参数: iHandle 句柄。消息缓冲区句柄或XML参数句柄。 iParameterType 返回参数类型。类型见“清单:A-1”所示。 pszParameterValue 返回参数值。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 >0 若获取的参数为XML参数，返回值为XML参数句柄。 说明: 返回当前参数。因为程序员很难记住当前参数，一般不使用该函数取参数值。所以 该函数无实 际的应用。 , GetH 第 81 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) function GetH(iHandle:integer; pszParameterName:pchar; var iParameterType:integer; pszParameterValue:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄*/ pszParameterName:pchar /* 参数名称 */ iParameterType:pchar /* 返回参数类型 */ pszParameterValue:pchar /* 返回参数值 */ pszErrorMsg:pchar /* 错误信息 */ 获取系统参数的值。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName 系统参数名称。系统参数见“清单:A-3”所示。 清单:A-3 系统参数 参数含义 备注 0 成功 ERRORFLG 返回码 -1 失败 ERRORMSG 错误信息 iParameterType 返回参数类型。类型见“清单:A-1”所示。 pszParameterValue 返回参数值。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来返回固定的系统参数。医院系统程序员一般不调用该函数。 , GetErrorFlag function GetErrorFlag(iHandle:integer; pszErrorFlag:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄*/ pszErrorFlag:pchar /* 交易失败成功标志 */ pszErrorMsg:pchar /* 错误信息 */ 第 82 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 获取交易成功或失败标志。 参数: iHandle 句柄。消息缓冲区句柄。 pszErrorFlag 交易成功失败标志。取值: -1 失败 0 成功 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来返回交易成功或失败标志。 , GetErrorMessage function GetErrorMessage(iHandle:integer; pszErrorMessage:pchar ):Longint iHandle:integer /* 消息缓冲区句柄*/ pszErrorMessage:pchar /* 错误信息 */ 获取交易返回错误信息。 参数: iHandle 句柄。消息缓冲区句柄。 pszErrorMessage 交易返回错误信息。 返回值:-1 失败。 0 成功。 说明: 用来返回交易返回的错误信息。 , GetOfIndex function GetOfIndex(iHandle:integer; iIndex:integer; var iParameterType:integer; pszParameterValue:pchar; 第 83 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) Longint pszErrorMsg:pchar): iHandle:integer /* XML参数句柄 */ iIndex: integer /* 参数索引序号 */ iParameterType:pchar /* 返回参数类型 */ pszParameterValue:pchar /* 返回参数值 */ pszErrorMsg:pchar /* 错误信息 */ 按参数索引号获取参数的值。 iHandle 参数: 句柄。XML参数句柄。 iIndex 参数索引号。参数的顺序号。 iParameterType 返回参数类型。类型见“清单:A-1”所示。 pszParameterValue 返回参数值。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 >0 若获取的参数为XML参数，返回值为XML参数句柄。 说明: 返回参数索引号指定的参数值。如果参数在缓冲区中有严格的顺序，可以使用该函 数来获取参 数值，我们建议尽量不要使用该函数来获取参数值。根据参数名获取参数值是最好 的选择，按 参数名获取参数的函数参见参见函数GetOfName。 , GetOfName function GetOfName(iHandle:integer; pszParameterName:pchar; var iParameterType:integer; pszParameterValue:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* XML参数句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:pchar /* 返回参数类型 */ pszParameterValue:pchar /* 返回参数值 */ pszErrorMsg:pchar /* 错误信息 */ 按参数名称获取参数的值。 第 84 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 参数: iHandle 句柄。XML参数句柄。 pszParameterName 参数名称。 iParameterType 返回参数类型。类型见“清单:A-1”所示。 pszParameterValue 返回参数值。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 -1 失败。 返回值: 0 成功。 >0 若获取的参数为XML参数，返回值为XML参数句柄。 说明: 返回参数名称指定的参数值。我们强烈推荐程序员使用该函数来获取参数值。 , GetOut function GetOut(iHandle:integer; pszParameterName:pchar; var iParameterType:integer; pszParameterValue:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄 */ pszParameterName:pchar /* 参数名称 */ iParameterType:pchar /* 返回参数类型 */ pszParameterValue:pchar /* 返回参数值 */ pszErrorMsg:pchar /* 错误信息 */ 按参数名称获取传出参数的值。 参数: iHandle 句柄。消息缓冲区句柄。 pszParameterName 传出参数名称。 iParameterType 返回传出参数类型。类型见“清单:A-1”所示。 pszParameterValue 返回传出参数值。 pszErrorMsg 第 85 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 >0 若获取的传出参数为XML参数，返回值为XML参数句柄。 说明: 返回传出参数名称指定的参数值。 , ToString function ToString(iHandle:integer; pszXML:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄或XML参数句柄 */ pszXML:pchar /* 输出的字符串 */ pszErrorMsg:pchar /* 错误信息 */ 以字符串的格式输出句柄所指的XML内容。 参数: iHandle 句柄。消息缓冲区句柄或XML参数句柄。 pszXML 字符串格式XML内容。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 以字符串个数输出句柄所指的XML内容。 , ToSave function ToSave(iHandle:integer; pszFileName:pchar; pszErrorMsg:pchar):Longint iHandle:integer /* 消息缓冲区句柄或XML参数句柄 */ pszFileName:pchar /* 文件名 */ pszErrorMsg:pchar /* 错误信息 */ 以字符串的格式输出句柄指定的XML内容。 参数: iHandle 句柄。消息缓冲区句柄或XML参数句柄。 第 86 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) pszFileName 输出的文件名。可以带路径。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 输出句柄所指的XML内容到一个指定文件。 8.1.3. 配置函数 , SetComm function SetComm(iComm:integer; pszErrorMsg:pchar): Longint iComm:integer /* 串口号 */ pszErrorMsg:pchar /* 错误信息 */ 设置医保卡读写POS机连接医保终端计算机的串口号。 参数: iComm 串口号。取值1-9,支持串口1到串口9。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 设置医保卡读写器连接医保终端计算机的串口号。设置错误将造成无法读写医保卡。 , SetTimeout function SetTimeout(iTimeout:integer; pszErrorMsg:pchar): Longint iTimeout:integer /* 超时时间(秒) */ pszErrorMsg:pchar /* 错误信息 */ 设置密码键盘输入医保卡密码的等待超时时间(秒)。 参数: iTimeout 超时时间(秒)。取值范围:30秒~120秒;默认40秒。 第 87 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 设置密码键盘输入密码的等待超时时间。 , SetServerIP function SetServerIP(pszServerIP:pchar; pszErrorMsg:pchar): Longint pszServerIP:pchar /* 前置医保应用服务器IP地址 */ pszErrorMsg:pchar /* 错误信息 */ 设置医保终端计算机连接前置医保应用服务器的IP地址。 参数: pszServerIP 前置医保应用服务器IP地址。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 设置医保终端计算机连接前置医保应用服务器的IP地址。设置错误将造成所有医保交易调用 失败。 , SetServerPort function SetServerPort(pszServerPort:pchar; pszErrorMsg:pchar): Longint pszServerPort:pchar /* 前置医保应用服务器端口号 */ pszErrorMsg:pchar /* 错误信息 */ 设置医保终端计算机连接前置医保应用服务器的端口号。 参数: pszServerPort 前置医保应用服务器端口号。 pszErrorMsg 第 88 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 设置医保终端计算机连接前置医保应用服务器的端口号。设置错误将造成所有医保 交易调用 失败。 , GetComm function GetComm(var iComm:integer; pszErrorMsg:pchar): Longint iComm:integer /* 串口号 */ pszErrorMsg:pchar /* 错误信息 */ 获取配置的医保卡读写POS机连接医保终端计算机的串口号。 参数: iComm 返回串口号。取值1-9,支持串口1到串口9。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 获取配置的医保卡读写器连接医保终端计算机的串口号。 , GetTimeout function GetTimeout(var iTimeout:integer; pszErrorMsg:pchar): Longint iTimeout:integer /* 超时时间(秒) */ pszErrorMsg:pchar /* 错误信息 */ 获取配置的密码键盘输入医保卡密码的等待超时时间(秒)。 参数: iTimeout 返回超时时间(秒)。取值范围:30秒~120秒;默认40秒。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 第 89 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 0 成功。 说明: 获取配置的密码键盘输入密码的等待超时时间。 , GetServerIP function GetServerIP(pszServerIP:pchar; pszErrorMsg:pchar): Longint pszServerIP:pchar /* 前置医保应用服务器IP地址 */ pszErrorMsg:pchar /* 错误信息 */ 获取配置的医保终端计算机连接前置医保应用服务器的IP地址。 参数: pszServerIP 返回前置医保应用服务器IP地址。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 获取配置的医保终端计算机连接前置医保应用服务器的IP地址。 , GetServerPort function GetServerPort(pszServerPort:pchar; pszErrorMsg:pchar): Longint pszServerPort:pchar /* 前置医保应用服务器端口号 */ pszErrorMsg:pchar /* 错误信息 */ 获取配置的医保终端计算机连接前置医保应用服务器的端口号。 参数: pszServerPort 返回前置医保应用服务器端口号。 pszErrorMsg 错误信息。返回值为-1时，该参数返回错误信息。 返回值:-1 失败。 0 成功。 说明: 获取配置的医保终端计算机连接前置医保应用服务器的端口号。 第 90 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 8.1.4. 其他函数 8.2. 医保接口DLL动态连接库API函数使用参考 8.2.1. Delphi开发 , DLL函数声明 //交易接口API function Init(pszErrorMsg:pchar):Longint;stdcall; external 'Business2.dll'; function OpenBuffer(pszErrorMsg:pchar):Longint;stdcall; external 'Business2.dll'; function Service(pszErrorMsg:pchar):Longint;stdcall; external 'Business2.dll'; function CloseBuffer(pszErrorMsg:pchar):Longint;stdcall; external 'Business2.dll'; //消息缓冲区处理函数 function CreateXML(fileType:integer;pszErrorMsg:pchar):Longint;stdcall; external 'Business2.dll'; function Add(ihandle:longint;const pszParameterName:pchar;iParameterType:integer; const pszParameterValue:pchar;iLength:longint;pszErrorMsg:pchar):Longint; stdcall; external 'Business2.dll'; (其它函数不在此一一列出。) //配置函数 function SetComm(iComm:integer;pszErrorMsg:pchar):Longint;stdcall; external 'Business2.dll'; (其它函数不在此一一列出。) , Delphi代码例子(目录对照) var pszErrorMsg:pchar; pszReturnMsg:pchar; iType:integer; requestHandle, comparisionHandle,responseHandle:longint; begin pszErrorMsg:=stralloc(1024); zeromemory(pszErrorMsg,1024); pszReturnMsg:=stralloc(1024*1024); zeromemory(pszReturnMsg, 1024*1024); //创建消息缓冲区，打开交易 bufHandle =OpenBuffer(pszErrorMsg); if bufHandle<0 then raise Exception.Create(pszErrorMsg); try //设置交易类型(目录对照) if SetH(bufHandle,‘SYSTEM/BUSINESSNO’,’SI010’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //设置交易超时时间 if SetH(bufHandle,‘SYSTEM/ TIMEOUT’,’60’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //创建参数:对照(ListXML) comparisionHandle =CreateXML(1, pszErrorMsg); 第 91 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) if comparisionHandle<0 then raise Exception.Create(pszErrorMsg); //设置参数 //医院项目编号 if Add(comparisionHandle,’yyxmbh’,1,’医院项目编号’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目名称 if Add(comparisionHandle,’yyxmmc’,1,’医院项目名称’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目剂型 if Add(comparisionHandle,’yyxmjx’,1,’医院项目剂型’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目规格 if Add(comparisionHandle,’yyxmgg’,1,’医院项目规格’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目计价单位 if Add(comparisionHandle,’yyxmjjdw’,1,’医院项目计价单位’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目最小包装单位 if Add(comparisionHandle,’yyxmzxbzdw’,1,’医院项目最小包装单位’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目最小包装数量 if Add(comparisionHandle,’yyxmxbzsl’,3,’医院项目最小包装数量’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目生产单位 if Add(comparisionHandle,’yyxmscdw’,1,’医院项目生产单位’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目批准文号 if Add(comparisionHandle,’yyxmpzwh’,1,’医院项目批准文号’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医院项目备注 if Add(comparisionHandle,’yyxmbz’,1,’医院项目备注’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //费用项目类别 if Add(comparisionHandle,’fyxmlb’,1,’ 费用项目类别’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //医保项目编号 if Add(comparisionHandle,’ybxmbh’,1,’ 医保项目编号’,0, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //参数:对照，加入消息缓冲区 if AddInHandle(requestHandle,’COMPARISION’,38, comparisionHandle, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //参数:撤消标志，加入消息缓冲区 if Add(requestHandle,’CXBZ’,1, comparisionHandle, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); //参数:操作员，加入消息缓冲区 if Add(requestHandle,’CZY’,1, comparisionHandle, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); 第 92 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) //调用交易 responseHandle=Service(pszErrorMsg); if responseHandle<0 then raise Exception.Create(pszErrorMsg); //取返回码 if GetH(responseHandle,’ ERRORFLG’, iType, pszReturnMsg, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); if string(pszReturnMsg)=’-1’ then begin if GetH(responseHandle,’ ERRORMSG’, iType, pszReturnMsg, pszErrorMsg)<0 then raise Exception.Create(pszErrorMsg); raise Exception.Create(pszReturnMsg); end; finally strdispose(pszErrorMsg); strdispose(pszReturnMsg); CloseBuffer(pszErrorMsg); end; end; 8.2.2. PowerBuilder开发 8.2.3. Java开发 如果有用户需要用JAVA开发;请与我们联系;我们将另外提供JAR库。 主要包含:BusinessXML解析类、HTTP帮助器、公用类等。 第 93 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第9章. 附录B 科室编码表 编号 科室名称 编号 科室名称 编号 科室名称 预防保健科 胸外科 儿科04.05 01. 07. 全科医疗科 心脏大血管外科 新生儿 04.06 07.01 02. 小儿传染病 内科烧伤科04.07 07.02 03. 呼吸内科 整形外科 小儿消化 03.01 04.08 07.03 消化内科 其他 小儿呼吸 03.02 04.09 07.04 神经内科 妇产科 小儿心脏病 03.03 07.05 05. 心血管内科 妇科 小儿肾病 03.04 05.01 07.06 血液内科 产科 小儿血液病 03.05 05.02 07.07 肾病内科 计划生育 小儿神经病03.06 05.03 07.08 内分泌内科 优生学 小儿内分泌 03.07 05.04 07.09 免疫学内科 生殖健康与不孕症 小儿遗传病 03.08 05.05 07.10 变态反应内科 其他 小儿免疫 03.09 05.06 07.11 老年病内科 妇女保健科 其他 03.10 07.12 06. 其他 青春期保健 小儿外科 03.11 06.01 08. 外科 围产期保健 小儿普通外科 06.02 08.01 04. 普通外科 更年期保健 小儿骨科 04.01 06.03 08.02 神经外科 妇女心理卫生 小儿泌尿外科04.02 06.04 08.03 妇女营养 小儿胸心外科 骨科04.03 06.05 08.04 泌尿外科 其他 小儿神经外科 04.04 06.06 08.05 编号 科室名称编号 科室名称 编号 科室名称 其他 其他 结核病科 08.06 13.03 17. 儿童保健科医病美容科 09. 14. 儿童生长发育 美容外科 地方病科 09.01 14.01 18. 儿童营养 美容牙科 09.02 14.02 儿童心理卫生美容皮肤科 肿瘤科 09.03 14.03 19. 儿童五官保健 美容中医科 09.04 14.04 儿童康复 精神科 急诊医学科 09.05 15. 20. 其他 精神病 09.06 15.01 第 94 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 康复医学科 眼科精神卫生15.02 10. 21. 耳鼻咽喉科 药物依赖 15.03 11. 精神康复 运动医学科 耳科11.01 15.04 22. 鼻科 社区防治 11.02 15.05 职业病科 咽喉科 临床心理11.03 15.06 23. 其他 司法精神 职业中毒11.04 15.07 23.01 口腔科 其他 尘肺 15.08 23.02 12. 口腔内科 传染科 放射病12.01 23.03 16. 肠道传染病 物理因素损伤 口腔颌面外科12.02 16.01 23.04 正畸专业 呼吸道传染病 职业健康监护12.03 16.02 23.05 口腔修复专业 肝炎 其他 12.04 16.03 23.06 虫媒传染病 临终关怀科 口腔预防保健12.05 16.04 24. 其他 动物源性传染病 特种医学与军事医学科12.06 16.05 25. 皮肤科 蠕虫病 麻醉科 16.06 13. 26. 皮肤病 其他 医学检验科 13.01 16.07 30. 性传播疾病 临床体液、血液专业 13.02 30.01 编号 科室名称 编号 科室名称 编号科室名称 临床微生物学专业 外科 藏医学 30.02 50.02 51.02 临床生化检验专业 妇产科 蒙医学 30.03 50.03 51.03 临床免、血清学专业 儿科 彝医学 30.04 50.04 51.04 其他 皮肤科 傣医学 30.05 50.05 51.05 病理科 眼科 其他 50.06 51.06 31. 医学影像科 耳鼻咽喉科 中西医结合科 50.07 32. 52. X线诊断专业 口腔科 32.01 50.08 CT诊断专业 肿瘤科 重症监护室(综合) 32.02 50.09 61. 磁共振成像诊断专业 骨伤科 32.03 50.10 肛肠科 管理科室 核医学专业32.04 50.11 99. 超声诊断专业 老年病科 感染管理科 32.05 50.12 99.01 针炙科 心电诊断专业32.06 50.13 脑电及脑血流图诊断专业 推拿科32.07 50.14 神经肌肉电图专业 康复医学科 药店模拟科室 32.08 50.15 YD. 介入放射学专业 急诊科32.09 50.16 放射治疗专业 预防保健科 32.10 50.17 第 95 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 其他 其他 32.11 50.18 中医科民族医学科 50. 51. 内科 维吾尔医学 50.01 51.01 注: 1. 门诊部、卫生室、卫生站等要维护科室，至少设置科室“全科医疗科”。 2.设置科室的医疗机构，不允许使用“药店模拟科室” 第 96 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第10章. 附录C 2011年社会保障(市民)卡切换医院 端方案 10.1. 医院信息管理系统改造要求 , 升级原则:医院信息管理系统不做任何接口的调整，可以自动识别社会保障(市民) 卡的刷卡消费，完成无缝切换。 , 医保接口自实施以来，医院信息系统调用医保接口的开发存在这样那样的误区， 下面就几个突出问题做重点说明，各家定点医疗机构做好程序的修改调整，保证 社会保障(市民)卡工程的顺利实施。 , 关于存在入参为“帐号”的交易。 2 ZH帐号 string 使用注意点: 1. 该参数是可空参数(即无卡交易时)。意思就是，调用时，可空。 2. 如果无卡交易，该参数就是空的; 3. 如果有卡交易，该参数的值应该取用读卡时返回的帐号。有的医院系统开 发时，取自己系统中保存的帐号，比如住院登记时记下的“帐号”，如果 医保病人换卡了，就造成交易失败了; 4. 这次涉及到社会保障(市民)卡的升级，所有参保病人的帐号更换，如果 不遵从以上的编程规范，将造成参保病人，特别是住院病人的刷卡就医。 所以，尽快做好修改。 , 关于住院退费。 系统上线以后，一直有医院反映住院退费之后，卡中的住院标志成在院状态 了。首先说明这是正确的。 然而，有的医院就使用改住院状态标志的工具(社保应急提供的)直接修改 住院标志，这是错误做法(而且，社会保障卡升级以后将不提供该工具)。所 以，对存在该情况的医院，要做好医院信息系统的调整。 正确的做法有两种: 第一种:记账，并重新做出院结算; 第二种:调用“撤销入院登记”; , 关于挂起交易的问题。 由于医院数据库和社保数据是两个事务，如果处理不好会造成交易挂起，即 交易做了一半，没有完整的结束。从以下的业务流程图中来说明发生的可能 情况; 第 97 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 开始 预结算(退费) 成功失败 暂存医院本地数据库(标志:未决) 结算 ?? 失败成功 更新医院本地数据库更新医院本地数据库(提交)(回退) 提交回退 ??定时发起定时发起 失败成功成功失败 更新医院本地数据库(标志:已决) 结束 医院设计的重要说明: 1).暂存医院本地数据库,在结算前做;该结算的状态为“未决”。若不继续结算，就不必要暂存本地数据库。2).若结算成功，医院数据库做提交标志; 若结算失败，医院数据库做回退标志; 必须遵守:一旦做了提交标志,意味着医院必须给医保病人完成结付,即使后续调用”提交”失败;3).提交或回退必须调用成功;所以系统还提供无卡提交和无卡回退的调用;详见交易说明。4).提交或回退的目的就是对结算做决断，如果医保病人存在未决断的记录，将锁住该医保病人继续就医，所以医疗机构系统必须做好结算的提交 和回退。否则医保病人将找医疗机构对交易做出决断。 异常情况发生: 1、“结算”、“有卡提交”和“有卡回退”这几个交易要写卡，如果这时进行社会保 障卡的非法 插拔，有可能会出现交易挂起，卡异常。 2、“结算”成功后，程序崩溃、人为或其它环境造成无法执行以下步骤时，有可能 会出现交易 挂起，卡异常。 3、“结算”成功后且医院信息系统更新成功后，程序崩溃、人为或其它环境造成无 法执行以下 步骤(“提交”或“回退”)时，有可能会出现交易挂起，卡异常。 编程和操作提示: 1、交易过程中，严禁非法插拔卡。 2、“结算”失败时，自动调用一次读卡(参数NOSHOW传1)。 3、“结算”成功、且医院信息系统保存成功后，就可以收款或退费(与参保病人的 关系结束); 程序中可以不考虑有以下“有卡提交”或“有卡回退”执行返回的成功或失败;但 第 98 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 是，在程序 中，必须及时对这些“提交”或“回退”未成功的交易及时进行“无卡提交”或“无卡回退” (用守候进程实现)，如果是分时交易，要保证网络的通畅及时传回中心，否则会造成参保病 人的社会保障卡出现异常无法正常使用。 , 如果配合新的医保政策或其它修改，请随时注意查收。 10.2. 社会保障(市民)卡上线，医院的工作 , 到市民卡服务中心领取社会保障(市民)卡读写器，并由市民卡服务中心负责做好 读写器的登记注册;切换前要部署到位。 , 社会保障(市民)卡上线将发布新的读写接口dll和新的前置机程序;在上线前会 自动更新到医院前置机和医保刷卡终端。虽然不要人工参与，务必请各医院信息工作 人员负责做好检查、排错和及时汇报工作。 医保刷卡终端新的程序(由市民卡中心提供部署)包括:Rfsim.dll和ZJGSMK.dll; 在软件开发完成后，正式运行之前，我公司负责向吴中区人社局提供免费的技术培训，使用户可以迅速的上手进行业务操作。 第 99 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第11章. 附录D 常见问题集 问题1:提示“因为与社保中心的网络不通,医保卡【****】年度没圈存或者存在异常读写，无法刷卡!” 直接原因:医疗机构与社保中心的网络不通。医保卡中的医保年度不正确。 间接原因:有两种。 , 医保卡在医保年度中首次刷卡，医疗机构与社保中心的网络 不通。 , 医保卡因为非法插拔(在读写过程中，读写没有完成的插拔) 或非法 写，造成医保年度被非法修改, 医疗机构与社保中心的网络不 通。 解决办法:以下任何一种，可以解决以上问题。 ? 保证医疗机构的网络通畅; ? 到网络正常的定点医疗机构读一次卡即可; 到社保中心读一次卡即可; ? 问题2:提示“医保卡出现异常，请回上次就诊医疗机构【*****】做异常恢复! ” 直接原因:医保病人在上次就诊医疗机构就医时，刷卡消费交易写卡没有正 常结束。 解决办法:回到上次就诊医疗机构,并且社保中心的网络正常的前提下，读一次卡 即可。 以下任何一种，可以尝试解决以上问题，但不一定成功。 ? 保证当前医疗机构的网络通畅; ? 就近到网络正常的定点医疗机构读一次卡; ? 到人力资源和社会局中心读一次卡; 问题3:提示“当前医疗机构【*****】与医保中心网络不通，请回上次就诊医疗机构【*****】做异常恢复～” 直接原因:医保病人在上次就诊医疗机构就医时，刷卡消费交易写卡没有正 常结束。 间接原因: , 当前医疗机构与社保中心的网络不通。 , 当前医疗机构非最近就诊的医疗机构。 解决办法:回到上次就诊医疗机构,并且社保中心的网络正常的前提下，读 第 100 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 一次卡 即可。 以下任何一种，可以尝试解决以上问题，但不一定成功。 ? 保证当前医疗机构的网络通畅; ? 就近到网络正常的定点医疗机构读一次卡; ? 到人力资源和社会局中心读一次卡; 问题4:提示“出现不可知异常，请回社保中心处理医保卡的异常! ” 直接原因:医保病人在上次就诊医疗机构就医时，刷卡消费交易写卡没有正 常结束。 解决办法:到人力资源和社会局中心手工处理。 问题5:提示“与医保中心的网络不通已经有【**】小时，请务必尽快修复。如果网络不通达到72小时将自动关闭医保交易! ” 直接原因:医疗机构与医保中心的网络不通。如果网络不通达到72小时， 医保交易自动关闭，该期间，整点都会做以上提示。 解决办法:修复网络。 问题6:提示“与医保中心的网络不通,无法提供医保交易服务!” 直接原因:启动前置机服务时，如果医疗机构与医保中心的网络不通，会做 以上提示。 解决办法:修复网络。 第 101 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) 第12章. 附录E 修改记录 12.1. 时间:2011年8月24日 12.1.1. 内容1:读卡时返回“人员通讯地址”(取人员表) 详见“5.4.1参保人员信息(SIMESSAGE)”;新增返回字段rytxdz。 string 27rytxdz 人员通讯地址 12.1.2. 内容2:医保暂停定点标志(hos_yljg.yljgksqtbz=0)提示“取消定点”修改成“暂停定点” 12.1.3. 内容3:读卡返回“冻结记录”按个人编号或卡号取冻结记录，因为卡号可能对应不同的个人编号(身份证号相同)，所以造成错误提示，取消“卡号”条件。 12.2. 时间:2011年9月6日 12.2.1. 内容1:读卡时返回“人员通讯地址”(修改取地址的方法:默认人员表的，若制卡文件的通讯地址不空，用该地址取代。) 12.2.2. 内容2:读卡时返回“人员通讯电话”(取制卡信息)和“单位名称”(取单位表) 详见“5.4.1参保人员信息(SIMESSAGE)”;新增返回字段rytxdh和rydw。 第 102 页 张家港市医疗保险费用结算审核 医院系统接口规范(第二版) string 28rytxdh 人员通讯电话 string 29 rydw 人员单位 12.2.3. 内容3:提交交易pub02升级，临时表的删除工作不在交易中执行，由数据库job定时晚上12点定时来执行删除，提高交易的性能。 12.3. 时间:2011年01月01日 12.3.1. 内容1:新增“体育运动消费预结算”(交易号SI090) 调用的一般流程: 读卡YB002 , 体育运动刷卡预结算SI090 , 结算PUB02 , 提交PUB06 12.4. 时间:2012年06月06日 12.4.1. 内容1:新增“单病种出院预结算”(交易号SI058) 为了医院升级的方便，该交易SI058的出入参数与出院预结算交易SI057的出入参数完全一致。调用流程和使用方法与“出院预结算SI057”完全相同。 调用的一般流程: 读卡YB002 , 单病种出院预结算SI058 , 结算PUB02 , 提交PUB06 第 103 页