成都市基本医疗保险支付接口应用编程规范Version 5.02015年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修改说明接口5.0部分：⏹以下涉及到修改的交易编号（11、111、21、23、25等，除28a、28b类查询交易），在control节点都需要传入edition节点，固定值为5.0⏹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、调用pkg_K_ydyl.prc_K_recordAke005（akb020,ake005,yka059）过程记录⏹增加132号交易诊疗使用设备编码上传⏹2014-10-26修正说明接口5.0部分：⏹需注意以下交易 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 4.0）》（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。
规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。
规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。
⏹术语及参考资料COM： Common Object ModelHIS：Hospital Information SystemMIS：Management Information System⏹应用模式银海医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。
⏹环境要求◆硬件环境◆网络环境◆系统软件⏹接口描述⏹总体描述组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。
新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。
⏹接口COM说明组件库提供交易的COM组件属性如下：⏹交易接口函数描述yh_interface_init⏹原型定义：yh_interface_init(ref long aint_appcode,ref string astr_appmsg)yh_interface_init2yh_interface_init2(string astr_parmxml,ref long aint_appcode,ref string astr_appmsg)astr_parmxml：<?xml version=“1.0” 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,交易主函数，完成所有医疗业务的实际处理。