1、湖南省新农合信息系统与医院信息管理系统互联接口开发文档湖南省新农合信息系统与医院信息管理系统互联接口开发文档(V1。0)一.引言本接口规范适用于省级定点医院和省级平台对接，市级定点医院和虚拟市级平台对接，区/县/乡镇级定点医院和区县农合业务系统对接.一.1编制目的湖南省新农合信息系统与医院HIS数据接口规范是我省针对新农合信息系统与医院信息管理系统（HIS）接口的信息技术文档。本接口规范旨在于为各定点医疗机构提供一套定义明确的诊疗信息传输标准，以规范医院信息系统与新农合系统数据接口传输内容， 保证及时、准确地获取就诊患者的诊疗活动信息，以供补偿、统计、查询、分析、决策使用.本规范以病人一次就诊
2、事件发生的时间、地点及临床诊断、检查、治疗的主要过程和结果信息为描述内容，通过定义接口调用规范、接口数据传输格式、接口数据传输要求、信息传输内容、接口安全规范,从而实现医院信息系统的数据到新农合系统的有效交换。一.2读者对象新农合系统技术开发人员定点医疗机构信息系统(HIS）技术开发人员HIS实施人员一.3参考文献新型农村合作医疗管理信息系统基本规范（2008年修订版）（卫办农卫发2008127号附件）一.4术语与缩写解释缩写、术语解 释HTTP超文本传输协议(HTTP，HyperText Transfer Protocol） Web ServiceWeb服务XML可扩展标记语言（Extens
3、ible Markup Language)SOAP简单对象访问协议二.接口方案介绍本接口方案实现使用典型的基于SOAP的Web服务，以操作为中心,通过HTTP协议实现调用，每个操作接受 XML 文档作为输入，提供 XML 文档作为输出。二.1流程图解二.1.1医院需配合的工作1.医院需要根据新农合政策的需要,按照湖南省新农合信息系统所提供的Web Service改造医院的HIS系统，使其HIS系统能够满足新农合即付及补的业务要求。2.医院需要通过接口下载湖南省基本新农合标准目录，包括新农合疾病诊断目录、新农合药品及诊疗项目目录,建立与医院相应目录内码与新农合标准目录对应的对照信息，称为匹配。3
4、.对于自费药品，可以匹配成保外费用.4.此标准跨操作系统，支持各种开发语言,如Java、。NET、VB、Delphi、PB、C+、C等.二.2Web Service调用说明二.2.1参数类型说明为了方便调用，所有入参对象和出参对象中的属性的数据类型均为字符串类型，根据不同的数据类型（如数字、日期、时间等)格式说明如下:1.数字格式：必须是0-9的数字组成,前面可以带+号，号,小数点. 等符号字节，如无特别申明一般保留2位小数，不能是表达式,类型名定义为：Number。2.日期格式：必须是yyyy-MM-dd （年4位，月2位，日2位)的字符串，类型名定义为：Date.3.时间格式：必须是yyy
5、yMMdd HH：mm：ss (年4位，月、日、时、分、秒均2位,小时格式为24小时制）的字符串，类型名定义为：Datetime.4.字符格式：指定长度的字符串，类型名定义为：String。5.列表格式：类型后带“”表示列表/数组，如字符串数组用“String”表示。二.2.2输入参说明输入参数包括系统级输入参数和应用级输入参数。二.2.2.1系统级输入参数每个功能服务的第一个参数为系统级输入参数（Systemlevelinput parameters)，包含服务调用的公用参数，用于服务安全认证和服务版本控制等。类型名定义为:WSUser,具体字段说明如下：名称类型是否必须描述loginNam
6、eString是当前接口操作用户登录名passwordString是当前接口操作用户登录密码centerCodeString否当前医院所在统筹区农合中心编码（预留字段）versionString否请求调用服务的版本号（默认为1.0）二.2.2.2应用级输入参数进行具体的服务调用是,传入的系统级参数之外的参数，用于控制具体的业务服务获取，具体定义参看相应的服务功能说明。二.2.3输出参说明所有输出参数均继承自WSResult.WSResult 类型定义如下:名称类型描述resultCodeString处理结果代码:0表示成功,其它表示失败messageString处理结果描述，当处理结果代码不为
7、0时,该值提供详细的失败描述信息.三.接口设计三.1服务定义三.1.1基本部分HIS字典匹配是HIS系统和农合系统数据传输的基础,在HIS和农合实现业务对接前，必须先完成字典匹配工作，确保HIS字典与农合系统字典数据的正确转换.注：数据匹配标化是一个长期的、动态的过程。1)药品诊疗字典下载通过接口函数getStdDrug下载农合标准药品诊疗字典，由专人完成医院药品诊疗目录字典和农合药品诊疗目录字典的匹配工作，并做好校对.2)疾病字典下载通过接口函数getStdDisease下载农合标准疾病字典，由专人完成医院疾病字典和农合疾病字典的匹配工作，并做好校对.注：关于疾病字典的处理,建议HIS改造为
8、住院登记时直接选择农合疾病.3)治疗方式字典下载通过接口函数treatmentModeUpdate下载省厅统一规定的治疗方式。治疗方式主要是针对省定大病特殊政策而实现的,省厅根据各区县治疗方式统一定义适用全省新农合补偿的治疗方式集,HIS需根据所属医疗机构获取适用于该机构的治疗方式,建议HIS每周至少更新获取一次，并且提供手动更新获取方式。4)补偿类型字典下载通过接口函数redeemTypeDownload下载省厅统一规定的补偿类型.建议HIS每周至少更新获取一次，并且提供手动更新获取方式。5)病人信息获取 通过接口函数getFamilyMember获取指定医疗证卡号（身份证号，健康卡号）对应
9、的家庭有效参合人员基本信息。6)医疗机构信息获取 通过接口函数getHospitalInfo获取指定名称的医疗机构基本信息.7)药品诊疗匹配关系上传通过接口函数uploadDrugMatch上传HIS药品诊疗和省标药品诊疗匹配关系。8)药品诊疗匹配关系下载通过接口函数getDrugMatch下载医疗机构已上传匹配关系审核状态和可报比例等信息。三.1.2住院部分1)住院登记在完成查询农合病人相关信息的基础上，通过接口函数inpatientRegister完成新农合参保患者农合住院登记。2)住院登记查询通过接口函数inpatientRegisterSeek传入的HIS住院登记号,农合患者个人编码查
10、询该患者在当前医疗机构就诊的住院登记信息。1.本服务主要用于inpatientRegister农合系统执行成功,HIS应网络等原因没有收到执行结果时使用。2.如果因网络或其它原因导致农合执行服务inpatientRegister成功,而HIS没有收到返回，或HIS对成功的方法没有正确处理，可通过服务inpatientRegisterSeek查询住院登记农合执行结果并同步HIS系统中的数据状态。3)住院登记修改通过接口函数inpatientUpdate修改未出院的住院就诊登记信息.4)取消住院登记通过接口函数cancelInpatientRegister取消住院登记,即对住院就诊信息处于在院或出
11、院状态的就诊信息和医嘱明细进行作废处理.5)住院诊疗明细上传在住院登记成功的基础上，可以通过调用接口函数uploadInpatientDetails进行住院明细批量上传。1.对于错误的明细上传可以通过调用接口函数uploadInpatientDetails上传负费用（数量为负数,单价不变，注：总金额等于单价乘以数量)进行抵消。6)住院结算（出院）HIS出院登记时同时调用接口函数leaveInpatientRegister完成农合患者出院结算.即将住院就诊信息业务状态修改为出院状态.1.建议在农合住院结算前先调用住院补偿试算接口函数inpatientCalculate校对总费用.7)取消出院登记
12、通过调用接口函数cancelLeaveInpatientRegister对已出院但未进入补偿流程的住院就诊信息进行取消出院操作，即将住院就诊信息业务状态变为在院状态.8)住院补偿在正确完成了出院结算后，通过调用接口函数inpatientPay完成农合住院补偿.9)住院补偿冲红对已进行农合住院补偿的住院就诊信息通过接口函数cancelInpatientPay进行撤销农合补偿操作.即作废住院补偿信息,并将住院就诊信息业务状态变为出院状态。10)住院补偿试算通过接口函数inpatientCalculate对已经上传到农合系统的数据，计算可以补偿的金额,此计算不影响农合数据本身,此服务可用于整个农合业
13、务流程的全过程.11)住院登记信息获取通过接口函数getInpatientRegisterInfo从农合系统获取已经存在的住院登记数据，包括登记基本信息和费用分类信息。12)住院补偿信息获取通过接口函数getInpatientRedeemInfo从农合系统获取已经存在的住院补偿数据。包括农合补偿信息和补偿分段算法信息。三.2功能说明三.2.1基础服务三.2.1.1药品诊疗字典下载功能说明此服务用于医院信息系统从省级平台增量下载省标药品字典。服务定义GetStdDrugResult getStdDrug(WSUser user，GetStdDrugIn appIn）；输入参数说明序号名称类型是否
14、必须描述1userWSUser必须系统级参数2appInGetStdDrugIn必须应用级输入参数GetStdDrugIn类型说明序号名称类型/格式长度（字节）是否必须描述1updateTimeDatetime可选最后更新时间2skipNumber必须获取记录开始位置,取值为正整数【下标从0开始】3maxNumber必须获取记录最大数，取值为正整数输出参数说明序号名称类型/格式描述1resultCodeString处理结果代码：0表示成功,其它表示失败2messageString处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息3rowsNumber可下载的药品诊疗记录总数，取值
15、为整数4detailsStdDrugDTO药品诊疗信息列表StdDrugDTO类型说明序号名称类型/格式描述1insureIdString药品编码2classNoString项目费用类别，参照农合相关字典3.2。3。8费用分类字典.3gradeString最低用药资质等级,0代表适用所有医院 ”1”代表一二三级医院用药 2”代表二三级医院用药 ”3”代表三级医院用药4nameString中文名称5specString规格6confString剂型7unitString单位8priceNumber基准价格9everyMoneyNumber纳入农合可报费用次定额 0表示规则不起作用10ratioN
16、umber保内比例 =0 且 =111adminLevelString使用该药品的医院所必须达到的最低行政级别 0表示不限制级别；参照:农合相关字典3.2.3。812statusString是否正常启用 1启用 2-停用13remarkString备注说明14inputPyCodeString拼音码15inputWbCodeString五笔码16approveMaxPriceNumber纳入农合可报费用最高价格，缺省为0,表示不限制最高价格17approveMinPriceNumber纳入农合可报费用最低价格，缺省为0，表示不限制最低价格18manufacturerString生产企业19wi
17、nSoesString招标企业20updateTimeDatetime数据最新更新时间戳三.2.1.2疾病字典下载功能说明此服务用于医院信息系统从省级平台增量下载省标疾病字典。服务定义GetStdDiseaseResult getStdDisease(WSUser user， GetStdDiseaseIn appIn)；输入参数说明序号名称类型是否必须描述1userWSUser必须系统级参数2appInGetStdDiseaseIn必须应用级输入参数GetStdDiseaseIn类型说明序号名称类型/格式长度(字节)是否必须描述1updateTimeDatetime可选最后更新时间2skip
18、Number必须获取记录开始位置，取值为正整数【下标从0开始】3maxNumber必须获取记录最大数，取值为正整数输出参数说明序号名称类型/格式描述1resultCodeString处理结果代码：0表示成功，其它表示失败2messageString处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息3rowsNumber可下载的疾病字典记录总数,取值为整数4detailsStdDiseaseDTO疾病字典信息列表StdDiseaseDTO类型说明序号名称类型/格式描述1icdAllnoString疾病或手术全编码2icdNameString疾病或手术中文名称3scienceName
19、String学名4enNameString疾病或手术英文名称5descriptionString疾病或手术描述6icdTypeString疾病分类 参看附件一新农合疾病目录（类目、亚目）7icdFlagString是否为疾病的标志 1表示疾病 2表示手术8sexLimitedString性别限制 0-无限制 1-仅限男性 2仅限女性9createTimeDate创建时间10inputPyCodeString拼音输入码 统一使用小写11inputWbCodeString五笔输入码 统一使用小写12adminLevelString使用本疾病诊断要求的最低医院级别(参照农合相关字典3。2。3.7医疗
20、机构行政级别）13statusString状态 0停用 1启用14remarkString备注15useFrequencyNumber使用次数或频率16updateTimeDatetime最新更新时间戳三.2.1.3治疗方式字典下载功能说明此服务用于医院信息系统从省级平台下载省厅统一规定的适用于本医疗机构的治疗方式字典。服务定义TreatmentModeUpdateResult treatmentModeUpdate(WSUser user， TreatmentModeUpdateIn appIn）;输入参数说明序号名称类型是否必须描述1userWSUser必须系统级参数2appInTreat
21、mentModeUpdateIn必须应用级输入参数TreatmentModeUpdateIn类型说明序号名称类型/格式长度（字节)是否必须描述1runYearString4必须运行年度2obligateOneString128可选预留参数一3obligateTwoString128可选预留参数二4obligateThreeString128可选预留参数三5obligateFourString128可选预留参数四6obligateFiveString128可选预留参数五输出参数说明序号名称类型/格式描述1resultCodeString处理结果代码：0表示成功，其它表示失败2messageStr
22、ing处理结果描述,当处理结果代码不为0时,该值提供详细的失败描述信息3detailsTreatmentModeDTO治疗方式信息列表TreatmentModeDTO 类型说明序号名称类型描述1codeString治疗方式编码2nameString治疗方式名称3isDiseaseAppointedString是否指定农合疾病 0表示不指定，1 表示指定4diseaseListTreatmentDiseaseDTO治疗方式关联的疾病信息列表，参看TreatmentDiseaseDTO5remarkString说明6otherString其他参数字段7obligateOneString预留字段一8
23、obligateTwoString预留字段二9obligateThreeString预留字段三10obligateFourString预留字段四11obligateFiveString预留字段五TreatmentDiseaseDTO类型说明序号名称类型/格式描述1treatCodeString治疗方式编码,治疗方式标识符2diseaseCodeString农合疾病编码,农合ICD标准编码3diseaseNameString农合疾病名称，农合ICD标准名称4obligateOneString预留字段一5obligateTwoString预留字段二6obligateThreeString预留字段三
24、7obligateFourString预留字段四8obligateFiveString预留字段五三.2.1.4补偿类型字典下载功能说明此服务用于医院信息系统从省级平台下载省厅统一规定的补偿类型.服务定义RedeemTypeDownLoadResult redeemTypeDownload（WSUser user， RedeemTypeDownLoadIn appIn）；输入参数说明序号名称类型是否必须描述1userWSUser必须系统级参数2appInRedeemTypeDownloadIn必须应用级输入参数RedeemTypeDownloadIn类型说明序号名称类型/格式长度（字节）是否必须
25、描述1runYearString4必须运行年度2obligateOneString128可选预留参数一3obligateTwoString128可选预留参数二4obligateThreeString128可选预留参数三5obligateFourString128可选预留参数四6obligateFiveString128可选预留参数五输出参数说明序号名称类型/格式描述1resultCodeString处理结果代码：0表示成功,其它表示失败2messageString处理结果描述，当处理结果代码不为0时,该值提供详细的失败描述信息3detailsRedeemTypeDownloadDTO补偿类型字
26、典列表，参见RedeemTypeDownloadDTORedeemTypeDownloadDTO类型说明序号名称类型/格式描述1codeString标准补偿类别代码2nameString标准补偿类别名称3otherParamString其他参数4commentString说明5accountTypeString本补偿类别对应的补偿账户类别及由哪类补偿账户支付6isRedemImmediateString是否可实时结报0：不可实时结报，1:可实时结报7obligateOneString预留字段一8obligateTwoString预留字段二9obligateThreeString预留字段三10o
27、bligateFourString预留字段四11obligateFiveString预留字段五注:补偿类型字典参照:附件二。补偿类型字典三.2.1.5病人信息获取功能说明此服务用于医院信息系统从省级平台获取参合人员家庭和成员信息。服务定义GetFamilyMemberResult getFamilyMember（WSUser user,GetFamilyMemberIn appIn);输入参数说明序号名称类型是否必须描述1userWSUser必须系统级参数2appInGetFamilyMemberIn必须应用级输入参数GetFamilyMemberIn类型说明序号名称类型/格式长度（字节）是否必须描述1countryCodeString6必须患者所在区县的编码2searchCodeString32必须查询码，查询的证号或卡号3searchTypeString1必须查询类
