RIS与HIS接口方案.doc

RIS与HIS接口方案上海金仕达卫宁医疗软件股份有限公司目录一、简介3二、接口示意图31、总示意图32、HIS接口说明3三、接口结构方案4四、基本功能说明51、读取病人基本信息52、获取在院病人信息列表63、获取病人未执行医嘱项目74、执行病人收费项目85、新增医嘱项目请求96、获取医嘱项目明细信息107、获取科室、病区、人员配置信息118、获取病人申请单列表信息(不使用)129、查看申请单明细（不使用）13一、 简介接口模块主要是配合RIS，它封装了RIS（及相关子系统）与HIS之间的交互，并由RIS通过预先约定的接口函数来调用接口模块中的功能；因此，在接口函数既定的情况下，对接口模块可以针对各种HIS的具体情况做任意的改动。接口模块的调用通过COM接口实现，并以DLL的形式存在，程序编码使用Delphi6，RIS数据库使用SQL Server 7/2000，HIS数据库支持Delphi6所能支持的任何数据库。二、 接口示意图1、 总示意图终端用户HIS接口RIS报告系统RIS数据库HIS数据库2、 HIS接口说明HIS接口由我公司提供 由HIS公司提供RIS报告系统HIS数据库HisInterface.dll存储过程或动态链接库三、 接口结构方案该结构将HIS接口模块划分在客户端一层，它将与RIS系统共同存在于同一主机上，但在功能上它属于中间应用层，故也可称伪三层。它虽然能同样起到三层的作用但必须在每个客户端都安装该接口，并且每个客户端都须与数据层作数据库连接，这样势必更多的消耗了数据库的资源，但同时它也相对减轻了服务器的压力，转而将压力分摊到各客户端。另外，当某一客户端的接口程序出现异常错误导致接口无法正常工作时，网络上的其他客户端不会受到任何影响，仍可正常使用。结构示意图客户层中间应用层数据层客户端RIS报告HIS接口客户端RIS报告HIS接口客户端RIS报告HIS接口服务器数据库MSSQL Server服务器四、 基本功能说明由于RIS系统的相关业务要求已经确定，故我公司对于RIS与HIS（Ris系统与HisInterface.dll）的相关接口也已确定。针对HisInterface.dll的相关业务处理，以下将列出HIS公司需要提供的主要接口，如有疑问或问题双方可协商解决。1、 读取病人基本信息业务描述：在RIS中对病人报告登记时，不需要将病人所有的基本信息输入到系统中，而只需要输入病人的住院号或者卡号就可通过HIS接口从全院病人的数据库中调取到病人的基本信息，无论该病人是否收费，都可以调取病人的基本信息。接口描述：传入参数：Brlb 病人类别Int说明： 0门诊 1住院codetype号码类型 Int说明： 1住院/门诊号指病历号，2卡号， 3 病人唯一号， 4 病人本次检查号 Code 号码值varchar 说明：它的含义，由上面号码类型指定传出参数：（或以数据集的形式提供，如果是多条记录则只处理第一条）WardOrReg病人类别Int0门诊 1住院 PatName 病人姓名 VarCharAge病人年龄 IntAgeUnit病人年龄单位Varchar岁、月、天、小时Sex病人性别 Char(1) 1 男，2 女 3 未知Birthday 出生年月Varchar 1979-04-01ApplyDept病人所在科室代码 VarChar Ward病人所在病区代码 VarCharBedNo病人所在病区的床号 VarCharHospNo病人的门诊/住院号VarCharIDNum 身份证VarcharCardNo病人的卡号 VarCharChargeType病人的收费类别代码 VarCharApplyDoctor病人的主治医生代码 VarCharAddress病人的地址VarCharPhone病人的电话VarCharClinicDesc病人的临床诊断VarCharPatientID病人唯一号Varchar同号码类型中的3 CureNo病人本次检查号Varchar同号码类型中的4其他说明：病人唯一号、病人本次检查号分别表示病人在HIS中的唯一代码和病人本次就诊的唯一代码，该参数将被回传入HIS中以获得病人本次就诊的所有申请单及未执行收费项目，故该参数的含义要视HIS的具体情况而定，不一定是以上所说的含义。2、 获取在院病人信息列表（目前杨思暂时只用住院）业务描述：在RIS中对病人进行登记时，当无法通过卡号或住院号调取病人基本信息时，需要通过查询在院病人列表进行查找，因此需要HIS提供通过多种条件进行查询病人的接口。接口描述：传入参数：brlb病人类别Int0门诊 1住院 hzxm病人姓名varchar可按姓名查找（为空代表全部）ksdm科室代码Varchar可按科室查找（为空代表全部）bqdm病区代码Varchar可按病区查找（为空代表全部）cwdm床位代码Varchar可按床号查找（为空代表全部）rq1开始日期 DateTime门诊指挂号时间，住院不处理rq2结束日期 DateTime门诊指挂号时间，住院不处理zxksdm执行科室Varchar可按传出参数：（以数据集的形式提供，为便于处理，返回字段最好是中文）病人姓名 VarChar病人年龄 Int病人年龄单位Varchar岁、月、天、小时病人性别 Char(1) 1 男，2 女 3 未知病人所在科室代码 VarChar 病人所在病区代码 VarChar病人所在病区的床号 VarChar病人的门诊/住院号VarChar病人的卡号 VarChar病人的收费类别代码 VarChar病人的主治医生代码 VarChar病人的地址VarChar病人的电话VarChar病人的临床诊断VarChar病人唯一号Varchar 病人本次检查号VarcharPatientID病人唯一号Varchar返回英文字段名CureNo病人本次检查号Varchar其他说明：返回的数据格式基本同“读取病人基本信息”接口类似，其实本身就是“读取病人基本信息”接口的补充。 3、 获取病人未执行医嘱项目业务描述：在RIS中对病人进行登记时，在调出病人基本信息的同时还将调用出病人的医嘱项目信息，以供医技科室医生进行核对并作收费确认。这里的接口只需返回某一个病人在一段时间内的所有医嘱项目，不须区分科室，RIS会处理相关的过滤。接口描述：传入参数：brlb病人类别Int0门诊 1住院 patientid病人唯一号Varchar由“读取病人基本信息”接口返回curno病人本次检查号Varchar由“读取病人基本信息”接口返回rq1开始日期 DateTime收费项目的开始申请日期rq2结束日期 DateTime收费项目的结束申请日期传出参数：（以数据集的形式提供）SerialNoint返回固定值-1PatientID病人唯一号Varchar由接口传入Cureno病人本次检查号Varchar由接口传入LogNo医嘱序号Varchar医嘱的唯一序号HisApplyNo申请单号Varchar 医嘱所属的申请单号 没有返回0GroupNo分组号Varchar医嘱的分组序号ItemType项目类别varchar如果HIS中对项目有分类，就把分类传入如果没有请传1ItemCode项目代码VarcharItemName项目名称VarcharPrice单价moneyItemQty数量floatItemUnit单位varcharApplyTime申请时间datetimeApplyDocCode申请医生（代码）varcharApplyDept申请科室（代码）varcharExecDept执行科室（代码）varcharStatus 确认标志varchar 0：未确认，1：已确认这里住院，门诊都为0ChargeFlag收费标志varchar0：未收费，1：已收费这里住院一般都为0，普通门诊病人为1AddType上传标志varchar 0：HIS开出项目1：医技上传其他说明：医嘱序号、申请单号、分组号、项目类别用于标识每一条医嘱项目信息（结合项目代码），其含义可以不是以上所描述的含义，并且可以选择性的返回，具体需要根据HIS的情况而定。“收费标志”表示医嘱项目是否收费或退费，一般只有对于接收门诊处方项目才是已收费，住院都为0。4、 执行病人收费项目业务描述：在RIS中对病人进行登记时，调出病人未执行医嘱项目后将对医嘱项目作确认操作，同时对医嘱项目进行计费。接口描述：传入参数：brlb病人类别Int0门诊 1住院 patiendid病人唯一号Varchar由“获取病人未执行医嘱项目”接口返回curno病人本次检查号Varchar由“获取病人未执行医嘱项目”接口返回zxksdm执行科室（代码）varcharzxysdm执行医生（代码）varcharlogno医嘱序号Varchar由“获取病人未执行医嘱项目”接口返回hisapplyno申请单号Varchar 由“获取病人未执行医嘱项目”接口返回groupno分组号Varchar由“获取病人未执行医嘱项目”接口返回xmlb项目类别varchar由“获取病人未执行医嘱项目”接口返回xmdm项目代码Varchar由“获取病人未执行医嘱项目”接口返回xmdj单价money对于由医技科室定价的项目此价格才有用。xmsl数量floatxmstatus项目状态Int0不处理1确认2拒绝 3撤销sfflag收费标志 Int0不处理1收费2退费传出参数：返回 0成功 -1失败。其他说明：该接口大部分参数都是由“获取病人未执行医嘱项目”接口返回，该接口对“获取病人未执行医嘱项目”接口返回的数据逐条进行执行。对于参数项目状态、收费标志可以理解为对医嘱项目所作的操作，即：门诊病人只作“确认”，“不收费”；住院病人既作“确认”、又作“收费”，之所以这样处理，是因为存在着先作检查再收费（先登记，出了报告再收费）的情况，当然，如果HIS中没有处理有关医嘱的执行状态（只处理收费标志），那可以默认为确认。另外，医技科室对医嘱项目的拒绝和退费操作也同样取决于HIS是否支持该操作。5、 新增医嘱项目请求业务描述：RIS系统中对于住院病人或门诊预交金病人（目前杨思暂时只用住院），可以直接新增医嘱或处方,然后确认。本功能取决于HIS是否支持该操作。接口描述：传入参数：brlb病人类别Int0门诊 1住院patiendid病人唯一号Varchar由“读取病人基本信息”接口返回curno病人本次检查号Varchar由“读取病人基本信息”接口返回zxksdm执行科室代码Varchar执行增加项目的科室zxysdm执行医生代码Varchar执行增加项目的医生xmdm项目代码Varcharxmdj项目单价moneyxmsl项目数量floatxmlb项目类别Varchar如果HIS中对项目有分类，就把分类传入如果没有请传1qqksdm申请科室代码Varcharqqysdm申请医生代码Varchar 传出参数：返回0成功 -1失败。其他说明：在医技科室中，存在由医技科室添加收费项目的情况，添加项目后，RIS再通过“获取病人未执行医嘱项目”接口下载项目，然后通过“执行病人收费项目”接口进行确认和收费。6、 获取医嘱项目明细信息业务描述：医技系统中将对HIS的医嘱项目作关联性的配置，因此，需要从HIS获得医嘱项目明细列表。并且，医技系统还将判定项目在HIS中的有效性，故需要提供项目的查询接口，现将这两种应用定义在同一接口中。接口描述：传入参数：xmdm项目代码Varchar如果项目代码不为空，则通过该代码作精确查询 xmtype查询码Varchar如果项目代码为空，则通过该查询码作模糊查询lb类别 int0：RIS4：LIS传出参数：（以数据集的形式提供）ItemType项目类别Varchar如果HIS中对项目有分类，就把分类传入如果没有请传1ItemCode项目代码VarcharItemName项目名称VarcharPrice单价moneyUnit单位VarcharMemCode1输入码一VarcharMemCode2输入码二Varchar其他说明：当项目代码为空时，将使用查询码进行模糊查询，查询的字段应包括所有可查询字段，如：项目代码、项目名称、输入码一、输入码二等。7、 获取科室、病区、人员配置信息业务描述：RIS系统中将对HIS的科室、病区、人员作关联性的配置，以便与HIS的科室、病区、人员相对应，因此，需要从HIS获得科室、病区、人员的信息。接口描述：传入参数：xxlb信息类别Varchar用于区别科室、病区、人员 1：科室；2：病区；3：人员传出参数：（以数据集的形式提供）Code代码Varchar科室、病区、人员代码name名称Varchar科室、病区、人员名称Dept所属科室Varchar人员所属科室（仅对人员有效）MemCode1输入码一VarcharMemCode2输入码二Varchar其他说明：由于该接口比较简单，故将科室、病区、人员统一在该接口中实现，仅通过类型来区分。该接口也可分开实现，具体处理可与HIS公司协商。8、 获取病人申请单列表信息(杨思不使用)业务描述：RIS系统中需要对病人的电子申请单进行查询，以获得最新待检查的病人，便于医生提前安排工作；应提供多种条件对申请单进行查询。接口描述：传入参数：病人类别Int0门诊 1住院门诊/住院号varchar可按门诊住院号查找卡号varchar可按病人卡号查找病人姓名varchar可按姓名查找科室代码Varchar可按科室查找病区代码Varchar可按病区查找执行科室代码Varchar可按申请单执行科室查找项目代码varchar可按申请单中包括的项目查询项目类别varchar可按申请单中包括的项目的类别查询项目状态varchar可按申请单中包括的项目的状态查询状态：0未处理1已确认开始日期 DateTime门诊指挂号时间，住院不处理结束日期 DateTime门诊指挂号时间，住院不处理 传出参数：（以数据集的形式提供）病人类别varchar门诊、住院 必须返回病人唯一号Varchar必须返回病人本次检查号Varchar必须返回病人申