贵州省社会保险全省统一应用系统医保支付接口应用编程接口规范
贵州省全省统一社保系统 两定接入医保支付接口
编程接口规范
（V1.0.0.16）
四川久远银海软件股份有限公司 2011 年 9 月
第 1 页 共 114 页
贵州省社会保险全省统一应用系统医保支付接口应用编程接口规范
§1.目的
为了简 化实 时结 算系 统对 实时 支付 中心 接口 的调 用， 减少 中心 实时 支付 接口 变化 对实 时结 算系统的影响，减少实时结算系统整改工作量，对医院和药店提供统一的医保两定接口 dll 应用 程序。
§4.3.2. 网络环境
协议
指标
指标值 TCP/ IP、HTTP/HTTPS
第 3 页 共 114 页
广域网带 宽 网络连接
§4.3.3. 网络拓扑图
贵州省社会保险全省统一应用系统医保支付接口应用编程接口规范 ≧56k 客户端直 接访问 医保中 心网络
§4.3.4. 系统软件
操作系统 辅助软件
指标
交易流水号 String 出口参数 唯一标识一次交易，VARCHAR(20)
astr_jyyzm
交易验证码 String 出口参数 处理类交易返回，确认交易时传入
VARCHAR(15)
astr_jysc_xml 交易输出
String 出口参数 xml 方式，组志
long
出口参数 小于 0 均为失败。此值数据类型是整
数 ， 范 围 为 -2147483648 to
+2147483647
astr_appmsg
交易信息
String 出口参数 错误信息描述。aint_appcode 小于 0
时存放错误描述，其他 aint_appcode
不用关心 该参数 内容。
函数说明：
§5. 修改记录
指标值 WIN2000/ NT/XP 及以上 WIN 系列操作系统 IE6.0 及其以上；Ms xml4.0
修改时间 2011-06-24 2011-06-24 2011-06-29
2012-07-24
版本 V1.1.0.1 V1.1.0.1 V1.1.0.3
V1.1.0.3
修改描述
贵州省社会保险全省统一应用系统医保支付接口应用编程接口规范
易参数组织采用 xml（所有社保经办机构交易调用及交易参数统一），差别处理对于 HIS 透明。 3. 新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内 部也可能存在用户交互窗口，因此建议 HIS 事务管理与接口交易调用相互独立。 4. 文档内但凡日期格式的处理均传入年月日，不带时分秒的处理，且全部为 YYYY-MM -DD 格式 5. 接口中返回的 YA B003 和 YKB065 两个值，HIS 需要保留，在后续的业务处理中需要传 入该两个 值。
1. 交易主函数，完成所有医疗业务的实际处理。
2. 由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入
HIS 系统事务管理。
3. 在交易接口函数定义中，传递的参数都是字符串。但是在交易详细说明中，数据类
型都是逻 辑类型， 常用类 型有三 种：s tring,number,datetime，下面 的表格 描述了 交易
V1.0.0.8 1、 增加 Q99A 查询交易返回值(红色部分)
V1.0.0.9 出院诊断信息上传
V1.0.0.10 修改 91 号交易返回 aka101
V1.0.0.11 修改 41、43、48 号交易返回 PRM_SCDOC 返回参数，增加累计返回
V1.0.0.12 V1.0.0.13
修改 43 号交易，增加账户可支付金额 prm_zhkzf 返回 增加智 慧医 疗接 口调 用，03c(智慧医 疗身 份识 别)、48b（智慧 医疗 门 诊结算）
ref string astr_appmsg)
参数名称
参数含义 参数类型 参数类别
参数说明
astr_jybh
交易编号
String 入口参数 具体的交易代码见〖交易列表〗
astr_jysr_xml 交易输入
String 入口参数 xml 方式，组织方式见业务说明，字
符串最大长度 65534 字符
astr_jylsh
2. 接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资 源 释 放 ， yh_interface_call 业 务 方 法 调 用 ， yh_interface_confirm 业 务 办 理 确 认 ， yh_interface_cancel 业务办理取消，yh_interface_getuncertaintytrade 不确定交易查询)，交 第 5 页 共 114 页
接口进行 类型转 换的限 制和说 明。
数据类型
空字符串
格式不合 法
其它说明
string
视同空串
无
无特别说 明标注 的长度 为最大 长度
第 7 页 共 114 页
版本
修改描述
V1.1.0.3 V1.1.0.3
V1.1.0.4, V1.0.0.5 V1.0.0.5 V1.0.0.6 V1.0.0.7
1、增加清算方式修改交易 47 号交易
1、 修改 71、75 增加异地医疗清算相关。 2、 交易类型和调用流程图修改。 3、 修改清算申请执行社会保险办法产生歧义相关。 修改 22 号交易传入参数，传入新增 <pr m_aka 130>支付 类别 </pr m_aka 130> 1、 增加调用 47 号交易，用于修改清算方式（毕节适用） 2、 增加特殊门诊用药控制交易（毕节、六盘水适用） 修改 74 号交易入参，将传入日期修改为传入期号 <pr m_yae366>清算 期号 </pr m_yae366>（格 式： YY YYMM） 1、 修改 46 交易返回 2、 新增 H110,H28a,H28b,H28c 交易查询 1、 修改 Q99D 为“特殊门诊用药控制查询（六盘水适用）”毕节取消 2、 新增 Q99F 交易查询
原型定义：
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,
§6.2.接口 COM 说明
组件库提供交易的 COM 组件属性如下：
属性
值
App ID
Type Library ID
Program ID
yinhai.TAIYUAN.interface
COM ClassName
COClass_n_yh_interface
COM ClassID
Interface Type Interface Name
§4.2. 应用模式
银海医保支付组件库是一组运行在 WINDOWS 32 位环境下的 COM 组件，第三方应用软件 使用相应的 COM 组件调用方式来调用它。
§4.3. 环境要求
§4.3.1. 硬件环境
CPU Memory Hard D is k NetCa rd
指标
指标值 ≧1.6MHz ≧512M B ≧2000M(free) ≧10MB
Dual Interface In_yh_interface
Interface ID
§6.3.交易接口函数描述
yh_interface_init
原型定义： yh_interface_init( ref integer aint_appcode, ref string astr_appmsg)
函数说明： 初始化函数，HIS 应用启动时调用，进行医保交易处理初始化，本交易调用成功后
2. 规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易 的调用 方法 。规 范从 编程 的角 度来 介绍 以上 内容 ，对 医保 政策 和医 保支 付流 程的 介绍 不属 于本规范 的范围 。
§4.1. 术语及参考资料
COM： Common Object Model HIS：Hospital Information System MIS：Management Information System
第 4 页 共 114 页
贵州省社会保险全省统一应用系统医保支付接口应用编程接口规范
修改时间 2013-09-23
2013-10-09
2013-11-01
2013-11-06
2013-11-29
2013-12-10
2014-04-18 2014-08-08 2015-04-20 2015-05-07 2015-07-28 2015-11-25 2016-1-06 2016-1-27 2016-04-12 2016-04-12 2016-05-04 2016-05-04
4) 提供社保卡安全控件 满足社保卡交易规范、社保卡鉴权和 pin 码验证。
5) 提供两定支付接口 dll 的自动升级 当中心支付接口有调整时，需要修改两定支付接口 d ll，新版本发布后，各医院和药店在使 用两定接 口支付 时会自 动更新 升级， 确保政 策和管 理的统 一执 行
6) 提供统一的申请功能和医保统一要求的单据打印功能
§3. 与中心支付接口交互的逻辑示意图
医保中心业务 经办子系统
医保实时支 付中心接口
服务
医保业务管理系统
两定支付接 口应用程序
医院HIS 药店MIS
两定支付实时结算系统
第 2 页 共 114 页