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

湖南省新农合信息系统与医院信息管理系统互联接口开发文档（V1.0）一.引言本接口规范适用于省级定点医院和省级平台对接，市级定点医院和虚拟市级平台对接，区/县/乡镇级定点医院和区县农合业务系统对接。1.1编制目的《湖南省新农合信息系统与医院HIS数据接口规范》是我省针对新农合信息系统与医院信息管理系统(HIS)接口的信息技术文档。本接口规范旨在于为各定点医疗机构提供一套定义明确的诊疗信息传输标准，以规范医院信息系统与新农合系统数据接口传输内容，保证及时、准确地获取就诊患者的诊疗活动信息，以供补偿、统计、查询、分析、决策使用。本规范以病人一次就诊事件发生的时间、地点及临床诊断、检查、治疗的主要过程和结果信息为描述内容，通过定义接口调用规范、接口数据传输格式、接口数据传输要求、信息传输内容、接口安全规范，从而实现医院信息系统的数据到新农合系统的有效交换。1.2读者对象新农合系统技术开发人员定点医疗机构信息系统（HIS）技术开发人员HIS实施人员1.3参考文献《新型农村合作医疗管理信息系统基本规范(2008年修订版)》(卫办农卫发[2008]127号附件)1.4术语与缩写解释缩写、术语解释HTTP超文本传输协议（HTTP，HyperTextTransferProtocol)WebServiceWeb服务XML可扩展标记语言（ExtensibleMarkupLanguage）SOAP简单对象访问协议二.接口方案介绍本接口方案实现使用典型的基于SOAP的Web服务，以操作为中心，通过HTTP协议实现调用，每个操作接受XML文档作为输入，提供XML文档作为输出。2.1流程图解县级非定点病人住院门诊数据农合疾病药品字典更新住院门诊登记,划价退费,注销等数据传输预结算,结算补偿兑付等数据回馈县级定点病人补偿兑付相关数据省级农合平台(HIS新增)数据匹配管理农合疾病药品字典更新(HIS新增)住院/门诊农合业务管理WebServices(XMLOverHttp)县级定点病人住院门诊相关数据需依据匹配数据上传数据县级农合平台数据交换药品及诊疗项目匹配数据上传药品及诊疗项目匹配数据上传审核匹配数据回馈审核匹配数据回馈2.1.1医院需配合的工作1.医院需要根据新农合政策的需要，按照湖南省新农合信息系统所提供的WebService改造医院的HIS系统，使其HIS系统能够满足新农合即付及补的业务要求。2.医院需要通过接口下载湖南省基本新农合标准目录，包括新农合疾病诊断目录、新农合药品及诊疗项目目录，建立与医院相应目录内码与新农合标准目录对应的对照信息，称为匹配。3.对于自费药品，可以匹配成保外费用。4.此标准跨操作系统,支持各种开发语言,如Java、.NET、VB、Delphi、PB、C++、C等。2.2WebService调用说明2.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.2.2.1系统级输入参数每个功能服务的第一个参数为系统级输入参数(System-levelinputparameters)，包含服务调用的公用参数，用于服务安全认证和服务版本控制等。类型名定义为：WSUser，具体字段说明如下：名称类型是否必须描述loginNameString是当前接口操作用户登录名passwordString是当前接口操作用户登录密码centerCodeString否当前医院所在统筹区农合中心编码（预留字段）versionString否请求调用服务的版本号(默认为1.0)2.2.2.2应用级输入参数进行具体的服务调用是，传入的系统级参数之外的参数，用于控制具体的业务服务获取，具体定义参看相应的服务功能说明。2.2.3输出参说明所有输出参数均继承自WSResult。WSResult类型定义如下：名称类型描述resultCodeString处理结果代码：0表示成功，其它表示失败messageString处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息。三.接口设计3.1服务定义3.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下载医疗机构已上传匹配关系审核状态和可报比例等信息。3.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从农合系统获取已经存在的住院补偿数据。包括农合补偿信息和补偿分段算法信息。3.2功能说明3.2.1基础服务3.2.1.1药品诊疗字典下载功能说明此服务用于医院信息系统从省级平台增量下载省标药品字典。服务定义GetStdDrugResultgetStdDrug(WSUseruser,GetStdDrugInappIn);输入参数说明序号名称类型是否必须描述1userWSUser必须系统级参数2appInGetStdDrugIn必须应用级输入参数GetStdDrugIn类型说明序号名称类型/格式长度(字节)是否必须描述1updateTimeDatetime可选最后更新时间2skipNumber必须获取记录开始位置，取值为正整数【下标从0开始】3maxNumber必须获取记录最大数，取值为正整数输出参数说明序号名称类型/格式描述1resultCodeString处理结果代码：0表示成功，其它表示失败2messageString处理结果描述，当处理结果代码不为0时，该值提供详细的失败描述信息3rowsNumber可下载的药品诊疗记录总数，取值为整数4detailsStdDrugDTO[]药品诊疗信息列表StdDrugDTO类型说明序号名称类型/格式描述1insureIdString药品编码2classNoString项目费用类别,参照[农合相关字典]3.2.3.8费用分类字典。3gradeString最低用药资质等级，0代表适用所有医院1代表一二三级医院用药2代表二三级医院用药3代表三级医院用药4nameString中文名称5specString规格6confString剂型7unitString单位8priceNumber基准价格9everyMoneyNumber纳入农合可报费用次定额0表示规则不起作用10ratioNumber保内比例=0且=111adminLevelString使用该药品的医院所必须达到的最低行政级别0表示不限制级别;参照：[农合相关字典]3.2.3.812statusString是否正常启用1-启用2-停用13remarkString备注说明14inputPyCodeString拼音码15inputWbCodeString五笔码16approveMaxPriceNumber纳入农合可报费用最高价格，缺省为0，表示不限制最高价格17approveMinPriceNumber纳入农合可报费用最低价格，缺省为0，表示不限制最低价格18manufacturerString生产企业19winSoesString招标企