医保his接口规范1

武汉市铁路医保系统 HIS 接口应用编程接口规范 华中兴业软件 2007 年 05 月 2 1、 概述 武汉市铁路医保系统支付接口应用编程接口规范 （以下简称规范）的使用对象为将使用武汉兴 业公司的医保支付组件库（以下简称组件库）来完成医保支付的为定点医疗机构提供应用软件的 HIS 供应商、药店 MIS 供应商或其它第三方应用软件供应商。 规范公布了组件库所提供的交易，规定了调用每一交易的前提条件，详细描述了每一交易的调用 方法。规范从编程的角度来介绍以上内容，对医保政策和医保支付流程的介绍不属于本规范的范围。 1.1. 术语及参考资料 COM： Common Object Model HIS：Hospital Information System MIS：Management Information System 1.2. 应用模式 兴业医保支付组件库是一组运行在 WINDOWS 32 位环境下的 COM 组件，第三方应用软件使用相 应的 COM 组件调用方式来调用它。 1.3. 环境要求 1.3.1. 硬件环境 指标 指标值 CPU 1.6MHz Memory 256MB HardDisk 100M(free) NetCard 10MB 武汉铁路医保医保支付接口应用编程接口规范 第 3 页 共 41 页 1.3.2. 网络环境 指标 指标值 协议 TCP/IP、 HTTP/HTTPS 广域网带宽 56k 网络连接 客户端直接访问医保中心网络 1.3.3. 系统软件 指标 指标值 操作系统 WIN98 SE 或 WIN 2000 及以上 WIN 系 列操作系统 辅助软件 IE6.0 2. 接口描述 2.1. 总体描述 组件库注册在每一台需要进行医保支付业务的客户机上（该客户端也必须能连接到医保网络） ，通 过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中（以下简称 HIS） ； 接口交易组件库提供了三个公共方法(Init 初始化，Destroy 资源释放，Trade 业务方法调用) ，交易 参数组织采用 String（字符串） （所有社保经办机构交易调用及交易参数统一） ，差别处理对于 HIS 透明。 接口交易内部也存在用户交互窗口，因此建议 HIS 事务管理与接口交易调用相互独立。 字段分隔符:； 行分隔符:/； 2.2. 接口 COM 说明 组件库提供交易的 COM 组件属性如下： 属性 值 App ID 4 Type Library ID Program ID Railway_insure.InsureInterface COM ClassName InsureInterface COM ClassID Interface Type Dual Interface Interface Name Interface ID 2.3. 交易接口函数描述 Init 原型定义： Init(ByRef intAppCode As Long, ByRef strAppMsg As String) 参数名称 参数含义 参数类型 参数类别 参数说明 intAppCode 交易标志 long 出口参数 小于 0 均为失败。此值数据类型是 整数 strAppMsg 交易信息 String 出口参数 错误信息描述。intAppCode 小于 0 时存放错误描述，其他 intAppCode 不用关心该参数内容。 函数说明： 初始化函数，HIS 应用启动时调用，进行医保交易处理初始化，本交易调用成 功后才能进行其他交易处理。 Destroy 原型定义： 武汉铁路医保医保支付接口应用编程接口规范 第 5 页 共 41 页 Destroy() 函数说明： 资源释放函数，在 HIS 应用退出时调用。 Trade 原型定义： Trade( Byval strTradeId As String, 交易编号 Byval strControl As String, 交易控制 Byval strIn As String, 交易输入 Byref strSerialId As string, 交易流水号 Byref strOut As string, 交易输出 Byref intAppCode As long, 交易标志 Byref strAppMsg As string) 交易信息 参数名称 参数含义 参数类型 参数类别 参数说明 strTradeId 交易编号 String 入口参数 具体的交易代码见交 易列表 strControl 交易控制 String 入口参数 字符串方式，组织方式见业务说明 strIn 交易输入 String 入口参数 字符串方式，组织方式见业务说明 strSerialId 交易流水号 String 出口参数 唯一标识一次交易，VARCHAR(20) strOut 交易输出 String 出口参数 字符串方式，组织方式见业务说明 intAppCode 交易标志 long 出口参数 小于 0 均为失败。此值数据类型是 整数，范围为-2147483648 to +2147483647 strAppMsg 交易信息 String 出口参数 错误信息描述。intAppCode 小于 0 时存放错误描述，其他 intAppCode 不用关心该参数内容。 函数说明： 6 交易主函数，完成所有医疗业务的实际处理。 由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入 HIS 系统事务管理。 在交易接口函数定义中，传递的参数都是字符串。但是在交易详细说明中，数据类 型都是逻辑类型，常用类型有三种：string,number,datetime，下面的表格描述了交易接口 进行类型转换的限制和说明。 数据类型 空字符串 格式不合法 其它说明 string 视同空串 无 无特别说明标注的长度为最大长度 number 视同 0 返回错误 无特别说明标注的长度为最大长度 （小数尾数同） datetime 视同空值 返回错误 足 19 位长，格式如下： YYYY-MM-DD hh24:mm:ss date 视同空值 返回错误 足 19 位长，格式如下： YYYY-MM-DD 00:00:00 接口调用示例： VB 调用 Dim XYobject As Object 定义存放引用对象的变量。 Set XYobject = CreateObject(“Railway_insure.InsureInterface “) 检查连接是否建立 If XYobject Is Nothing Then MsgBox “对象为空 !“ End If dim strTradeId As String, 交易编号 dim strControl As String, 交易控制 dim strIn As String, 交易输入 dim strSerialId As string, 交易流水号 dim strOut As string, 交易输出 武汉铁路医保医保支付接口应用编程接口规范 第 7 页 共 41 页 dim intAppCode As long, 交易标志 dim strAppMsg As string) 交易信息 strTradeId =“01“ HIS 业务处理 Call XYobject.Trade(strTradeId ,strControl,strIn,strSerialId,strOut,intAppCode,strAppMsg) 判断返回信息 If Appcode0 then messagebox(“error“，“fail to connect“) return end if BusinessID=”01” XYobject.Trade(strTradeId ,strControl,strIn,ref strSerialId,ref strOut,ref intAppCode,ref strAppMsg) / 返回结果判断，HIS 内部处理 2.4. 交易类型和调用流程 1、 查询类交易：包括一般查询交易,例如：身份确认； 武汉铁路医保医保支付接口应用编程接口规范 第 9 页 共 41 页 2、 处理类交易：包括门诊结算（退单/作废） 、入院办理（回退） 、出院结算（退单/取消结算）六个交 易，一次完整的处理类交易可以有两种方式： 1） 只有处理流程，符合情况是处理流程执行失败（接口返回错误代码及信息） ； 2） 处理流程取消流程，符合情况是处理流程执行成功，HIS 处理失败，调用取消流程。 调用交易的处理流程 interface _call 调用处理流程 是否成功 交易失败 HIS 进行处理 6 、 调用失败 2、 调用成功 HIS 处理是否成 功 调用交易的取消流程 _4、 处理失败 5、 处理成功 3 、 HIS 处理完毕 1、 处理流程处理完毕 交易成功 图 1-1 处理类交易调用流程 2.5. 处理交易的不同宕机点和相应的处理 1、 处理流程处理完毕 2、 调用成功 3、 HIS 处理完毕 4、 处理失败 10 5、 处理成功 在上面 5 个点系统宕机，系统重新启动后，都没有办法直接决定调用【取消流程】还是【确认流 程】 ；对于这种情况，应及时通知相关部门（例如：医保中心） ，再根据这些交易出的相关信息，查询 HIS 系统的情况，决定是否调用【取消流程】 。 不同的业务交易，判断不同。 门诊结算：如果 HIS 系统没有相应的结算信息，则应该调用取消流程。 门诊结算回退：如果 HIS 系统没有相应的结算信息，或者有相应的退单信息，则通知医保中心取 消相关记录。 2.6. 交易列表 序 号 交易代码 交易名称 交易类型 广域网 支持 备注 1. 01 身份识别 查询类交易 患者登记确认 2. 10 门诊费用分解 处理类交易 3. 11 门诊结算 处理类交易 4. 12 门诊结算回退（取消结算） 处理类交易 5. 21 入院办理 处理类交易 6. 22 入院办理回退 处理类交易 7. 23 入院办理信息修改 处理类交易 8. 25 出院办理 查询类交易 9. 26 出院办理回退 查询类交易 10. 31 住院费用明细写入（住院） 处理类交易 11. 42 住院费用明细写入（结算） 处理类交易 12. 51 住院费用分解 处理类交易 13. 52 住院结算 处理类交易 14. 53 住院结算退单 处理类交易 15. 91 服务项目目录获取（三大目录） 查询类交易 16. 94 医院需审核项目上传 处理类交易 HIS 基本业务调用说明： （1） 门诊挂号：01 身份识别； （2） 门诊结算：01 身份识别10 门诊费用分解11 门诊结算； （3） 门诊结算取消：01 身份识别12 门诊结算回退（取消结算； （4） 入院办理：01 身份识别21 入院办理； （5） 入院办理回退：01 身份识别22 入院办理回退； 武汉铁路医保医保支付接口应用编程接口规范 第 11 页 共 41 页 （6） 入院办理信息修改：01 身份识别23 入院办理信息修改； （7） 出院办理：01 身份识别25 出院办理； （8） 出院办理回退：01 身份识别26 出院办理回退； （9） 住院结算：01 身份识别51 住院费用分解52 住院结算； 2.7. 交易详细说明部分 01 身份识别 交易名称 身份识别 交易类型 查询类交易 处理描述 读卡，验证成功后返回个人医疗信息相关参数。 调用说明 本交易返回 HIS 参保人员个人信息、参保信息、帐户信息，由 HIS 完成错误信息 控制和相关信息显示。 输入参数 交易编号 01 交易控制 交易输入 输出参数 交易流水号 无 交易输出 医疗保险号卡号身份证号码姓名性别出生日期年龄民族人员参保类 别编码人员参保类别个人帐户余额本年帐户支出累计单位编码单位名称 地址联系电话邮政编码户口所在地卡状态是否在院 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 交易输入： 代码 名称 约束 类型 说明 交易输出： 代码 名称 约束 类型 说明 12 1 医疗保险号 NOT NULL VARCHAR(10) 2 卡号 NOT NULL VARCHAR(12) IC 卡号 3 身份证号码 VARCHAR(18) 4 姓名 NOT NULL VARCHAR(20) 5 性别 NOT NULL VARCHAR(2) 1 男 2 女 6 出生日期 NOT NULL DATE yyyy-MM-dd 7 年龄 NOT NULL VARCHAR(10) 例如：50 岁 8 民族 VARCHAR(20) 9 人员参保类别编码 NOT NULL VARCHAR(3) 10 人员参保类别 NOT NULL VARCHAR(20) 11 个人帐户余额 NOT NULL NUMERIC(10,2) 12 本年帐户支出累计 NOT NULL NUMERIC(10,2) 13 单位编码 NOT NULL CHAR(8) 14 单位名称 NOT NULL VARCHAR(50) 15 地址 VARCHAR(40) 16 联系电话 VARCHAR(20) 17 邮政编码 CHAR(6) 18 户口所在地 VARCHAR(50) 19 卡状态 NOT NULL CHAR(1) 0 正常、1 挂失、2 消号、 3 未办理参保手续、4 冻 结、5 卡不可用 20 是否在院 NOT NULL CHAR(1) 0 否 1 是 注意：患者如果在院（在 院未结算） ，门诊结算系统 自动以自费患者处理 武汉铁路医保医保支付接口应用编程接口规范 第 13 页 共 41 页 10 门诊费用分解 交易名称 门诊费用分解 交易类型 处理类交易 处理描述 读卡，身份确认，接口根据传入的明细信息进行明细分割和门诊预结算，明细分割 和预结算成功后显示结算结果窗口，由操作员选择分解或取消，如果选择分解则 完成前置机结算处理，如果取消，则返回 HIS 取消结算错误代码； 本交易完成后，完成费用分解。 调用说明 收费员录入门诊费用明细信息，HIS 系统组织明细相关参数调用门诊结算交易，等 待费用分解返回结果信息；如果返回成功则写入 HIS 数据库门诊结算详细信息，写入成 功后调用确认流程，写入失败后调用取消流程； 详细处理流程见：图 1-1 处理类交易调用流程； 由于本交易存在用户交互，建议 HIS 内部事务处理不要包含本交易调用。 输入参数 交易编号 10 交易控制 医疗保险号明细条数费用总额发票号 交易输入 记账流水号医保项目编码医院项目名称(诊疗项目)规格数量单价费用总额 实收费用总额开单科室开单医生开单时间结算时间HIS 项目编码/。 。 。/ 输出参数 交易流水 号 交易输出 医疗机构代码门诊收费流水号结算日期医保号总金额起付线药品甲类金额 药品乙类医保内金额药品乙类按比例自付金额自费药品金额普通治疗金额普 通治疗自费金额特检特治医保内金额特检特治按比例自付金额服务医保内金额 自费服务金额统筹基金支付金额大额保险支付慢性病自付补助支付金额普通门 诊自付补助支付金额个人帐户支付普通门诊个人自付本次帐户余额慢性病标志 慢性病病种编码医保内金额医保外金额医保内个人自付 交易标志 小于 0 表示失败 交易信息 参数详细说明: 14 交易控制： 代码 名称 约束 类型 说明 1 医疗保险号 NOT NULL CHAR(10) 医疗保险号码 2 明细条数 NOT NULL NUMBER(3) 3 费用总额 NOT NULL NUMBER(14,2) 4 发票号 VARCHAR(20) 交易输入： 代码 名称 约束 类型 说明 1 记账流水号 NOT NULL VARCHAR(20) 2 项目记帐流水号 NOT NULL VARCHAR(12) 项目记帐流水号 3 医保项目编码 NOT NULL VARCHAR(20) 见医保目录信息 4 医院项目名称 NOT NULL VARCHAR2(100) 5 规格 VARCHAR2(50) 6 数量 NOT NULL NUMBER(10,2) 本条明细数量 7 单价 NOT NULL NUMBER(14,4) 单价保留四位小数 8 费用总额 NOT NULL NUMBER(14,4) 单条明细费用总额保留 4 位小数， 结算时汇总费用总额保留 2 位小数 9 实收费用总额 NOT NULL NUMBER(14,4) 实际收费额 10 开单科室 VARCHAR2(20) 11 开单医生 VARCHAR2(20) 12 开单时间 NOT NULL DATE 医院收费员录入明细时间 13 结算时间 NOT NULL DATE 明细结算时间 14 HIS 项目编码 NOT NULL VARCHAR(20) 交易输出： 代码 名称 约束 类型 说明 1 医疗机构代码 NOT NULL VARCHAR2(8) 2 门诊收费流水号 NOT NULL VARCHAR2(16) 3 结算日期 NOT NULL DATE 4 医保号 NOT NULL CHAR(10) 5 总金额 NOT NULL NUMERIC(10,2) 武汉铁路医保医保支付接口应用编程接口规范 第 15 页 共 41 页 6 起付线 NOT NULL NUMERIC(10,2) 7 药品甲类金额 NOT NULL NUMERIC(10,2) 8 乙类医保内金额 NOT NULL NUMERIC(10,2) 9 乙类按比例自付金额 NOT NULL NUMERIC(10,2) 10 自费药品金额 NOT NULL NUMERIC(10,2) 11 普通治疗金额 NOT NULL NUMERIC(10,2) 12 普通治疗自费金额 NOT NULL NUMERIC(10,2) 13 特检特治医保内金额 NOT NULL NUMERIC(10,2) 14 特检特治按比例自付金 额 NOT NULL NUMERIC(10,2) 15 服务医保内金额 NOT NULL NUMERIC(10,2) 16 自费服务金额 NOT NULL NUMERIC(10,2) 17 统筹基金支付金额 NOT NULL NUMERIC(10,2) 18 大额保险支付 NOT NULL NUMERIC(10,2) 19 慢性病自付补助支付金 额 NOT NULL NUMERIC(10,2) 20 普通门诊自付补助支付 金额 NOT NULL NUMERIC(10,2) 21 个人帐户支付 NOT NULL NUMERIC(10,2) 22 普通门诊个人自付 NOT NULL NUMERIC(10,2) 23 本次帐户余额 NOT NULL NUMERIC(10,2) 24 慢性病标志 CHR(1) 0 否 1 是 25 慢性病病种编码 VARCHAR(20 ) 26 医保内金额 NOT NULL NUMERIC(10,2) 27 医保外金额 NOT NULL NUMERIC(10,2) 28 医保内个人自付 NOT NULL NUMERIC(10,2) 相关界面： 16 针对门诊慢性病患者就诊，需要选择的慢性病种类。 界面集中显示患者的参保信息、账户信息以及本次费用的分解计算结果信息，和相关的明细分解结果 信息。 11 门诊费用结算 交易名称 门诊结算 交易类型 处理类交易 处理描述 读卡，身份确认，接口根据传入的明细信息进行明细分割和门诊预结算，明细分割 武汉铁路医保医保支付接口应用编程接口规范 第 17 页 共 41 页 和预结算成功后显示结算结果窗口，由操作员选择确认或取消结算，如果选择确 认则完成前置机结算处理，如果取消结算，则返回 HIS 取消结算错误代码； 本交易完成后，结算数据处于未上传中心状态，当 HIS 存盘成功，调用确认门诊结 算业务,成功后完成前置机结算业务的门诊结算数据上传中心业务，明细数据处于等待 上传状态。 调用说明 收费员录入门诊费用明细信息，HIS 系统组织明细相关参数调用门诊结算交易，等 待结算返回结果信息；如果返回成功则写入 HIS 数据库门诊结算详细信息，写入成功后 调用确认流程，写入失败后调用取消流程； 详细处理流程见：图 1-1 处理类交易调用流程； 由于本交易存在用户交互，建议 HIS 内部事务处理不要包含本交易调用。 输入参数 交易编号 11 交易控制 门诊结算发票号 交易输入 输出参数 交易流水 号 返回，唯一标识一次交易 交易输出 医疗机构代码门诊收费流水号结算日期医保号总金额起付线药品甲类金额 药品乙类医保内金额药品乙类按比例自付金额自费药品金额普通治疗金额普 通治疗自费金额特检特治医保内金额特检特治按比例自付金额服务医保内金额 自费服务金额统筹基金支付金额大额保险支付慢性病自付补助支付金额普通门 诊自付补助支付金额个人帐户支付普通门诊个人自付本次帐户余额慢性病标志 慢性病病种编码医保内金额医保外金额医保内个人自付 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 18 交易输入： 代码 名称 约束 类型 说明 交易输出： 代码 名称 约束 类型 说明 1 医疗机构代码 NOT NULL VARCHAR2(8) 2 门诊收费流水号 NOT NULL VARCHAR2(16) 3 结算日期 NOT NULL DATE 4 医保号 NOT NULL CHAR(10) 5 总金额 NOT NULL NUMERIC(10,2) 6 起付线 NOT NULL NUMERIC(10,2) 7 药品甲类金额 NOT NULL NUMERIC(10,2) 8 乙类医保内金额 NOT NULL NUMERIC(10,2) 9 乙类按比例自付金额 NOT NULL NUMERIC(10,2) 10 自费药品金额 NOT NULL NUMERIC(10,2) 11 普通治疗金额 NOT NULL NUMERIC(10,2) 12 普通治疗自费金额 NOT NULL NUMERIC(10,2) 13 特检特治医保内金额 NOT NULL NUMERIC(10,2) 14 特检特治按比例自付金 额 NOT NULL NUMERIC(10,2) 15 服务医保内金额 NOT NULL NUMERIC(10,2) 16 自费服务金额 NOT NULL NUMERIC(10,2) 17 统筹基金支付金额 NOT NULL NUMERIC(10,2) 18 大额保险支付 NOT NULL NUMERIC(10,2) 19 慢性病自付补助支付金 额 NOT NULL NUMERIC(10,2) 20 普通门诊自付补助支付 金额 NOT NULL NUMERIC(10,2) 21 个人帐户支付 NOT NULL NUMERIC(10,2) 武汉铁路医保医保支付接口应用编程接口规范 第 19 页 共 41 页 22 普通门诊个人自付 NOT NULL NUMERIC(10,2) 23 本次帐户余额 NOT NULL NUMERIC(10,2) 24 慢性病标志 CHR(1) 25 慢性病病种编码 VARCHAR(20 ) 26 医保内金额 NOT NULL NUMERIC(10,2) 27 医保外金额 NOT NULL NUMERIC(10,2) 28 医保内个人自付 NOT NULL NUMERIC(10,2) 12 门诊结算回退 交易名称 门诊结算回退 交易类型 处理类交易 处理描述 接口弹出身份识别窗口，进行读卡；根据 HIS 传入参数调用中心门诊结算回退预处 理。本交易完成后并未进行实际回退，HIS 须调用确认才能完成整个回退业务。 调用说明 收费员选择需要退费的结算数据，HIS 系统组织相关参数调用本交易，等待返回结 果信息；如果返回成功则进行 HIS 系统门诊结算回退，数据操作成功后调用确认流程， 失败后调用取消流程； 详细处理流程见：图 1-1 处理类交易调用流程； 由于本交易存在用户交互，建议 HIS 内部事务处理不要包含本交易调用。 输入参数 交易编号 12 交易控制 交易流水号医疗保险号 交易输入 输出参数 交易流水 号 返回，唯一标识一次交易 交易输出 20 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 1 交易流水号 NOT NULL VARCHAR(20) 相关的门诊结算的交易流水号 交易输入： 代码 名称 约束 类型 说明 交易输出： 代码 名称 约束 类型 说明 21 入院办理 交易名称 入院办理 交易类型 处理类交易 处理描述 接口弹出身份识别窗口，进行读卡处理,接口根据传入的入院参数信息，完成入院 办理业务；本交易完成后，完成中心实际入院业务。 调用说明 HIS 系统组织相关参数调用本交易，等待返回结果信息；如果返回成功则写入 HIS 数据库相关信息，写入成功后调用确认流程，写入失败后调用取消流程；不能进行同一 病员的重复入院办理； 详细处理流程见：图 1-1 处理类交易调用流程； 由于本交易存在用户交互，建议 HIS 内部事务处理不要包含本交易调用。 输入参数 交易编号 21 交易控制 医疗保险号 交易输入 住院流水号（HIS）住院号入院日期入院诊断入院科室入院原因经办人姓 名入院经办时间姓名 输出参数 交易流水 返回就诊编码，唯一标识入院办理的一次交易 武汉铁路医保医保支付接口应用编程接口规范 第 21 页 共 41 页 号 交易输出 就诊编号医院编码支付类别医疗保险编号姓名性别出生日期病种编码 病种名称本次起付线本次医疗支付限额其他说明上次出院时间本次住院时间 天数提示信息 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 交易输入： 代码 名称 约束 类型 说明 1 住院流水号 NOT NULL VARCHAR(20) 2 住院号 NOT NULL VARCHAR(20) 3 入院日期 NOT NULL DATETIME 4 入院诊断 NOT NULL VARCHAR(200) 5 入院科室 NOT NULL VARCHAR(50) 6 入院原因 VARCHAR(200) 7 经办人姓名 NOT NULL VARCHAR(20) 8 入院经办时间 NOT NULL DATETIME 交易输出： 代码 名称 约束 类型 说明 1 就诊编码 NOT NULL VARCHAR(20) 唯一标识一次住院，中心生成 2 医院编码 NOT NULL VARCHAR(20) 3 支付类别 NOT NULL VARCHAR(12) 医疗保险类别 4 医疗保险编号 NOT NULL VARCHAR(10) 5 姓名 NOT NULL VARCHAR(20) 6 性别 NOT NULL CHAR(1) 1 男 2 女 7 出生日期 NOT NULL DATETIME yyyy-MM-dd 22 8 病种编码 NOT NULL VARCHAR(10) 9 病种名称 NOT NULL VARCHAR(200) 10 本次起付线 NOT NULL NUMBER(10,2) 11 本次医疗支付限额 NOT NULL NUMBER(10,2) 12 其他说明上次出院时间 VARCHAR(100) 13 本次住院时间 DATE yyyy-MM-dd 14 天数 NUMBER(10,0) 距离上次住院间隔天数 15 提示信息 VARCHAR(200) 如距离上次住院间隔天数小于中心 系统配置警告天数，系统警告提示 信息 相关界面： 显示患者的参保信息，以及需要填写的入院登记信息。 22 入院办理回退 交易名称 入院办理回退 交易类型 处理类交易 处理描述 对入院信息进行回退处理；如果已经出院办理则不能进行回退。注意：患者如果以 医保身份办理入院，而以自费方式办理住院结算，则必需先办理“入院办理回退” 。 调用说明 收费员选择需要回退的数据，HIS 系统组织相关参数调用本交易，等待返回结果信 息；如果返回成功则进行 HIS 系统数据回退，数据操作成功后调用确认流程，失败则调 用取消流程；详细处理流程见：图 1-1 处理类交易调用流程。 武汉铁路医保医保支付接口应用编程接口规范 第 23 页 共 41 页 输入参数 交易编号 22 交易控制 就诊编号 交易输入 经办人姓名 输出参数 交易流水 号 不返回 交易输出 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 1 就诊编号 NOT NULL VARCHAR(20) 入院办理返回的交易流水号 交易输入： 代码 名称 约束 类型 说明 1 经办人姓名 NOT NULL VARCHAR(20) 交易输出： 代码 名称 约束 类型 说明 23 入院办理信息修改 交易名称 入院办理信息修改 交易类型 查询类交易 处理描述 修改在院病员的入院相关信息，已办理出院病员不允许修改入院办理信息。 调用说明 入院办理成功并确认后才能调用该交易完成入院信息修改； 对于支付类别修改：采用入院办理回退后，重新入院办理解决。 输入参数 交易编号 23 交易控制 就诊编号（入院办理的交易流水号） 24 交易输入 住院号入院日期支付类型入院诊断入院科室入院原因经办人姓名入院经 办时间 输出参数 交易流水 号 不返回 交易输出 交易标志 小于 0 表示失败 交易信息 参数详细说明:参见入院办理 25 出院办理 交易名称 出院办理 交易类型 查询类交易 处理描述 对入院办理成功，并且费用总额大于 0 的住院人员进行出院办理，完成出院信息登 记。 调用说明 入院办理成功并确认，且有明细发生时才能调用本交易完成出院办理。 当错误编号等于（）时，表示该就诊编号已在中心办理出院成功，HIS 需要调用出 院办理回退交易，撤销出院办理后再次办理出院。 输入参数 交易编号 25 交易控制 就诊编码医疗保险号 交易输入 出院类型出院日期出院诊断(中文描述)出院科室转出医院编码经办人姓名 出院经办时间 输出参数 交易流水 号 不返回 交易效验 码 不返回 交易输出 武汉铁路医保医保支付接口应用编程接口规范 第 25 页 共 41 页 交易标志 小于 0 表示失败 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 1 就诊编码 NOT NULL VARCHAR(20) 入院办理的交易流水号 2 医疗保险号 NOT NULL CHAR(10) 医疗保险号 交易输入： 代码 名称 约束 类型 说明 1 出院类型 NOT NULL CHAR(1) 2 出院日期 NOT NULL DATE 3 出院诊断(中文描述) NOT NULL VARCHAR2(200) 4 出院科室 VARCHAR2(20) 5 转出医院编码 VARCHAR(8) 6 经办人姓名 NOT NULL VARCHAR2(10) 操作员 7 出院经办时间 DATE 交易输出： 代码 名称 约束 类型 说明 相关界面： 显示参保人员信息和出院需填写的出院信息（出院类别和出院诊断） ，注意出院诊断为必须填写的项目。 26 26 出院办理回退 交易名称 出院办理回退 交易类型 查询类交易 处理描述 对于已经出院，但没有办理住院结算的医保病员完成恢复入院操作。 调用说明 HIS 系统组织相关参数调用本交易，等待返回结果信息；如果返回成功则恢复 HIS 系统中病员入院，如果返回失败则需要再次办理。 对于在院人员返回回退成功信息。 输入参数 交易编号 26 交易控制 就诊编号医疗保险号 交易输入 经办人姓名 输出参数 交易流水 号 不返回 交易效验 码 不返回 交易输出 交易标志 小于 0 表示失败 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 1 就诊编码 NOT NULL VARCHAR(20) 入院办理的交易流水号 2 医疗保险号 NOT NULL CHAR(10) 医疗保险号 交易输入： 代码 名称 约束 类型 说明 1 经办人姓名 NOT NULL VARCHAR2(10) 操作员 交易输出： 代码 名称 约束 类型 说明 无 武汉铁路医保医保支付接口应用编程接口规范 第 27 页 共 41 页 31 住院费用明细写入（住院） 交易名称 住院费用明细写入 交易类型 查询类交易 处理描述 HIS 定时上传。 调用说明 HIS 定时上传住院费用明细，中心端记录。要求每次上传明细条数不要超过 2000 条。 输入参数 交易编号 31 交易控制 交易输入 记帐流水号社保号住院登记号患者姓名项目名称规格单价数量金额 实收金额收费日期医保（项目）编码开单医师开单科室/。 。 。 输出参数 交易流水 号 不返回 交易输出 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 交易输入： 代码 名称 约束 类型 说明 1 医院编码 NOT NULL CHAR(8) 2 记帐流水号 NOT NULL VARCHAR(20) HIS 项目记帐流水号 3 社保号 NOT NULL CHAR(10) 4 住院登记号 NOT NULL VARCHAR(16) 5 患者姓名 VARCHAR2（20 ） 6 项目名称 VARCHAR2(50) 7 规格 VARCHAR2(50) 8 单价 NUMBER(10,4) 28 9 数量 NUMBER(10,2) 10 金额 NUMBER(10,4) 11 实收金额 NUMBER(10,2) 12 收费日期 DATE 13 医保（项目）编码 VARCHAR(20) 14 开单医师 VARCHAR2(20) 15 开单科室 VARCHAR2(100) 交易输出： 代码 名称 约束 类型 说明 42 住院费用明细写入（结算） 交易名称 住院费用明细写入 交易类型 查询类交易 处理描述 HIS 定时上传。 调用说明 HIS 定时上传住院费用明细，中心端记录。要求每次上传明细条数不要超过 2000 条。 输入参数 交易编号 42 交易控制 交易输入 结算交易号社保号住院登记号项目记账流水号项目名称单价数量金额 实收金额收费日期医保（项目）编码医保类型结算日期开单医师开单科室 规格/ 输出参数 交易流水 号 不返回 交易输出 交易标志 小于 0 表示失败 交易信息 参数详细说明: 武汉铁路医保医保支付接口应用编程接口规范 第 29 页 共 41 页 交易控制： 代码 名称 约束 类型 说明 交易输入： 代码 名称 约束 类型 说明 1 结算交易号 NOT NULL VARCHAR2（16 ） 2* 医院编码 NOT NULL CHAR(8) 3 社保号 NOT NULL CHAR(10) 4 住院登记号 NOT NULL VARCHAR(16) 5* 项目记账流水号 VARCHAR(20) 6 项目名称 VARCHAR2(50) 7 单价 NUMBER(10,4) 8 数量 NUMBER(10,2) 9 金额 NUMBER(10,4) 10 实收金额 NUMBER(10,2) 11 收费日期 DATE 12 医保（项目）编码 VARCHAR(20) 13 医保类型 CHAR(1) 1 甲 2 乙 3 丙 14 结算日期 DATE 15 开单医师 VARCHAR2(20) 16 开单科室 VARCHAR2(100) 17 规格 VARCHAR2(10) 交易输出： 代码 名称 约束 类型 说明 51 住院费用分解 交易名称 住院费用分解 交易类型 处理类交易 处理描述 接口弹出身份识别窗口，进行读卡处理，接口根据传入参数进行中心金额核对，核对成 功后，进行计算并显示住院结算结果窗口，操作员选择确认或取消结算，如果选择确认则 30 完成结算处理，如果取消，则返回取消结算错误代码； 本交易完成后，完成前置机业务，但结算数据处于不确定状态。 调用说明 HIS 系统组织相关参数调用本交易，等待结算返回结果信息；如果返回成功则写入 HIS 数据库结算详细信息，写入成功后调用确认流程，写入失败后调用取消流程； 详细处理流程见：图 1-1 处理类交易调用流程； 由于本交易存在用户交互，建议 HIS 内部事务处理不要包含本交易调用。 输入参数 交易编号 51 交易控制 就诊编号医疗保险号住院号明细总额本次住院明细行数发票号 交易输入 记账流水号医保项目编码医院项目名称(诊疗项目)规格数量单价费用总额实 收费用总额开单科室开单医生开单时间结算时间HIS 项目编码收费类型标记 （药为 0 非药为 1）/。 。 。/ 输出参数 交易流水 号 返回，标识本次交易 交易输出 医疗机构代码医保号住院号住院结算流水号住院类别结算日期入院日期出院 日期住院天数本年住院次数总金额药品甲类金额药品乙类医保内金额药品乙类 按比例自付金额自费药品金额普通诊疗金额普通诊疗自付金额特检特治医保内金额 特检特制按比例自付金额服务医保内金额自费服务金额起付额统筹基金支付金额 医保内个人自付大额保险支付金额个人账户支付住院补助自付补助支付金额个人 支付医保内金额医保外金额 交易标志 小于 0 表示失败 交易信息 参数详细说明: 交易控制： 代码 名称 约束 类型 说明 1 就诊编码 NOT NULL VARCHAR(20) 入院办理的交易流水号 2 医疗保险号 NOT NULL VARCHAR(20) 3 住院号 VARCHAR(20) HIS 的住院号 武汉铁路医保医保支付接口应用编程接口规范 第 31 页 共 41 页 4 明细总额 NOT NULL NUMBER(14,2) 5 本次住院明细行数 NOT NULL NUMBER(10,0) 6 发票号 VARCHAR2(20) 交易输入： 代码 名称 约束 类型 说明 1 记账流水号 NOT NULL VARCHAR(20) 2 医保项目编码 NOT NULL VARCHAR(20) 见医保目录信息 3 医院项目名称(诊疗项目) NOT NULL VARCHAR(100) 4 规格 VARCHAR2(50) 5 数量 NOT NULL NUMBER(10,2) 本条明细数量 6 单价 NOT NULL NUMBER(14,4) 单价保留四位小数 7 费用总额 NOT NULL NUMBER(14,4) 单条明细费用总额保留 4 位小数， 结算时汇总费用总额保留 2 位小 数 8 实收费用总额 NOT NULL NUMBER(14,4) 实际收费额 9 开单科室 VARCHAR2(20) 10 开单医生 VARCHAR2(20) 11 开单时间 NOT NULL DATE 医院收费员录入明细时间 12 结算时间 NOT NULL DATE 明细结算时间 13 HIS 项目编码 NOT NULL VARCHAR(20) 交易输出： 代码 名称 约束 类型 说明 1 医疗机构代码 NOT NULL VARCHAR(8) 2 医保号 NOT NULL CHAR(10) 3 住院号 NOT NULL VARCHAR2(20) 4 住院结算流水号 NOT NULL VARCHAR(20) 5 住院类别 NOT NULL CHAR(1) 6 结算日期 NOT NULL DATETIME 结算中心记录写入时间 7 入院日期 NOT NULL DATETIME 32 8 出院日期 NOT NULL DATETIME 9 住院天数 NOT NULL INTEGER 10 本年住院次数 NOT NULL INTEGER 11 总金额 NOT NULL NUMBER(14,2) 12 药品甲类金额 NOT NULL NUMBER(14,2) 13 药品乙类医保内金额 NOT NULL NUMBER(14,2) 14 药品乙类按比例自付金额 NOT NULL NUMBER(14,2) 15 自费药品金额 NOT NULL NUMBER(14,2) 16 普通诊疗金额 NOT NULL NUMBER(14,2) 17 普通诊疗自付金额 NOT NULL NUMBER(14,2) 17 特检特治医保内金额 NOT NULL NUMBER(14,2) 18 特检特制按比例自付金额 NOT NULL NUMBER(14,2) 19 服务医保内金额 NOT NULL NUMBER(14,2) 20 自费服务金额 NOT NULL NUMBER(14,2) 21 起付额 NOT NULL NUMBER(14,2) 22 统筹基金支付金额 NOT NULL NUMBER(14,2) 23 医保内个人自付 NOT NULL NUMBER(14,2) 24 大额保险支付金额 NOT NULL NUMBER(14,2) 25 个人账户支付 NOT NULL NUMBER(14,2) 26 住院补助自付补助支付金额 NOT NULL NUMBER(14,2) 27 个人支付 NOT NULL NUMBER(14,2) 28 医保内金额 NOT NULL NUMBER(14,2) 29 医保外金额 NOT NULL NUMBER(14,2) 相关界面： 武汉铁路医保医保支付接口应用编程接口规范 第 33 页 共 41 页 界面集中显示患者的参保信息、账户信息以及本次费用的分解计算结果信息，和相关的明细分解结果 信息。 52 住院费用结算 交易名称 住院结算 交易类型 处理类交易 处理描述 接口弹出身份识别窗口，进行读卡处理，接口根据传入参数进行中心金额核对，核对成 功后，进行计算并显示住院结算结果窗口，操作员选择确认或取消结算，如果选择确认则 完成结算处理，如果取消结算，则返回取消结算错误代码； 本交易完成后，完成前置机业务，但结算数据处于不确定状态。 调用说明 HIS 系统组织相关参数调用本交易，等待结算返回结果信息；如果返回成功则写入 HIS 数据库结算详细信息，写入成功后调用确认流程，写入失败后调用取消流程； 详细处理流程见：图