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

湖南省新农合信息系统与医院信息管理系统互联接口开发文档V1.0） 引言 本接口规范适用于省级定点医院和省级平台对接，市级定点医院和虚拟市级平台对接，区/县/乡镇级定点医院和区县农合业务系统对接。 编制目的 《湖南省新农合信息系统与医院HIS数据接口规范》是我省针对新农合信息系统与医院信息管理系统(HIS接口的信息技术文档。本接口规范旨在于为各定点医疗机构提供一套定义明确的诊疗信息传输标准，以规范医院信息系统与新农合系统数据接口传输内容， 保证及时、准确地获取就诊患者的诊疗活动信息，以供补偿、统计、查询、分析、决策使用。 本规范以病人一次就诊事件发生的时间、地点及临床诊断、检查、治疗的主要过程和结果信息为描述内容，通过定义接口调用规范、接口数据传输格式、接口数据传输要求、信息传输内容、接口安全规范，从而实现医院信息系统的数据到新农合系统的有效交换。 读者对象 新农合系统技术开发人员 定点医疗机构信息系统HIS）技术开发人员 HIS实施人员 参考文献 《新型农村合作医疗管理信息系统基本规范(2008年修订版》(卫办农卫发[2008]127号附件 术语与缩写解释 缩写、术语 解 释 HTTP 超文本传输协议HTTP，HyperText Transfer Protocol Web Service Web服务 XML 可扩展标记语言Extensible Markup Language） SOAP 简单对象访问协议 接口方案介绍 本接口方案实现使用典型的基于SOAP的Web服务，以操作为中心，通过HTTP协议实现调用，每个操作接受 XML 文档作为输入，提供 XML 文档作为输出。 流程图解 医院需配合的工作 医院需要根据新农合政策的需要，按照湖南省新农合信息系统所提供的Web Service改造医院的HIS系统，使其HIS系统能够满足新农合即付及补的业务要求。 医院需要通过接口下载湖南省基本新农合标准目录，包括新农合疾病诊断目录、新农合药品及诊疗项目目录，建立与医院相应目录内码与新农合标准目录对应的对照信息，称为匹配。 对于自费药品，可以匹配成保外费用。 此标准跨操作系统,支持各种开发语言,如Java、.NET、VB、Delphi、PB、C++、C等。 Web Service调用说明 参数类型说明 为了方便调用，所有入参对象和出参对象中的属性的数据类型均为字符串类型，根据不同的数据类型如数字、日期、时间等）格式说明如下： 数字格式：必须是0-9的数字组成，前面可以带+号，-号，小数点. 等符号字节，如无特别申明一般保留2位小数，不能是表达式，类型名定义为：Number。 日期格式：必须是yyyy-MM-dd (年4位，月2位，日2位的字符串，类型名定义为：Date。 时间格式：必须是yyyy-MM-dd HH:mm:ss (年4位，月、日、时、分、秒均2位，小时格式为24小时制的字符串，类型名定义为：Datetime。 字符格式：指定长度的字符串，类型名定义为：String。 列表格式：类型后带“[]”表示列表/数组，如字符串数组用“String[]”表示。 输入参说明 输入参数包括系统级输入参数和应用级输入参数。 系统级输入参数 每个功能服务的第一个参数为系统级输入参数(System-level?input parameters，包含服务调用的公用参数，用于服务安全认证和服务版本控制等。 类型名定义为：WSUser，具体字段说明如下： 名称 类型 是否必须 描述 loginName String 是 当前接口操作用户登录名 password String 是 当前接口操作用户登录密码 centerCode String 否 当前医院所在统筹区农合中心编码预留字段） version String 否 请求调用服务的版本号(默认为1.0 应用级输入参数 进行具体的服务调用是，传入的系统级参数之外的参数，用于控制具体的业务服务获取，具体定义参看相应的服务功能说明。 输出参说明 所有输出参数均继承自WSResult。 WSResult 类型定义如下： 名称 类型 描述 resultCode String 处理结果代码：0表示成功，其它表示失败 message String 处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息。 接口设计 服务定义 基本部分 HIS字典匹配是HIS系统和农合系统数据传输的基础，在HIS和农合实现业务对接前，必须先完成字典匹配工作，确保HIS字典与农合系统字典数据的正确转换。 注：数据匹配标化是一个长期的、动态的过程。 药品诊疗字典下载 通过接口函数getStdDrug下载农合标准药品诊疗字典，由专人完成医院药品诊疗目录字典和农合药品诊疗目录字典的匹配工作，并做好校对。 疾病字典下载 通过接口函数ge