1、 成都市医保支付接口应用编程接口规范第 1 页 共 224 页成都市基本医疗保险支付接口应用编程规范Version 5.02015年06月成都市医保支付接口应用编程接口规范第 2 页 共 224 页1、 变更说明 2009-3-9文字错误更正日常修正： 门诊结算11交易的control XML漏写接口版本标志 身份识别03交易的输出XML在个人帐户余额一段多写了，去掉。 14A和14B交易的节点数据类型注释中yke170 应为yae170 2009-3-16调整输入输出节点日常修正： 20交易增加返回节点，不影响业务 17交易增加返回节点，不影响业务 14A、14B、16交易删除【 yka10
2、5记账流水号】节点 03、 11交易 control XML节点改名，【version】改为 【edition】（因version之前已使用） 2009-3-19调整输入输出节点日常修正： 16交易返回节点【YKE141 】，应为【YKC141 】 2009-3-27交易41、52调整明细冲负及打印预结算单调整： 41交易数量可以传入负数。HIS可以通过传入负数的数量或43交易两种方式来退明细 52交易：住院结算。控制xml中增加一个节点是否打印预结算单 。预结算单不能作为报销凭据，仅提供给参保人查看。如果该节点为1，则表示是打印预结算单。其他值或者无此节点，表示住院结算。注意：（1）打印出预
3、结算单可能和正式结算有差异，因为在预结算和正式结算之间，个人的信息可能改变，费用明细可能改变等原因。（2）当打印预结算单时，交易标志aint_appcode返回的值总是小于零的。 2010-6-28门诊统筹相关交易变更说明：门诊统筹项目： 100交易：医院医保信息新增申请成都市医保支付接口应用编程接口规范第 3 页 共 224 页说明：新增交易 101交易：医院医保信息停用申请说明：新增交易 102交易：医院医保信息查询说明：新增交易 103交易：药品新增申请说明: 新增交易 104交易：医院药品对码说明: 新增交易 105交易：医院药品停用申请说明：新增交易 106交易：医院医保药品目录查询
4、说明：新增交易 107交易：药品基本信息查询说明：新增交易 108交易：挂号费项目查询说明：新增交易 110交易：门诊挂号说明：新增交易 111交易：门诊明细上传说明：新增交易，本交易在医院医生工作站进行实时传输中医电子处方信息、西医电子处方信息、医嘱信息、门诊病例信息、检查信息、手术信息、中医四诊、挂号信息、服务对象信息 11交易：门诊结算说明：门诊明细上传后，可根据记帐流水号选择需要结算的明细费用 12交易：门诊结算回退说明：增加支持挂号结算回退 30交易：查询住院和门诊统筹支付限额和不支付原因说明：支持门诊统筹查询 43交易：住院和门诊费用明细退单说明：支持门诊统筹费用退单 55交易：医
5、保基金详单打印说明：支持门诊统筹汇总单据、门诊统筹明细单据打印 71交易：清算申请说明：支持城职门诊统筹、城乡门诊统筹清算 2010-8-27交易16，25变更说明：门特信息扩展完善： 16交易：交易增加人员所申请过的门诊特殊病病种查询 25交易：交易输入xml 串增加病人联系电话、诊疗过程描述节点 2011-4-15交易52变更，118新增说明：单病种项目： 52交易：增加病种编码，病种名称及医院负担部分节点 118交易：查询单病种编码，ICD码和手术信息查询成都市医保支付接口应用编程接口规范第 4 页 共 224 页 2013-07-31变更 120， 121，122新增说明新门特项目：
6、14a交易 增加病种编码节点 14b交易 增加病种编码节点 16交易 增加病种编码节点 20交易 增加新门特医院结算节点 20a交易 增加新门特医院结算节点 41交易 增加病种编码节点 120交易 病种认定交易（新增交易） 121交易 一般诊疗费置标（新增交易）（一般诊疗费置标） 122交易 病种认定查询交易 2013-10-24 新增123， 124说明工伤康复项目： 123交易 工伤康复住院上传治疗方案 124交易 工伤康复住院撤消治疗方案 20交易 交易输入添加节点疾病诊断序号 03交易 添加工伤诊断输出节点多row 14A 添加传入节点门特结束时间（针对工伤联网部分） 2014-9-1
7、修改说明接口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出院科室编码、
8、yke664实际住院天数、yke665离院方式 21交易增加yke660入院途径、 yke380婚姻状况类别代码、aae004联系人姓名、yke661联系人关系、aae005联系电话、 yke662入院科室编码成都市医保支付接口应用编程接口规范第 5 页 共 224 页 23交易增加yke660入院途径、 yke380婚姻状况类别代码、aae004联系人姓名、yke661联系人关系、aae005联系电话、 yke662入院科室编码 28a,28b增加对输入字段的输出 增加127、128 、129 号交易 增加130、131 号交易 增加42A、42B 、42C 号交易 11/41/111交易增
9、加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由原节点信息,修正为以下节点信息:医院对码编码 2015-06-05 修正说明络氨酸激酶抑制剂部分：1、新增135交易：络氨酸激酶抑制剂认定申请2、新增136交易：络氨酸激酶抑制剂认定复核结果查询3、新增137交易：酪氨酸激
10、酶抑制剂方案申请4、新增137A交易：酪氨酸激酶抑制剂方案申请回退5、新增137B交易：酪氨酸激酶抑制剂就诊登记6、新增137E交易：酪氨酸激酶抑制剂就诊登记回退7、新增138交易：酪氨酸激酶抑制剂结算8、新增139交易：酪氨酸激酶抑制剂结算回退9、新增140交易：酪氨酸激酶抑制剂方案变更申请 2016-05-18 修正说明异地门特部分：成都市医保支付接口应用编程接口规范第 6 页 共 224 页1、03交易新增返回参数，人员特慢病病种编码（ICD10 ）2、新增yd11交易：异地门诊结算3、新增yd12交易：异地结算回退2、 概述成都市基本医疗保险支付接口应用编程规范（Version 4.0
11、）（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店 MIS供应商或其它第三方应用软件供应商。规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。 术语及参考资料COM： Common Object ModelHIS：Hospital Information SystemMIS：Management Information System 应用模式银海医保支付组件库是一组运行在WINDOWS 32
12、位环境下的 COM组件，第三方应用软件使用相应的 COM组件调用方式来调用它。 环境要求 硬件环境指标 指标值CPU 1.6MHzMemory 256MBHardDisk 100M(free)成都市医保支付接口应用编程接口规范第 7 页 共 224 页NetCard 10MB 网络环境指标 指标值协议 TCP/IP、HTTP/HTTPS广域网带宽 56k网络连接 客户端直接访问医保中心网络 系统软件指标 指标值操作系统 WIN98 SE或WIN 2000及以上WIN系列操作系统辅助软件 IE6.0Msxml4.0 接口描述 总体描述组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必
13、须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）；接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资源释放，yh_interface_call 业务方法调用，yh_interface_confirm 业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade 不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于 HIS透明。新接口存在多社保经办机构处理，并
14、且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。 接口COM说明组件库提供交易的COM组件属性如下：属性 值App ID 5767E3DB-64CF-46B0-8997-04CC6506CA37Type Library ID A6C75A98-FC7F-456A-9E2D-4141CC758C63Program ID YinHai.ChenDu.Interface成都市医保支付接口应用编程接口规范第 8 页 共 224 页COM ClassName CoClass_n_yh_interfaceCOM ClassID 1FB2A
15、005-1AAF-42BD-A95E-AED025ABD75BInterface Type Dual InterfaceInterface Name In_yh_interfaceInterface ID BC708B00-5ED0-4DC7-8345-14FA94D5F840 交易接口函数描述yh_interface_init 原型定义：yh_interface_init(ref long aint_appcode,ref string astr_appmsg)yh_interface_init2yh_interface_init2(string astr_parmxml,ref long
16、aint_appcode,ref string astr_appmsg)astr_parmxml：1 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,成都市医保支付接
17、口应用编程接口规范第 9 页 共 224 页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
18、交易输入 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
19、 +2147483647astr_appmsg 交易信息 String 出口参数 错误信息描述。aint_appcode 小于0时存放错误描述，其他aint_appcode不用关心该参数内容。 函数说明：交易主函数，完成所有医疗业务的实际处理。由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入HIS系统事务管理。在交易接口函数定义中，传递的参数都是字符串。但是在交易详细说明中，数据类型都是逻辑类型，常用类型有三种：string,number,datetime，下面的表格描述了交易接口进行类型转换的限制和说明。数据类型 空字符串 格式不合法 其它说明string 视同空串
20、无 无特别说明标注的长度为最大长度number 视同0 返回错误 无特别说明标注的长度为最大长度（小数尾数同）datetime 视同空值 返回错误 足19位长，格式如下：YYYY-MM-DD hh24:mm:ssdate 视同空值 返回错误 足19位长，格式如下：YYYY-MM-DD 00:00:00astr_jykz_xml、astr_jysr_xml、astr_jysc_xml 参数均按照交易详细说明里xml 参数组合，顺序无关。接口调用示例：成都市医保支付接口应用编程接口规范第 10 页 共 224 页VB调用Dim yinhaiobject As Object 定义存放引用对象的变量。
21、Set yinhaiobject = CreateObject(“YinHai.ChenDu.Interface“)检查连接是否建立If yinhaiobject Is Nothing ThenMsgBox “对象为空!“End IfDim BusinessID As StringDim Ctrlxml As StringDim Dataxml As StringDim Pcbh As StringDim Businesssequence As StringDim Businessvalidate As StringDim Outputxml As StringDim Appcode as L
22、ongDim Appmsg As StringBusinessID=“01“Ctrlxml =“ 组织参数Dataxml =“ 组织参数yinhaiobject.yh_interface_call BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg 判断返回信息HIS业务处理Set yinhaiobject = Nothing 关闭对象delphi调用注意：delphi调用时先要 uses ComObj;否则不能引用oleobject。Varyinhaiobject
23、: Variant; /定义存放引用对象的变量。BusinessID : StringCtrlxml : StringDataxml : StringPcbh : StringBusinesssequence : StringBusinessvalidate : StringOutputxml : StringAppcode : integerAppmsg:String;Begintry成都市医保支付接口应用编程接口规范第 11 页 共 224 页yinhaiobject := CreateOleObject(YinHai.ChenDu.Interface);BusinessID:= 01;y
24、inhaiobject.yh_interface_call(BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg)/返回结果判断，HIS 内部处理finally yinhaiobject:=Unassigned;/ 关闭对象end;End;pb调用oleobject yinhaiobjectlong result, AppcodeString BusinessID,Ctrlxml,Dataxml,Pcbh,BusinesssequenceString Business
25、validate,Outputxml, Appmsgyinhaiobject=create oleobjectresult=yinhaiobject.ConnectToNewObject(“YinHai.ChenDu.Interface“)if result0 thenmessagebox(“error“，“fail to connect“)returnend ifBusinessID=”01”yinhaiobject.yh_interface_call(BusinessID,Ctrlxml,Dataxml,Pcbh,Businesssequence,Businessvalidate,Outp
26、utxml,Appcode,Appmsg)/ 返回结果判断，HIS 内部处理/ 关闭对象yinhaiobject.DisconnectObject ( )destroy yinhaiobjectyh_interface_confirm 原型定义：yh_interface_confirm(string astr_jylsh,string astr_jyyzm,ref long aint_appcode,ref string astr_appmsg)参数名称 参数含义 参数类型 参数类别 参数说明astr_jylsh 交易流水号 String 入口参数 唯一标识一次交易，VARCHAR(20)as
27、tr_jyyzm 交易验证码 String 入口参数 处理类交易返回，VARCHAR(64)aint_appcode 交易标志 long 出口参数astr_appmsg 交易信息 String 出口参数确认交易HIS不用关心本次处理返回结果，但是必须采用查询不确定交易的方式来确定是否所有数据正确处理。成都市医保支付接口应用编程接口规范第 12 页 共 224 页 函数说明：交易辅助函数，完成交易的确认处理。对于处理类交易，HIS调用接口成功后完成HIS系统数据保存，则调用该交易进行中心确认处理。 接口调用示例：参看yh_interface_call调用说明。yh_interface_cance
28、l 原型定义：yh_interface_cancel (string astr_jylsh,ref long aint_appcode,ref string astr_appmsg)参数名称 参数含义 参数类型 参数类别astr_jylsh 交易流水号 String 入口参数 唯一标识一次交易，VARCHAR(20)aint_appcode 交易标志 long 出口参数astr_appmsg 交易信息 String 出口参数确认交易HIS不用关心本次处理返回结果，但是必须采用查询不确定交易的方式来确定是否所有数据正确处理。 函数说明：交易辅助函数，完成交易的取消处理。对于处理类交易，HIS调用
29、接口成功后未完成HIS系统数据保存，则调用该交易进行中心取消处理。 接口调用示例：参看yh_interface_call调用说明。yh_interface_getuncertaintytrade 原型定义：yh_interface_getuncertaintytrade (string astr_jybh,ref string astr_jgxml,ref long aint_appcode,ref string astr_appmsg)yh_interface_getuncertaintytrade2yh_interface_getuncertaintytrade2 (string astr
30、_cxtj,ref string astr_jgxml,ref long aint_appcode,ref string astr_appmsg)astr_cxtj的结构成都市医保支付接口应用编程接口规范第 13 页 共 224 页查询的批次编号查询的交易编号查询的收费员姓名参数名称 参数含义 参数类型 参数类别astr_jybh 交易编号 String 入口参数 具体的交易代码见交易列表astr_jgxml 交易输出 String 出口参数 具体的输出内容格式见交易详细说明的“查询不确定交易输出XML” 部分aint_appcode 交易标志 long 出口参数 大于等于0时交易成功，其他均
31、为失败。此值数据类型是整数，范围为-2147483648 to +2147483647astr_appmsg 交易信息 String 出口参数 错误信息描述。aint_appcode 小于0时存放错误描述，其他不用关心该参数内容。 函数说明：交易辅助函数，完成不确定交易的查询处理。对于处理类交易，HIS调用接口成功后未进行确认/取消（或调用确认/取消失败），及时调用本函数查询未确认或取消的交易数据，并进行HIS数据查询，判断并调用确认或取消方法完成数据校对。 接口调用示例：参看yh_interface_call调用说明。yh_interface_setasyyh_interface_setas
32、y(int aint_asy)aint_asy 1:表示异步执行 0：表示同步执行 交易类型和调用流程 查询类交易：包括一般查询交易和接口内部完成确认、取消的交易； 处理类交易：包括门诊结算（退单）、入院办理（回退）、出院结算（退单）、清算申请（回退）等多个交易，一次完整的处理类交易可以有三种方式： 只有处理流程，符合情况是处理流程执行失败（接口返回错误代码及信息）； 处理流程确认流程，符合情况是处理流程执行成功，his处理也成功，调用确认流程； 处理流程取消流程，符合情况是处理流程执行成功，his处理失败，调用取消流程。成都市医保支付接口应用编程接口规范第 14 页 共 224 页调用交易的
33、处理流程y h _ i n t e r f a c e _ c a l l调用处理流程是否成功交易失败H I S 进行处理6 、 调用失败2 、 调用成功H I S 处理是否成功调用交易的确认流程y h _ i n t e r f a c e _ c o n f i r m调用交易的取消流程y h _ i n t e r f a c e _ c a n c e l4 、 处理失败5 、 处理成功3 、 H I S 处理完毕1 、 处理流程处理完毕交易成功图1-1 处理类交易调用流程 处理交易的不同宕机点和相应的处理 处理流程处理完毕 调用成功 HIS处理完毕 处理失败 处理成功在上面5个点系统
34、宕机，系统重新启动后，都没有办法直接决定调用【取消流程】还是【确认流程】；对于这种情况，应该查询出没有调用【取消流程】或【确认流程】的不确定交易，再根据这些交易出的相关信息，查询HIS系统的情况，决定调用 【取消流程】还是【确认流程】。成都市医保支付接口应用编程接口规范第 15 页 共 224 页根据 H I S 系统情况查询中心的不确定交易y h _ i n t e r f a c e _ g e t u n c e r t a i n t y t r a d e调用交易的取消流程y h _ i n t e r f a c e _ c a n c e l调用交易的确认流程y h _ i n
35、t e r f a c e _ c o n f i r mH I S 系统原处理失败H I S 系统原处理成功图1-2 不确定交易处理流程不同的业务交易，判断不同。门诊结算： 如果HIS系统有相应的结算信息，则应该调用确认流程 如果HIS系统没有相应的结算信息，则应该调用取消流程门诊结算回退 如果HIS系统有相应的结算信息，没有相应的退单信息，则调用取消流程 如果HIS系统没有相应的结算信息，或者有相应的退单信息，则调用确认流程 交易列表序号 交易代码 交易名称 交易类型 广域网支持 02 修改密码 查询类交易 03 身份识别 查询类交易 04 获取医院信息 查询类交易 05 签到 查询类交易
36、 06 批次号对帐签退 查询类交易 07 批次号结算信息上传签退 查询类交易 08 查询未签退的批次号信息 查询类交易 09 按分中心查询未签退的批次号信息 查询类交易 11 门诊结算 处理类交易 12 门诊结算回退 处理类交易 13 查询个人帐户是否可以支付 查询类交易 成都市医保支付接口应用编程接口规范第 16 页 共 224 页 14A 门诊特殊病、工伤门诊新申请 处理类交易 14B 门诊特殊病、工伤门诊变更申请 处理类交易 15 门诊特殊病、工伤门诊申请回退 处理类交易 16 门诊特殊病、工伤门诊申请查询 查询类交易 17 门诊特殊病、工伤门诊就诊登记 处理类交易 17A 门诊特殊病、
37、工伤门诊就诊登记回退 处理类交易 18 门诊特殊病、工伤门诊就诊登记修改 查询类交易 20 门诊特殊病、工伤门诊结算 处理类交易 20A 门诊特殊病、工伤门诊结算回退 处理类交易 21 入院办理 处理类交易 22 入院办理回退 处理类交易 23 入院办理信息修改 查询类交易 25 出院办理 查询类交易 26 出院办理回退 查询类交易 28a 按就诊编号入出院信息查询 查询类交易 28b 按入院经办时间入出院信息查询 查询类交易 29a 精神合并躯体疾病治疗申请 查询类交易 29b 精神合并躯体疾病治疗查询 查询类交易 30 查询住院统筹支付限额和不支付原因 查询类交易 31 住院医嘱上传 查询
38、类交易 32 住院医嘱作废 查询类交易 34 住院医嘱查询 查询类交易 41 住院费用明细写入 查询类交易 43 住院费用明细回退 查询类交易 44 费用明细分割信息查询及打印 查询类交易 51a 医院无密码结算申请 查询类交易 51b 医院无密码结算申请查询 查询类交易 52 住院结算 处理类交易 53 住院结算退单 处理类交易 54 住院结算模拟计算 查询类交易 55 医保基金详单打印 查询类交易 59 住院结算信息查询 查询类交易 61 结算信息查询（含门诊和住院） 查询类交易 71 清算申请 处理类交易 72 清算单打印 查询类交易 73 清算回退 处理类交易 74 清算申请查询 查询
39、类交易 91 服务项目目录获取 查询类交易 92 ICD-10信息获取 查询类交易 93 编码对照信息获取 查询类交易 118 病种，ICD,手术信息获取 查询类交易 120 新门特病种认定 查询类交易 成都市医保支付接口应用编程接口规范第 17 页 共 224 页 121 一般诊疗费置标 查询类交易 122 病种认定查询 查询类交易 123 工伤康复住院上传治疗方案 查询类交易 124 工伤康复住院撤消治疗方案 查询类交易 交易详细说明部分 修改密码（02）交易名称 修改密码 交易类型 查询类交易3.0版变更说明：城乡居民参保人如果已经发卡，使用该交易修改密码。对于未发卡的城乡居民参保人员，
40、不能使用该交易。处理描述接口弹出密码修改界面，提示参保人员刷卡和输入密码，采用密码小键盘获取参保人员密码信息，完成密码校验及修改。本交易为查询交易，有可能出现前端接口调用修改密码返回失败，结果中心修改密码成功的情况，此类特殊情况只能由医保病员自己验证当前使用密码是否是修改的新密码，不作交易控制。调用说明 修改的处理结果由接口显示提示，HIS不用对本交易返回结果进行判断和用户提示。输入参数交易编号 02交易控制xml交易输入xml输出参数交易流水号无交易输出xml交易标志 小于0 表示失败 身份识别（03）交易名称 身份识别 交易类型 查询类交易成都市医保支付接口应用编程接口规范第 18 页 共
41、 224 页3.0版变更说明：由于城乡居民可能还未领取到医疗保险卡，会继续使用医疗证，身份识别需要予以支持。处理描述1. 弹出身份识别窗口。医院经办人员选择刷卡或者直接输入。2. 刷卡方式需要输入密码进行校验；直接输入方式要求在【个人社保编号】、【医疗证号】、【身份证号】、【姓名】四项中至少输入其中两项，系统进行城乡居民参保人员检索并返回符合检索条件人员列表，选择参保人员。3. 城镇职工无法通过直接输入方式进行检索。4. 校验成功后返回个人信息。5. 返回的个人信息中akc021节点代码含义有所改变。如果是城镇职工返回代码不变，标识在职、退休等等；如果是城乡居民返回的代码为城乡居民人员来源（0
42、1农村居民；02城镇居民；03 少儿； 04大学生）6. 增加了接口版本标志入口参数，以确定返回个人帐户余额的XML 串格式调用说明本交易返回HIS参保人员个人信息，由HIS完成错误信息控制和相关信息显示。本交易为门诊结算交易服务，未进行身份识别交易的参保人员不能办理门诊结算，但可办理其他查询、入院等业务。输入参数交易编号03交易控制 xml接口版本标志 本次接口传入固定值3 2009-3-18 变更为下行接口版本标志 本次接口传入固定值3交易输入 xml输出参数交易流水号无交易输出 xml个人编码身份证号码姓名性别出生日期实足年龄医疗人员类别公务员类别个人帐户种类个人帐户余额成都市医保支付接
43、口应用编程接口规范第 19 页 共 224 页个人帐户种类个人帐户余额社保经办机构其他说明参保人所在单位编号 单位名称医院工伤诊断工伤伤害部位工伤支付类别工伤审批时间/此时间起7日内必须办理工伤入院允许办理工伤入院的开始时间 医院工伤诊断工伤伤害部位工伤支付类别/根据不同的工伤支付类别分段工伤审批时间/此时间起7日内必须办理工伤入院允许办理工伤入院的开始时间 -离休身份识别新增 hff add 2014-06-26当前是否享受待遇门诊定点机构编码门诊定点机构名称成都市医保支付接口应用编程接口规范第 20 页 共 224 页-异地门特新增返回参数异地标志 (1,本地 2,省内异地 3,省外异地)
44、特慢病病种编码（全省统一）特慢病病种名称享受待遇标示 0 不享受 1 享受不享受医保待遇原因 交易标志小于0 表示失败交易信息参数详细说明:交易控制：代码 名称 约束 类型 说明交易输入：代码 名称 约束 类型 说明edition接口版本号 NOT NULL VARCHAR(5) 本接口上传固定值3，以确定返回XML串格式交易输出：代码 名称 约束 类型 说明aac001 个人编码 NOT NULL VARCHAR(20)aac002 身份证号码 NOT NULL VARCHAR(18)aac003 姓名 NOT NULL VARCHAR(20)aac004 性别 NOT NULL VARCH
45、AR(4) 代码aac006 出生日期 NOT NULL DATETIME YYYY-MM-DD 00:00:00akc023 实足年龄 NOT NULL INTEGERakc021 医疗人员类别 NOT NULL VARCHAR(4) 代码。如果是城乡居民则返回城乡居民来源类别ykc117 公务员类别 NULL VARCHAR(4) 代码。如果是城乡居民则可以为NULLykc303 个人帐户种类 NOT NULL VARCHAR(40)ykc194 个人帐户余额 NOT NULL NUMBER(8,2) 如果是城镇职工，表示可用的个人帐户余额；如果是城乡居民，表示可用的门诊定额补助金额。aa
46、e013 其他说明 NULL VARCHAR(255)成都市医保支付接口应用编程接口规范第 21 页 共 224 页aab001 单位编码 NULL VARCHAR(20)aab004 单位名称 NULL VARCHAR(240)bkc014 特慢病病种编码 NULL VARCHAR(20)bkc117 特慢病病种名称 NULL VARCHAR(240) 获取医院信息（04）交易名称 获取医院信息 交易类型 查询类交易3.0版变更说明：无变化处理描述传入社保经办机构，查询出医院在该社保经办机构的定点资料信息。调用说明 HIS可以调用本交易完成定点医院信息的资料获取，用于用户查询。输入参数交易编
47、号 04交易控制xml社保经办机构交易输入xml输出参数交易流水号 为空，没有交易流水号返回交易输出xml服务机构编号 服务机构名称服务机构类型 医院等级医疗机构类别 法人姓名地址邮政编码执业（经营）许可证号药品经营企业合格证号银行行号户名银行账号床位数量备注交易标志 小于0 表示失败参数详细说明:成都市医保支付接口应用编程接口规范第 22 页 共 224 页交易控制：代码 名称 约束 类型 说明yab003 社保经办机构 NOT NULL VARCHAR(4)交易输入：代码 名称 约束 类型 说明交易输出：代码 名称 约束 类型 说明akb020 服务机构编号 NOT NULL VARCHA
48、R(20) 在该社保经办机构中的定点编码akb021 服务机构名称 NOT NULL VARCHAR(200)akb022 服务机构类型 NOT NULL VARCHAR(6) 代码aka101 医院等级 NOT NULL VARCHAR(6) 代码akb023 医疗机构类别 NOT NULL VARCHAR(6) 代码akb024 法人姓名 NULL VARCHAR(20)aae006 地址 NULL VARCHAR(200)aae007 邮政编码 NULL VARCHAR(12)akb026 执业（经营）许可证号 NULL VARCHAR(20)akb027 药品经营企业合格证号 NULL VARCHAR(20)aae008 银行行号 NULL VARCHAR(40)aae009 户名 NULL VARCHAR(50)aae010 银行账号 NULL VARCHAR(40)ykb001 床位数量 NULL Number(6)aae013 备注 NULL VARCHAR(200) 签到（05 ）交易名称 签到 交易类型 查询类交易3.0版变更说明：无变化处理描述 对不同的社保经办机
