【经典】华西医院LIS接口解决方案.doc

华 西 医 院lis系统接口方案v1.12007-11签字确认：文档名称华西医院lis系统接口方案版 本 号v1.1版本日期2007年12月28日创 建 者华西医院 徐勤创建日期2007年11月27日l 版本修订历史版本号变更时间变更内容拟稿人审批人v1.02007-11-27初稿徐勤v1.12007-12-28增加设置医嘱状态接口徐勤目 录1现状和目标12接口技术实现方式13接口描述13.1接口流程描述13.1.1病人在诊间就诊13.1.2病人在收费处缴费13.1.3病人在检验科报到登记23.1.4出检验报告（审核报告后）23.1.5取消检验23.1.6病人退费23.1.7资源安排23.2接口功能说明及定义33.2.1发送病人信息(sendpatientdetail)33.2.2发送标本号 (sendspecimenno)53.2.3设置医嘱报告状态（setreportstatus）63.2.4更改医嘱状态(updateorderstatus)63.2.5病人退费 (returnfare)83.2.6打印条码（lisdataprint）83.2.5同步资源安排信息104其他说明12华西医院lis接口方案v1.0华西医院lis与trakcare接口方案1 现状和目标华西医院lis系统目前使用的是上海杏和软件公司的产品，利用pb和sql server开发，运行于windows2000平台上。华西医院要求在新的his系统trakcare一期工程(门诊系统)投入运行后，仍然使用目前的lis系统。为了确保与trakcare系统的信息共享和交互，同时保证双方业务正常和高效进行，特制定本方案。2 接口技术实现方式l soap方式。l 所有接口传递的消息均使用xml格式定义和传递。l 实现平台为ensemble系统集成平台。3 接口描述3.1 接口流程描述3.1.1 病人在诊间就诊病人在进入诊间就诊时，如果医生认为病人需要进行检验，his系统调用初排程信息（初排程根据检验科每天最大检验人数和每次检验时间来排定，并在his内部进行），为该病人开出检验医嘱，his中该检验医嘱状态为“核实”状态。在此时不需要和lis系统交互信息。在门诊第一期中医生工作站不向lis请求检验结果。3.1.2 病人在收费处缴费病人持就诊卡到收费处交费。his系统通过调用lis系统提供的webservice（原为dll文件），完成如下工作：(1)将病人基本信息、就诊信息以及检验医嘱信息传入lis；(2)由lis系统回传打印条码。当病人交费时，检验材料费仍采用目前的方式来收取，即由收费员估计检验材料的消耗量并录入系统来收费。交费后his中该检验医嘱状态为“核实”状态，lis中该医嘱为“预约”状态。在收费处条码打印失败时，患者可在检验科的专门窗口补打条码。3.1.3 病人在检验科报到登记病人交费后，持打印的条码去检验科。如果在收费处条码打印失败时或病人丢失条码，患者可在检验科的专门窗口补打条码。lis系统中通过扫条码得到相应的医嘱信息及检验项目和标本信息。在采取了相应的检验样本后，在lis系统中保存登记信息 ，并将标本号和医嘱号返回his系统。his系统接收到标本号后，将医嘱状态修改为执行状态。表明lis中已经采取了标本，不能再退费。3.1.4 出检验报告（审核报告后）当检验结果报告出来并审核后，lis系统向trakcare系统回传该检验对应的医嘱号以及检验结果已报告标志，同时回传检验结果，在trakcare系统中保存（在第一期中不实现检验结果回传）。lis系统中该医嘱为“出报告”状态。说明：一个医嘱号可能对应多个检验报告，并且可能分多次出结果报告。经过和lis检验科室确认，如果一个医嘱号对应多个检验报告，当只出一个检验报告时，不审核报告。只有所有报告出来并审核后该医嘱才为“出报告”状态。一个医嘱号可以有多个检验报告，一个检验报告也可以对应多个医嘱号；一个医嘱项目可能对应多个检验项目；一个检验项目可能同时包含定量和定性两种结果，需建立定量和定性两字段保存。3.1.5 取消检验在病人已经抽取样本或检验结果已经报告后要求退费，需lis审核并向his系统提交撤销标志，his系统修改医嘱状态标志“核实”状态后，可退费。lis系统中该医嘱为“取消”状态。3.1.6 病人退费当病人缴费并打印条码后，并未到lis检验室做登记就到收费处退费，此时his系统应通知lis系统更改该病人的医嘱状态为“已取消”，不能再给该病人做检验。3.1.7 资源安排某些检验项目不是每天都能够做，需要lis检验人员对检验项目进行安排。当需要对检验项目进行安排时，lis检验人员登陆his系统安排资源。资源安排过程中，需要指定一些特殊说明，比如说需要某项检查需要病人空腹、十日内无输血史等要求。3.2 接口功能说明及定义3.2.1 发送病人信息(sendpatientdetail)请求发出者：his系统。服务提供者：lis系统。患者在交费时将病人的基本信息、本次就诊信息和检验医嘱信息发送给lis系统。接口定义：接口名称5/trakcare/trak/web/interface/getpatientdetail接口描述患者在交费时将病人的基本信息、本次就诊信息和检验医嘱信息发送给lis系统。请求消息名应答消息名接口协议web service+xml服务提供者trakcare发出信息：名称说明数据类型长度patientid病人id(his系统内部病人唯一标识)stringpatientno病人登记号stringname姓名stringbirthdate出生日期(yyyy-mm-dd)stringsex性别stringidcode身份证号stringaddress住址stringcompany工作单位stringtelephoneno联系电话stringresultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string名称说明数据类型长度episodeid病人就诊号stringadmissiontype就诊类型(门、急、住、体)stringadmissiondate就诊日期(yyyy-mm-dd)stringadmissiontime就诊时间(hh:mm:ss)stringadmissiondept就诊科室stringward病人所在病区(住院病人)stringbed病人所在床位(住院病人)stringmaindoctor主治医生(住院病人)stringorder医嘱collectionorderdiagnosis诊断collectiondiagnosisresultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string诊断消息定义名称说明数据类型长度diagdesc诊断名称stringdiagcode诊断代码(icd10)string检验医嘱消息定义名称说明数据类型长度orditemid医嘱idstringorditmmastdesc医嘱名称stringorditemdate医嘱日期(yyyy-mm-dd)stringorditemtime医嘱时间(hh:mm:ss)stringorditemnotes医嘱备注stringorditemdoc下医嘱医生stringorditemloc下医嘱科室string名称说明数据类型长度resultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string3.2.2 发送标本号 (sendspecimenno)请求发出者：lis系统。服务提供者：his系统。病人在lis系统中登记时抽取检验样本，同时通过该接口将lis系统产生的标本号和his系统的医嘱号传送给his系统。his接收到标本号后将医嘱状态修改为执行状态，表明该病人的该条检验医嘱已经抽取标本，不能再退费。接口定义：接口名称5/trakcare/trak/web/interface/ sendspecimenno接口描述lis系统在病人登记时将生成的标本号和his中对应的遗嘱项对应.请求消息名应答消息名接口协议web service+xml发出信息：名称说明数据类型长度orditemid医嘱idstringepisodeid病人就诊号stringspecimenno标本号string返回信息：名称说明数据类型长度resultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string3.2.3 设置医嘱报告状态（setreportstatus）请求发出者：lis系统。服务提供者：his系统。当lis系统检验报告出来后，需要将出报告的检验医嘱和报告状态回传给his系统。接口定义：接口名称5/trakcare/trak/web/interface/setreportstatus接口描述请求消息名应答消息名接口协议web service+xml服务提供者trakcare发出信息：名称说明数据类型长度episodeid病人就诊号stringorditemid医嘱idstringreportstatus报告状态string返回信息：名称说明数据类型长度resultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string3.2.4 更改医嘱状态(updateorderstatus)请求发出者：lis系统。服务提供者：his系统。当lis系统中进行一些操作导致his系统中医嘱状态发生变化时，通过该接口更改医嘱状态。1 当病人在检查室登记时,需要将his的医嘱状态修改为执行状态。2当出检验报告后病人要求退费时，lis系统需要通知his系统将对应的医嘱状态设置为“核实”。如果检查医嘱状态为“核实”，并且记费标志为已经交费则可以退费。3当病人登记后，但病人皮试时过敏等原因导致检查无法进行，ris系统需要通知his系统将对应的医嘱状态设置为“核实”。接口定义：接口名称5/trakcare/trak/web/interface/updateorderstatus接口描述根据医嘱id设置his系统对应医嘱的状态请求消息名应答消息名接口协议web service+xml服务提供者trakcare发出信息：名称说明数据类型长度episodeid病人就诊号stringorditemid医嘱idstringexecloccode报告科室代码stringexecusercode报告审核人代码stringexecdate报告审核日期(yyyy-mm-dd)stringexectime报告审核时间(hh:mm:ss)stringcancelloccode取消科室代码stringcancelusercode取消人代码stringcanceldate取消日期stringcancelreason取消理由string返回信息：名称说明数据类型长度resultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string3.2.5 病人退费 (returnfare)请求发出者：his系统。服务提供者：lis系统。当病人交费后并未到检验科室登记就到收费处退费，则his通知lis系统该医嘱已经退费。一旦退费，lis系统就不能再给该病人做登记。接口定义：接口名称5/trakcare/trak/web/interface/ returnfare接口描述根据医嘱id通知lis系统对应医嘱的已经退费，不能再进行检查。请求消息名应答消息名接口协议web service+xml服务提供者trakcare发出信息：名称说明数据类型长度orderid医嘱idstringepisodeid病人就诊号string返回信息：名称说明数据类型长度resultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string3.2.6 打印条码（lisdataprint）请求发出者：his系统。服务提供者：lis系统。病人到收费处交费时，his系统通过调用lis系统提供的webservice，将病人基本信息、就诊信息以及医嘱信息传入lis，同时打印检验条码。接口定义：接口名称5/trakcare/trak/web/interface/ lisdataprint接口描述打印检验条码请求消息名应答消息名接口协议web service+xml服务提供者lis发出信息：no数据列说明1hisidhis系统医嘱id2pattype病人类别1：住院；2：门诊3：住院急诊4：门诊急诊5：体检3outpatid病员号门诊病人：门诊号住院病人：住院号体检病人：体检号4inpatid病员唯一号5chargetype收费类别6patname姓名7patsex性别1：男；2：女8patage年龄9patnation民族10aboabo血型a,b,ab,o11rhrh血型12patdept科别代码13patward病区（住院病人必须）代码14patbed床号（住院病人必须）15especial特殊条件16inspected已检信息17infection传染信息18diagnoses诊断代码19medicalrecord简要病史20reqdept申请科室代码21reqtime申请时间yyyy-mm-dd hh:mm22reqperson申请人代码23exedept执行科室代码24exetime执行时间yyyy-mm-dd hh:mm25exeperson执行人代码26printdept打印科室代码27printtime打印时间yyyy-mm-dd hh:mm28printperson打印人代码29sampleclass标本30samplingpos采集位置31samplingdept采集科室代码32samplingtime采集时间yyyy-mm-dd hh:mm33samplingperson采集人代码34receivedept接收科室代码35receivetime接收时间yyyy-mm-dd hh:mm36receiveperson接收人代码37reqstate申请状态、0：未检38remark备注39chargeitemid检验项目代码40chargestate收费状态1：已收费；0：未收费41chargetime收费时间yyyy-mm-dd hh:mm42chargeperson收费人员代码43chargeitemuniteflag合并标记注：红色信息内容是必须的。返回信息：名称说明数据类型长度resultcode结果标志(0 成功、1 失败)stringerrormsg错误信息string3.2.5同步资源安排信息根据讨论结果，his系统和lis系统都可以维护lis的资源安排计划。因此存在资源安排结果的双向同步问题，双方都需要提供接口来进行信息交互。资源安排有信息：检验大类、检验小类、检验项目、每天最多完成资源数、开放时间、取样特殊要求检验大类分：分子诊断、骨髓、激素、临床免疫、凝血溶血、生化、微生物、药物浓度监测等。检验小