成都市基本医疗保险
支付接口应用编程规范
Version 4.0
银海软件
2010年06月
1、 变更说明
§1.1.
2、 概述
《成都市基本医疗保险支付接口应用编程规范(Version 4.0)》(以下简称规范)的使用对象为将使用银海医保支付组件库(以下简称组件库)来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。
规范公布了组件库所提供的交易,规定了调用每一交易的前提条件,详细描述了每一交易的调用方法。规范从编程的角度来介绍以上内容,对医保政策和医保支付流程的介绍不属于本规范的范围。
§1.2. 术语及参考资料
COM: Common Object Model
HIS:Hospital Information System
MIS:Management Information System
§1.3. 应用模式
银海医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件,第三方应用软件使用相应的COM组件调用方式来调用它。
§1.4. 环境要求
§1.4.1. 硬件环境
指标 指标值
CPU ≧1.6MHz
Memory ≧256MB
HardDisk ≧100M(free)
NetCard ≧10MB
§1.4.2. 网络环境
指标 指标值
协议 TCP/IP、HTTP/HTTPS
广域网带宽 ≧56k
网络连接 客户端直接访问医保中心网络
§1.4.3. 系统软件
指标 指标值
操作系统 WIN98 SE或WIN 2000及以上WIN系列操作系统
辅助软件 IE6.0
Msxml4.0
§2. 接口描述
§2.1. 总体描述
组件库注册在每一台需要进行医保支付业务的客户机上(该客户端也必须能连接到医保网络),通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中(以下简称HIS);
接口交易组件库提供了六个公共方法(yh_interface_init 初始化,yh_interface_destroy 资源释放,yh_interface_call业务方法调用,yh_interface_confirm业务办理确认,yh_interface_cancel业务办理取消,yh_interface_getuncertaintytrade不确定交易查询),交易参数组织采用xml(所有社保经办机构交易调用及交易参数统一),差别处理对于HIS透明。
新接口存在多社保经办机构处理,并且各社保经办机构处理模式存在差异,接口交易内部也可能存在用户交互窗口,因此建议HIS事务管理与接口交易调用相互独立。
§2.2. 接口COM说明
组件库提供交易的COM组件属性如下:
属性 值
App ID {5767E3DB-64CF-46B0-8997-04CC6506CA37}
Type Library ID {A6C75A98-FC7F-456A-9E2D-4141CC758C63}
Program ID YinHai.ChenDu.Interface
COM ClassName CoClass_n_yh_interface
COM ClassID {1FB2A005-1AAF-42BD-A95E-AED025ABD75B}
Interface Type Dual Interface
Interface Name In_yh_interface
Interface ID {BC708B00-5ED0-4DC7-8345-14FA94D5F840}
§2.3. 交易接口函数描述
yh_interface_init
原型定义:
yh_interface_init(
ref long aint_appcode,
ref string astr_appmsg)
yh_interface_init2
yh_interface_init2(string astr_parmxml,
ref long aint_appcode,
ref string astr_appmsg)
astr_parmxml:
< asy>1 asy> 1:表示异步执行确认或取消 0:表示同步执行
astr_parmxml:
函数说明:
初始化函数,HIS应用启动时调用,进行医保交易处理初始化,本交易调用成功后才能进行其他交易处理。
yh_interface_destroy
原型定义:
yh_interface_destroy()
函数说明:
资源释放函数,在HIS应用退出时调用。
yh_interface_call
原型定义:
yh_interface_call(
string astr_jybh,
string astr_jykz_xml,
string astr_jysr_xml,
ref string astr_pcbh,
ref string astr_jylsh,
ref string astr_jyyzm,
ref string astr_jysc_xml,
ref long aint_appcode,
ref string astr_appmsg)
参数名称 参数含义 参数类型 参数类别 参数说明
astr_jybh 交易编号 String 入口参数 具体的交易代码见〖交易列表〗
astr_jykz_xml 交易控制 String 入口参数 xml方式,组织方式见业务说明
astr_jysr_xml 交易输入 String 入口参数 xml方式,组织方式见业务说明
astr_pcbh 批次编号 String 出口参数 与签到交易中返回的值相同,用于标识签到与支付数据的相关性
astr_jylsh 交易流水号 String 出口参数 唯一标识一次交易,VARCHAR(20)
astr_jyyzm 交易验证码 String 出口参数 处理类交易返回,确认交易时传入
VARCHAR(15)
astr_jysc_xml 交易输出 String 出口参数 xml方式,组织方式见业务说明
aint_appcode 交易标志 long 出口参数 小于0均为失败。此值数据类型是整数,范围为-2147483648 to +2147483647
astr_appmsg 交易信息 String 出口参数 错误信息描述。aint_appcode小于0时存放错误描述,其他aint_appcode不用关心该参数内容。
函数说明:
交易主函数,完成所有医疗业务的实际处理。
由于交易调用远程方法,并且可能存在用户交互界面,因此建议所有交易不要纳入HIS系统事务管理。
在交易接口函数定义中,传递的参数都是字符串。但是在交易详细说明中,数据类型都是逻辑类型,常用类型有三种:string,number,datetime,下面的表格描述了交易接口进行类型转换的限制和说明。
数据类型 空字符串 格式不合法 其它说明
string 视同空串 无 无特别说明标注的长度为最大长度
number 视同0 返回错误 无特别说明标注的长度为最大长度(小数尾数同)
datetime 视同空值 返回错误 足19位长,格式如下:
YYYY-MM-DD hh24:mm:ss
date 视同空值 返回错误 足19位长,格式如下:
YYYY-MM-DD 00:00:00
astr_jykz_xml、astr_jysr_xml、astr_jysc_xml参数均按照交易详细说明里xml参数组合,顺序无关。接口调用示例:
VB调用
|
|