湖南省新农合信息系统与医院信息管理系统互联接口开发文档

湖南省新农合信息系统与医院信息管理系统互联接口开发

文档（V1.0）

一.引言

本接口规范适用于省级定点医院和省级平台对接，市级定点医院和虚拟市级平台对接，区/县/乡镇级定点医院和区县农合业务系统对接。

1.1编制目的

《湖南省新农合信息系统与医院HIS数据接口规范》是我省针对新农合信息系统与医院信息管理系统(HIS)接口的信息技术文档。本接口规范旨在于为各定点医疗机构提供一套定义明确的诊疗信息传输标准，以规范医院信息系统与新农合系统数据接口传输内容，保证及时、准确地获取就诊患者的诊疗活动信息，以供补偿、统计、查询、分析、决策使用。

本规范以病人一次就诊事件发生的时间、地点及临床诊断、检查、治疗的主要过程和结果信息为描述内容，通过定义接口调用规范、接口数据传输格式、接口数据传输要求、信息传输内容、接口安全规范，从而实现医院信息系统的数据到新农合系统的有效交换。

1.2读者对象

新农合系统技术开发人员

定点医疗机构信息系统（HIS）技术开发人员

HIS实施人员

1.3参考文献

《新型农村合作医疗管理信息系统基本规范(2008年修订版)》(卫办农卫发[2008]127号附件)

1.4术语与缩写解释

二.接口方案介绍

本接口方案实现使用典型的基于SOAP的Web服务，以操作为中心，通过HTTP协议实现调用，每个操作接受XML 文档作为输入，提供XML 文档作为输出。

2.1流程图解

2.1.1医院需配合的工作

1.医院需要根据新农合政策的需要，按照湖南省新农合信息系统所提供的Web

Service改造医院的HIS系统，使其HIS系统能够满足新农合即付及补的业务要求。

2.医院需要通过接口下载湖南省基本新农合标准目录，包括新农合疾病诊断目录、新

农合药品及诊疗项目目录，建立与医院相应目录内码与新农合标准目录对应的对照

信息，称为匹配。

3.对于自费药品，可以匹配成保外费用。

4.此标准跨操作系统,支持各种开发语言,如Java、.NET、VB、Delphi、PB、C++、C

等。

2.2Web Service调用说明

2.2.1参数类型说明

为了方便调用，所有入参对象和出参对象中的属性的数据类型均为字符串类型，根据不同的数据类型（如数字、日期、时间等）格式说明如下：

1.数字格式：必须是0-9的数字组成，前面可以带+号，-号，小数点. 等符号字节，

如无特别申明一般保留2位小数，不能是表达式，类型名定义为：Number。

2.日期格式：必须是yyyy-MM-dd (年4位，月2位，日2位)的字符串，类型名定义

为：Date。

3.时间格式：必须是yyyy-MM-dd HH:mm:ss (年4位，月、日、时、分、秒均2位，

小时格式为24小时制)的字符串，类型名定义为：Datetime。

4.字符格式：指定长度的字符串，类型名定义为：String。

5.列表格式：类型后带“[]”表示列表/数组，如字符串数组用“String[]”表示。

2.2.2输入参说明

输入参数包括系统级输入参数和应用级输入参数。

2.2.2.1系统级输入参数

每个功能服务的第一个参数为系统级输入参数(System-level input parameters)，包含服务调用的公用参数，用于服务安全认证和服务版本控制等。

类型名定义为：WSUser，具体字段说明如下：

2.2.2.2应用级输入参数

进行具体的服务调用是，传入的系统级参数之外的参数，用于控制具体的业务服务获取，

具体定义参看相应的服务功能说明。

2.2.3输出参说明

所有输出参数均继承自WSResult。

WSResult 类型定义如下：

三.接口设计

3.1服务定义

3.1.1基本部分

HIS字典匹配是HIS系统和农合系统数据传输的基础，在HIS和农合实现业务对接前，必须先完成字典匹配工作，确保HIS字典与农合系统字典数据的正确转换。

注：数据匹配标化是一个长期的、动态的过程。

1)药品诊疗字典下载

通过接口函数getStdDrug下载农合标准药品诊疗字典，由专人完成医院药品诊疗目录字典和农合药品诊疗目录字典的匹配工作，并做好校对。

2)疾病字典下载

通过接口函数getStdDisease下载农合标准疾病字典，由专人完成医院疾病字典和农合疾病字典的匹配工作，并做好校对。

注：关于疾病字典的处理，建议HIS改造为住院登记时直接选择农合疾病。

3)治疗方式字典下载

通过接口函数treatmentModeUpdate下载省厅统一规定的治疗方式。

治疗方式主要是针对省定大病特殊政策而实现的，省厅根据各区县治疗方式统一定义适用全省新农合补偿的治疗方式集，HIS需根据所属医疗机构获取适用于该机构的治疗方式，建议HIS每周至少更新获取一次，并且提供手动更新获取方式。

4)补偿类型字典下载

通过接口函数redeemTypeDownload下载省厅统一规定的补偿类型。

建议HIS每周至少更新获取一次，并且提供手动更新获取方式。

5)病人信息获取

通过接口函数getFamilyMember获取指定医疗证卡号（身份证号，健康卡号）对应的家庭有效参合人员基本信息。

6)医疗机构信息获取

通过接口函数getHospitalInfo获取指定名称的医疗机构基本信息。

7)药品诊疗匹配关系上传

通过接口函数uploadDrugMatch上传HIS药品诊疗和省标药品诊疗匹配关系。

8)药品诊疗匹配关系下载

通过接口函数getDrugMatch下载医疗机构已上传匹配关系审核状态和可报比例等信息。

3.1.2住院部分

1)住院登记

在完成查询农合病人相关信息的基础上，通过接口函数inpatientRegister完成新农合参保患者农合住院登记。

2)住院登记查询

通过接口函数inpatientRegisterSeek传入的HIS住院登记号，农合患者个人编码查询该患者在当前医疗机构就诊的住院登记信息。

1.本服务主要用于inpatientRegister农合系统执行成功，HIS应网络等原因没有收

到执行结果时使用。

2.如果因网络或其它原因导致农合执行服务inpatientRegister成功，而HIS没有

收到返回，或HIS对成功的方法没有正确处理，可通过服务inpatientRegisterSeek

查询住院登记农合执行结果并同步HIS系统中的数据状态。

3)住院登记修改

通过接口函数inpatientUpdate修改未出院的住院就诊登记信息。

4)取消住院登记

通过接口函数cancelInpatientRegister取消住院登记，即对住院就诊信息处于‘在