新疆医保支付接口规范

新疆(喀什)医保支付接口应用编程接口规范

-

新疆（喀什）医保系统 支付接口应用编程接口规范

（初稿）

银海软件

第 1 页 共 88 页

2009年11月

新疆(喀什)医保支付接口应用编程接口规范

1、

概述

1. 《新疆(吐鲁番)医保系统支付接口应用编程接口规范》（以下简称规范）的

使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。

2.

规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细

描述了每一交易的调用方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。 §1.1.

术语及参考资料

COM： Common Object Model HIS：Hospital Information System MIS：Management Information System §1.2.

应用模式

1. 银海医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。

§1.3.

§1.3.1.

环境要求

硬件环境 指标 CPU Memory HardDisk NetCard 2.

指标值 ≧1.6MHz ≧256MB ≧100M(free) ≧10MB 第 2 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

§1.3.2. 指标 协议 广域网带宽 网络连接 网络环境

指标值 TCP/IP、HTTP/HTTPS ≧56k 客户端直接访问医保中心网络 §1.3.3. 网络拓扑图

医院接口处理网络拓扑图Web服务器应用服务器医保中心数据库医院前服务器

§1.3.4. 指标 操作系统 系统软件

指标值 WIN98 SE或WIN 2000及以上WIN系列操作系统 辅助软件 IE6.0 Msxml4.0 第 3 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

§1. 接口描述

§1.1. 总体描述

1. 组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到

医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）； 2. 接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。

3. 新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。

4. 文档内但凡日期格式的处理均传入年月日，不带时分秒的处理，且全部为YYYYMMDD格式

§1.2.

5. 属性 App ID Type Library ID Program ID COM ClassName COM ClassID Interface Type Interface Name Interface ID 接口COM说明

组件库提供交易的COM组件属性如下：

值 yinhai.xjcj.interface COClass_n_yh_interface Dual Interface In_yh_interface 第 4 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

§1.3. 交易接口函数描述

yh_interface_init ? 原型定义：

yh_interface_init(

ref integer aint_appcode, ref string astr_appmsg)

? 函数说明：

初始化函数，HIS应用启动时调用，进行医保交易处理初始化，本交易调用成功后才能进行其他交易处理。

? 原型定义：

yh_interface_destroy() ? 函数说明：

资源释放函数，在HIS应用退出时调用。

? 原型定义：

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 参数说明 yh_interface_call

yh_interface_destroy

入口参数 具体的交易代码见〖交易列表〗 第 5 页 共 88 页