1、P-1/26 建行 银医 一卡通 银医 HIS 接口说明书 P-2/26 目录 1 简介 . 3 1.1 目的 3 1.2 范围 3 1.3 参考资料 3 1.4 概述 3 2 设计目标和约束 . 3 3 设计思路 . 3 4 业务流程 . 3 5 接口 . 4 5.1 发卡 4 5.2 自助挂号 6 5.2.1 接口描述 . 6 5.3 预约挂号 16 5.3.1 接口描述 . 16 5.4 缴费 20 5.4.1 接口说明及流程图 . 20 5.4.2 接口描述 . 20 5.5 验证 his 交易流水 . 24 6.7 判断是否可在挂号 ，同 一专家同一午别只能挂一个号 . 24 6.8
2、 查询已缴费明细 . 25 P-3/26 1 简介 1.1 目的 本文档将从概要的层面对一卡通就诊卡进行综合概述，从逻辑视图、实施视图以及数据视图等多个角度来描述系统的各个方面，它用于记录并表述已对系统的设计做出的重要决策。本文档将指导系统设计人员进行详细设计活动。 1.2 范围 1.3 参考资料 1.4 概述 本文档中包括了技术路线、逻辑视图、实施视图、数据视图、数据视图以及系统性能和系统质量等多方面的内容。 2 设计目标和约束 以 socket 提供对外接口 如果是医保接口，报文格式不变，传输机制采用 socket 服务 3 设计 思路 以 socket 对外提供统一的接口，对外开放统一的
3、方法 Process，通过业务编码来确认调用的具体方法 (通过配置 )，数据交互统一使用 XML(通过对实体序列化和反序列化 )，目前该接口适用于自费患者。（对于医保患者自助这部分采用COM+或 Socket 待定） 4 业务流程 P-4/26 5 接口 5.1 发卡 需求编号： Account01 需求分类： 一卡通自助机接口 需求名称：自助机办卡 优先级：高 需求说明 实现患者在自助终端自助办卡同时建立 患者 医院 账户 发卡 P-5/26 传入参数 003自助办卡 病历号 姓名 生日 性别 电话号 地址 身份证号 合同单位编码 账号 (注册为空 ) 就诊卡号 卡类型 密码 (注册为空 )
4、 预交支付方式 (注册为空 ) 银行名称 (注册为空 ) 银行账号 (注册为空 ) 金额 001 2013-11-21 5.00 0 交易类型 1为预交金模式， 2为直接连接模式 传 2 物理卡号 0 身份标识卡类别 支付类型（ 0 现金， 1预缴金， 2医保卡） 0 支付方式（卡类型 0 银行卡， 1就诊卡， 2医保卡） 0 0 0 P-6/26 返回值 1 创建病人成 CXZ00000066 5.2 自助挂号 5.2.1 接口描述 需求编号： Account04 需求分类： 一卡通自助机接口 需求名称：自助挂号 优先级：高 需求说明 对自助终端挂号提供相关接口 因目前 his 系统的科室结
5、构只有一级。此接口不用。如果确实需要需现场确认要一级科室的用途 函数模型 查询大科室 传入参数 0083 19 2014-05-16 P-7/26 返回值 008挂号 00x预约挂号 1成功 0无数据 -1失败 错误信息 总笔数 返回笔数 科室编码 科室名称 位置 . . 查询 排班小科室 传入参数 008 开始笔数 请求笔数 大科编码 院区 ALL为全部 预约日期 P-8/26 返回值 1成功 0无数据 -1失败 错误信息 总笔数 返回笔数 科室编码 科室名称 排班病号 id（号码） 小科室编码 名字 挂号级别 挂号级别名称 挂号费 检查费用 诊察费 附加费 挂号数限额 已挂号数 开始时间
6、不能为空 结束时间 不能为空 总费用 午别代码（ 1上午， 2下午， 3晚上， 4全天） 午别（上午，下午，晚上，全天） 主任，副主任 . . 查询排班情况 P-9/26 传入参数 0084 开始笔数 请求笔数 大科编码 院区 ALL为全部 预约日期 挂号级别 医生代码，暂不用 0科室， 1医生 P-10/26 传出参数 1 查询成功！ 0084 交易号 2总记录数 2 返回数 - 215566 排班编号，没排班返回空 科室 查询类型 2013-12-11 0:00:00 看诊日期 上午 午别 1002 科室代码 耳鼻喉科 (门诊 ) 科室名称 医生代码 医生名字 30 挂号限额 0 已挂号
7、数 科室地址 2013-12-11 8:00:00 开始时间 2013-12-11 12:00:00 结束时间 0预约 限额 0 预约 已挂号数 0已预约数 0 特诊限额 0 特诊已挂 90 挂号级别代码 挂号级别 0.50 挂号费 3 检查费 0 诊察费 0 其他附加费 3.50 挂号总金额 - . 按照 小 科室查询医生排班信息 P-11/26 传入参数 009挂号查询 0091预约挂号查询 0092挂号查询 过滤挂号级别 0093预约挂号查询过滤挂号级别 开始笔数 请求笔数 小科室编码 院区 ALL为全部 排班类型 1为医生， 2为科室 挂号种类（挂号级别） 预约日期 (现场挂号为当前时
8、间 ) 返回值 1 查询成功！ 0092 1 1 120119 何芸 正高号 正高号 0.50 0 7 0 10 0 2014-05-16 08:00:00 2014-05-16 12:00:00 7.50 上午 上午 主任医师 何芸正高号 10 0 5 0 挂号保存 P-12/26 传入参数 010交易编码 0120（预约挂号锁号） 病历号 （患者 id） 姓名 生日 性别 电话号 地址 身份证号 合同单位编码 统一传 挂号科室 挂号科室 科室名称 医生编码 医生名称 挂号级别 挂号级别名称 选择时间点编码 (预约时间点 ) 医生或科室看诊 开始 时间 医生或科室看诊结束时间 自助交易 流水
9、号 银行交易号 终端号，机器号 操作员 ：默认传 空 操作时间 交易金额 交易后金额 交易类型 1为预交金模式， 2为直接连接模式 物理卡号不能为空 身份标识卡类别 0磁卡卡 1就诊卡 2IC卡 3医保卡 4身份证 支付类型（ 0 现金， 1预缴金， 2医保卡） 医保传 2，自费传 0 支付方式（卡类型 0 银行卡， 1就诊卡， 2医保卡） -医保结算时下面 3个字段必须回传预结算金额 ,非医保传“ 0“ 医保使用自费金额 医保使用统筹金额 医保使用帐户金额 排班病号 id（号码） 预约流水号 此节点预结算 传空，结算时将预结算返回的在传入 异地标志 P-13/26 参保地统筹区编码 个人编码
10、 卡号 就诊登记号 账户余额 预结算与自费传 0.00 P-14/26 返回值 例子： 1 挂号成功！ 010 1 1 1 0000472 2014-05-16 CXZ00000053 2014-05-16 48074 0 0 0 1成功 -1失败 错误信息 010交易编码 1 1 看诊序号 发票号 就诊时间 患者 ID 预约时间 自费 医保自付 医保统筹 此节点预结算全传空，结算时将预结算返回的在传入 异地标志 参保地统筹区编码 个人编码 卡号 就诊登记号 账户余额 例子： P-15/26 1 挂号成功 010 1 1 4 A000000000-1 2013-11-28T18:21:26 0
11、000749595 2013-11-28T18:21:26 0 0 0 此节点预结算全传空，结算时将预结算返回的在传入 异地标志 参保地统筹区编码 个人编码 卡号 就诊登记号 账户余额 查询挂号级别（挂号类别） 入参 019交易编码 开始笔数 请求笔数 P-16/26 出参 0191 查询挂号级别成功！ 急诊号 急诊 号 0.50 0 5 0 99 5.3 预约挂号 5.3.1 接口描述 需求编号： Account05 需求分类： 一卡通自助机接口 需求名称：预约挂号 优先级：高 需求说明 对自助终端挂号提供相关接口 函数模型 查询挂号大科室 见现场挂号 查询挂号小科室 见现场挂号 按照 小
12、科室查询医生排班信息 见现场挂号 查询预约挂号时间点 (适用排版根据医生看诊间隔生成排版 )（查询挂号安排时段 -保留） string QueryPoint(string requestXml) 输入参数 0123 P-17/26 输出参数 0123 1 040103 产科门诊 120138 罗琼 副高号 副高号 上午 副主任医师 罗琼副高号 0.50 5 5.50 1 预约挂号 /取号保存 传入参数 交易编码 0121 原预约取号 病历号 （患者 id） 姓名 生日 性别 电话号 地址 身份证号 合同单位编码 统一传 20 挂号科室 科室名称 医生编码 医生名称 挂号级别 挂号级别名称 选择
13、时间点编码 (预约时间点 ) P-18/26 医生或科室看诊 开始 时间 医生或科室看诊结束时间 自助交易 流水号 银行交易号 终端号，机器号 操作员 ：默认传 空 操作时间 交易金额 交易后金额 交易类型 1为预交金模式， 2为直接连接模式 物理卡号不能为空 身份标识卡类别 0磁卡卡 1就诊卡 2IC卡 3医保卡 4身份证支付类型（ 0 现金， 1预缴金， 2医保卡） 医保传 2 支付方式（卡类型 0 银行卡， 1就诊卡， 2医保卡） -医保结算时下面 3个字段必须回传预结算金额 ,非医保传“ 0“ 医保使用自费金额 医保使用统筹金额 医保使用帐户金额 排班病号 id（号码） 预约流水号 此
14、节点预结算全传空，结算时将预结算返回的在传入 异地标志 参保地统筹区编码 个人编码 卡号 就诊登记号 账户余额 预结算与自费传 0.00 P-19/26 返回值 1成功 -1失败 错误信息 010交易编码 1 1 看诊序号 发票号 就诊时间 患者 ID 预约时间 自费 医保自付 医保统筹 此节点预结算全传空，结算时将预结算返回的在传入 异地标志 参保地统筹区编码 个人编码 卡号 就诊登记号 账户余额 网页预约增加返回信息 病人姓名 身份证 科室 医生 预约开始时间 预约结束时间 预约流水号 电话 1 挂号成功 010 1 1 4 A000000000-1 2013-11-28T18:21:26
15、 0000749595 2013-11-28T18:21:26 0 0 0 P-20/26 5.4 缴费 5.4.1 接口说明及流程图 患者通过自助终端对已划价的项目进行缴费 5.4.2 接口描述 需求编号： Account06 需求分类： 一卡通自助机接口 需求名称：缴费 优先级：高 需求说明 为患者通过自助终端对已划价项目进行缴费提供相关接口 函数模型 查询有效挂号信息 传入参数 013 开始笔数 请求笔数 病历号 返回值 1成功 0没有值 -1失败 错误信息 就诊卡号 挂号流水号 科室名称 医生名称 挂号日期 查询待缴费明细 P-21/26 传入参数 014 开始笔数 请求笔数 就诊卡号
16、 挂号流水号 科室名称 医生名称 挂号日期 返回值 1成功 0没有值 -1失败 错误信息 处方号 处方流水号 医嘱流水号 项目名称 规格 每次用量 用量单位 数量 单价 单价单位 金额 处方总金额 库存是否足够 1：足够， 0不足 缴费 /医保预结算 传入参数 0152/0153 预结算 0152,结算 0153，自费不用预结算 开始笔数 P-22/26 请求笔数 挂号流水号 处方号 0 0 0 0 0 . 自助交易号 银行交易号 机器号 操作员 操作时间 交易金额 交易后金额 交易类型 1为预交金模式， 2为直接连接模式 1 1 1 医保传 2 1 -医保结算时下面 3个字段必须回传预结算金
17、额 ,非医保传“ 0“ 1 1 1 此节点预结算全传空，结算时将预结算返回的在传入 异地标志 参保地统筹区编码 个人编码 卡号 就诊登记号 账户余额 预结算与自费传 0.00 P-23/26 返回值 - 1 预结算成功 0 0 0 0 150.00 -本次结算总额 0.00 -本次结算统筹总额 150.00 -本次结算自费总额 0.00 -本次结算医保账户支付总额 - OC0000000436 发票号 1 合同单位编号 一卡通支付 合同单位 150.00 -本发票总金额 0 -本发票统筹总额 150.00 -本发票自费总额 0 -本发票医保账户支付总额 - OC0000000436 -发票号
18、06 -项目类别编号 治疗费 -项目类别名称 150 -项目金额 - . - . 此节点预结算全传空，结算时将预结算返回的在传入 异地标志 参保地统筹区编码 个人编码 卡号 就诊登记号 账户余额 P-24/26 5.5 验证 his交易流水 说明：南天验证是否 his 生效 入参 0401 YN00030030581 7000000001 YN0003 出参 2 查询到多条记录！ 0 0 6.7判断是否可在挂号 ，同一专家同一午别只能挂一个号 入参 0402 挂号开始时间 挂号结束时间 科室代码 医生代码 挂号级别 门诊号 出参 1 返回结果， 1 可挂号， -1 不可挂或错误 提示 0 0
19、6.8 P-25/26 6.8查询已缴费明细 说明 查询已缴费清单接口 入参 0095固定 0095 开始笔数 请求笔数 4 固定传 4 0000749817门诊号码 2013-01-01开始时间 2014-12-31结束时间 0预留字段 6预留字段 出参 1 查询成功 23总数 1此次返回数 行 OC9000002158 发票号码 3745733处方号 维生素 A药品 /项目名称 2.5 万 u*100 粒 /瓶 规格 1数量 4.8880单价 瓶 单位 4.89总价 皮肤科 (门诊 )开单科室 郝建华 开单医生 门诊西药房 执行科室 预留字段 预留字段 预留字段 预留字段 预留字段 预留字段 预留字段 P-26/26
