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

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

《湖南省新农合信息系统与医院信息管理系统互联接口开发文档.docx》由会员分享，可在线阅读，更多相关《湖南省新农合信息系统与医院信息管理系统互联接口开发文档.docx（77页珍藏版）》请在冰豆网上搜索。

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

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

0）

一.引言

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

一.1编制目的

《湖南省新农合信息系统与医院HIS数据接口规范》是我省针对新农合信息系统与医院信息管理系统（HIS）接口的信息技术文档。

本接口规范旨在于为各定点医疗机构提供一套定义明确的诊疗信息传输标准，以规范医院信息系统与新农合系统数据接口传输内容，保证及时、准确地获取就诊患者的诊疗活动信息，以供补偿、统计、查询、分析、决策使用.

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

一.2读者对象

新农合系统技术开发人员

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

HIS实施人员

一.3参考文献

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

一.4术语与缩写解释

缩写、术语

解释

HTTP

超文本传输协议（HTTP，HyperTextTransferProtocol）

WebService

Web服务

XML

可扩展标记语言（ExtensibleMarkupLanguage）

SOAP

简单对象访问协议

二.接口方案介绍

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

二.1流程图解

二.1.1医院需配合的工作

1.医院需要根据新农合政策的需要,按照湖南省新农合信息系统所提供的WebService改造医院的HIS系统，使其HIS系统能够满足新农合即付及补的业务要求。

2.医院需要通过接口下载湖南省基本新农合标准目录，包括新农合疾病诊断目录、新农合药品及诊疗项目目录,建立与医院相应目录内码与新农合标准目录对应的对照信息，称为匹配。

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

4.此标准跨操作系统，支持各种开发语言,如Java、。

NET、VB、Delphi、PB、C++、C等.

二.2WebService调用说明

二.2.1参数类型说明

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

1.数字格式：

必须是0-9的数字组成,前面可以带+号，—号,小数点.等符号字节，如无特别申明一般保留2位小数，不能是表达式,类型名定义为：

Number。

2.日期格式：

必须是yyyy-MM-dd（年4位，月2位，日2位）的字符串，类型名定义为：

Date.

3.时间格式：

必须是yyyy—MM—ddHH：

mm：

ss（年4位，月、日、时、分、秒均2位,小时格式为24小时制）的字符串，类型名定义为：

Datetime.

4.字符格式：

指定长度的字符串，类型名定义为：

String。

5.列表格式：

类型后带“［］”表示列表/数组，如字符串数组用“String［］”表示。

二.2.2输入参说明

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

二.2.2.1系统级输入参数

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

类型名定义为:

WSUser,具体字段说明如下：

名称

类型

是否必须

描述

loginName

String

是

当前接口操作用户登录名

password

String

是

当前接口操作用户登录密码

centerCode

String

否

当前医院所在统筹区农合中心编码（预留字段）

version

String

否

请求调用服务的版本号（默认为1.0）

二.2.2.2应用级输入参数

进行具体的服务调用是,传入的系统级参数之外的参数，用于控制具体的业务服务获取，具体定义参看相应的服务功能说明。

二.2.3输出参说明

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

WSResult类型定义如下:

名称

类型

描述

resultCode

String

处理结果代码:

0表示成功,其它表示失败

message

String

处理结果描述，当处理结果代码不为0时,该值提供详细的失败描述信息.

三.接口设计

三.1服务定义

三.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下载医疗机构已上传匹配关系审核状态和可报比例等信息。

三.1.2住院部分

1）住院登记

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

2）住院登记查询

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

1.本服务主要用于inpatientRegister农合系统执行成功,HIS应网络等原因没有收到执行结果时使用。

2.如果因网络或其它原因导致农合执行服务inpatientRegister成功,而HIS没有收到返回，或HIS对成功的方法没有正确处理，可通过服务inpatientRegisterSeek查询住院登记农合执行结果并同步HIS系统中的数据状态。

3）住院登记修改

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

4）取消住院登记

通过接口函数cancelInpatientRegister取消住院登记,即对住院就诊信息处于‘在院’或‘出院’状态的就诊信息和医嘱明细进行作废处理.

5）住院诊疗明细上传

在住院登记成功的基础上，可以通过调用接口函数uploadInpatientDetails进行住院明细批量上传。

1.对于错误的明细上传可以通过调用接口函数uploadInpatientDetails上传负费用（数量为负数,单价不变，注：

总金额等于单价乘以数量）进行抵消。

6）住院结算（出院）

HIS出院登记时同时调用接口函数leaveInpatientRegister完成农合患者出院结算.即将住院就诊信息业务状态修改为出院状态.

1.建议在农合住院结算前先调用住院补偿试算接口函数inpatientCalculate校对总费用.

7）取消出院登记

通过调用接口函数cancelLeaveInpatientRegister对已出院但未进入补偿流程的住院就诊信息进行取消出院操作，即将住院就诊信息业务状态变为在院状态.

8）住院补偿

在正确完成了出院结算后，通过调用接口函数inpatientPay完成农合住院补偿.

9）住院补偿冲红

对已进行农合住院补偿的住院就诊信息通过接口函数cancelInpatientPay进行撤销农合补偿操作.即作废住院补偿信息,并将住院就诊信息业务状态变为出院状态。

10）住院补偿试算

通过接口函数inpatientCalculate对已经上传到农合系统的数据，计算可以补偿的金额,此计算不影响农合数据本身,此服务可用于整个农合业务流程的全过程.

11）住院登记信息获取

通过接口函数getInpatientRegisterInfo从农合系统获取已经存在的住院登记数据，包括登记基本信息和费用分类信息。

12）住院补偿信息获取

通过接口函数getInpatientRedeemInfo从农合系统获取已经存在的住院补偿数据。

包括农合补偿信息和补偿分段算法信息。

三.2功能说明

三.2.1基础服务

三.2.1.1药品诊疗字典下载

Ø功能说明

此服务用于医院信息系统从省级平台增量下载省标药品字典。

Ø服务定义

GetStdDrugResultgetStdDrug（WSUseruser，GetStdDrugInappIn）；

Ø输入参数说明

序号

名称

类型

是否必须

描述

1

user

WSUser

必须

系统级参数

2

appIn

GetStdDrugIn

必须

应用级输入参数

●GetStdDrugIn类型说明

序号

名称

类型/格式

长度（字节）

是否必须

描述

1

updateTime

Datetime

可选

最后更新时间

2

skip

Number

必须

获取记录开始位置,取值为正整数

【下标从0开始】

3

max

Number

必须

获取记录最大数，取值为正整数

Ø输出参数说明

序号

名称

类型/格式

描述

1

resultCode

String

处理结果代码：

0表示成功,其它表示失败

2

message

String

处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息

3

rows

Number

可下载的药品诊疗记录总数，取值为整数

4

details

StdDrugDTO[]

药品诊疗信息列表

●StdDrugDTO类型说明

序号

名称

类型/格式

描述

1

insureId

String

药品编码

2

classNo

String

项目费用类别，参照［农合相关字典］3.2。

3。

8费用分类字典.

3

grade

String

最低用药资质等级,"0"代表适用所有医院”1”代表一二三级医院用药"2”代表二三级医院用药”3”代表三级医院用药

4

name

String

中文名称

5

spec

String

规格

6

conf

String

剂型

7

unit

String

单位

8

price

Number

基准价格

9

everyMoney

Number

纳入农合可报费用次定额0表示规则不起作用

10

ratio

Number

保内比例>=0且<=1

11

adminLevel

String

使用该药品的医院所必须达到的最低行政级别0表示不限制级别；参照:

[农合相关字典]3.2.3。

8

12

status

String

是否正常启用1—启用2-停用

13

remark

String

备注说明

14

inputPyCode

String

拼音码

15

inputWbCode

String

五笔码

16

approveMaxPrice

Number

纳入农合可报费用最高价格，缺省为0,表示不限制最高价格

17

approveMinPrice

Number

纳入农合可报费用最低价格，缺省为0，表示不限制最低价格

18

manufacturer

String

生产企业

19

winSoes

String

招标企业

20

updateTime

Datetime

数据最新更新时间戳

三.2.1.2疾病字典下载

Ø功能说明

此服务用于医院信息系统从省级平台增量下载省标疾病字典。

Ø服务定义

GetStdDiseaseResultgetStdDisease（WSUseruser，GetStdDiseaseInappIn）；

Ø输入参数说明

序号

名称

类型

是否必须

描述

1

user

WSUser

必须

系统级参数

2

appIn

GetStdDiseaseIn

必须

应用级输入参数

●GetStdDiseaseIn类型说明

序号

名称

类型/格式

长度（字节）

是否必须

描述

1

updateTime

Datetime

可选

最后更新时间

2

skip

Number

必须

获取记录开始位置，取值为正整数【下标从0开始】

3

max

Number

必须

获取记录最大数，取值为正整数

Ø输出参数说明

序号

名称

类型/格式

描述

1

resultCode

String

处理结果代码：

0表示成功，其它表示失败

2

message

String

处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息

3

rows

Number

可下载的疾病字典记录总数,取值为整数

4

details

StdDiseaseDTO［］

疾病字典信息列表

●StdDiseaseDTO类型说明

序号

名称

类型/格式

描述

1

icdAllno

String

疾病或手术全编码

2

icdName

String

疾病或手术中文名称

3

scienceName

String

学名

4

enName

String

疾病或手术英文名称

5

description

String

疾病或手术描述

6

icdType

String

疾病分类参看附件一《新农合疾病目录》（类目、亚目）

7

icdFlag

String

是否为疾病的标志1—表示疾病2—表示手术

8

sexLimited

String

性别限制0-无限制1-仅限男性2—仅限女性

9

createTime

Date

创建时间

10

inputPyCode

String

拼音输入码统一使用小写

11

inputWbCode

String

五笔输入码统一使用小写

12

adminLevel

String

使用本疾病诊断要求的最低医院级别（参照［农合相关字典]3。

2。

3.7医疗机构行政级别）

13

status

String

状态0—停用1—启用

14

remark

String

备注

15

useFrequency

Number

使用次数或频率

16

updateTime

Datetime

最新更新时间戳

三.2.1.3治疗方式字典下载

Ø功能说明

此服务用于医院信息系统从省级平台下载省厅统一规定的适用于本医疗机构的治疗方式字典。

Ø服务定义

TreatmentModeUpdateResulttreatmentModeUpdate（WSUseruser，TreatmentModeUpdateInappIn）;

Ø输入参数说明

序号

名称

类型

是否必须

描述

1

user

WSUser

必须

系统级参数

2

appIn

TreatmentModeUpdateIn

必须

应用级输入参数

●TreatmentModeUpdateIn类型说明

序号

名称

类型/格式

长度（字节）

是否必须

描述

1

runYear

String

4

必须

运行年度

2

obligateOne

String

128

可选

预留参数一

3

obligateTwo

String

128

可选

预留参数二

4

obligateThree

String

128

可选

预留参数三

5

obligateFour

String

128

可选

预留参数四

6

obligateFive

String

128

可选

预留参数五

Ø输出参数说明

序号

名称

类型/格式

描述

1

resultCode

String

处理结果代码：

0表示成功，其它表示失败

2

message

String

处理结果描述,当处理结果代码不为0时,该值提供详细的失败描述信息

3

details

TreatmentModeDTO［］

治疗方式信息列表

●TreatmentModeDTO类型说明

序号

名称

类型

描述

1

code

String

治疗方式编码

2

name

String

治疗方式名称

3

isDiseaseAppointed

String

是否指定农合疾病0表示不指定，1表示指定

4

diseaseList

TreatmentDiseaseDTO［]

治疗方式关联的疾病信息列表，参看TreatmentDiseaseDTO

5

remark

String

说明

6

other

String

其他参数字段

7

obligateOne

String

预留字段一

8

obligateTwo

String

预留字段二

9

obligateThree

String

预留字段三

10

obligateFour

String

预留字段四

11

obligateFive

String

预留字段五

●TreatmentDiseaseDTO类型说明

序号

名称

类型/格式

描述

1

treatCode

String

治疗方式编码,治疗方式标识符

2

diseaseCode

String

农合疾病编码,农合ICD标准编码

3

diseaseName

String

农合疾病名称，农合ICD标准名称

4

obligateOne

String

预留字段一

5

obligateTwo

String

预留字段二

6

obligateThree

String

预留字段三

7

obligateFour

String

预留字段四

8

obligateFive

String

预留字段五

三.2.1.4补偿类型字典下载

Ø功能说明

此服务用于医院信息系统从省级平台下载省厅统一规定的补偿类型.

Ø服务定义

RedeemTypeDownLoadResultredeemTypeDownload（WSUseruser，RedeemTypeDownLoadInappIn）；

Ø输入参数说明

序号

名称

类型

是否必须

描述

1

user

WSUser

必须

系统级参数

2

appIn

RedeemTypeDownloadIn

必须

应用级输入参数

●RedeemTypeDownloadIn类型说明

序号

名称

类型/格式

长度（字节）

是否必须

描述

1

runYear

String

4

必须

运行年度

2

obligateOne

String

128

可选

预留参数一

3

obligateTwo

String

128

可选

预留参数二

4

obligateThree

String

128

可选

预留参数三

5

obligateFour

String

128

可选

预留参数四

6

obligateFive

String

128

可选

预留参数五

Ø输出参数说明

序号

名称

类型/格式

描述

1

resultCode

String

处理结果代码：

0表示成功,其它表示失败

2

message

String

处理结果描述，当处理结果代码不为0时,该值提供详细的失败描述信息

3

details

RedeemTypeDownloadDTO[］

补偿类型字典列表，参见RedeemTypeDownloadDTO

●RedeemTypeDownloadDTO类型说明

序号

名称

类型/格式

描述

1

code

String

标准补偿类别代码

2

name

String

标准补偿类别名称

3

otherParam

String

其他参数

4

comment

String

说明

5

accountType

String

本补偿类别对应的补偿账户类别及由哪类补偿账户支付

6

isRedemImmediate

String

是否可实时结报0：

不可实时结报，1:

可实时结报

7

obligateOne

String

预留字段一

8

obligateTwo

String

预留字段二

9

obligateThree

String

预留字段三

10

obligateFour

String

预留字段四

11

obligateFive

String

预留字段五

注:

补偿类型字典参照:

《附件二。

补偿类型字典》

三.2.1.5病人信息获取

Ø功能说明

此服务用于医院信息系统从省级平台获取参合人员家庭和成员信息。

Ø服务定义

GetFamilyMemberResultgetFamilyMember（WSUseruser,GetFamilyMemberInappIn）;

Ø输入参数说明

序号

名称

类型

是否必须

描述

1

user

WSUser

必须

系统级参数

2

appIn

GetFamilyMemberIn

必须

应用级输入参数

●GetFamilyMemberIn类型说明

序号

名称

类型/格式

长度（字节）

是否必须

描述

1

countryCode

String

6

必须

患者所在区县的编码

2

searchCode

String

32

必须

查询码，查询的证号或卡号

3

searchType

String

1

必须

查询类