©2010-2026 宁波自信网络信息技术有限公司 版权所有
客服电话：0574-28810668 投诉电话：18658249818
浙ICP备2021020529号-1 | 浙B2-20240490
关注我们 ：
1、 新疆(区本级)医保支付接口应用编程接口规范 - 新疆（区本级）医保系统 支付接口应用编程接口规范 （初稿） 银海软件 2009年11月 1、 概述 1. 《新疆(区本级)医保系统支付接口应用编程接口规范》（以下简称规范）的使用对象为将使用银海医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。 2. 规范公布了组件库
2、所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。 §1.1. 术语及参考资料 COM： Common Object Model HIS：Hospital Information System MIS：Management Information System §1.2. 应用模式 1. 银海医保支付组件库是一组运行在WINDOWS 32位环境下的COM组件，第三方应用软件使用相应的COM组件调用方式来调用它。 §1.3. 环境要求 §1.3.1. 硬件环境 指标
3、指标值 CPU ≧1.6MHz Memory ≧256MB HardDisk ≧100M(free) NetCard ≧10MB 2. §1.3.2. 网络环境 指标 指标值 协议 TCP/IP、HTTP/HTTPS 广域网带宽 ≧56k 网络连接 客户端直接访问医保中心网络 §1.3.3. 网络拓扑图 §1.3.4. 系统软件 指标 指标值 操作系统 WIN98 SE或WIN 2000及以上WIN系列操作系统 辅助软件 IE6.0 Msxml4.0 §1. 接口描述 §1.1. 总体描述 1. 组件库注册在每一台需要进行医保支付
4、业务的客户机上（该客户端也必须能连接到医保网络），通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称HIS）； 2. 接口交易组件库提供了六个公共方法(yh_interface_init 初始化，yh_interface_destroy 资源释放，yh_interface_call业务方法调用，yh_interface_confirm业务办理确认，yh_interface_cancel业务办理取消，yh_interface_getuncertaintytrade不确定交易查询)，交易参数组织采用xml（所有社保经办机构交易调用及交易参数统一），差别处理对于HIS透明。
5、 3. 新接口存在多社保经办机构处理，并且各社保经办机构处理模式存在差异，接口交易内部也可能存在用户交互窗口，因此建议HIS事务管理与接口交易调用相互独立。 4. 文档内但凡日期格式的处理均传入年月日，不带时分秒的处理，且全部为YYYYMMDD格式 §1.2. 接口COM说明 5. 组件库提供交易的COM组件属性如下： 属性 值 App ID Type Library ID Program ID yinhai.xjcj.interface COM ClassName COClass_n_yh_interface COM ClassID Interface
6、Type Dual Interface Interface Name In_yh_interface Interface ID §1.3. 交易接口函数描述 yh_interface_init ü 原型定义： yh_interface_init( ref integer aint_appcode, ref string astr_appmsg) ü 函数说明： 初始化函数，HIS应用启动时调用，进行医保交易处理初始化，本交易调用成功后才能进行其他交易处理。 yh_interface_destroy ü 原型定义： yh_interface_destroy()
7、 ü 函数说明： 资源释放函数，在HIS应用退出时调用。 yh_interface_call ü 原型定义： 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, ref string astr_appmsg) 参数名称 参数含义 参数类型 参数类别 参数说明 astr_jybh 交易编号 String
8、入口参数 具体的交易代码见〖交易列表〗 astr_jysr_xml 交易输入 String 入口参数 xml方式，组织方式见业务说明，字符串最大长度65534字符 astr_jylsh 交易流水号 String 出口参数 唯一标识一次交易，VARCHAR(20) astr_jyyzm 交易验证码 String 出口参数 处理类交易返回，确认交易时传入 VARCHAR(15) astr_jysc_xml 交易输出 String 出口参数 xml方式，组织方式见业务说明 aint_appcode 交易标志 long 出口参数 小于0均为失败。此
9、值数据类型是整数，范围为-2147483648 to +2147483647 astr_appmsg 交易信息 String 出口参数 错误信息描述。aint_appcode小于0时存放错误描述，其他aint_appcode不用关心该参数内容。 ü 函数说明： 交易主函数，完成所有医疗业务的实际处理。 由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入HIS系统事务管理。 在交易接口函数定义中，传递的参数都是字符串。但是在交易详细说明中，数据类型都是逻辑类型，常用类型有三种：string,number,datetime，下面的表格描述了交易接口进行类型转
10、换的限制和说明。 数据类型 空字符串 格式不合法 其它说明 string 视同空串 无 无特别说明标注的长度为最大长度 number 视同0 返回错误 无特别说明标注的长度为最大长度（小数尾数同） datetime 视同空值 返回错误 足19位长，格式如下： YYYY-MM-DD hh24:mm:ss date 视同空值 返回错误 足19位长，格式如下： YYYY-MM-DD astr_jykz_xml、astr_jysr_xml、astr_jysc_xml参数均按照交易详细说明里xml参数组合，顺序无关。接口调用示例： VB调用 Dim yi
11、nhaiobject As Object '定义存放引用对象的变量。 Set yinhaiobject = CreateObject("yinhai.xjcj.interface") '检查连接是否建立 If yinhaiobject Is Nothing Then MsgBox "对象为空!" End If Dim BusinessID As String Dim Dataxml As String Dim Businesssequence As String Dim Businessvalidate As String Dim Outputxml As String
12、 Dim Appcode as Long Dim Appmsg As String BusinessID="01" Ctrlxml ="" '组织参数 Dataxml ="" '组织参数 yinhaiobject.yh_interface_call BusinessID ,Dataxml ,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg '判断返回信息 'HIS业务处理 Set yinhaiobject = Nothing '关闭对象 delphi调用 注意：delphi调用时先要 us
13、es ComObj;否则不能引用oleobject。 Var yinhaiobject: Variant; //定义存放引用对象的变量。 BusinessID : String Dataxml : String Businesssequence : String Businessvalidate : String Outputxml : String Appcode : integer Appmsg:String; Begin try yinhaiobject := CreateOleObject('yinhai.xjcj.interface'); BusinessI
14、D:= '01'; yinhaiobject.yh_interface_call(BusinessID ,Dataxml ,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg) //返回结果判断，HIS内部处理 finally yinhaiobject:=Unassigned;// 关闭对象 end; End; pb调用 oleobject yinhaiobject long result, Appcode String BusinessID ,Dataxml ,Businesssequence
15、String Businessvalidate,Outputxml, Appmsg yinhaiobject=create oleobject result=yinhaiobject.ConnectToNewObject("yinhai.xjcj.interface") if result<>0 then messagebox("error"，"fail to connect") return end if BusinessID=”01” yinhaiobject.yh_interface_call(BusinessID ,Dataxml ,Businesssequence
16、Businessvalidate,Outputxml,Appcode,Appmsg) // 返回结果判断，HIS内部处理 // 关闭对象 yinhaiobject.DisconnectObject ( ) destroy yinhaiobject yh_interface_confirm ü 原型定义： yh_interface_confirm( string astr_jylsh, string astr_jyyzm, ref long aint_appcode, ref string astr_appmsg) 参数名称 参数含义 参数类型
17、 参数类别 参数说明 astr_jylsh 交易流水号 String 入口参数 唯一标识一次交易，VARCHAR(20) astr_jyyzm 交易验证码 String 入口参数 处理类交易返回，VARCHAR(64) aint_appcode 交易标志 long 出口参数 确认交易HIS不用关心本次处理返回结果，但是必须采用查询不确定交易的方式来确定是否所有数据正确处理。 astr_appmsg 交易信息 String 出口参数 ü 函数说明： 交易辅助函数，完成交易的确认处理。 对于处理类交易，HIS调用接口成功后完成HIS系统数据保存，则调
18、用该交易进行中心确认处理。 ü 接口调用示例： 参看yh_interface_call调用说明。 yh_interface_cancel ü 原型定义： yh_interface_cancel ( string astr_jylsh, ref long aint_appcode, ref string astr_appmsg) 参数名称 参数含义 参数类型 参数类别 astr_jylsh 交易流水号 String 入口参数 唯一标识一次交易，VARCHAR(20) aint_appcode 交易标志 long 出口参数 确认交易HIS不用关心本
19、次处理返回结果，但是必须采用查询不确定交易的方式来确定是否所有数据正确处理。 astr_appmsg 交易信息 String 出口参数 ü 函数说明： 交易辅助函数，完成交易的取消处理。 对于处理类交易，HIS调用接口成功后未完成HIS系统数据保存，则调用该交易进行中心取消处理。 ü 接口调用示例： 参看yh_interface_call调用说明。 yh_interface_getuncertaintytrade ü 原型定义： yh_interface_getuncertaintytrade ( string astr_jybh, ref string astr_
20、jgxml, ref long aint_appcode, ref string astr_appmsg) 参数名称 参数含义 参数类型 参数类别 astr_jybh 交易编号 String 入口参数 具体的交易代码见〖交易列表，为空时查询所有不确定交易〗 astr_jgxml 交易输出 String 出口参数 astr_jgxml格式:
21、号
22、或调用确认/取消失败），及时调用本函数查询未确认或取消的交易数据，并进行HIS数据查询，判断并调用确认或取消方法完成数据校对。 ü 接口调用示例： 参看yh_interface_call调用说明。 §1.4. 交易类型和调用流程 1、 查询类交易：包括一般查询交易和接口内部完成确认、取消的交易； 2、 处理类交易：包括门诊结算（回退）、入院办理（回退）、住院结算（回退）和清算（回退）等交易，一次完整的处理类交易可以有三种方式： 1） 只有处理流程，符合情况是处理流程执行失败（接口返回错误代码及信息）； 2） 处理流程＋确认流程，符合情况是处理流程执行成功，his处理也成功，调用
23、确认流程； 3） 处理流程＋取消流程，符合情况是处理流程执行成功，his处理失败，调用取消流程。 图1-1 处理类交易调用流程 在HIS进行处理环节，应该保存返回的交易流水号和验证码，建议HIS增加一张表存放交易流水号和验证码（后面的叙述中该表名称为交易记录表），并且保存的过程在HIS处理的事物内。 §1.5. 处理交易的不同宕机点和相应的处理 1、 处理流程处理完毕 2、 调用成功 3、 HIS处理完毕 4、 处理失败 5、 处理成功 在上面5个点系统宕机，系统重新启动后，都没有办法直接决定调用【取消流程】还是【确认流程】；对于这种情况，应该查询出没有调用【取消流程
24、或【确认流程】的不确定交易，再根据这些交易出的相关信息，查询HIS系统的交易记录表情况，如果该表存在该交易流水号的信息，则调用【确认流程】,如果该表不存在该交易流水号的信息，则调用【取消流程】。 §1.6. 交易列表 序号 交易代码 交易名称 交易类型 HIS是否必须实现 1. 02 修改密码 查询类 是 2. 03 身份识别 查询类 是 3. 03a 查询个人累计情况 查询类 4. 04 获取医院信息 查询类 是 5. 51 待遇审批 查询类 6. 21 入院办理 处理类 是 7. 22 入院办理回退
25、处理类 是 8. 23 入院办理信息修改 查询类 是 9. 25 出院办理 查询类 是 10. 26 出院办理回退 查询类 是 11. 28a 入出院信息查询 查询类 12. 31 费用明细写入 查询类 是 13. 32 费用明细退单 查询类 是 14. 45 费用明细分割信息查询及打印 查询类 是 15. 41 住院费用结算 处理类 是 16. 43 住院模拟结算 查询类 17. 48 药店购药、普通门诊及慢性病结算 处理类 是 18. 42 结算回退 处理类 是 19.
26、44 医保结算单打印 查询类 是 20. 59 住院结算信息查询 查询类 21. 46 结算信息查询 查询类 22. 71 清算申请 处理类 是 23. 72 清算单打印 查询类 是 24. 73 清算回退 处理类 是 25. 74 清算申请查询 查询类 是 26. 91 服务项目目录获取 查询类 是 27. 57 编码对照信息获取 查询类 28. 58 特殊慢性病申报 查询类 是 29. 52 获取医保中心日期 查询类 是 30. 53 三目录对码信息新增 查询类 是
27、31. 54 三目录对码信息修改 查询类 是 32. 55 三目录对码信息停用 查询类 是 35 56 获取三目录对码审核信息 查询类 是 36 33 批量删除明细 查询类 37 60 中心对码数据下载 查询类 38 28b 入出院信息查询 查询类 39 28c 入出院信息查询 查询类 40 72 清算汇总单打印 查询类 是 41 72b 清算清单打印 查询类 是 42 60 中心对码数据下载 查询类 43 61 中心ICD10数据下载 查询类 是 44 Q23A 出院病
28、人一览表 查询类 §1.7. 交易详细说明部分 §1.7.1. 修改密码（02） 交易名称 修改密码 交易类型 查询类交易 处理描述 接口弹出密码修改界面，提示参保人员刷卡和输入密码，采用密码小键盘获取参保人员密码信息，完成密码校验及修改。 本交易为查询交易，有可能出现前端接口调用修改密码返回失败，结果中心修改密码成功的情况，此类特殊情况只能由医保病员自己验证当前使用密码是否是修改的新密码，暂时不作交易控制。 调用说明 修改的处理结果由接口显示提示，HIS不用对本交易返回结果进行判断和用户提示。 输入参数 交易编号 02 交易输入xml
29、sion=“1.0” encoding=“GBK” standalone=“yes” ?> 输出参数 交易流水号 无 交易输出xml 交易标志 小于0表示失败 §1.7.2. 身份识别（03） 交易名称 身份识别 交易类型 查询类交易 处理描述 支付接口弹出身份识别窗口界面，提示参保人员刷卡和输入密码，密码验证成功后返回个人医疗信息相关参数。 调用说明 本交易返回HIS参保人员个
30、人信息，由HIS完成错误信息控制和相关信息显示。本交易为结算交易、结算退单交易服务，未进行身份识别交易的参保人员不能办理结算和结算退单，但可办理其他查询、入院等业务。 输入参数 交易编号 03 交易输入xml 输出参数 交易流水号 无 交易输出xml 交易标志 1、小于0表示失败 2、如果该医院如果不是该参保人员所属分中心定点，则报错 交易信息 交易输出： 代码 名称 约束
34、 类型 说明 prm_aac001 个人编号 NOT NULL VARCHAR2(15) prm_akc021 医疗人员类别 NOT NULL VARCHAR2(6) 见代码表 prm_ykc296 离休人员类别 NOT NULL VARCHAR2(6) 见代码表 prm_ykc120 公务员级别 NOT NULL VARCHAR2(6) 见代码表 prm_ykc117 公务员标志 NOT NULL VARCHAR2(6) 见代码表 prm_yab139 参保所属分中心 NOT NULL VARCHAR2(6) 见代码表 prm
35、ykd002 执行的医疗政策 NOT NULL VARCHAR2(6) 见代码表 prm_yac505 缴费人员类别 NOT NULL VARCHAR2(6) 见代码表 prm_ykc150 异地安置标志 NOT NULL VARCHAR2(6) 见代码表 prm_ykd131 驻外类别 NOT NULL VARCHAR2(6) 见代码表 prm_ykc298 驻外类型 NOT NULL VARCHAR2(6) 见代码表 prm_aac003 姓名 NULL VARCHAR2(20) prm_aac004 性别 NULL V
36、ARCHAR2(6) 见代码表 prm_aac002 公民身份号码 NULL VARCHAR2(18) prm_aac006 出生日期 NULL DATETIME prm_akc023 实足年龄 NULL NUMBER(3,0) prm_aab001 单位编号 NOT NULL VARCHAR2(15) prm_aab004 单位名称 NULL VARCHAR2(50) prm_aab019 单位类型 NULL VARCHAR2(50) 见代码表 prm_aab020 经济类型 NULL VARCHAR2(6)
37、见代码表 prm_yab136 单位管理类型 NULL VARCHAR2(6) 见代码表 prm_aab021 隶属关系 NULL VARCHAR2(6) 见代码表 prm_aac031 个人参保状态 NOT NULL VARCHAR2(6) 见代码表 prm_yae102 最后一次变更日期 NULL DATETIME prm_akc087 个人账户余额 NOT NULL NUMBER(14,2) prm_yab003 分中心编号 NOT NULL VARCHAR2(6) 见代码表 §1.7.3. 查询个人累计情况（03a）
38、
交易名称
查询个人累计情况
交易类型
查询类交易
处理描述
支付接口弹出身份识别窗口界面，提示参保人员刷卡和输入密码，密码验证成功后返回个人医疗累计情况。
调用说明
本交易返回HIS参保人员个人累计信息，仅供参考。
输入参数
交易编号
03a
交易输入xml
39、"1.0" encoding="GBK" standalone="yes" ?> 交易标志 1、小于0表示失败 2、累计信息仅作为参考使用，不作为结算依据 交易信息 交易输入 代码 名称 约束 类型 说明 prm_aae030 查询时间 NULL DATETIME 交易输出： 代码 名称 约束 类型 说明 prm_dyljxx 待遇累计信息 NOT NULL VARCHAR2(4000
40、) §1.7.4. 获取医院信息（04） 交易名称 获取医院信息 交易类型 查询类交易 处理描述 查询出医院在社保经办机构的定点资料信息。 调用说明 HIS可以调用本交易完成定点医院信息的资料获取，用于用户查询。 输入参数 交易编号 04 交易输入xml 输出参数 交易流水号 为空，没有交易流水号返回 交易输出xml
41、"yes" ?> 交易标志 1、 小于0表示失败 2、 一个医院被多个分中心定点的情况下，医院基本信息相同 交易输出 代码 名称 约束 类型 说明 prm_akb021 服务机构名称 NOT NULL VARCHAR2(200) prm_akb022 医疗机构类型 NOT NULL VARCHAR2(6) 见代码表 prm_ykd064 医院所属地 NOT NULL VARCHAR2(6) 见代码表 prm_akb023 医疗机构级别 NULL VARCHAR2(6) 见
43、代码表 prm_ykd122 限价医院等级 NOT NULL VARCHAR2(6) 见代码表 prm_aka101 医院类别 NULL VARCHAR2(6) 见代码表 prm_aae006 通信地址 NULL VARCHAR2(200) prm_ykd120 批准定点日期 NOT NULL DATETIME prm_yke368 是否惠民机构 NOT NULL VARCHAR2(6) §1.7.5. 待遇审批（51） 交易名称 待遇审批 交易类型 查询类交易 处理描述 调用中心待遇审批过程，确定该人入院时间点上的是否可以
44、享受待遇，以给入院经办人员提供参考。
字符串内返回的/n为换行符，HIS需要处理成各个语言对应的换行符
调用说明
。
输入参数
交易编号
51
交易输入xml
45、utput>
46、完成入院办理业务；
本交易完成后，完成中心实际入院业务，但入院数据处于不确定状态。
调用说明
HIS系统组织相关参数调用本交易，等待返回结果信息；如果返回成功则写入HIS数据库相关信息，写入成功后调用确认流程，写入失败后调用取消流程；不能进行同一病员的重复入院办理；
详细处理流程见：图1-1处理类交易调用流程；
由于本交易存在用户交互，建议HIS内部事务处理不要包含本交易调用。
输入参数
交易编号
21
交易输入xml
47、院号_YKC010
48、c014>
49、易的输入
50、
约束
类型
说明
prm_ykc010
住院号
NULL
VARCHAR2(20)
prm_akc192
入院日期
NOT NULL
DATETIME
prm_akc193
入院诊断
NULL
VARCHAR2(200)
prm_ykc302
第一入院诊断ICD码
NOT NULL
VARCHAR2(20)
prm_ykc012
入院床位
NULL
VARCHAR2(20)
prm_ykc011
入院科室
NULL
VARCHAR2(50)
prm_ykc013
入院经办人
NULL
VARCHAR2(20
©2010-2026 宁波自信网络信息技术有限公司 版权所有
客服电话：0574-28810668 投诉电话：18658249818
浙ICP备2021020529号-1 | 浙B2-20240490
关注我们 ：
