武汉市铁路医保系统 HIS接口应用编程接口规范.doc

武汉市铁路医保系统 HIS接口应用编程接口规范 华中兴业软件 2007年05月 概述 《武汉市铁路医保系统支付接口应用编程接口规范》（以下简称规范）的使用对象为将使用武汉兴业公司的医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。 规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。 术语及参考资料 COM： Common Object Model HIS：Hospital Information System MIS：Management Information System 应用模式 兴业医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。 环境要求 硬件环境 指标 指标值 CPU ≧1.6MHz Memory ≧256MB HardDisk ≧100M(free) NetCard ≧10MB 网络环境 指标 指标值 协议 TCP/IP、HTTP/HTTPS 广域网带宽 ≧56k 网络连接 客户端直接访问医保中心网络 系统软件 指标 指标值 操作系统 WIN98 SE或WIN 2000及以上WIN系列操作系统 辅助软件 IE6.0 接口描述 总体描述 组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）； 接口交易组件库提供了三个公共方法(Init 初始化，Destroy 资源释放，Trade业务方法调用)，交易参数组织采用String（字符串）（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。 接口交易内部也存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。 字段分隔符:@@； 行分隔符:\/； 接口COM说明 组件库提供交易的COM组件属性如下： 属性 值 App ID Type Library ID Program ID Railway_insure.InsureInterface COM ClassName InsureInterface COM ClassID Interface Type Dual Interface Interface Name Interface ID 交易接口函数描述 Init 原型定义： Init(ByRef intAppCode As Long, ByRef strAppMsg As String) 参数名称 参数含义 参数类型 参数类别 参数说明 intAppCode 交易标志 long 出口参数 小于0均为失败。此值数据类型是整数 strAppMsg 交易信息 String 出口参数 错误信息描述。intAppCode小于0时存放错误描述，其他intAppCode不用关心该参数内容。 函数说明： 初始化函数，HIS应用启动时调用，进行医保交易处理初始化，本交易调用成功后才能进行其他交易处理。 Destroy 原型定义： 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 strAppMsg As string) ‘交易信息 参数名称 参数含义 参数类型 参数类别 参数说明 strTradeId 交易编号 String 入口参数 具体的交易代码见〖交易列表〗strControl 交易控制 String 入口参数 字符串方式，组织方式见业务说明 strIn 交易输入 String 入口参数 字符串方式，组织方式见业务说明 strSerialId 交易流水号 String 出口参数 唯一标识一次交易，VARCHAR(20) strOut 交易输出 String 出口参数 字符串方式，组织方式见业务说明 intAppCode 交易标志 long 出口参数 小于0均为失败。此值数据类型