湖南省新农合信息系统与医院信息管理系统互联接口开发文档.docx
- 文档编号:24745605
- 上传时间:2023-06-01
- 格式:DOCX
- 页数:77
- 大小:126.29KB
湖南省新农合信息系统与医院信息管理系统互联接口开发文档.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
必须
查询类
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 湖南省 新农合 信息系统 医院 信息管理 系统 联接 开发 文档