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

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

文档（V1.0）

一. 引言

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

1.1 编制目的

《湖南省新农合信息系统与医院HIS数据接口规范》是我省针对新农合信息系统与医院信息管理系统(HIS)接口的信息技术文档。本接口规范旨在于为各定点医疗机构提供一套定义明确的诊疗信息传输标准，以规范医院信息系统与新农合系统数据接口传输内容， 保证及时、准确地获取就诊患者的诊疗活动信息，以供补偿、统计、查询、分析、决策使用。 本规范以病人一次就诊事件发生的时间、地点及临床诊断、检查、治疗的主要过程和结果信息为描述内容，通过定义接口调用规范、接口数据传输格式、接口数据传输要求、信息传输内容、接口安全规范，从而实现医院信息系统的数据到新农合系统的有效交换。

1.2 读者对象

新农合系统技术开发人员

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

1.3 参考文献

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

1.4 术语与缩写解释

缩写、术语 HTTP Web Service XML SOAP

Web服务 可扩展标记语言（Extensible Markup Language） 简单对象访问协议 解 释 超文本传输协议（HTTP，HyperText Transfer Protocol) 二. 接口方案介绍

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

2.1 流程图解

省级农合平台数据交换县级农合平台县级定点县级定点病人病人补偿兑付住院门诊相关数据相关数据农合疾病药品及诊疗审核匹配县级非药品项目匹配数据回馈定点病人字典更新数据上传住院门诊数据Web Services (XML Over Http)预结算,结算补偿兑付等数据回馈住院门诊登记,划价退费,注销等数据传输审核匹配数据回馈药品及诊疗项目匹配数据上传农合疾病药品字典更新(HIS新增)住院/门诊农合业务管理需依据匹配数据上传数据(HIS新增)数据匹配管理 2.1.1 医院需配合的工作

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

Service改造医院的HIS系统，使其HIS系统能够满足新农合即付及补的业务要求。 2. 医院需要通过接口下载湖南省基本新农合标准目录，包括新农合疾病诊断目录、新

农合药品及诊疗项目目录，建立与医院相应目录内码与新农合标准目录对应的对照信息，称为匹配。

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

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

等。

2.2 Web 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，具体字段说明如下： 名称 loginName password centerCode 类型 String String String String 是否必须 是 是 否 否 描述 当前接口操作用户登录名 当前接口操作用户登录密码 当前医院所在统筹区农合中心编码（预留字段） 请求调用服务的版本号(默认为1.0) version 2.2.2.2 应用级输入参数

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

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

2.2.3 输出参说明

所有输出参数均继承自WSResult。 WSResult 类型定义如下： 名称 resultCode message 类型 String String 描述 处理结果代码：0表示成功，其它表示失败 处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息。 三. 接口设计 3.1 服务定义 3.1.1 基本部分

HIS字典匹配是HIS系统和农合系统数据传输的基础，在HIS和农合实现业务对接前，必须先完成字典匹配工作，确保HIS字典与农合系统字典数据的正确转换。 注：数据匹配标化是一个长期的、动态的过程。 1)

药品诊疗字典下载

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

疾病字典下载

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

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

治疗方式字典下载

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

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

补偿类型字典下载