医技接口说明文档.doc

(完整版)医技接口说明文档

< THIS4。0与医技系统流程及说明文档〉

版本 〈4.0>

一. 概述
目前,已经有很多医院采用了上海金仕达卫宁公司的医院管理系统,而对于医院的LIS、RIS、PACS及其他信息系统（以下统称为医技系统）可能采用不同的产品，这些系统与HIS系统都是医院信息化范畴内的相互完全独立的子系统，没有实现数据的共享，例如一个检验系统里的检验结果还需要在体检系统里再次录入，因此这种重复录入工作占据了很大的工作比重，既影响了医院的工作效率又常常因为重复录入不一致造成数据不准确.
基于以上原因，我们提供第三方的开放性接口实现各子系统之间的数据共享,从而大大提高了医院资源的合理利用率。

二. 医院系统的环境与接口方式
根据目前医院使用的操作系统,客户端基本采用Windows环境，采用客户端直接调用存储过程的方式来完成数据交换与访问.
三. 接口流程图

四. 接口列表
序号
接口代码
接口说明
1
usp_yjjk_jcbrfb
检查报告发布
2
usp_yjjk_jg_huishou
检查报告回收
3
usp_yjjk_yjjgfb
医技结果发布
4
usp_yjjk_getpzxxlist
获取科室列表
5
usp_yjjk_getpzxxlist
获取职工列表
6
usp_yjjk_getpzxxlist
获取病区列表
7
usp_yjjk_getxmlist
获取项目列表
8
usp_yjjk_getdruginfo
获取药品信息
9
usp_yjjk_getbrxx
读取病人基本信息
10
usp_yjjk_getbrlist
根据时间段获取需要做检查的病人结果集
11
usp_yjjk_getwzxxm
根据当前某个病人id获取需要做的检查项目信息
12
usp_yjjk_yjqr
传入需要确费项目(根据标志也可以进行退费)
13
usp_yjjk_bgztxg
报告状态修改
14
usp_yjjk_addyjqq
增加项目/药品
15
usp_yjjk_ModifyYydd
修改项目预约地点
16
usp_mz_bryjjbj
门诊病人预交金报警,取得余额
17
tr_sf_ys_report_class
同步视图YJ_REPORT_CLASS数据
18
usp_yjjk_getsqdlist
查询申请单列表
19
usp_yjjk_getsqdxx
读取申请单详细信息
20
yy_mzsfjk。dll
医技收费接口

五. 接口格式说明

1. 检查报告发布
调用类型：usp_yjjk_jcbrfb
实现功能：提供医技系统报告发布,主要是记录报告的主记录，包括报告号、申请号、病人基本信息、报告医生、报告时间等数据。
前提条件：医技系统确认项目后
相关库表：SF_YS_REPORT（THIS4_REPORT.。YJ_REPORT）

2. 检查报告回收
调用类型：usp_yjjk_jg_huishou
实现功能:提供已经发布报告的回收
前提条件：已经发布了报告主记录
相关库表：SF_YS_REPORT（THIS4_REPORT..YJ_REPORT)

3. 医技结果发布
调用类型：usp_yjjk_yjjgfb
实现功能:提供医技系统报告明细发布，只记录文字信息
前提条件：已经发布了报告主记录
相关库表:SF_JCJGK、SF_YJJGK(YJ_RIS_RESULT、YJ_LIS_RESULT）

4. 获取科室信息
调用类型：usp_yjjk_getpzxxlist
实现功能：获取HIS中科室列表
相关库表：YY_KSBMK

5. 获取病区信息
调用类型：usp_yjjk_getpzxxlist
实现功能：获取HIS中病区列表
相关库表：YY_BQDMK

6. 获取职工信息
调用类型：usp_yjjk_getpzxxlist
实现功能：获取HIS中职工列表
相关库表：YY_ZGBMK

7. 获取项目信息
调用类型：usp_yjjk_getxmlist
实现功能:获取项目信息
相关库表：YY_LCSFXMK、YY_SFXXMK

8. 获取药品信息
调用类型：usp_yjjk_getdruginfo
实现功能：获取药品信息，根据药房取相应的药品列表
相关库表：YK_YPCDMLK

9. 读取病人基本信息
调用类型：usp_yjjk_getbrxx
实现功能：根据条件获取病人的基本信息，条件包括卡号、patid、syxh等；门诊取一条结算库中的记录的相关信息，住院取在院病人的相关信息
相关库表：
门诊：SF_BRJSK、SF_NBRJSK、SF_BRXXK、YY_DQDMK
住院：ZY_BRSYK、ZY_BRXXK、YY_DQDMK、YY_ZYDMK、YY_MZDMK、ZY_BQDMK

10. 查询需要检查病人的列表
调用类型:usp_yjjk_getbrlist
实现功能：根据条件获取病人列表，
条件说明：
@hzxm 根据病人姓名过滤（为空表示不过滤）
@ksdm 根据病人挂号科室代码过滤(为空表示不过滤）
＠bqdm 根据病人就诊病区代码过滤（为空表示不过滤），门诊不使用、住院使用
@cwdm 根据病人床位代码过滤（为空表示不过滤），门诊不使用、住院使用
＠rq1 开始日期 门诊指挂号时间，住院不处理
＠rq2 结束日期 门诊指挂号时间，住院不处理
@fph 发票号 门诊使用，0表示不过滤
相关库表：
门诊:SF_BRXXK,SF_BRJSK（VW_MZBRJSK)
住院：ZY_BRXXK， ZY_BRSYK， YY_KSBMK， ZY_BQDMK

11. 获取病人未收费的项目明细
调用类型： usp_yjjk_getwzxxm
实现功能：根据条件获取病人未确认的项目列表
条件说明：
＠brlb 病人类别 0门诊 1住院 3体检
@patid 病人patid 门诊patid,住院patid
@cureno 病人号码 门诊不处理，住院syxh
@rq1 开始日期
@rq2 结束日期
＠sqdxh 申请单序号 为0表示不过滤
执行结果:
门诊:返回非药品和体检的收费项目，临床项目作为单条记录处理，项目包括年表中的数据
a. 普通流程：返回已经收费未确认的项目
b. 优化流程：返回未收费未确认和已经收费未确认的项目
住院：返回需要住院医技确认的收费项目，临床项目作为单条记录处理，如果5172设置为是且病人年龄小于14岁时，项目价格返回为处理了特需比例后的价格
相关库表：
门诊： VW_MZCFK，VW_MZCFMXK，YY_LCSFXMK,VW_MZBRJSK，SF_MZSQD
SF_MZSQDMXK，SF_HJCFK，SF_HJCFMXK，YY_SFXXMK
住院： ZY_BRSYK,BQ_YJQQK，YY_LCSFXMK，YY_SFXXMK，YY_LCSFXMDYK
ZY_BRSQD,ZY_BRSQDMXK，YY_TSSFXMK
12. 项目确费
调用类型:usp_yjjk_yjqr
实现功能：
a. 实现未确认项目的确认（项目列表由“获取病人未收费的项目明细"获取)
b. 实现已经确认项目的退费、撤销功能
c. 住院确认和退费时同时处理相关费用即实现计费和退费功能
条件说明：
＠xmdj 项目单价，如原来项目为零，取输入条件中的价格，否则取价格表中的价格
@xmstatus 确认标志0不处理1确认2拒绝3撤销
@sfflag 收费标志0不处理1收费2退费
＠bgdh 报告单号，处理医技报告单号的保存
@bglx 报告类型,处理医技报告类型的保存
相关库表:
门诊：SF_HJCFK，SF_HJCFMXK，SF_MZSQD,SF_MZCFK，SF_CFMXK，SF_NMZCFK，SF_NCFMXK
住院：BQ_YJQQK，ZY_BRSQD，确费调用usp_zy_brqf处理

13. 报告状态修改
调用类型：usp_yjjk_bgztxg
实现功能:完成明细项目对应状态的保存和修改，新建表MZ_YJXMZTK，BQ_YJXMZTK对应相关数据的处理
条件说明：
@bgzt 报告状态0未发布 1发布
＠txzt 图像状态,0未发布 1发布
＠jczt 检查状态
报告检查状态      LIS                 RIS
  10       采样状态               预约状态
  20       签收状态               登记状态
  30       入库状态               检查状态
  40       初始报告               初始报告
  50       审核报告               审核报告
  60       发布报告               发布报告
＠logno 明细序号集合，多个项目用”,”分隔
相关库表:
VW_MZHJCFMXK,VW_MZCFMXK，MZ_YJXMZTK，MZ_NYJXMZTK，BQ_YJXMZTK，BQ_NYJXMZTK
14. 增加项目信息
调用类型：usp_yjjk_addyjqq
实现功能:增加对应病人的项目，门诊增加到SF_HJCFK和SF_HJCFMXK中，住院增加到BQ_YJQQK中，该接口不处理相关的收费功能
条件说明：
＠brlb 病人类别 0门诊 1住院
@patid 病人唯一号 patid（门诊)，patid（住院)
＠curno 病人号 syxh（住院)
＠zxksdm 执行科室代码
@zxysdm 执行医生代码
＠xmdm 项目代码
@xmdj 项目单价，如原来项目为零,此价格才有用,否则要取项目中的价格
@xmsl 项目数量
@xmlb 项目类别0临床项目1收费项目2药品项目
@qqksdm ut_ksdm=’'， ——申请科室代码
@qqysdm ut_czyh=’' —-申请医生代码
相关库表：
门诊：SF_BRXXK，GH_GHZDK，YY_SFXXMK，YY_LCSFXMK，YK_YPCDMLK，SF_XDCFMXK，YY_JZBRK,SF_HJCFK，SF_HJCFMXK
住院：ZY_BRSYK，YY_SFXXMK，YY_LCSFXMK，YK_YPCDMLK，YY_KSBMK，SF_XDCFMXK，VW_YJJGK_EX

15. 修改预约地点
调用类型：usp_yjjk_ModifyYydd
实现功能：更新收费项目备注信息
条件说明：
＠id 收费项目的编码
＠yydd 预约地点
相关库表:YY_SFXXMK

16. 门诊病人预交金报警
调用类型:usp_yjjk_getbrjexx
实现功能：取得优化流程病人（门诊）和住院病人押金余额信息，返回冻结金额、实际余额等信息
相关库表:
门诊：SF_BRXXK,YY_JZBRK，SF_BRJSK
住院：ZY_BRSYK，ZY_BRJSK，ZYB_BRYJK

17. 同步视图YJ_REPORT_CLASS数据
调用类型：tr_sf_ys_report_class
实现功能:同步HIS数据库和THIS4_REPORT数据库YJ_REPORT_CLASS表数据,根据参数0113判断是否同步

18. 查询申请单列表
调用类型：usp_yjjk_getsqdlist
实现功能：获取有申请单的病人列表和申请单序号
条件说明:
＠brlb 病人类别 0门诊 1住院
@cureno 病历号，为空表示不过滤
＠cardno 卡号码，为空表示不过滤
@hzxm 病人姓名,为空表示不过滤
@ksdm 科室代码，门诊是指病人挂号科室，住院指病人所在科室
@bqdm 病区代码，住院使用
@zxksdm 执行科室代码,为空表示不过滤
＠xmdm 项目代码，暂不使用
＠xmlb 项目类别,暂不使用
@xmstatus 项目状态，0未处理1已确认
@rq1 开始日期 门诊指挂号时间,住院不处理
@rq2 结束日期 门诊指挂号时间，住院不处理
相关库表：
门诊:SF_BRXXK，SF_MZSQD，YY_ZGBMK，YJ_SQDMBK,SF_HJCFK，SF_MZCFK
住院：ZY_BRXXK，ZY_BRSYK,YY_KSBMK,ZY_BQDMK，ZY_BRSQD,YY_ZGBMK，YJ_SQDMBK，BQ_LSYZK

19. 读取申请单详细信息
调用类型:usp_yjjk_getsqdxx
实现功能：显示对应申请单的明细信息
条件说明：
@brlb 病人类别 0门诊 1住院
@patid 病人唯一号 暂不使用
＠curno 病员号 暂不适用
@sqdh 申请单号
相关库表:
门诊：SF_MZSQDMXK 住院：ZY_BRSQDMXK

20. 医技收费接口
调用类型：yy_mzsfjk。dll
实现功能:提供接口实现优化流程病人收费结算的功能。
入口参数:
序号
入口参数
实现功能
调用说明
1
fServerConnect
数据连接（初始化）
返回值1成功0失败
2
fServerClose
关闭连接
返回值1成功0失败
4
fHisMzsf
读卡函数
返回值第一位T表示成功；为F表示失败后面为错误提示

六. 修改说明

Confidential
Ó金仕达卫宁
Page 11 of 11