新疆(区本级)医保系统支付接口规范VIP免费

新疆(区本级)医保支付接口应用编程接口规范-新疆（区本级）医保系统支付接口应用编程接口规范（初稿）银海软件2009年11月第1页共95页新疆(区本级)医保支付接口应用编程接口规范1、概述1.《新疆(区本级)医保系统支付接口应用编程接口规范》（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。2.规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。§1.1.术语及参考资料COM：CommonObjectModelHIS：HospitalInformationSystemMIS：ManagementInformationSystem§1.1.应用模式1.银海医保支付组件库是一组运行在WINDOWS32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。§1.2.环境要求§1.1.1.硬件环境指标指标值CPU≧1.6MHzMemory≧256MBHardDisk≧100M(free)NetCard≧10MB2.§1.2.1.网络环境指标指标值协议TCP/IP、HTTP/HTTPS第2页共95页新疆(区本级)医保支付接口应用编程接口规范广域网带宽≧56k网络连接客户端直接访问医保中心网络§1.2.2.网络拓扑图§1.2.3.系统软件指标指标值操作系统WIN98SE或WIN2000及以上WIN系列操作系统辅助软件IE6.0Msxml4.0§1.接口描述§1.1.总体描述1.组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；2.接口交易组件库提供了六个公共方法(yh_interface_init初始化，yh_interface_destroy第3页共95页新疆(区本级)医保支付接口应用编程接口规范资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。3.新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。4.文档内但凡日期格式的处理均传入年月日，不带时分秒的处理，且全部为YYYYMMDD格式§1.2.接口COM说明5.组件库提供交易的COM组件属性如下：属性值AppIDTypeLibraryIDProgramIDyinhai.xjcj.interfaceCOMClassNameCOClass_n_yh_interfaceCOMClassIDInterfaceTypeDualInterfaceInterfaceNameIn_yh_interfaceInterfaceID§1.3.交易接口函数描述yh_interface_init原型定义：yh_interface_init(refintegeraint_appcode,refstringastr_appmsg)函数说明：初始化函数，HIS应用启动时调用，进行医保交易处理初始化，本交易调用成功后才能进行其他交易处理。第4页共95页新疆(区本级)医保支付接口应用编程接口规范yh_interface_destroy原型定义：yh_interface_destroy()函数说明：资源释放函数，在HIS应用退出时调用。yh_interface_call原型定义：yh_interface_call(stringastr_jybh,stringastr_jysr_xml,refstringastr_jylsh,refstringastr_jyyzm,refstringastr_jysc_xml,reflongaint_appcode,refstringastr_appmsg)参数名称参数含义参数类型参数类别参数说明astr_jybh交易编号String入口参数具体的交易代码见〖交易列表〗astr_jysr_xml交易输入String入口参数xml方式，组织方式见业务说明，字符串最大长度65534字符astr_jylsh交易流水号String出口参数唯一标识一次交易，VARCHAR(20)astr_jyyzm交易验证码String出口参数处理类交易返回，确认交易时传入VARCHAR(15)astr_jysc_xml交易输出String出口参数xml方式，组织方式见业务说明aint_appcode交易标志long出口参数小于0均为失败。此值数据类型是整数，范围为-2147483648to+2147483647astr_appmsg交易信息String出口参数错误信息描述。aint_appcode小于0时存放错误描述，其他aint_appcode不用关心该参数内第5页共95页新疆(区本级)医保支付...