贵州省社会保险全省统一应用系统 医保支付接口应用编程接口规范
(V1.0.0.5)
四川久远银海软件股份有限公司
2011年9月
1、概述
1.《贵州省社会保险全省统一应用系统医保支付接口应用编程接口规范》(以下简称规范)的
使用对象为将使用银海医保支付组件库(以下简称组件库)来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。
2.规范公布了组件库所提供的交易,规定了调用每一交易的前提条件,详细描述了每一交易
的调用方法。规范从编程的角度来介绍以上内容,对医保政策和医保支付流程的介绍不属于本规范的范围。
§1.1.术语及参考资料
COM:Common Object Model
HIS:Hospital Information System
MIS:Management Information System
§1.2.应用模式
银海医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件,第三方应用软件使用相应的COM组件调用方式来调用它。
§1.3.环境要求
§1.3.1.硬件环境
指标指标值
CPU ≧1.6MHz
Memory ≧512MB
HardDisk ≧2000M(free)
NetCard ≧10MB
§1.3.2.网络环境
指标指标值协议TCP/IP、HTTP/HTTPS
广域网带宽≧56k
网络连接客户端直接访问医保中心网络
§1.3.3.网络拓扑图
§1.3.4.系统软件
指标指标值
操作系统WIN2000/NT/XP及以上WIN系列操作系统辅助软件IE6.0及其以上;Msxml4.0
§2.修改记录
修改时间版本修改描述
2011-6-24 V1.1 修改91交易主要为字段变更
2011-6-24 V1.1 增加交易
53、54、55、56、56a、56d,60
2011-6-29 V1.1 增加交易
76,、76a、76b
修改91交易增加字段
修改时间版本修改描述
修改41交易增加输出字段
2012-07-24 V1.2 1、增加附录说明
2、修改41、42、4
3、48号交易必须传入个人编号
3、修改75(适用贵州省统一项目)号交易<prm_aka130></prm_aka130>【默认:31 医疗;M31 生育;G31 工伤】
4、调用21号交易传入<prm_aac001> 个人编号</prm_aac001>
5、调用48、21号交易<prm_ykb065>执行社会保险办法</prm_ykb065>
2013-9-23 V1.3 1、增加清算方式修改交易47号交易
2013-10-09 V1.4 1、修改71、75增加异地医疗清算相关。
2、交易类型和调用流程图修改。
3、修改清算申请执行社会保险办法产生歧义相关。
2013-11-01 V1.4 修改22号交易传入参数,传入新增<prm_aka130>支付类别</prm_aka130>
2013-11-06 V1.0.0.5 1、增加调用47号交易,用于修改清算方式(毕节适用)
2、增加特殊门诊用药控制交易(毕节适用)
§3.接口描述
§3.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.文档内但凡日期格式的处理均传入年月日,不带时分秒的处理,且全部为YYYY-MM-DD
格式
5.接口中返回的Y AB003和YKB065两个值,HIS需要保留,在后续的业务处理中需要传
入该两个值。
§3.2.接口COM说明
组件库提供交易的COM组件属性如下:
属性值
App ID
Type Library ID
Program ID yinhai.TAIYUAN.interface
COM ClassName COClass_n_yh_interface
COM ClassID
Interface Type Dual Interface
Interface Name In_yh_interface
Interface ID
§3.3.交易接口函数描述
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,
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论