区本级医保支付接口规范.doc

新疆(区本级)医保支付接口应用编程接口规范 PAGE PAGE 第 PAGE 117 页 共 NUMPAGES 117 页 - 新疆（区本级）医保系统 支付接口应用编程接口规范 （初稿） 银海软件 2009年11月 概述 《新疆(区本级)医保系统支付接口应用编程接口规范》（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的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 Msxml4.0 接口描述 总体描述 组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）； 接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。 新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。 文档内但凡日期格式的处理均传入年月日，不带时分秒的处理，且全部为YYYYMMDD格式 接口COM说明 组件库提供交易的COM组件属性如下： 属性 值 App ID Type Library ID Program ID erface COM ClassName COClass_n_yh_interface COM ClassID Interface Type Dual Interface Interface Name In_yh_interface Interface ID 交易接口函数描述 yh_interface_init 原型定义： yh_interface_init( ref integer aint_appcode, ref string astr_appmsg) 函数说明： 初始化函数，HIS应用启动时调用，进行医保交易处理初始化，本交易调用成功后才能进行其他交易处理。 yh_interface_destroy 原型定义： yh_interface_destroy() 函数说明： 资源释放函数，在HIS应用退出时调用。 yh_interface_call 原型定义： yh_interface_call( string astr_jybh, string astr_jysr_xml, ref string astr_jylsh, ref string astr_jyyzm, ref string astr_jysc_xml, ref long aint_appcode, ref string astr_appmsg) 参数名称 参数含义 参数类型 参数类别 参数说明 astr_jybh 交易编号 String 入口参数 具体的交易代码见〖 HYPERLINK file:///C:\\Documents%20and%20Settings\\Administrator.5F7114AD788D41E\\桌面\\荆州市医保支付接口规范.doc \l _交易列表 交易列表〗 astr_j