THIS4.0与第三方公司医技接口规范(金仕达卫宁).doc

金仕达卫宁版本 HIS与第三方公司医技接口规范 Version: 总体设计方案： Issue Date: 文件编号：WN-JK-接口规范-1.0 一. 概述目前，已经有很多医院采用了上海金仕达卫宁公司的医院体检管理系统，而对于医院的LIS、RIS、PACS及其他信息系统（以下统称为其他信息系统）可能采用其他公司的产品，这些系统与体检系统都是医院信息化范畴内的相互完全独立的子系统，没有实现数据的共享，例如一个检验系统里的检验结果还需要在体检系统里再次录入，因此这种重复录入工作占据了很大的工作比重，既影响了医院的工作效率又常常因为重复录入不一致造成数据不准确。 基于以上原因，我们提供第三方的开放性接口实现各子系统之间的数据共享，从而大大提高了医院资源的合理利用率。二. 医院系统的环境与接口方式根据目前医院使用的操作系统，客户端基本采用Windows环境，采用客户端直接调用接口程序（DLL），以函数的参数方式传递要发送的输入信息，并以XML字符串格式返回输出信息。直接访问DLL调用/HL7中间库接口方式通过直接读写对方系统数据库来完成数据交换（比如调用存储过程、库表、视图）通过调用对方系统提供的接口DLL程序或者通过HL7协议来完成数据交换通过读写双方约定的中间数据库来完成数据交换安全性差，直接访问对方系统数据库，进行表或者视图操作，数据完全可见，有安全隐患好，接口调用完全通过程序调用的方式，数据不可见，数据库不可直接访问较好，不直接访问对方数据库，但是如果权限设置不完善，容易发生中间库数据出错或者丢失后，责任无法鉴定的问题独立性差，双方程序耦合程度高，一方修改程序如果涉及到接口表结构，影响到另外一方好，只要保证接口调用函数参数和返回结果格式不变，对程序没有任何影响较好，一般来说只要不改动中间库中对方接口表的结构，就不会带来程序问题维护性差，接口表共同维护，责任不清，容易造成混乱好，接口提供方维护接口程序差，中间库功能维护，责任不清，容易造成混乱规范性差，接口实现方式随意，没有规范好，采用同一的函数调用方式和参数格式，规范统一差，接口实现方式随意，没有规范工作量小，直接访问对方数据表，可以当作自己系统中的表同样处理，接口提供方工作量较小，但是接口调用方接口功能需要自己实现小，调用接口函数程序，但是不用关心接口功能实现，接口调用方工作量较小一般，双方都访问中间库，接口功能需要自己实现。性能隐患高，直接访问数据，如果编程效率不高将直接对对方系统性能造成重大影响低，接口由对方提供，性能由接口提供方负责较低，不直接访问数据，可能因为编程原因对中间数据库性能造成影响使用范围常见于公司内部系统之间的接口普遍使用，例如医保接口、软硬件接口等使用面窄，多用于在数据库环境相同的系统之间接口 接口示意图：终端用户RIS报告调阅软件RIS报告系统RIS数据库HIS数据库HIS接口由HIS公司提供 RIS报告系统HIS数据库HisInterface.dll存储过程或动态链接库三. 调用接口程序的操作步骤1. 调用下述接口程序(DLL)，以函数参数的方式传递要发送的消息。DLL名：Hisinterface.dllIni配置文件 kwv40.ini函数列表a. SendEmr (AMsgCode: pChar; AsSendXml: pChar; AsRetXml: pChar): Integer;stdcall;功能说明：数据传输接口参数描述：参数1：调用类型 (4位字符串)参数2：输入的XML字符串消息参数3：输出的XML字符串消息返回值：返回的消息码(0-成功，-1-失败，7-获取参数失败，8-参数无效，9-连接失败)通过传入消息、参数、接收返回的Xml字符串b. Init(AIniDir: pChar):integer; 检查整个网络环境是否畅通，包括客户端与his服务器之间连接是否正常以及配置his数据库连接。可以指定His的配置文件的路径，如kwv40.ini 在serverhis路径下UnInit;stdcall; /释放退出时释放His连接2. 接收到接口程序的返回消息后，根据此返回结果，进行后续处理3. XML的字符串消息格式示例如下： 四. 接口流程图A. 门诊预约中心流程图： B. 住院预约中心流程图五. 接口流程说明门诊流程说明：1、 门诊医生为病人开处方，病人持处方去门诊收费处交费。2、 如果处方中含有检查或化验项目，病人到检查或化验科室后，检查或化验管理系统根据接口获取病人需要做的项目，然后为病人做相应的检查或化验。3、 做完后，检查或化验管理系统通过接口进行医技确认，目的在于通知HIS系统该项目已完成。4、 检查或化验的报告出来后，检查或化验管理系统应该调用接口把报告数据传给HIS，如果报告涉及到图像，检查或化验管理系统应该提供插件供HIS浏览报告。住院流程说明： 1、住院医生为病人开申请，护士审核并执行申请。2、如果申请中含有检查或化验项目，病人到检查或化验科室后，检查或化验管理系统根据接口获取病人需要做的项目，然后为病人做相应的检查或化验。3、做完后，检查或化验管理系统通过接口进行医技确认，目的在于通知HIS系统该项目已完成。4、检查或化验的报告出来后，检查或化验管理系统应该调用接口把报告数据传给HIS，如果报告涉及到图像，检查或化验管理系统应该提供插件供HIS浏览报告。住院特殊流程说明：1、住院医生为病人开申请，护士审核并执行申请。2、如果申请中含有检查或化验项目，病人到检查或化验科室后，检查或化验管理系统根据接口获取病人需要做的项目，然后为病人做相应的检查登记或化验取样。3、做完后，检查或化验管理系统通过接口进行医技确认，目的在于通知HIS系统该项目已登记。4、当检查完成或标本入库后，检查或化验管理系统应该调用接口对病人项目进行记费。其他流程说明：1、 在门诊发票上的打印预约地点信息在HIS的收费小项目库中的项目说明中维护好预约地点，并在发票中打印出来。通过后台任务从RIS同步HIS的预约地点信息。2、 检查科室增加费用如果是门诊病人，可以增加项目和药品信息，HIS提供可选择项目信息（检查和材料信息），可选择药品信息(指定分类的急诊药房药品信息)，检查科室在RIS中增加项目/药品后保存到HIS的数据库中，病人到门诊收费处收费后，如果有药品，则去急诊药房领药后，返回检查科室继续检查。如果是住院病人，则只能增加项目信息，项目信息直接保存到HIS数据库中后检查科室进行确认后完成检查。如果需要增加药品，则通知住院医生增加药品后，护士审核执行后，由中心药房发药后，再到检查科室完成检查。3、 门诊退费病人可在退费中取消预约信息当门诊病人想退费时，按发票号选择出收费明细信息，操作员选择需要退费项目，如果退费项目属于已预约项目，则通过RIS接口判断是否可以取消病人预约信息，当RIS接口返回结果为是时，则提示操作员是否需要继续取消RIS中的预约信息，如果病人确定要取消，则通过RIS接口取消RIS中的预约信息，接口RIS接口返回取消预约成功后，操作员继续进行退费处理。4、 门诊医生站输入处方时预约地点提示在门诊医生站输入项目信息时，如果属于预约项目，则在保存处方时提醒医生，病人的哪些项目属于预约项目，项目应该到哪个预约中心预约。5、 门诊医生站显示预约结果在门诊医生站的汇总信息中显示已预约的时间、地点、注意事项。六. 接口列表业务范围接口代码接口说明基础数据YY01科室信息YY02人员信息YY03项目信息YY04临床项目信息YY05药品信息病人信息及项目信息JB01申请病人信息JB02申请病人列表JB03申请项目信息项目确认QF01项目确认/取消/退费 (正常流程使用)QF02住院项目确认（无确费）(特殊情况下使用)QF03住院项目确费 (特殊情况下使用)QR01预约确认/取消AD01增加项目/药品MD01修改项目预约地点MD02修改已增加的项目/药品信息报告发布BG01报告发布BG02报告回收BG03报告结果回传其他SS01获取病人的手术信息七. 接口格式说明1. 获取科室信息 YY01调用类型：YY01 输入信息：无 输出信息： 序号字符名字符长度说 明1id4科室代码2name32科室名称3py8拼音4wb8五笔2. 获取人员信息YY02调用类型：YY02输入信息：无输出信息：序号字符名字符长度说明1id6人员代码2name12人员名称3py8拼音4wb8五笔3. 获取项目信息 YY03调用类型：YY03输入信息：序号字符名字符长度说明1codetype1查询类别：0:拼音 1：五笔 2：项目代码2code20查询值 输出信息：序号字符名字符长度说明1id12项目代码2name32项目名称3py8拼音4wb8五笔5xmdj19项目价格6mzbz1门诊标志（0门诊不使用1门诊使用）7zybz1住院标志（0住院不使用1门诊使用）4. 获取临床项目信息 YY04调用类型: YY04 输入信息：空 输出信息：序号字符名字符长度说明1id12项目代码2name32项目名称3py8拼音4wb8五笔5xmdj19项目价格6mzbz1门诊标志（0门诊不使用1门诊使用）7zybz1住院标志（0住院不使用1门诊使用）5. 获取药品信息 YY05 调用类型：YY05 输入信息：序号字符名字符长度说明1codetype1查询类别：0:拼音 1：五笔 2：药品代码2code20查询值3yfdm10药房代码输出信息：序号字符名字符长度说明1idm10药品内码2ypdm12药品代码3ypmc64药品名称4ypgg32药品规格5ylsj16零售价格6mzxs12门诊系数7mzdw12门诊单位8ypsl12药品数量6. 申请病人信息 JB01调用类型：JB01输入信息：序号字符名字符长度说明(1)codetype1病人状态,取值为151：住院/门诊号指病历号；2：卡号；3：PatientID his中的 patid(门诊)patid(住院)；4：CureNohis中的ghsjh (门诊),和syxh(住院)；5：条形码；(2)code20查询值，codetype类别对应的值，用于查找基本信息(3)brlb1病人类别0:门诊1：住院3：体检输出信息（门诊、住院）：序号字符名字符长度说明(1)patientid10病人唯一内码(2)hospno24门诊号（住院则为住院号）(3)patname12病人名称(4)sex4性别(男:1,女2,其他3)(5)age10年龄(6)ageunit12年龄单位(例如岁)(7)wardorreg1病区标志（干保病人使用=2）(8)chargetype4医保代码(9)cureno10病人唯一码(10)cardno32病人卡号(11)applydept6科室代码(12)ward6病区代码(住院使用)(13)bedno12床号(14)applydoctor6医生代码(15)clincdesc20诊断代码(16)idnum18身份证号(17)phone16电话(18)address64地址(19)zip6邮编(20)career4职业(21)nation20国家(22)todoc6申请医生(23)sendno10申请单号(24)syxh12住院首页序号(25)bqmc50病区名称(住院使用)(26)yexh12婴儿序号(27)deptName64科室名称 输出信息（体检）：序号字符名字符长度说明(1)patientid10病人唯一内码(2)hospno24门诊号（住院则为住院号）(3)patname12病人名称(4)sex4性别(男:1,女2,其他3)(5)age10年龄(6)ageunit12年龄单位(例如岁)(7)chargetype4医保代码(8)wardOrReg1病区标志(9)cureNo10病人唯一码(10)tjrybh10体检人员编号(体检人员内部编号，同CureNo字段)(11)cardno32病人卡号(12)applydept6科室代码(13)ward6病区代码(14)bedno12床号(15)todoc6申请医生(16)clincdesc20诊断代码(17)idnum18身份证号(18)phone16电话(19)address64地址(20)zip6邮编(21)career4职业(22)nation20国家(23)qfyy8区分意义(24)deptName64科室名称7. 申请病人列表 JB02 调用类型：JB02 输入信息： 序号字符名字符长度说明1ksrq16开始日期2jsrq16结束日期3zxks6科室代码（如B超等）4brlb10:门诊1：住院3：体检 5blh24病历号（blh）/体检号6fph25发票号码7codetype1查询方式：0磁卡；1体检号输出信息：序号字符名字符长度说明1blh24门诊号或者住院号2brlb10：门诊1：住院3：体检3patid10病人唯一码4syxh10首页序号5qqrq16申请日期6qqks12请求科室代码7ysmc12医生名称8qqxh12请求序号9hzxm20病人姓名10tjrybh20体检人员编号11bqdm12病区代码12cwdm12床位代码13bqmc32病区名称14sqdxh12申请单序号15kdysks32开单医生科室名称8. 申请项目信息 JB03调用类型：JB03输入信息：序号字符名字符长度说明1blh24门诊号或者住院号2brlb10：门诊1：住院 3:体检3patid10病人唯一码4syxh10首页序号5qqxh10申请序号6tjrybh20体检人员编号7rq116开始日期8rq216结束日期9zxks4执行科室代码输出信息（门诊、住院）：序号字符名字符长度说明1blh24门诊号或者住院号/体检号2brlb10：门诊1：住院 3：体检3patid10病人唯一吗4syxh10首页序号5qqxh10申请序号（序号）6qqmxxh10申请序号（明细序号）由于这个序号在确费时要求传入，因此增加了这个字段的输出7qqksmc32请求科室名称8ysmc12医生名称9qqrq16请求日期10itemcode12项目代码11itemname32项目名称12price19项目价格13itemqty10项目数量14itemunit12项目单位15url50申请单信息路径url16itemtype2项目类别（0临床项目1收费项目）17jzbz20：门诊 1：急诊 18ysdm12医生代码（门诊返回）输出信息（体检）：序号字符名字符长度说明1blh24门诊号或者住院号/体检号2brlb10：门诊1：住院 3：体检3patid10病人唯一吗4syxh10首页序号5qqxh10申请序号（序号）6qqmxxh10申请序号（明细序号）由于这个序号在确费时要求传入，因此增加了这个字段的输出7qqksmc32请求科室名称8ysmc12医生名称9qqrq16请求日期10itemcode12项目代码11itemname32项目名称12price19项目价格13Itemqty10项目数量14itemunit12项目单位15url50申请单信息路径url16itemtype2项目类别（0临床项目1收费项目）17jzbz20：门诊 1：急诊 18tjrybh20体检人员编号9. 项目确认/取消/退费 QF01调用类型：QF01输入信息：序号字符名字符长度说明1blh24门诊号或者住院号2brlb10：门诊1：住院 3：体检3xmlb10临床项目1收费项目(JB03- itemtype)4patid10病人唯一码5syxh10首页序号6zxksdm10确认科室代码(需要接口传入是哪个科室进行确费的)7zxysdm10确认人员代码(需要接口传入是哪个操作员进行确费的)8qqxh10申请序号9qqmxxh10申请序号（明细序号）由于这个序号在确费时要求传入，在返回中已经增加了这个字段的输出10itemcode12项目代码11itemname32项目名称12price19项目单价13itemqty10项目数量14xmstatus1项目状态：0不处理1确认2拒绝3撤销(增加撤销处理)15sfflag1收费状态：0不收费1收费2退费 16djlb1单价类别(0:使用原来的单价1：自定义价格)17bgdh32报告单号18bglx12报告类型19tssm100自定义单价时需要给出解释，否则确费不成功如果需要使用自定义单价则djlb需要设置为1同时给出说明his会纪录到对应的项目信息的备注上面20tjrybh12体检人员编号输出信息：无10. 住院项目确认（无确费）QF02调用类型：QF02 (特殊流程使用)输入信息：序号字符名字符长度说明1blh24住院号2brlb11：住院 （默认为1）3xmlb10临床项目1收费项目(JB03- itemtype)4patid10病人唯一码5syxh10首页序号6zxksdm10确认科室代码(需要接口传入是哪个科室进行确费的)7zxysdm10确认人员代码(需要接口传入是哪个操作员进行确费的)8qqxh10申请序号9qqmxxh10申请序号（明细序号）由于这个序号在确费时要求传入，在返回中已经增加了这个字段的输出10itemcode12项目代码11itemname32项目名称12price19项目单价13itemqty10项目数量14xmstatus1项目状态：1确认3撤销(增加撤销处理)15sfflag1收费状态：0不收费16djlb1单价类别(0:使用原来的单价1：自定义价格)17bgdh32报告单号18bglx12报告类型19tssm100自定义单价时需要给出解释，否则确费不成功如果需要使用自定义单价则djlb需要设置为1同时给出说明his会纪录到对应的项目信息的备注上面20tjrybh12体检人员编号（传空）输出信息：无11. 住院项目确费QF03调用类型：QF03 (特殊流程使用)输入信息：序号字符名字符长度说明1blh24住院号2brlb11：住院 （默认为1）3xmlb10临床项目1收费项目(JB03- itemtype)4patid10病人唯一码5syxh10首页序号6zxksdm10确认科室代码(需要接口传入是哪个科室进行确费的)7zxysdm10确认人员代码(需要接口传入是哪个操作员进行确费的)8qqxh10申请序号9qqmxxh10申请序号（明细序号）由于这个序号在确费时要求传入，在返回中已经增加了这个字段的输出10itemcode12项目代码11itemname32项目名称12price19项目单价13itemqty10项目数量14xmstatus1项目状态：0不处理15sfflag1收费状态：1收费2退费16djlb1单价类别(0:使用原来的单价1：自定义价格)17bgdh32报告单号18bglx12报告类型19tssm100自定义单价时需要给出解释，否则确费不成功如果需要使用自定义单价则djlb需要设置为1同时给出说明his会纪录到对应的项目信息的备注上面20tjrybh12体检人员编号（传空）输出信息：无12. 预约确认/取消 QR01调用类型：QR01输入信息：序号字符名字符长度说明1blh24门诊号或者住院号2brlb10：门诊1：住院3xmlb10临床项目1收费项目4patid10病人唯一吗5syxh10首页序号6yyksdm10预约科室代码(需要接口传入是哪个科室进行确费的)7yyysdm10预约人员代码(需要接口传入是哪个操作员进行确费的)8yyqqxh10HIS申请序号9yymxxh10HIS申请序号（明细序号）10yycode12预约项目代码11yyname32预约项目名称12yydjprice19预约项目单价13yyxmslitemqty10预约项目数量14yyflag1预约标志 （1确认预约2拒绝预约）15yfflag1收费标志 (0 不收费1收费2退费 )16djlb1单价类别(0:使用原来的单价1：自定义价格)17tssm100自定义单价时需要给出解释，否则确费不成功如果需要使用自定义单价则djlb需要设置为1同时给出说明his会纪录到对应的项目信息的备注上面18yysj16预约时间 格式为 2007010110:00:0019yyaddr100预约地点20notice200注意事项输出信息： 序号字符名字符长度说明1qrbz1确认成功标志（0-成功，1-失败）2errmsg255返回失败的错误信息13. 增加项目信息AD01调用类型：AD01 输入信息：序号字符名字符长度说明1brlb10门诊 1住院 2patid12对应于his中的 patid(门诊),patid(住院)3curno20对应于his中的ghsjh (门诊),和syxh(住院)4zxksdm6项目执行科室代码/药品为药房代码5zxysdm6增加医生代码6xmdm12增加项目代码(药品时为idm)7xmdj20增加项目单价8xmsl10增加项目数量9xmlb1项目类别1收费项目2药品项目10qqksdm6申请增加项目（药品）的科室代码11qqysdm6申请增加项目(药品)医生代码12djlb10：使用原来单价 1：自定义单价13tssm100自定义单价说明输出信息： 序号字符名字符长度说明1F或applyNo2增加成功状态（F-失败,其他都为成功）2errmsg255返回失败的错误信息14. 修改预约地点 MD01调用类型：MD01 输入信息：序号字符名字符长度说明1id12收费项目的编码（唯一）2yydd255收费小项目的预约地点输出信息： 序号字符名字符长度说明1qrbz1增加成功标志（0-成功，1-失败）2errmsg255返回失败的错误信息15. 修改预约确认信息 MD02调用类型：MD02输入信息：序号字符名字符长度说明1blh24门诊号或者住院号2brlb10：门诊1：住院3xmlb10临床项目1收费项目4patid10病人唯一吗5syxh10首页序号6yyksdm10预约科室代码(需要接口传入是哪个科室进行确费的)7yyysdm10预约人员代码(需要接口传入是哪个操作员进行确费的)8yyqqxh10HIS申请序号9yymxxh10HIS申请序号（明细序号）10yycode12预约项目代码11yyname32预约项目名称12yydj19预约项目单价13yyxmslitemqty10预约项目数量14yyflag1预约标志 （1确认预约2拒绝预约）15yfflag1收费标志 (0不收费 1收费2退费 )16djlb1单价类别(0:使用原来的单价1：自定义价格)17tssm100自定义单价时需要给出解释，否则确费不成功如果需要使用自定义单价则djlb需要设置为1同时给出说明his会纪录到对应的项目信息的备注上面18yysj16预约时间 格式为 2007010110:00:0019yyaddr100预约地点20notice200注意事项输出信息： 序号字符名字符长度说明1qrbz1修改成功标志（0-成功，1-失败）2errmsg255返回失败的错误信息16. 报告发布 BG01调用类型：BG01输入信息：序号字符名字符长度说明(1)repno10报告单申请号(2)reqno10原始申请号(3)syxh10首页序号(4)patid10病人内码(5)blh24病历号(体检人员编号)(6)cardno32卡号(7)hzxm12患者姓名(8)sex4性别(9)age3年龄(10)sjksdm6送检科室(11)sjksmc32送检科室名称(12)bqdm6病区编码(13)bqmc32病区名称(14)cwdm12床位号(15)sjysdm6送检医生(16)sjysxm12送检医生姓名(17)sjrq16送检日期(18)replb12报告单类别编码(19)replbmc32报告单类别名称(20)reprq16报告单日期(21)xtbz1系统标志 0：门诊 1：住院 3：体检(22)jcbw200检查部位(23)jcysdm16检查医生代码(24)jcysxm16检查医生姓名(25)jcksdm16检查科室代码(26)jcksmc64检查科室名称(27)pubtime16发布日期输出信息：无17. 报告回收 BG02调用类型：BG02输入信息：序号字符名字符长度说明(1)repno30报告单号(2)replb10报告类别(3)hslb1类别（0：回收1：查询）输出信息：具体错误信息，如果不能回收显示具体信息。18. 报告结果回传 BG03调用类型：BG03 输入信息：序号字符名字符长度说明1repno30报告单号(不允许为空)2replb10报告类别(不允许为空)3xmdm20医技项目代码4xmmc40医技项目名称5xmjg255项目结果6xm