成都市医保支付接口规范

成都市基本医疗保险支付接口应用编程规范
Version
2015年06月
1、变更说明
2009-3-9文字错误更正
日常修正：
门诊结算11交易的control XML漏写<version>接口版本标志</version>
身份识别03交易的输出XML在个人帐户余额一段多写了</ykc194>，去掉。

14A和14B交易的节点数据类型注释中yke170应为yae170
2009-3-16调整输入输出节点
日常修正：
20交易增加返回节点，不影响业务
17交易增加返回节点，不影响业务
14A、14B、16交易删除【yka105记账流水号】节点
03、11交易control XML节点改名，【version】改为【edition】（因version之前已使
用）
2009-3-19调整输入输出节点
日常修正：
16交易返回节点【YKE141】，应为【YKC141】
2009-3-27交易41、52调整
明细冲负及打印预结算单调整：
41交易数量可以传入负数。

HIS可以通过传入负数的数量或43交易两种方式来退明细
52交易：住院结算。

控制xml中增加一个节点<print>是否打印预结算单</print>。

预结算单不能作为报销凭据，仅提供给参保人查看。

如果该节点为1，则表示是打印预结算单。

其他值或者无此节点，表示住院结算。

注意：（1）打印出预结算单可能和正式结算有差异，因为在预结算和正式结算之间，个人的信息可能改变，费用明细可能改变等原因。

（2）当打印预结算单时，交易标志aint_appcode返回的值总是小于零的。

2010-6-28门诊统筹相关交易变更说明：
门诊统筹项目：
100交易：医院医保信息新增申请
说明：新增交易
101交易：医院医保信息停用申请
说明：新增交易
102交易：医院医保信息查询
说明：新增交易
103交易：药品新增申请
说明:新增交易
104交易：医院药品对码
说明:新增交易
105交易：医院药品停用申请
说明：新增交易
106交易：医院医保药品目录查询
说明：新增交易
107交易：药品基本信息查询
说明：新增交易
108交易：挂号费项目查询
说明：新增交易
110交易：门诊挂号
说明：新增交易
111交易：门诊明细上传
说明：新增交易，本交易在医院医生工作站进行实时传输中医电子处方信息、西医电子处方信息、医嘱信息、门诊病例信息、检查信息、手术信息、中医四诊、挂号信息、
服务对象信息
11交易：门诊结算
说明：门诊明细上传后，可根据记帐流水号选择需要结算的明细费用
12交易：门诊结算回退
说明：增加支持挂号结算回退
30交易：查询住院和门诊统筹支付限额和不支付原因
说明：支持门诊统筹查询
43交易：住院和门诊费用明细退单
说明：支持门诊统筹费用退单
55交易：医保基金详单打印
说明：支持门诊统筹汇总单据、门诊统筹明细单据打印
71交易：清算申请
说明：支持城职门诊统筹、城乡门诊统筹清算
2010-8-27交易16，25变更说明：
门特信息扩展完善：
16交易：交易增加人员所申请过的门诊特殊病病种查询
25交易：交易输入xml串增加病人联系电话、诊疗过程描述节点
2011-4-15交易52变更，118新增说明：
单病种项目：
52交易：增加病种编码，病种名称及医院负担部分节点
118交易：查询单病种编码，ICD码和手术信息查询
2013-07-31变更 120，121，122新增说明
新门特项目：
14a交易增加病种编码节点
14b交易增加病种编码节点
16交易增加病种编码节点
20交易增加新门特医院结算节点
20a交易增加新门特医院结算节点
41交易增加病种编码节点
120交易病种认定交易（新增交易）
121交易一般诊疗费置标（新增交易）（一般诊疗费置标）
122交易病种认定查询交易
2013-10-24 新增123，124说明
工伤康复项目：
123交易工伤康复住院上传治疗方案
124交易工伤康复住院撤消治疗方案
20交易交易输入添加节点<xh>疾病诊断序号</xh>
03交易添加工伤诊断输出节点<gsdataset>多row
14A 添加传入节点门特结束时间（针对工伤联网部分）
2014-9-1修改说明
接口部分：
以下涉及到修改的交易编号（11、111、21、23、25等，除28a、28b类查询交易），在
control节点都需要传入edition节点，固定值为
25交易在ykd018dataset节点下增加中西医诊断信息节点。

11交易中yke112医嘱记录序号字段为必传项，其对应的医嘱信息使用31号交易上传。

考虑到时效性，医嘱信息允许事后上传。

其中医嘱记录序号允许对应多条费用信息。

增加31A、31B、31C、31D交易
34交易增加医嘱信息的输出
111交易中对医嘱节点增加结构化数据
25交易中增加yke659医疗付款方式、yke663出院科室编码、yke664实际住院天数、
yke665离院方式
21交易增加yke660入院途径、yke380婚姻状况类别代码、aae004联系人姓名、yke661
联系人关系、aae005联系电话、yke662入院科室编码
23交易增加yke660入院途径、yke380婚姻状况类别代码、aae004联系人姓名、yke661
联系人关系、aae005联系电话、yke662入院科室编码
28a,28b增加对输入字段的输出
增加127、128、129号交易
增加130、131号交易
增加42A、42B、42C号交易
11/41/111交易增加ake005,yka059节点
1、判断kb01kae
如果存在医院编码对应的数据
2、解析明细中的ake005,yka059节点
3、调用（akb020,ake005,yka059
）过程记录
增加132号交易诊疗使用设备编码上传
2014-10-26修正说明
接口部分：
需注意以下交易 11,31,34,111
由原<医院对码编码>节点信息,修正为以下节点信息: <ake005>医院对码编码</ake005>
2015-06-05 修正说明
络氨酸激酶抑制剂部分：
1、新增135交易：络氨酸激酶抑制剂认定申请
2、新增136交易：络氨酸激酶抑制剂认定复核结果查询
3、新增137交易：酪氨酸激酶抑制剂方案申请
4、新增137A交易：酪氨酸激酶抑制剂方案申请回退
5、新增137B交易：酪氨酸激酶抑制剂就诊登记
6、新增137E交易：酪氨酸激酶抑制剂就诊登记回退
7、新增138交易：酪氨酸激酶抑制剂结算
8、新增139交易：酪氨酸激酶抑制剂结算回退
9、新增140交易：酪氨酸激酶抑制剂方案变更申请
2016-05-18 修正说明
异地门特部分：
1、03交易新增返回参数，人员特慢病病种编码（ICD10）
2、新增yd11交易：异地门诊结算
3、新增yd12交易：异地结算回退
2、概述
《成都市基本医疗保险支付接口应用编程规范（Version ）》（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。

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

规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。

术语及参考资料
COM： Common Object Model
HIS：Hospital Information System
MIS：Management Information System
应用模式
银海医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。

环境要求
硬件环境
指标指标值
CPU≧
Memory≧256MB
HardDisk≧100M(free)
NetCard≧10MB
网络环境
指标指标值
协议TCP/IP、HTTP/HTTPS
广域网带宽≧56k
网络连接客户端直接访问医保中心网络
系统软件
指标指标值
操作系统WIN98 SE或WIN 2000及以上WIN系列操
作系统
辅助软件
接口描述
总体描述
组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；
接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。

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

接口COM说明
组件库提供交易的COM组件属性如下：
属性值
App ID{5767E3DB-64CF-46B0-8997-04CC6506CA37}
Type Library ID{A6C75A98-FC7F-456A-9E2D-4141CC758C63}
Program ID
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}
交易接口函数描述
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：
<?xml version=“” encoding=“GBK” standalone=“yes” ?>
<root>
< asy>1</asy> 1:表示异步执行确认或取消 0：表示同步执行
</root>
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均为失败。

此值数据类型是整
数，范围为-48 to +47
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调用
Dim yinhaiobject As Object '定义存放引用对象的变量。

Set yinhaiobject = CreateObject("")
'检查连接是否建立
If yinhaiobject Is Nothing Then
MsgBox "对象为空!"
End If
Dim BusinessID As String
Dim Ctrlxml As String
Dim Dataxml As String
Dim Pcbh As String
Dim Businesssequence As String
Dim Businessvalidate As String
Dim Outputxml As String
Dim Appcode as Long
Dim Appmsg As String
BusinessID="01"
Ctrlxml ="" '组织参数
Dataxml ="" '组织参数
BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputx
ml,Appcode,Appmsg
'判断返回信息
'HIS业务处理
Set yinhaiobject = Nothing '关闭对象
delphi调用
注意：delphi调用时先要 uses ComObj;否则不能引用oleobject。

Var
yinhaiobject: Variant;
1.
算行为
ykd007报销类型NOT NULL VARCHAR(4)结算交易返回，标识正常结
算和退单，详细信息参见代
码表
yab003社保经办机构编号NOT NULL VARCHAR(4)结算时返回
aae036中心业务经办时间NOT NULL DATETIME结算中心记录写入时间aka130支付类别NOT NULL VARCHAR(4)结算时返回
aac001个人编码NOT NULL VARCHAR(20)结算时返回
yka055费用总额NOT NULL NUMBER(14,2)
ykh011社保基金支付总额NOT NULL NUMBER(14,2)医保基金支付部分，不含个
人帐户支付，同结算时返回
yka107金额
yka065个人帐户支付总额NOT NULL NUMBER(14,2)
查询未签退的批次号信息（08）
交易名称查询未签退的批次号信息交易类型查询类交易
处理描述版变更说明：
无变化
接口按社保经办机构分别查询24小时前没有签退的批次信息。

调用说明HIS在医院管理员查询本院收费员的对帐签退情况时调用，获取各社保经办机构中本院未签退的信息。

输入参数
交易编号08
交易控制xml <?xml version=“” encoding=“GBK” standalone=“yes” ?> <control>
</control>
交易输入xml <?xml version="" encoding="GBK" standalone="yes" ?> <data>
</data>
输出参数
交易流水
号
不返回
交易效验
码
不返回
交易输出xml <?xml version="" encoding="GBK" standalone="yes" ?> <output>
<dataset>
<row>
<yab003>社保经办机构</yab003>
<yke189>批次编号</yke189>
<yke191>签到时间</yke191>
</row>
<row>
…
</row>
</dataset>
</output>
交易标志小于0表示失败，
参数详细说明:
交易控制：
代码名称约束类型说明
交易输入：
代码名称约束类型说明
交易输出：
代码名称约束类型说明
yab003社保经办机构NOT NULL VARCHAR(4)
yke189批次编号NOT NULL NUMBER(15)
yke191签到时间NOT NULL DATETIME
按分中心查询未签退的批次号信息（09）
交易名称按分中心查询未签退的批次号信息交易类型查询类交易
处理描述版变更说明：
无变化
按传入社保经办机构查询24小时前没有签退的批次信息。

调用说明HIS在医院管理员查询本院收费员的对帐签退情况时调用，获取传入社保经办机构中本院未签退的信息。

输入参数
交易编号09
交易控制xml <?xml version=“” encoding=“GBK” standalone=“yes” ?> <control>
<yab003>社保经办机构</yab003>
</control>
交易输入xml <?xml version="" encoding="GBK" standalone="yes" ?> <data>
</data>
输出参数
交易流水
号
不返回
交易效验
码
不返回
交易输出<?xml version="" encoding="GBK" standalone="yes" ?>
xml<output>
<dataset>
<row>
<yab003>社保经办机构</yab003>
<yke189>批次编号</yke189>
<yke191>签到时间</yke191>
</row>
<row>
…
</row>
</dataset>
</output>
交易标志小于0表示失败，
参数详细说明:
交易控制：
代码名称约束类型说明
交易输入：
代码名称约束类型说明
交易输出：
代码名称约束类型说明
yab003社保经办机构NOT NULL VARCHAR(4)
yke189批次编号NOT NULL NUMBER(15)
yke191签到时间NOT NULL DATETIME
门诊结算（11）
交易名称门诊结算交易类型处理类交易
版变更说明：
本交易同时支持城镇职工普通门诊结算和城乡居民普通门诊结算。

城镇职工使用个人帐户进行就诊记账，城乡居民使用门诊定额补助进行就诊
记账。

当参保人发生保险关系转移时（城镇职工和城乡居民的相互转换）原
参保剩余可享受金额可以继续使用。

门诊结算时显示城镇职工个人帐户余额和城乡居民门诊补助金额，参保人可
以选择使用其中一个险种的余额，不能合并使用。

门诊特殊病、工伤门诊由于采用先申请、再记帐、最后结算的方式，与普通
门诊差异较大，新增交易另行支持
增加了接口版本标志入口参数，以确定返回个人帐户余额的XML串格式
版本变更说明：
门诊结算改为了明细上传和费用结算分开进行，接口可以根据已传到中心门
诊费用明细的“记帐流水号”来进行费用结算，如：门诊明细上传了5条，
记帐流水号分别是1、2、3、4、5，结算时可只选择记帐流水号2，4来进行
结算
如果参保人员结算后门诊统筹待遇享受状态yke484为1，需要立即调用55
交易进行门诊统筹结算单打印
支持零药门诊结算，零药结算不需要进行挂号交易，交易类似版11结算交易，
补充增加零药结算标志。