新农合转诊基础平台 Webservice 省级接口说明 - V2001 - 图文

新农合转诊基础平台 WebService接口说明 (省级)

文 档 编 号： 版 本 号：v2001

软件产品名称：新农合转诊基础平台

编 写：北航冠新研发一部 日 期： 2011 年 03月 08日 审 核：省级转诊基础平台项目组 日 期： 2013 年 04月 19日

变更记录

序号 1. 更改内容 此次修改后版本由1007直接升级为2000 4.24家庭成员查询（家庭发卡预留） 入参: D401_10 卡号 (中卡号改成医疗证/卡号) 4.25个人信息查询（个人发卡预留） 入参: D401_10 卡号 (中卡号改成医疗证/卡号) 4.27出院补偿登记汇总表 D504_10 就诊类型 （中就诊类型改成就诊类别） D506_03 住院总费用 （中住院总费用改成住院总费用(元)） D506_24 垫付的补偿金额 （中垫付的补偿金额改成实际补偿金额(元)） 4.28拨付垫付补偿资金报表 D504_10 就诊类型（中就诊类型改成就诊类别） D910_09 住院总费用 （中住院总费用改成住院总费用(元)） D910_10 总药费 （中D910_10改成D506_66） D910_11 目录内药费 （中D910_11改成D604_44） D910_18 目录内药费占总药费的比 （中目录内药费占总药费的比改成目录内药品费用占总药品费用比例(单位:%) D910_18改成D102_12） D910_12 总诊疗费 （中总诊疗费改成住院诊疗费(元) D910_12改成D506_09） D910_13 可补偿诊疗费 （中可补偿诊疗费改成可补偿住院诊疗费(元) D910_13改成D506_09_A） D910_19 可补偿诊疗费占总诊疗费的比 （中可补偿诊疗费占总诊2. 疗费的比改成可补偿诊疗费用占总诊疗费用的比例(单位:%) D910_19改成D102_13） D910_14 可补偿总费用 （中可补偿总费用改成住院可报总费用(元) D910_14改成D506_19） D910_20改成D102_14 D910_21改成D102_16 在36文件中找不到需要增添 D910_15 申请拨付垫付补偿资金 （中D910_15改成D506_117） 4.30门诊预结算/4.31门诊结算 入参: D502_04 医院项目编码 （中医院项目编码改成项目编码） D502_05 医院项目名称 （中医院项目名称改成项目名称） D502_08 单价 （中单价改成单价(元)） D502_11 金额 （中金额改成金额(元)） 返回值: D603_02 基金年份 （中基金年份改成年份） D501_78 HIS疾病代码 （中D501_78改成D504_80） D501_79 HIS疾病名称 （中D501_79改成D504_81） D503_02_2 门诊总费用 （中门诊总费用改成门诊总费用(元)） D503_58 门诊可报总费用 （中门诊可报总费用改成可补偿费用） D503_09 实际补偿金额 （中实际补偿金额改成补偿金额(元)） 从 D503_03 西药费 到 D503_53 卫生材料费 （中费的后面都加上(元)） 从 D503_03_A 西药补偿费 到 D503_53_A 卫生材料补偿费 （中费的后面都加上(元)） 门诊预结算返回值在feeInfo标签中增加统筹补偿金额和医疗机2000 2013.8.20 版本 2000 更改日期 2013.8.19 备注 构负担金额，在allFeeSubentry标签中去掉医疗机构负担金额并且加上一般诊疗费，在computeTypeFee标签的最后加上一般诊疗费补偿费。 4.32门诊结算单 从 D503_03 西药费 到 D503_51 其它费 （中最后都加上(元)） D503_02_2 费用合计 （中费用合计改成门诊总费用(元)） 从 D503_03_A 补偿西药费 到 补偿其它费 （都把补偿放到费的前边并且最后加上(元)） D503_58 补偿费用合计 （中补偿费用合计改成可补偿费用） D503_09 实际补偿金额 （中实际补偿金额改成补偿金额(元)） 4.33门诊发票 D503_54 药费 (中药费改成门诊药费) D503_56 卫生材料费用 （中卫生材料费用改成门诊卫生材料费用） D503_02_2 费用合计 （中费用合计改成门诊总费用(元)） D503_62 费用合计大写 （中费用合计大写改成门诊总费用大写） D503_09 实际补偿金额 （中实际补偿金额改成补偿金额(元)） 4.34门诊退票 入参: D504_02 个人编码 后必填改成非必填 4.36门诊统筹总额预算 D101_02 就医机构名称 （中就医机构名称改成机构名称） 4.37门诊结算记录查询 D503_39 补偿金额下限 （中补偿金额下限改成补偿金额下线） 4.38门诊结算明细查询 D502_04 医院项目编码 (中医院项目编码改成项目编码) D502_05 医院项目名称 （中医院项目名称改成项目名称） D502_08 单价 （中单价改成单价(元)） D502_11 金额 （中金额改成金额(元)） D502_36 单项限价补偿类别 （中单项限价补偿类别改成限价金额补偿类别） D503_66 限价金额 （中限价金额改成实际发生金额） 4.39门诊补偿公示表 D503_15 就诊类型 （中就诊类型改成就诊类别） D603_02 基金年份 （中基金年份改成年份） D503_02_2 门诊总费用 （中门诊总费用改成门诊总费用(元)） D503_09 实际补偿金额 （中实际补偿金额改成补偿金额(元)） D503_57_A 一般诊疗费补偿金额 （中一般诊疗费补偿金额改成一般诊疗费补偿费） 3. 增加了40个函数入参字段的字符串大小 和修改了住院和门诊中 结算和预结算中剂型字段 改为必填项 住院结算和住院预结算 新增入参 0900002=本子结算是否结算新疆特殊重大疾病 0 否 1 是 在住院和门诊的结算、预结算返回值的feeInfo标签中增加了2个字段目录内自付费用和本次自付总费用 门诊结算记录查询入参中 终止日期改为非必填项 5. 修改了 住院登记入参中的入院时间字段改为非必填项 住院和门诊的结算、预结算的类型值和类型代码增加一个字段0700002=家庭账户冲抵自付金额 0 否 1是 住院结算和住院预结算返回值增加字段： 2000 2013.8.23 2000 2013.8.21 4. 2000 2013.8.22 常规比例 特殊病实付起付线 特殊病补偿比例 第三方保险实付起付线 第三方保险补偿比例 实付起付线 6. 修改了 住院记账、批量记账、门诊结算、门诊预结算入参中金额改成必填项 修改了一个错误 把门诊预结算中的就诊类别 由非必填改成必填7. 项 修改了一个错误 门诊预结算中疾病代码文档中是非必填，改为必填项 修改了住院记账查询中入参HIS住院号为必填项。 在住院登记中增加了一个入参电话号码。 8. 修改了住院记账、住院批量记账、门诊结算、门诊预结算入参中对标准项目名称和标准项目代码的解释。 在住院记账查询函数中给HIS住院号做了一句解释 说明：HIS住院号和农合住院号二者填其一即可 9. 修改了其它字典下发中29字典改为违规转诊方案 住院结算单新增返回值： 是否新生儿 依附人编码 登记属性 家庭通讯地址 修改了住院记账查询中入参HIS住院号为必填项。 住院登记和住院登记修改都增加了一个入参电话号码。 修改了住院记账、住院批量记账、门诊结算、门诊预结算入参中对标准项目名称和标准项目代码的解释。 住院结算记录查询中增加返回值 登记属性 户人属性 家庭通讯地址 联系电话 10. 是否新生儿 依附人编码 入院时间 出院时间 实际住院天数 入院诊断 出院诊断 住院结算单中增加返回值 是否新生儿 依附人编码 登记属性 家庭通讯地址 门诊结算单增加返回值 一般诊疗总费用 一般诊疗补偿费用 统筹补偿金额 增加删除住院记账函数B020015 2000 2013.9.6 2000 2013.9.5 2000 2013.9.3 2000 2013.9.2 2000 2013.8.26 11. C020007 D506_105 医疗机构负担金额 修改到 D506_75 应退款大写的后面 住院结算记录查询函数中删除了2个重复的返回值 2000 2013.9.9 12. 住院诊疗费(元) 可补偿住院住院诊疗费(元) 门诊结算记录查询中入参个人编码由必填改为非必填 2000 2013.9.10 13. 接口文档住院登记函数入参中入院时间改为必填项 住院结算记录查询 增加了2个返回值 2000 2013.9.11 14. D506_09 住院诊疗费（元） D506_09_A 可补偿住院诊疗费(元) 2000 2013.9.17 15. 16. 17. 18. 新增函数4.42门诊慢性病患者疾病代码查询C010005 增加了 住院结算和预结算入参第三方保险的注释 更改了出院登记的名称都改成了出院办理 删除了门诊结算返回值中多余的医疗机构负担金额 2000 2000 2000 2000 2000 2000 2000 2013.9.22 2013.9.23 2013.10.9 2013.10.12 2013.10.12 2013.10.15 2013.10.21 19. 为门诊慢性病患者疾病代码查询C010005返回值增加循环 20. 21. 删除了业务介绍部分在WS开发手册中可以找到业务介绍。维护了名词解释。 其它字典获取A040001返回值增加机构ID 住院预结算、住院结算、住院结算单、住院结算记录查询这4个22. 函数中返回值更改名称为 农村居民自付金额(元)（原名称农村居民自费金额(元)） 23. 24. 25 住院预结算、住院结算这2个函数中返回值名称更改为 目录外费用（原名称本次自付总费用） 其它字典下发函数新增4.23.4 字典代码说明 4.14住院发票B020006中返回值D506_75 应退款大写 改成 D506_120 应补款 4.32门诊结算单B010003中返回值D502_44 限价金额改成D503_66 实际发生金额 4.13住院结算记录查询C020007中返回值D506_75 应退款大写 改成 D506_120 应补款 4.11住院预结算B020011 删除D504_54 D504_60字段说明； 4.12住院结算B020012 删除D504_54 D504_60字段说明； 4.30门诊预结算B010001 标准项目代码，标准项目名称说明 4.31门诊结算B010002标准项目代码，标准项目名称说明 2000 2013.10.21 2000 2000 2000 2013.10.21 2013.10.23 2013.11.8 26 2000 2013.11.8 27 2000 2013.11.8 28 2001 2013.12.26 29 2001 2013.12.31

目录

1引言 ............................................................. 10

1.1名词解释 ................................................... 10 1.2编写目的 ................................................... 12 2业务介绍 ......................................................... 12

见《省级转诊平台WS开发手册》 .................................. 12 3接口概述 ......................................................... 12

3.1 接口模式说明 ............................................... 12 3.2 部署说明 ................................................... 14 3.3参数备注说明 ............................................... 15 4接口描述 ......................................................... 15

4.1转诊申请单查询C020001 ...................................... 17

4.1.1 参数说明 ............................................. 17 4.1.2 参数格式 ............................................. 17 4.1.3 返回结果 ............................................. 18 4.2住院登记B020001 ............................................ 19

4.2.1 参数说明 ............................................. 19 4.2.2 参数格式 ............................................. 21 4.2.3 返回结果 ............................................. 24 4.3住院登记修改B020002 ........................................ 24

4.3.1 参数说明 ............................................. 24 4.3.2 参数格式 ............................................. 26 4.3.3 返回结果 ............................................. 29 4.4住院登记删除B020003 ........................................ 29

4.4.1 参数说明 ............................................. 29 4.4.2 参数格式 ............................................. 30 4.4.3 返回结果 ............................................. 30 4.5在院情况查询C020003 ........................................ 31

4.5.1 参数说明 ............................................. 31 4.5.2 参数格式 ............................................. 31 4.5.3 返回结果 ............................................. 32 4.6住院记账B020004 ............................................ 34

4.6.1 参数说明 ............................................. 34 4.6.2 参数格式 ............................................. 35 4.6.3 返回结果 ............................................. 39 4.7住院记账查询C020004 ........................................ 39

4.7.1 参数说明 ............................................. 39 4.7.2 参数格式 ............................................. 40 4.7.3 返回结果 ............................................. 40 4.8批量住院记账B020013 ........................................ 45

4.8.1 参数说明 ............................................. 45 4.8.2 参数格式 ............................................. 46 4.8.3 返回结果 ............................................. 50

4.9出院办理B020005 ............................................ 50

4.9.1 参数说明 ............................................. 50 4.9.2 参数格式 ............................................. 50 4.9.3 返回结果 ............................................. 51 4.10出院办理查询C020006 ....................................... 51

4.10.1 参数说明 ............................................ 51 4.10.2 参数格式 ............................................ 52 4.10.3 返回结果 ............................................ 52 4.11住院预结算B020011 ......................................... 53

4.11.1 参数说明 ............................................ 53 4.11.2 参数格式 ............................................ 54 4.11.3 返回结果 ............................................ 55 4.12住院结算 B020012 .......................................... 59

4.12.1 参数说明 ............................................ 59 4.12.2 参数格式 ............................................ 60 4.12.3 返回结果 ............................................ 61 4.13住院结算记录查询C020007 ................................... 65

4.13.1 参数说明 ............................................ 65 4.13.2 参数格式 ............................................ 66 4.13.3 返回结果 ............................................ 66 4.14住院发票B020006 ........................................... 70

4.14.1 参数说明 ............................................ 70 4.14.2 参数格式 ............................................ 70 4.14.3 返回结果 ............................................ 71 4.15住院结算单B020007 ......................................... 72

4.15.1 参数说明 ............................................ 72 4.15.2 参数格式 ............................................ 73 4.15.3 返回结果 ............................................ 73 4.16住院补偿公示表C020005 ..................................... 77

4.16.1 参数说明 ............................................ 77 4.16.2 参数格式 ............................................ 77 4.16.3 返回结果 ............................................ 78 4.17连续住院可依附结算记录列表C020009 ......................... 79

4.17.1 参数说明 ............................................ 79 4.17.2 参数格式 ............................................ 79 4.17.3 返回结果 ............................................ 80 4.18退票B020008 ............................................... 81

4.18.1 参数说明 ............................................ 81 4.18.2 参数格式 ............................................ 81 4.18.3 返回结果 ............................................ 82 4.19申请结算月份查询C020010 ................................... 82

4.19.1 参数说明 ............................................ 82 4.19.2 参数格式 ............................................ 82 4.19.3 返回结果 ............................................ 83

4.20申请结算查询C020011 ....................................... 83

4.20.1 参数说明 ............................................ 83 4.20.2 参数格式 ............................................ 83 4.20.3 返回结果 ............................................ 84 4.21申请结算B020009 ........................................... 85

4.21.1 参数说明 ............................................ 85 4.21.2 参数格式 ............................................ 85 4.21.3 返回结果 ............................................ 86 4.22退申请结算B020010 ......................................... 86

4.22.1 参数说明 ............................................ 86 4.22.2 参数格式 ............................................ 86 4.22.3 返回结果 ............................................ 87 4.23其它字典获取A040001 ....................................... 87

4.23.1 参数说明 ............................................ 87 4.23.2 参数格式 ............................................ 87 4.23.3 返回结果 ............................................ 88 4.24家庭成员查询C030001 ....................................... 95

4.24.1 参数说明 ............................................ 95 4.24.2 参数格式 ............................................ 95 4.24.3 返回结果 ............................................ 95 4.25个人信息查询C030002 ....................................... 97

4.25.1 参数说明 ............................................ 97 4.25.2 参数格式 ............................................ 98 4.25.3 返回结果 ............................................ 98 4.26未申请转诊患者查询C020012 ................................ 100

4.26.1 参数说明 ........................................... 100 4.26.2 参数格式 ........................................... 100 4.26.3 返回结果 ........................................... 100 4.27出院补偿办理汇总表C020013 ................................ 101

4.27.1 参数说明 ........................................... 101 4.27.2 参数格式 ........................................... 102 4.27.3 返回结果 ........................................... 102 4.28拨付垫付补偿资金报表C020014 .............................. 103

4.28.1 参数说明 ........................................... 103 4.28.2 参数格式 ........................................... 104 4.28.3 返回结果 ........................................... 104 4.29退出院办理B020014 ........................................ 105

4.29.1 参数说明 ........................................... 105 4.29.2 参数格式 ........................................... 105 4.29.3 返回结果 ........................................... 106 4.30门诊预结算B010001 ........................................ 107

4.30.1 参数说明 ........................................... 107 4.30.2 参数格式 ........................................... 108 4.30.3 返回结果 ........................................... 112

4.31门诊结算B010002 .......................................... 115

4.31.1 参数说明 ........................................... 115 4.31.2 参数格式 ........................................... 116 4.31.3 返回结果 ........................................... 120 4.32门诊结算单B010003 ........................................ 123

4.32.1 参数说明 ........................................... 123 4.32.2 参数格式 ........................................... 123 4.32.3 返回结果 ........................................... 124 4.33门诊发票B010004 .......................................... 126

4.33.1 参数说明 ........................................... 126 4.33.2 参数格式 ........................................... 126 4.33.3 返回结果 ........................................... 127 4.34门诊退票B010005 .......................................... 128

4.34.1 参数说明 ........................................... 128 4.34.2 参数格式 ........................................... 128 4.34.3 返回结果 ........................................... 129 4.35门诊连续日判断B010006 .................................... 129

4.35.1 参数说明 ........................................... 129 4.35.2 参数格式 ........................................... 130 4.35.3 返回结果 ........................................... 130 4.36门诊统筹总额预算B010007 .................................. 131

4.36.1 参数说明 ........................................... 131 4.36.2 参数格式 ........................................... 131 4.36.3 返回结果 ........................................... 132 4.37门诊结算记录查询C010001 .................................. 133

4.37.1 参数说明 ........................................... 133 4.37.2 参数格式 ........................................... 134 4.37.3 返回结果 ........................................... 136 4.38门诊结算明细查询C010002 .................................. 137

4.38.1 参数说明 ........................................... 137 4.38.2 参数格式 ........................................... 137 4.38.3 返回结果 ........................................... 138 4.39门诊补偿公示表C010003 .................................... 141

4.39.1 参数说明 ........................................... 141 4.39.2 参数格式 ........................................... 142 4.39.3 返回结果 ........................................... 142 4.40门诊统筹总额预算查询C010004 .............................. 144

4.40.1 参数说明 ........................................... 144 4.40.2 参数格式 ........................................... 144 4.40.3 返回结果 ........................................... 144 4.41删除住院记账B020015 ...................................... 146

4.41.1 参数说明 ........................................... 146 4.41.2 参数格式 ........................................... 146 4.41.3 返回结果 ........................................... 147

4.42门诊慢性病患者疾病代码查询C010005 ........................ 147

4.42.1 参数说明 ........................................... 147 4.42.2 参数格式 ........................................... 147 4.42.3 返回结果 ........................................... 148

1引言

1.1名词解释 WebService： HIS： XML： 通过Web进行调用API的应用程序。 医院信息系统（Hospital information System，HIS）。 可扩展标记语言，这里表示WebService平台中数据传输格式。 WSDL是用来描述服务的接口的，包括方法名字，参数类型，返回值是什么、通过什么地址、什么端口、什么协议调用等等。WSDL： WSDL还可以定义比较复杂的数据结构，比如结构体、数组、集合等。通过一个服务的WSDL可以了解如何调用这个服务。 UDDI是一种用于发现和定位服务协议，它把一个服务拆的非UDDI： 常细，用来管理,分发,查询webService 具体实现可以搜索 Web Services简单实例。 简单对象访问协议（Simple Object Access Protocol，SOAP），是一种轻量的、简单的、基于XML的协议，它被设计成在WEB上交换结构化的和固化的信息。webService三要素(SOAP, WSDL (Web Services Description Language),UDDI( Universal Description Discovery and Integration ))之一, soap用来传递信息的格式, WSDL 用来描述如何访问具体的接口, uddi用来管理,分发,查询webService 具体实现可以搜索 Web Services简单实例 ; SOAP 可以和现存的许多因特网协议和格式结合使用，包括超文本传输协议（HTTP），简单邮件传输协议（SMTP），多用途网际邮件扩充协议（MIME）。它还支持从消息系统到远程过程调用（RPC）等大量的应用程序。SOAP使用基于XML的数据结构和超文本传输协议(HTTP)的组合定义了一个标准的方法来使用Internet上SOAP： 各种不同操作环境中的分布式对象。简单对象访问协议（Simple Object Access Protocol，SOAP），是一种轻量的、简单的、基于XML的协议，它被设计成在WEB上交换结构化的和固化的信息。webService三要素(SOAP, WSDL (Web Services Description Language),UDDI( Universal Description Discovery and Integration ))之一, soap用来传递信息的格式, WSDL 用来描述如何访问具体的接口, uddi用来管理,分发,查询webService 具体实现可以搜索 Web Services简单实例 ; SOAP 可以和现存的许多因特网协议和格式结合使用，包括超文本传输协议（HTTP），简单邮件传输协议（SMTP），多用途网际邮件扩充协议（MIME）。它还支持从消息系统到远程过程调用（RPC）等大量的应用程序。SOAP使用基于XML的数据结构和超文本传输协议(HTTP)的组合定义了一个标准的方法来使用Internet上各种不同操作环境中的分布式对象。 新农合经办机构： 包括省、市、县（市、区）新型农村合作医疗管理部门，负责新农合的日常业务处理。这里特指县级新型农村合作医疗管理部门。 通过各级新农合管理机构认定的省、市级（县域外）定点医疗定点医疗机构： 机构。 新农合转诊基础主要包括转诊基础平台、数据交换平台以及WebService应用平台系统： 服务平台。本文特指“新农合省级转诊基础平台系统”。 域外就医： 这里是指在所属县新农合经办机构以外的定点医疗机构就医。 字典目录： 这里是指药品目录、诊疗目录、材料目录。 这里是指为了实现患者出院即报，定点医疗机构预先垫付的农垫付费用： 合报偿费用。 这里是指18位医疗证号。例如：130101010203000405其中前六位是县级编码（130101）后边两位是乡镇代码（01）后边两位新农合医疗证号： 是村代码（02）后边两位是组代码（03）后边4位是家庭代码（0004）最后两位是个人代码（05）。 农合住院号： 这里是指由县级农合系统产生的住院号。

1.2编写目的 ? 制定统一的新农合转诊基础平台系统与HIS接口规范，所有定点医疗机

构以及实现省级转诊的区县结算都需要遵循。

? 指导HIS厂商和县级农合开发商在新农合转诊基础平台统一规范、标准

和要求下，改造HIS接口系统和县级接口系统，为其开发、调试提供参考，使其接口改造顺利进行，尽快达到新农合转诊基础平台的要求。 ? 本规范作为新农合转诊基础平台HIS接口改造和县级农合接口系统进行

结算验收的依据之一。

2业务介绍

见《省级转诊平台WS开发手册》

3接口概述

3.1 接口模式说明 新农合转诊基础平台采用WebService技术与HIS系统进行对接，实现转诊业务的各项功能。包括身份认证、住院登记、住院记账、出院办理、住院结算等。

新农合转诊基础平台提供服务接口

http://localhost/ nh_webservice/n_api.asmx?WSDL。使用服务的HIS系统依据服务接口创建与WebService的连接对象并实例化后，通过调用pipe来调用相应业务函数处理业务功能。

服务接口说明：（http://localhost/ nh_webservice/n_api.asmx?WSDL） http：超文本传输协议，一种网络传输协议。

localhost：主机地址，此参数会根据服务部署的主机不同而发生改变。 nh_webservice：服务虚拟目录名称，固定不变。 n_api：WebService名称，固定不变。

新农合转诊基础平台验收前提供测试程序用于HIS系统的开发、调试。

第 12 页 共 149 页

开发语言 调用示例 PowerBuilder 开发语言 调用示例 //创建连接对象 SoapConnection conn conn = create SoapConnection //创建WS代理对象 test_n_webservice ws_obj String ls_parms //XML参数字符串 String ls_return //函数调用返回值 conn.CreateInstance(ws_obj,\bservice/n_api.asmx?WSDL\try ls_return=ws_obj. nh_pipe(ls_parms) catch(SoapException e) messagebox(\错误\调用失败\end try Java CXF //创建并连接WS对象 JaxWsProxyFactoryBean svr = new JaxWsProxyFactoryBean(); svr.setServiceClass(NApiSoap.class); svr.setAddress(\ nh_webservice/n_api.asmx?WSDL\NApiSoap hw = (NApiSoap) svr.create(); //parms :XML参数字符串 hw. nh_pipe (parms) 接口功能编号规则：

分类 基础类（A） 其他字典（04） 其它字典获取（0001） 门诊预结算（0001） 门诊结算（0002） 门诊结算单（0003） 门诊（01） 业务类（B） 门诊发票（0004） 门诊退票（0005） 门诊连续日判断（0006） 门诊统筹总额预算（0007） 住院登记（0001） 住院（02） 住院登记修改（0002） 住院登记删除（0003） 住院记账（0004） 功能编码 A040001 B010001 B010002 B010003 B010004 B010005 B010006 B010007 B020001 B020002 B020003 B020004 第 13 页 共 149 页

出院办理（0005） 住院发票（0006） 住院结算单（0007） 退票（0008） 申请结算（0009） 退申请结算（0010） 住院预结算（0011） 住院结算（0012） 批量住院记账（0013） 退出院办理（0014） 删除住院记账 门诊结算记录查询（0001） 门诊结算明细查询（0002） 门诊（01） 门诊补偿公示查询（0003） 门诊统筹总额预算查询（0004） 门诊慢性病患者疾病代码查询（0005） 转诊申请单查询（0001） 住院登记查询（0003） 住院记账查询（0004） 查询类（C） 住院（02） 住院补偿公示（0013） 出院办理查询（0006） 住院结算记录查询（0007） 连续住院可依附结算记录列表（0009） 申请结算月份查询（0010） 申请结算查询（0011） 未申请转诊患者查询（0012） 档案（03） 家庭成员查询（0001） 个人信息查询（0002） B020005 B020006 B020007 B020008 B020009 B020010 B020011 B020012 B020013 B020014 B020015 C010001 C010002 C010003 C010004 C010005 C020001 C020003 C020004 C020005 C020006 C020007 C020009 C020010 C020011 C020012 C030001 C030002

3.2 部署说明 网络拓扑图

第 14 页 共 149 页

省级省级新农合数据中心省级医院直报应用服务器省级医院即时结报客户端省级医院内部网络·医院HIS数据中心公卫网市级省级医院（隶属地市）县级终端前置机县级新农合数据中心市级数据中心县级公卫网防火墙公卫网交换机公卫网连接线省级定点医院即时结报网络架构图专网 3.3 参数备注说明 ? 参数备注详细说明请参考《河北省县级系统数据规范通知36号》文档。

4接口描述

XML 元素命名规则

? 元素名中第一个单词首字母统一小写，后续所有单词首字母统一大写。 ? Dxxx_xx、Sxxx_xx 的除外，D 和 S 均为大写。

传输规范说明

? 数据传输格式。从目前的发展趋势和标准化的角度考虑，XML是一个最优的

选择，它基于标准，扩展非常容易。因此新农合数据传输的信息格式将采用XML作为传输数据格式。

? XML数据交换模型。本部分规定的XML数据交换模型用于在不同系统间进行

信息交换时封装交换信息内容。

第 15 页 共 149 页

（1）数据传输报文全部内容封装在XML报文中，采用UTF-8 字符集。请求类XML报文使用?进行封装，应答类XML报文使用?进行封装。XML报文分为两大部分：XML数据交换头部分和业务数据体部分。

（2）XML头?部分用于标识XML报文的基本属性，在现阶段包括版本号、功能编码、目标机构代码、 医疗单位身份、密码等基本信息。每个接口函数的数据交换头都是相同的，参数描述如下： 数据交换头说明 参数 version 说明 版本号 类型 String 备注 必填 4位文档版本号,本次发布版本为2000。 functionNo 功能编码 String String 必填 函数功能编码 必填 6位行政区（各县区目标机构代码是唯一的，这个区划代码需要北航技术人员提供，然后各个医院根据自己实际需要开发程序） identity 医疗单位身份 String 必填 医疗机构编码，3位数字 详见4.23返回值第24号字典 password

（3）业务数据体...部分用于存放具体的数据传输报文。

需要注意事项：

在 XML 中，一些字符拥有特殊的意义。

如果你把字符 \放在 XML 元素中，会发生错误，这是因为解析器会把它当作新元素的开始。 这样会产生 XML 错误：

if salary < 1000 then 为了避免这个错误，请用实体引用来代替 \字符：

targetOrg 目标机构代码 密码 String 必填 6位密码 第 16 页 共 149 页

if salary < 1000 then 在 XML 中，有 5 个预定义的实体引用： < > & ' " < > & ' \小于 大于 和号 单引号 引号 注意事项：数据交互使用XML格式，请严格遵守XML相应标准进行编码。

4.1转诊申请单查询C020001 4.1.1 参数说明

参数 D507_01 说明 个人编码 类型 String(18) 备注 必填 18位个人医疗证号 4.1.2 参数格式

参数 格式 版本号 功能编码 目标机构代码 个人编码 第 17 页 共 149 页

4.1.3 返回结果

错误 成功 返回 格式 7位错误代码 成功代码+返回信息 返回代码 返回说明 转诊申请单号 个人编码 患者姓名 患者性别 疾病代码 审核说明 申请日期 审核时间 合管中心联系电话 转出医疗机构代码 经办机构代码 联系电话 患者身份证号 疾病名称 转出医疗机构 申请说明 转入医疗机构 转入医疗机构代码 第 18 页 共 149 页

审核状态 审核人 4.2住院登记B020001 4.2.1 参数说明

参数 D504_47 D504_02 D504_03 D504_04 说明 转诊申请单号 个人编码 患者姓名 患者性别 类型 String(50) String(50) String(50) String(5) 备注 非必填 详见4.1返回结果 必填 18位个人医疗证号 非必填 25个汉字以内 非必填 1男2女0其他 详见4.23第1号字典 D504_05 D504_06 D504_07 D504_08 D603_02 D504_28 D504_48 D504_10 D504_21 D504_49 D504_50 D504_16 患者身份证号 年龄 家庭编号 医疗证卡号 年份 月份 登记属性 就诊类别 疾病代码 是否恶性肿瘤 入院诊断 入院科室 String(100) String(10) String(16) String(16) String(10) String(10) String(5) String(5) String(20) String(10) String(500) String(5) 非必填 支持18位与15位身份证 非必填 非必填 16位家庭医疗证号 非必填 卡证预留 非必填 年份必须4位 非必填 2位月份，填写01-12 必填 详见4.23第12号字典 非必填 详见4.23第25号字典 非必填 详见4.23第11号字典 非必填 0否1是 非1按0处理 必填 非必填 详见4.23第9号字典 要求填写代码 第 19 页 共 149 页

D504_17 出院科室 String(5) 非必填 详见4.23第9号字典 要求填写代码

D504_51 D504_52 D504_53 D504_11

登记床位 入院类型 押金金额 入院时间

String(50) String(10) String(20) String(19)

非必填

非必填 详见4.23第13号字典 非必填 保留2位小数要补齐两位 必填 yyyy-mm-ddT24-mi-ss，强制要

D504_12 D504_13 D101_02 D504_14 D504_15 D504_18 D504_19 D504_20 D504_55 D504_23 D504_56 D504_09 D504_57 D504_58 D504_59 D504_54 D504_60 D504_61 D504_62 D504_63 D504_64

出院时间 String(19) 实际住院天数 String(5) 就医机构名称 String(100) 就医机构代码 String(25) 就医机构级别 String(5) 经治医生 String(50) 入院状态 String(5) 出院状态 String(5) 症状名称 String(100) 手术名称代码 String(8) 担保金额 String(20) 住院号 String(200) 担保人 String(50) 登记人 String(50) 是否商业保险 String(5) HIS科室代码 String(20) HIS科室名称 String(100) 经办机构代码 String(20) 住院补偿流水号 String(20) 转外类型 String(5) 是否急诊

String(5)

第 20 页 共 149 页

非必填非必填 非必填 必填 非必填 非必填

非必填 非必填 非必填 非必填 非必填 必填 HIS非必填 25非必填 25非必填 0 非必填 非必填

非必填 非必填 必填 非必填 0求位数，需补齐

，强制要

求位数，需补齐

不允许为0

详见4.23第23号字典 详见4.23第23号字典 详见4.23第23号字典 详见4.23第10号字典 详见4.23第15号字典 详见4.23第11号字典 详见4.23第14号字典 只允许为数字，2位小数需补齐 住院号字段最长为200位 个汉字以内 个汉字以内 否 1 是 默认0 详见4.17返回结果 详见4.17返回结果 详见4.23第29号字典 否1是，默认为0

yyyy-mm-ddT24-mi-ssD504_65 D504_66 D504_67 D504_69 D504_68 账户名 银行卡号 转诊理由 转出医疗机构名称 String(50) String(20) String(500) String(100) 非必填 10个汉字以内 非必填 20个字符 非必填 非必填 详见4.1返回结果 非必填 详见4.1返回结果 转出医疗机构代String(20) 码 D504_70 登记日期 String(19) 非必填 yyyy-mm-dd，强制要求位数，需补齐 D504_22 D504_26 D504_27 D504_81 D504_80 D401_15 并发症 民政通知书号 生育证号 HIS疾病名称 HIS疾病代码 电话号码 String(10) String(40) String(40) String(100) String(20) String(20) 非必填 非必填 非必填 非必填 非必填 非必填 4.2.2 参数格式

参数 格式 版本号 功能编码 目标机构代码 转诊申请单号 个人编码 第 21 页 共 149 页

患者姓名 患者性别 患者身份证号 年龄 家庭编号 医疗证卡号 年份 月份 登记属性 就诊类别 疾病代码 是否恶性肿瘤 入院诊断 入院科室 出院科室 登记床位 入院类型 入院状态 银行卡号 担保金额 HIS科室代码 担保人 登记人 实际住院天数 就医机构名称 就医机构代码 就医机构级别 第 22 页 共 149 页

出院时间 住院补偿流水号 症状名称 手术名称代码 出院状态 押金金额 入院时间 住院号 是否商业保险 经治医生 HIS科室名称 经办机构代码 转外类型 是否急诊 账户名 转诊理由 转出医疗机构名称 转出医疗机构代码 登记日期 并发症 民政通知书号 生育证号 HIS疾病代码 HIS疾病名称 电话号码 第 23 页 共 149 页

4.2.3 返回结果

错误 成功 返回 格式 7位错误代码 成功代码+返回信息 < response xmlns=\ 返回代码 返回说明 住院登记流水号 4.3住院登记修改B020002 4.3.1 参数说明

参数 D504_47 D504_01 D504_02 D504_03 D504_04 说明 转诊申请单号 住院登记流水号 个人编码 患者姓名 患者性别 类型 String(50) String(50) String(18) String(50) String(5) 备注 非必填 详见4.1返回结果 必填 农合住院流水号 必填 18位个人医疗证号 必填 25个汉字以内 必填 1男2女0其他 详见4.23第1号字典 D504_05 D504_06 D504_07 D504_08 D603_02 患者身份证号 年龄 家庭编号 医疗证卡号 年份 String(100) 非必填 支持18位与15位身份证 String(10) String(16) String(16) String(10) 非必填 非必填 16位家庭医疗证号 非必填 卡证预留 非必填 4位年份 第 24 页 共 149 页

D504_28 D504_48 D504_10 D504_49 D504_21 D504_50 月份 登记属性 就诊类别 是否恶性肿瘤 疾病代码 入院诊断 String(10) String(5) String(5) String(10) String(20)

非必填 2位月份，填写01-12 必填 详见4.23第12号字典 非必填 详见4.23第25号字典 非必填 0否1是 非1按0处理 非必填 详见4.23第11号字典

String(500) 必填 D504_16

D504_17 D504_51 D504_52 D504_53 D504_11

D504_12 D504_13 D101_02 D504_14 D504_15 D504_18 D504_19 D504_20 D504_55 D504_23 D504_56 D504_09 D504_57

入院科室

String(5)

出院科室 String(5) 登记床位 String(50) 入院类型 String(10) 押金金额 String(20) 入院时间

String(19)

出院时间 String(19) 实际住院天数 String(5) 就医机构名称 String(100) 就医机构代码 String(25) 就医机构级别 String(5) 经治医生 String(50) 入院状态 String(5) 出院状态 String(5)

症状名称 String(100) 手术名称代码 String(8) 担保金额 String(20)

住院号 String(200) 担保人

String(50)

第 25 页 共 149 页

非必填 详见4.23第9号字典要求填写代码

非必填 详见4.23第9号字典要求填写代码

非必填

非必填 详见4.23第13号字典 非必填 保留2位小数要补齐两位 必填 yyyy-mm-ddT24-mi-ss，强

制要求位数，需补齐

非必填 yyyy-mm-ddT24-mi-ss，强

制要求位数，需补齐

非必填 不能为0

非必填 详见4.23第23号字典 必填 详见4.23第23号字典 非必填 详见4.23第23号字典 非必填

非必填 详见4.23第10号字典 非必填 详见4.23第15号字典

非必填 详见4.23第11号字典 非必填 详见4.23第14号字典 非必填 只能是数字

必填 HIS住院号字段最长为200位 非必填 25个汉字以内

D504_58 D504_59 D504_54 D504_60 D504_61 D504_62 D504_63 D504_64 D504_65 D504_66 D504_67 D504_69 登记人 是否商业保险 HIS科室代码 HIS科室名称 经办机构代码 住院补偿流水号 转外类型 是否急诊 账户名 银行卡号 转诊理由 String(50) String(5) String(20) 非必填 25个汉字以内 非必填 0 否 1 是 默认0 非必填 String(100) 非必填 String(20) String(20) String(5) String(5) String(50) String(20) 非必填 详见4.17返回结果 非必填 详见4.17返回结果 必填 详见4.23第29号字典 非必填 非必填 10个汉字以内 非必填 20个字符 String(500) 非必填 转出医疗机构名String(100) 非必填 详见4.1返回结果 称 D504_68 转出医疗机构代String(20) 码 非必填 详见4.1返回结果 D504_70 D504_22 D504_26 D504_27 D504_80 D504_81 D401_15 登记日期 并发症 民政通知书号 生育证号 HIS疾病代码 HIS疾病名称 电话号码 String(19) String(10) String(40) String(40) String(20) 非必填 yyyy-mm-dd，强制要求位数，需补齐 非必填 非必填 非必填 非必填 String(100) 非必填 String(20) 非必填 4.3.2 参数格式

参数 格式 版本号 功能编码 第 26 页 共 149 页

目标机构代码 转诊申请单号 住院登记流水号 个人编码 患者姓名 患者性别 患者身份证号 年龄 家庭编号 医疗证卡号 年份 月份 登记属性 就诊类别 是否恶性肿瘤 疾病代码 入院诊断 入院科室 出院科室 登记床位 入院类型 押金金额 第 27 页 共 149 页

入院时间 出院时间 实际住院天数 就医机构名称 就医机构代码 就医机构级别 经治医生 入院状态 出院状态 症状名称 手术名称代码 担保金额 住院号 担保人 登记人 是否商业保险 HIS科室代码 HIS科室名称 经办机构代码 住院补偿流水号 转外类型 是否急诊 账户名 银行卡号 转诊理由 转出医疗机构名称 转出医疗机构代码 登记日期 并发症 第 28 页 共 149 页

民政通知书号 生育证号 HIS疾病代码 HIS疾病名称 电话号码 4.3.3 返回结果

错误 成功 返回 格式 7位错误代码 成功代码+返回信息 返回代码 返回说明 4.4住院登记删除B020003 4.4.1 参数说明

参数 D504_01 说明 住院登记流水号 D504_02 D504_09 个人编码 住院号 String(18) String(200) 必填 18位个人医疗证号 必填 HIS住院号字段最长为200位 类型 String(50) 备注 必填 农合住院流水号 第 29 页 共 149 页

4.4.2 参数格式

参数 格式 版本号 功能编码 目标机构代码 住院登记流水号 个人编码 住院号 4.4.3 返回结果

错误 成功 返回 格式 7位错误代码 成功代码+返回信息 返回代码 返回说明

第 30 页 共 149 页

4.5在院情况查询C020003 4.5.1 参数说明

参数 D504_01 说明 住院登记流水号 D504_02 D504_09 D504_78 个人编码 住院号 起始登记日期 String(18) String(200) String(19) 非必填 18位个人医疗证号 非必填 HIS住院号字段最长为200位 非必填yyyy-mm-ddT24-mi-ss强制要求位数，需补齐 D504_79 终止登记日期 String(19) 非必填 yyyy-mm-ddT24-mi-ss强制要求位数，需补齐 D504_80 D504_81 HIS疾病代码 HIS疾病名称 String(20) String(100) 非必填 详见4.23第11号字典 非必填 详见4.23第11号字典 类型 String(50) 备注 非必填 农合住院流水号 4.5.2 参数格式

参数 格式 版本号 功能编码 目标机构代码 住院登记流水号 个人编码 住院号 第 31 页 共 149 页

起始登记日期 终止登记日期 HIS疾病代码 HIS疾病名称 4.5.3 返回结果

错误 成功 返回 格式 7位错误代码 成功代码+返回信息 返回代码 返回说明 转诊申请单号 住院登记流水号 患者身份证号 年份 个人编码 年龄 医疗证卡号 患者性别 患者姓名 家庭编号 月份 第 32 页 共 149 页

是否新生儿 依附人编码 依附人姓名 退出院原因 退出院人 退出院日期 登记属性 就诊类别 是否恶性肿瘤 疾病代码 入院诊断 入院科室 登记床位 入院类型 押金金额 入院时间 就医机构名称 就医机构代码 就医机构级别 经治医生 入院状态 症状名称 手术名称代码 < D504_56>担保金额 住院号 担保人 登记人 第 33 页 共 149 页

是否商业保险 HIS科室代码 HIS科室名称 经办机构代码 住院补偿流水号 转外类型 是否急诊 账户名 银行卡号 转诊理由 转出医疗机构名称 转出医疗机构代码 登记日期 并发症 民政通知书号 生育证号 疾病名称 HIS疾病代码 HIS疾病名称 4.6住院记账B020004 4.6.1 参数说明

参数 D504_09 说明 住院号 类型 String(200) 第 34 页 共 149 页

备注 必填 HIS住院号字段最长为200位

D505_04 D505_16 D505_06 D505_05 D505_07 D505_08 D505_10 D505_13 项目编码 项目名称 剂型 规格 单价(元) 数量 金额(元) 开单时间 String(20) String(500) String(20) String(20) String(10) String(10) String(10) String(19) 必填 医院项目编码 必填 医院项目名称 必填 非必填 必填 保留4位小数，要求补齐四位 必填 不能为0 必填 保留4位小数，要求补齐四位 必填 yyyy-mm-ddT24-mi-ss，强制要求位数，需补齐 D505_33 D505_34 D505_35 合作标识 转外医疗机构 标准项目编码 String(5) String(20) String(30) 非必填 0 本地（缺省值）1 转外 非必填 详见4.23第23号字典 必填 如此项存在请正确填写,如此项不存在需填写his+医院项目编码D505_04 D505_36 标准项目名称 String(500) 必填 如此项存在请正确填写,如此项不存在需填写his+医院项目名称D505_16 D505_31 D505_12 D505_01 D505_14 D505_09 D505_32 D505_37 包装 医生姓名 住院处方流水号 明细费用流水号 付数 财务分类 单位 String(30) String(50) String(50) String(20) String(10) String(5) String(30) 非必填 非必填 非必填 必填 非必填 必填 详见4.23第27号字典 非必填 4.6.2 参数格式

参数 格式 版本号 第 35 页 共 149 页

功能编码 目标机构代码 住院号 开单时间 合作标识 转外医疗机构 医生姓名

错误 成功 返回 格式 7位错误代码 成功代码+返回信息 返回代码 返回说明 说明：药品 西药 中成药 中草药 诊疗 材料

4.7住院记账查询C020004 4.7.1 参数说明

参数 D504_02 D504_09 说明 个人编码 住院号 类型 String(18) String(200) 第 39 页 共 149 页

备注 必填 18位个人医疗证号 必填 HIS住院号字段最长为200位

本文来源：https://www.bwwdw.com/article/73o.html