附件四
定点医疗机构的HIS系统与省级平台的接口参考手册（V1.0）
河南省卫生厅
二0一0年七月二十日
目录
1. 引言 (4)
1.1. 文档编制目的 (4)
1.2. 读者对象 (4)
1.3. 参考文献 (4)
1.4. 术语与缩写解释 (4)
2. 接口设计 (5)
2.1. 接口方式 (5)
2.2. 接口定义 (5)
2.3. 调用流程 (7)
2.4. 标准字典目录规范 (8)
3. 接口方法明细 (8)
3.1. 基础应用类 (8)
3.1.1. 接口初始化 (8)
3.1.2. 药品、诊疗项目关联信息上报 (9)
3.2. 业务处理类 (10)
3.2.1. 就诊登记 (10)
3.2.2. 登记信息修改 (11)
3.2.3. 登记信息撤销 (13)
3.2.4. 处方明细上报 (14)
3.2.5. 处方明细撤销 (15)
3.2.6. 预结算 (16)
3.2.7. 出院登记 (18)
3.2.8. 正式结算 (19)
3.2.9. 结算撤销 (23)
3.2.10. 获取转诊患者信息 (24)
4. 查询下载 (25)
4.1. 字典数据 (26)
4.2. 上传处方明细查询 (26)
4.3. 结算明细/汇总信息查询 (26)
4.4. 打印补偿凭证 (26)
5. 附字典目录 (26)
5.1. 项目类型 (26)
5.2. 项目类别 (27)
5.3. S101-01性别代码 (27)
5.4. S101-02婚姻状况代码 (28)
5.5. S101-03民族代码 (28)
5.6. S101-04地区代码 (30)
5.7. S101-05健康状况代码 (30)
5.8. S101-06家庭关系代码 (31)
5.9. S101-07 职业分类代码 (32)
5.10. S101-08 专业技术职务代码 (32)
5.11. S101-09 行政职务代码 (33)
5.12. S101-10 户属性代码 (33)
5.13. S101-11迁移标志代码 (33)
5.14. S201-01 卫生机构代码（编码说明） (34)
5.15. S201-02机构隶属关系代码 (34)
5.16. S201-03 机构经济类型代码 (35)
5.17. S201-04诊疗科室代码 (35)
5.18. S201-05 机构类别代码 (40)
5.19. S201-06 定点医疗机构类型代码 (42)
5.20. S201-07资助部门类型代码 (43)
5.21. S201-08医疗机构级别代码 (43)
5.22. S301-01 疾病分类代码 (43)
5.23. S301-02 入院状态代码 (43)
5.24. S301-03 出院状态代码 (44)
5.25. S301-04 医疗服务项目代码（使用《全国医疗服务价格项目规范》） (44)
5.26. S301-05 就诊类型代码 (44)
5.27. S301-06 补偿类别代码 (44)
5.28. S301-07 参合属性代码 (45)
5.29. S301-09 补偿帐户类别代码 (45)
5.30. S401-01 基本药品代码（见国家基本药物目录） (45)
5.31. S701-01 是否标识代码 (46)
1.引言
1.1. 文档编制目的
实现全省各市、县(区)参合转诊患者到省市定点医疗机构的就诊管理，并实现补偿费用现场减免结算。本文档详细表述了基于河南省新型合作医疗省级平台实现省市定点医疗机构即时结算报销的接口设计。
1.2. 读者对象
省市定点医疗机构信息系统（HIS）技术开发人员
新农合即时结算报销系统接口实施人员
1.3. 参考文献
[1]《新型农村合作医疗信息系统基本规范（2008年修订版）》,卫生部，2008
[2]《河南省新型农村合作医疗统筹补偿方案（2010年版）》，河南省卫生厅，2010
[3]《河南省新型农村合作医疗省级平台技术方案》，北京蓝海联盟科技有限公司，2009
1.4. 术语与缩写解释
缩写、术语解释
新农合“新型农村合作医疗”的简称
省级平台“新型农村合作医疗省级信息平台”的简称
HIS “医院信息系统”的英文缩写
定点机构“新农合省市定点医疗机构”的简称
…
2.接口设计
2.1. 接口方式
为了实现各市、县(区)参合患者在省市定点医疗机构的即时结报工作，由卫生厅组织制订和下发全省统一标准字典目录、数据接口服务，供定点医疗机构HIS系统调用。
本系统提供给定点机构的是基于http协议的WebService接口服务，定点机构系统可通过调用此接口服务完成参合患者就诊、结算时的数据交互工作。
2.2. 接口定义
省级平台提供的WebService函数统一命名为：funMain。
输入和返回值均为字符串。
如：String funMain(String in)
输入参数：
输入参数为符合xml文件格式规范的字符串信息，内容示例如下：
……
返回值：
返回值为符合xml文件格式规范的字符串信息，内容示例如下：
部分函数有xml示例，示例只说明字符串信息样式，传输字段名以文档中规范为准。
注意事项：
1.xml格式信息中的encoding字段的值必须是UTF-8；
2.根节点必须是businessdata；
3.数据项的值如果为空，也必须有数据项，只是内容为空，如
4.如果存在多条记录，用标签指明范围，用
区分（id值需要加双引号括起）；
字段约定：
1.字段名为英文字母d（或t）+“数字”+“_”+两位序号开头字段均为卫生
部《新型农村合作医疗信息系统基本规范（2008年修订版）》规定数据编码。
2.字段名为英文字母i+交易编码后3位+“_”+两位序号开头字段为本接口规
范定义输入参数数据编码。
3.字段名为英文字母e+交易编码后3位+“_”+两位序号开头字段为本接口规
范定义返回值参数数据编码。
4.字段名英文字母全部为小写字母。
5.接口函数通用的返回值字段，采用统一定义字段名，分别为：
a)执行状态：state；
b)执行结果：r esult；
6.字段信息中“是否为空”栏目：Y 字段可以为空；N 字段不允许为空；
7.字段信息中“数据规范及说明”中如果有值，传递参数和获取参数时，值为
所标明字典目录值或所说明的规定格式。
开放函数列表：
序号交易编码功能简介交易性质
1100101 接口初始化基础应用2100102 药品、诊疗项目对照信息上报基础应用3100201 就诊登记业务4100202 登记信息修改业务5100203 登记信息撤销业务6100204 处方明细上报业务
7100205 处方明细撤销业务8100206 预结算业务9100207 出院登记业务10100208 正式结算业务11100209 结算撤销业务12100212 获取转诊患者信息业务
2.3. 调用流程
1．在开始启用之前，先与全省统一的“药品目录”、“诊疗目录”、“费用类别目录”、“标准科室目录”、“河南省行政区划代码”、“疾病诊断代码”与院内目录进行对照。对照完毕后，通过“药品、诊疗项目关联信息上报”函数，上送省级平台。
2．日常可以通过调用“接口初始化”函数，了解与省级平台之间通信状况信息。
3．在参合患者就医登记时，先通过“获取转诊患者信息”函数，判断是否为参合患者以及是否办理转诊手续，如果是参合农民并办理了转诊手续，通过“就诊登记”函数对参合患者进行入院登记。
4．病人在院期间发生的就诊记录，通过调用“处方明细上报”函数，实时传送到新农合省级平台。
5．在患者需要续交押金或需要了解患者在院补偿信息的时候，可以调用“预结算”函数，将全部已发生就诊记录信息传送到新农合省级平台，由所在县（区）合管办进行计算后，反馈可补偿信息。
6．患者办理出院手续的时候，调用“出院登记”函数，将患者出院信息上传。
7．患者办理出院结算的时候，调用“正式结算”函数，将患者入出院信息以及就诊详细记录一次性打包通过省级平台传递给所在县（区）业务系统进行补偿结算，并反馈医疗机构补偿结算结果以及补偿比例等信息。
注：在患者进行出院结算前，在院的就诊信息可以通过对应修改、撤消函数进行操作，结算后不能修改就诊记录。
2.4. 标准字典目录规范
为保证各定点机构传输数据与新农合省级平台的一致性，要求各定点机构药品、诊疗、科室、费用类别等字典目录要与省级平台标准目录对照对应关系。各定点医疗机构可通过省级平台开放的门户网站下载标准字典目录。
3.接口方法明细
3.1. 基础应用类
3.1.1.接口初始化
功能说明:
该接口用于检查接口运行环境：包括运行所需网络、参数等的检查。在调用接口交易方法前必须初始化连接，建议在接口程序登录时调用。
输入信息说明：
XML格式示例：in100101.xml
参数说明；
序号名称字段名长度
是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
输出信息说明：
XML格式示例：out100101.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3 定点机构名称d101_01_n (60) N
3.1.2.药品、诊疗项目关联信息上报
功能说明:
该接口方法主要实现定点机构药品、诊疗字典关联信息上报。
输入信息说明：
XML格式示例：in100102.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 项目类型i102_01 (4) N 0 药品 1 诊疗
3 费用类别i102_02 (4) Y
4 中心项目编码i102_03 (20) N
S301-04或
S501-01
5 中心项目名称i102_04 (80) N
6 医院项目编码i102_05 (20) N
7 医院项目名称i102_06 (80) N
8 医院项目剂型i102_07 (20) Y
9 医院项目规格i102_08 (40) Y
10 医院项目单位i102_09 (10) Y
11 医院项目价格i102_10 (15) Y
12 经办人i102_11 (20) Y
输出信息说明：
XML格式示例：out100102.xml 参数说明：
序号名称字段名长度是否
为空
数据规范及说
明
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2. 业务处理类
该类方法主要完成参合患者就诊登记、处方上报、预结算、正式结算等业务处理功能。
3.2.1.就诊登记
输入信息说明：
XML格式示例：in100201.xml
参数说明：
序号名称字段名长度是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 住院流水号t104_01 (20) N 本次住院唯一标识
3 个人编码t104_02 (20) N
4 患者姓名t104_03 (20) N
5 患者性别t104_04 (1) N s101-01
6 患者身份证号t104_05 (18) Y
7 年龄t104_06 （3）N
8 家庭编号t104_07 (20) N
9 医疗证卡号t104_08 (18) N
10 住院号t104_09 (20) N
11 就诊类型t104_10 (10) N s301-05
12 入院时间t104_11 (16) N YYYYMMDDHH24MI
13 入院科室编码t104_16 (4) N S201-04
14 入院科室名称t104_16_n (60) N
15 入院状态t104_19 (1) N s301-02
16 入院疾病诊断代码t104_21 (15) N s301-01
17 并发症t104_22 (15) Y
18 所属地区代码d401_19 (6) N S101-04
19 病区i201_01 (20) Y
20 病房号i201_02 (20) Y
21 床位号i201_03 (20) Y
22 病历信息i201_04 (100) Y
23 经办人i201_05 (20) N
输出信息说明：
XML格式示例：out100201.xml
参数说明：
是否
序号名称字段名长度
数据规范及说明
为空
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2.2.登记信息修改
说明：
登记信息修改时，不需要修改字段填写原来内容。
输入信息说明：
XML格式示例：in100202.xml 参数说明：
序号名称字段名长度是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 住院流水号t104_01 (20) N 本次住院唯一标识
3 个人编码t104_02 (20) N
4 患者姓名t104_03 (20) N
5 患者性别t104_04 (1) N s101-01
6 患者身份证号t104_05 (18) Y
7 年龄t104_06 （3）N
8 家庭编号t104_07 (20) N
9 医疗证卡号t104_08 (18) N
10 住院号t104_09 (20) N
11 就诊类型t104_10 (10) N s301-05
12 入院时间t104_11 (16) N YYYYMMDDHH24MI
13 入院科室编码t104_16 (4) N S201-04
14 入院科室名称t104_16_n (60) N
15 入院状态t104_19 (1) N s301-02
16 入院疾病诊断代码t104_21 (15) N s301-01
17 并发症t104_22 (15) Y
18 所属地区代码d401_19 (6) N S101-04
19 病区i202_01 (20) Y
20 病房号i202_02 (20) Y
21 床位号i202_03 (20) Y
22 病历信息i202_04 (100) Y
23 经办人i202_05 (20) N
输出信息说明：
XML格式示例：out100202.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2.3.登记信息撤销
说明：
调用登记信息撤销，系统将自动清除已上传明细。
输入信息说明：
XML格式示例：in100203.xml
参数说明：
序号名称字段名长度是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 住院流水号t104_01 (20) N 本次住院唯一标识
3 所属地区代码d401_19 (6) N S101-04
4 经办人i203_01 (20) N
输出信息说明：
XML格式示例：out100203.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2.
4.处方明细上报
输入信息说明：
XML格式示例：in100204.xml
参数说明：
序号名称字段名长度是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 所属地区代码d401_19 (6) N S101-04
3 处方流水号t105_01 (20) N 本次处方唯一标识
4 住院流水号t105_02 (20) N 本次住院唯一标识
5 项目类别t105_03 (10) N 中心项目类别
6 明细中心编码t105_04 (20) N S301-04
7 项目规格t105_05 (30) Y
8 单价t105_07 (14) N 4位小数
9 数量t105_08 (10) N
2位小数，退费时为
负数
10 总价t105_10 (14) N
2位小数，退费时为
负数
11 处方医师姓名t105_12 (20) Y
12 经办人t105_15 (20) Y
13 日期（记费日）t105_17 (16) N YYYYMMDDHH24MI
14 明细院内名称i204_01 (80) N
15 明细院内编码i204_02 (20) N
16 项目单位i204_03 (10) N
17 项目类型i204_04 (16) N 0 药品 1 诊疗输出信息说明：
XML格式示例：out100204.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2.5.处方明细撤销
输入信息说明：
XML格式示例：in100205.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 住院流水号t104_01 (20) N 本次住院唯一标识
3 所属地区代码d401_19 (6) N S101-04
4 经办人i205_01 (20) N
输出信息说明：
XML格式示例：out100205.xml
参数说明：
序号名称字段名长度是否数据规范及说明
为空
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2.6.预结算
说明：
在患者住院过程中，需要了解患者当前住院费用中可补偿部分时，可以调用此方法，各市、县（区）业务系统可以根据传递的就诊明细进行计算，但不用保存就诊明细信息。
输入信息说明：
XML格式示例：in100206.xml
参数说明：
1、就诊登记信息：
序号名称字段名长度
是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 住院流水号t104_01 (20) N 本次住院唯一标识
3 个人编码t104_02 (20) N
4 患者姓名t104_03 (20) N
6 患者身份证号t104_05 (18) Y
7 家庭编号t104_07 (20) N
8 医疗证卡号t104_08 (18) N
9 住院号t104_09 (20) N
10 就诊类型t104_10 (10) N s301-05
11 入院时间t104_11 (16) N YYYYMMDDHH24MI
12 所属地区代码d401_19 (6) N S101-04
13 经办人i206_01 (20) N
2、处方明细信息：
是否
序号名称字段名长度
数据规范及说明
为空
1 处方流水号t105_01 (20) N 本次处方唯一标识
2 住院流水号t105_02 (20) N 本次住院唯一标识
3 项目类别t105_03 (10) N 中心项目类别
4 明细中心编码t105_04 (20) N S301-04
5 项目规格t105_05 (30) Y
6 单价t105_0
7 (14) N 4位小数
2位小数，退费时为7 数量t105_08 (10) N
负数
2位小数，退费时为8 总价t105_10 (14) N
负数
9 处方医师姓名t105_12 (20) Y
10 经办人t105_15 (20) Y
11 日期（记费日）t105_17 (16) N YYYYMMDDHH24MI
12 明细医院名称i206_01 (80) N
13 明细医院编码i206_02 (20) N
14 项目单位i206_03 (10) N
15 项目类型i206_04 (16) N 0 药品 1 诊疗
输出信息说明：
XML格式示例：out100206.xml
参数说明：
是否
数据规范及说明序号名称字段名长度
为空
1 执行状态state (2) N 0 成功 -1 失败
2 执行结果result (100) N
3 住院医药费e206_01 (20) N
4 可补偿住院医药费e206_02 (20) N
其中：
e206_03 (14) Y 2位小数5
可补偿床位费（元）
6 可补偿住院护理费（元）e206_04 (14) Y 2位小数
7 可补偿住院西药费（元）e206_05 (14) Y 2位小数
8 可补偿住院中药费（元）e206_06 (14)Y 2位小数
9 可补偿住院化验费（元）e206_07 (14)Y 2位小数
10 可补偿住院诊疗费（元）e206_08 (14)Y 2位小数
11 可补偿住院手术费（元）e206_09 (14)Y 2位小数
12 可补偿住院检查费（元）e206_10 (14)Y 2位小数
13 可补偿其他住院费用（元）e206_11 (14)Y 2位小数
14 实际补偿金额e206_12 (20) N
15 起付标准e206_13 (20) N
16 本参合年度累计补偿金额e206_14 (20) N
17 住院流水号e206_15 (20) Y
0 未达到 1 达到18 累计补偿是否达到封顶线e206_16 (1) N
封顶线
19 补偿日期e206_17 (8) N YYYYMMDD
20 经办人e206_18 (20) N
3.2.7.出院登记
输入信息说明：
XML格式示例：in100207.xml
参数说明：
序号名称字段名长度是否数据规范及说明
为空
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 所属地区代码d401_19 (6) N S101-04
3 住院流水号t104_01 (20) N 本次住院唯一标识
4 出院时间t104_12 (16) N YYYYMMDDHH24MI
5 实际住院天数t104_13 (3) Y
6 出院状态t104_20 (1) N s301-03
7 出院疾病诊断代码t104_21 (15) N s301-01
8 手术名称代码t104_23 (12) Y s301-08
9 经办人t104_30 (20) N
10 出院诊断疾病名称i207_05 (40) N 医院诊断名称
11 出院科室编码i207_06 (4) N S201-04
12 出院科室名称i207_07 (20) N 医院科室名称
输出信息说明：
XML格式示例：out100207.xml
参数说明：
序号名称字段名长度
是否
为空
数据规范及说明
1 执行状态state (2) N 0成功 -1失败
2 执行结果result (100) N
3.2.8.正式结算
说明：
在进行正式结算时，将患者在院信息和就诊处方明细信息一次性打包上传。各市、县（区）业务系统保存就诊记录，并返回计算结果。
输入信息说明：
XML格式示例：in100208.xml
参数说明：
1、就诊登记信息：
序号名称字段名长度
是否
为空
数据规范及说明
1 定点机构代码d101_01 (22) N S201-01(WS218-20 02)，卫生厅统一编
码
2 所属地区代码d401_19 (6) N S101-04
3 住院流水号t104_01 (20) N 本次住院唯一标识
4 个人编码t104_02 (20) N
5 患者姓名t104_03 (20) N
6 患者性别t104_04 (1) N s101-01
7 患者身份证号t104_05 (18) Y
8 患者年龄t104_06 （3）N
9 家庭编号t104_07 (20) N
10 医疗证卡号t104_08 (18) N
11 住院号t104_09 (20) N
12 就诊类型t104_10 (10) N s301-05
13 入院时间t104_11 (16) N YYYYMMDDHH24MI
14 出院时间t104_12 (16) N YYYYMMDDHH24MI
15 实际住院天数t104_13 (3) N
16 入院科室编码t104_16 (4) N S201-04
17 入院科室名称t104_16_n (60) N 医院科室名称
18 出院科室编码t104_17 (4) N S201-04
19 出院科室名称t104_17_n (60) N 医院科室名称
20 经治医生姓名t104_18 (20) N
21 入院状态t104_19 (1) N s301-02