1、 武汉铁路医保医保支付接口应用编程接口规范第 1 页 共 41 页武汉市铁路医保系统HIS 接口应用编程接口规范华中兴业软件2007 年 05 月武汉铁路医保医保支付接口应用编程接口规范第 2 页 共 41 页1、 概述武汉市铁路医保系统支付接口应用编程接口规范 （以下简称规范）的使用对象为将使用武汉兴业公司的医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的 HIS供应商、药店 MIS 供应商或其它第三方应用软件供应商。规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的
2、介绍不属于本规范的范围。1.1. 术语及参考资料COM： Common Object ModelHIS：Hospital Information SystemMIS：Management Information System1.2. 应用模式兴业医保支付组件库是一组运行在 WINDOWS 32 位环境下的 COM 组件，第三方应用软件使用相应的 COM 组件调用方式来调用它。1.3. 环境要求1.3.1. 硬件环境指标 指标值CPU 1.6MHzMemory 256MBHardDisk 100M(free)NetCard 10MB武汉铁路医保医保支付接口应用编程接口规范第 3 页 共 41 页
3、1.3.2. 网络环境指标 指标值协议 TCP/IP、 HTTP/HTTPS广域网带宽 56k网络连接 客户端直接访问医保中心网络1.3.3. 系统软件指标 指标值操作系统 WIN98 SE 或 WIN 2000 及以上 WIN 系列操作系统辅助软件 IE6.02. 接口描述2.1. 总体描述组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络） ，通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称 HIS） ；接口交易组件库提供了三个公共方法(Init 初始化，Destroy 资源释放，Trade 业务方法调用) ，交易参数组织采用 Stri
4、ng（字符串） （所有社保经办机构交易调用及交易参数统一） ，差别处理对于 HIS 透明。接口交易内部也存在用户交互窗口，因此建议 HIS 事务管理与接口交易调用相互独立。字段分隔符:；行分隔符:/；2.2. 接口 COM 说明组件库提供交易的 COM 组件属性如下：属性 值App ID武汉铁路医保医保支付接口应用编程接口规范第 4 页 共 41 页Type Library IDProgram ID Railway_insure.InsureInterfaceCOM ClassName InsureInterfaceCOM ClassIDInterface Type Dual Interfac
5、eInterface NameInterface ID2.3. 交易接口函数描述Init 原型定义：Init(ByRef intAppCode As Long,ByRef strAppMsg As String)参数名称 参数含义 参数类型 参数类别 参数说明intAppCode 交易标志 long 出口参数 小于 0 均为失败。此值数据类型是整数strAppMsg 交易信息 String 出口参数 错误信息描述。intAppCode 小于0 时存放错误描述，其他intAppCode 不用关心该参数内容。 函数说明：初始化函数，HIS 应用启动时调用，进行医保交易处理初始化，本交易调用成功后才
6、能进行其他交易处理。Destroy 原型定义：武汉铁路医保医保支付接口应用编程接口规范第 5 页 共 41 页Destroy() 函数说明：资源释放函数，在 HIS 应用退出时调用。Trade 原型定义：Trade(Byval strTradeId As String, 交易编号Byval strControl As String, 交易控制Byval strIn As String, 交易输入Byref strSerialId As string, 交易流水号Byref strOut As string, 交易输出Byref intAppCode As long, 交易标志Byref str
7、AppMsg As string) 交易信息参数名称 参数含义 参数类型 参数类别 参数说明strTradeId 交易编号 String 入口参数 具体的交易代码见交 易列表strControl 交易控制 String 入口参数 字符串方式，组织方式见业务说明strIn 交易输入 String 入口参数 字符串方式，组织方式见业务说明strSerialId 交易流水号 String 出口参数 唯一标识一次交易，VARCHAR(20)strOut 交易输出 String 出口参数 字符串方式，组织方式见业务说明intAppCode 交易标志 long 出口参数 小于 0 均为失败。此值数据类型是
8、整数，范围为-2147483648 to +2147483647strAppMsg 交易信息 String 出口参数 错误信息描述。intAppCode 小于0 时存放错误描述，其他intAppCode 不用关心该参数内容。 函数说明：武汉铁路医保医保支付接口应用编程接口规范第 6 页 共 41 页交易主函数，完成所有医疗业务的实际处理。由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入HIS 系统事务管理。在交易接口函数定义中，传递的参数都是字符串。但是在交易详细说明中，数据类型都是逻辑类型，常用类型有三种：string,number,datetime，下面的表格描述了
9、交易接口进行类型转换的限制和说明。数据类型 空字符串 格式不合法 其它说明string 视同空串 无 无特别说明标注的长度为最大长度number 视同 0 返回错误 无特别说明标注的长度为最大长度（小数尾数同）datetime 视同空值 返回错误 足 19 位长，格式如下：YYYY-MM-DD hh24:mm:ssdate 视同空值 返回错误 足 19 位长，格式如下：YYYY-MM-DD 00:00:00接口调用示例：VB 调用Dim XYobject As Object 定义存放引用对象的变量。Set XYobject = CreateObject(“Railway_insure.Insu
10、reInterface “)检查连接是否建立If XYobject Is Nothing ThenMsgBox “对象为空 !“End Ifdim strTradeId As String, 交易编号dim strControl As String, 交易控制dim strIn As String, 交易输入dim strSerialId As string, 交易流水号dim strOut As string, 交易输出武汉铁路医保医保支付接口应用编程接口规范第 7 页 共 41 页dim intAppCode As long, 交易标志dim strAppMsg As string) 交易
11、信息strTradeId =“01“HIS 业务处理Call XYobject.Trade(strTradeId ,strControl,strIn,strSerialId,strOut,intAppCode,strAppMsg) 判断返回信息If Appcode0 thenmessagebox(“error“，“fail to connect“)returnend ifBusinessID=”01”XYobject.Trade(strTradeId ,strControl,strIn,ref strSerialId,ref strOut,ref intAppCode,ref strAppMs
12、g)/ 返回结果判断，HIS 内部处理2.4. 交易类型和调用流程1、 查询类交易：包括一般查询交易,例如：身份确认；武汉铁路医保医保支付接口应用编程接口规范第 9 页 共 41 页2、 处理类交易：包括门诊结算（退单/作废） 、入院办理（回退） 、出院结算（退单/取消结算）六个交易，一次完整的处理类交易可以有两种方式： 1） 只有处理流程，符合情况是处理流程执行失败（接口返回错误代码及信息） ；2） 处理流程取消流程，符合情况是处理流程执行成功，HIS 处理失败，调用取消流程。调用交易的处理流程interface _call调用处理流程是否成功 交易失败HIS 进行处理6 、 调用失败2、
13、调用成功HIS 处理是否成功调用交易的取消流程_4、 处理失败5、 处理成功3 、 HIS 处理完毕1、 处理流程处理完毕交易成功图 1-1 处理类交易调用流程2.5. 处理交易的不同宕机点和相应的处理1、 处理流程处理完毕2、 调用成功3、 HIS 处理完毕4、 处理失败武汉铁路医保医保支付接口应用编程接口规范第 10 页 共 41 页5、 处理成功在上面 5 个点系统宕机，系统重新启动后，都没有办法直接决定调用【取消流程】还是【确认流程】 ；对于这种情况，应及时通知相关部门（例如：医保中心） ，再根据这些交易出的相关信息，查询HIS 系统的情况，决定是否调用【取消流程】 。不同的业务交易，
14、判断不同。门诊结算：如果 HIS 系统没有相应的结算信息，则应该调用取消流程。门诊结算回退：如果 HIS 系统没有相应的结算信息，或者有相应的退单信息，则通知医保中心取消相关记录。2.6. 交易列表序号 交易代码 交易名称 交易类型广域网支持备注1. 01 身份识别 查询类交易 患者登记确认2. 10 门诊费用分解 处理类交易 3. 11 门诊结算 处理类交易 4. 12 门诊结算回退（取消结算） 处理类交易 5. 21 入院办理 处理类交易 6. 22 入院办理回退 处理类交易 7. 23 入院办理信息修改 处理类交易 8. 25 出院办理 查询类交易 9. 26 出院办理回退 查询类交易
15、10. 31 住院费用明细写入（住院） 处理类交易 11. 42 住院费用明细写入（结算） 处理类交易 12. 51 住院费用分解 处理类交易 13. 52 住院结算 处理类交易 14. 53 住院结算退单 处理类交易 15. 91 服务项目目录获取（三大目录） 查询类交易 16. 94 医院需审核项目上传 处理类交易 HIS 基本业务调用说明：（1） 门诊挂号：01 身份识别；（2） 门诊结算：01 身份识别10 门诊费用分解11 门诊结算；（3） 门诊结算取消：01 身份识别12 门诊结算回退（取消结算；（4） 入院办理：01 身份识别21 入院办理；（5） 入院办理回退：01 身份识别22 入院办理回退；
