地纬定点医院嵌入式接口服务方案核心平台三版v108.docx
- 文档编号:15961048
- 上传时间:2023-07-09
- 格式:DOCX
- 页数:103
- 大小:178.61KB
地纬定点医院嵌入式接口服务方案核心平台三版v108.docx
《地纬定点医院嵌入式接口服务方案核心平台三版v108.docx》由会员分享,可在线阅读,更多相关《地纬定点医院嵌入式接口服务方案核心平台三版v108.docx(103页珍藏版)》请在冰点文库上搜索。
地纬定点医院嵌入式接口服务方案核心平台三版v108
地纬定点医疗机构医保结算系统
核心平台三版接口服务方案
(1.0.8版本)
ShandongDarewayComputerSoftwareCo.,Ltd.
山东地纬计算机软件有限公司
Allrightsreserved
版权所有XX
2015年1月
修改记录
编号
日期
描述
版本
修改人
审核人
发布日期
1
2010-7-1
形成接口服务文档
1.0.0
王刚
杨道强
2010-8-1
2
2010-9-6
新增删除费用凭单,出院结算新增预结算标志
1.0.1
王加强
王刚
2010-9-6
3
2010-9-20
增加门诊预结算功能
1.0.2
王刚
王加强
2010-9-20
4
2012-3-16
增加省异地就医相关信息
1.0.3
郭伟
王刚
2012-3-16
5
2012-7-27
增加电子病历首页和医嘱
1.0.4
郭伟
王刚
2012-7-27
6
2012-8-8
增加对潍坊、济宁社保卡消费的支持
1.0.5
王刚
7
2012-12-12
增加下载医师功能
1.0.6
王加强
8
2013-9-17
增加对兖矿门诊结算住院结算时mzghzh(门诊),bxlb,qzjbzhzf的接收返回;
增加保存床位的方法;增加下载zybrxx服务
1.0.7
池振方
2015-01-11
更新sbjgbh为8位;更新枣庄mllb只有‘001’和‘002’。
1.0.8
谢佑通
本文档中所包含的信息属于机密信息,如无山东地纬计算机软件有限公司的书面许可,任何人都无权复制或利用。
第一章背景介绍
1.1金保工程
进入二十一世纪以来,计算机技术、通信技术和网络技术的高速发展,加快了社会经济的信息化进程,信息化已经成为当今世界经济和社会发展的大趋势。
劳动保障信息化建设是我国政府信息化建设的重要组成部分,一直受到党中央和各级政府部门的高度重视。
根据中办发〔2002〕17号文件精神,在全面总结劳动保障信息化工作多年经验的基础上,按照劳动保障事业发展的总体目标,以全国电子政务建设规划为指导,劳动保障部设计编制了金保工程项目建议书,于2002年递交国家发改委(原国家计委),正式向国家提出立项申请。
2003年8月,经国务院总理办公会讨论通过,金保工程正式获准国家立项,标志着我国劳动保障信息化工作进入了一个新的历史时期。
1.2核心平台三版(SICP3)
金保工程的主要内容包括两大系统即社会保险信息系统和劳动力市场信息系统,三级网络即市、省、中央三级数据库及其信息交互,四大功能即业务经办、公共服务、基金管理和决策支持。
核心平台三版是以城市级社会保险经办业务为核心,以实现基本养老保险、失业保险、基本医疗保险、工伤保险、生育保险主体业务经办和基金管理过程信息化为最终目标。
支持城市级的业务经办和基金管理,并通过其统计查询功能为决策支持提供服务,通过与劳动保障电话咨询中心及网站的连接提供公共服务,通过为市、省、中央三级网络及资源数据库提供数据源完成三级数据网建设。
1.3核心平台三版的技术架构
针对各地社会保险业务处理的特殊性,核心平台三版提供了适合社会保险业务的技术框架SICP3,其中包括安全、日志、交易、接口等服务。
在此技术框架之上,核心平台三版提供了社会保险业务的原子级业务处理。
同时,核心平台三版对于外部系统提供统一的接口方案,使得开发更加灵活,系统易于管理。
1.4核心平台三版的技术路线
1.核心平台三版开发采用SOA体系,利于互联互通,按照CMM的要求制定一系列开发规范,并通过质量保证小组最大程度地保证了核心平台三版的总体质量。
2.核心平台三版采用面向对象的分析和设计方法,在对指标体系改动最小的基础上,利用面向对象分析设计的优势,对不同层次采用不同的设计模式进行设计,即MVC模式。
3.核心平台三版采用统一的对外接口服务,无论是参保企业、银行、税务、劳动力市场还是医院、药店,都可以通过“接口服务”很快完成与核心平台三版的接口设计和开发。
4.核心平台三版采用基于J2EE的双兼容架构,并且参考了当前主流的Web应用框架(spring、struts),实现了适用于社会保险的企业级应用框架(SICP3)。
采用企业架构将业务逻辑处理集中到应用服务器,应用服务器具有良好的可扩展性,大大提高了系统的并发处理能力。
第二章接口设计方案
定点医疗机构业务是社会保险体系中的重要组成部分,定点医疗机构结算系统更是核心平台三版的核心外围业务系统之一。
为了更好的实现定点医疗机构结算系统与医院自身信息管理系统的对接,地纬公司研制设计了本接口系统。
“DW定点医院接口服务系统”是在地纬公司Dweaf快速开发框架的基础上,采用面向服务的应用程序开发(Services-orienteddevelopmentofapplication,SODA)使定点医院医保结算系统转换到面向服务架构(service-orientedarchitecture,SOA)。
“DW定点医院接口服务系统”集成了医疗保险定点医疗机构的所有结算业务服务(函数),这些函数供HIS系统调用,并支持重要结算信息的返回。
将该接口嵌入原医院管理系统后,医院管理系统可无缝连接到医疗保险网络信息系统。
接口完成以后,住院、门诊、门诊大病等主业务结算流程均完全嵌入医院HIS系统,通过DW定点医院接口,为各定点机构搭建了一个高品质、可管理、高可用性的信息集成平台,能够为HIS系统提供全面高效的服务。
2.1接口开发遵循的规范和标准
地纬公司在“DW定点医院接口服务系统”开发过程中,完全遵从金保工程“核心平台三版”的技术架构、指标体系和业务规范,系统符合《山东省劳动和社会保障管理信息系统总体方案》和劳动保障部关于核心平台三版信息系统建设的有关要求,可以完全实现医院自身信息管理系统与医保结算系统的无缝连接。
接口开发采用的产品、网络体系结构和通信协议采用国家相关标准、部门专业标准以及国际通用的工业标准,服从国家管理信息系统的规划和有关规定。
项目开发过程中所遵循的标准规范主要有:
●劳动和社会保险管理信息系统信息结构通则(LB001—2000)
●社会保险管理信息系统指标体系—业务部分(LB101-2000)
●《金保工程劳动力市场信息系统建设指导意见》
●ISO9000-3-97质量管理和质量保证标准
●EJB2.0规范
●GB/T17859—1999计算机信息系统安全保护等级划分准则
●GB/T17900—1999网络代理服务器的安全技术要求
●GB/T16680—1996软件文档管理指南
●GB/T14079—1993软件维护指南
●GB/T14394—1993计算机软件可靠性和可维护性管理
●GB/T12504—1990计算机软件质量保证计划规范
●GB/T12505—1990计算机软件配置管理计划规范
●GB1526-1989信息处理-数据流图、程序流程图、系统流程图、程序网络图和系统资源图的文件编制符号及约定
●GB/T8567—1988计算机软件产品开发文件编制指南
●GB/T9385—1988计算机软件需求说明编制指南
●GB/T9386—1988计算机软件测试文件编制规范
●GB/T10114—1988县以下行政区代码编制规则
●GB/T4754—1994国民经济行业分类与代码
●《山东地纬计算机软件有限公司质量体系程序文件》
2.2接口技术架构设计方案
“DW定点医院接口服务系统”是严格遵守“核心平台三版”的技术框架,采用基于Dweaf平台的多层体系结构模式,以集中式数据资源共享为基础,采用先进的O/RMapping映射机制实现了优良的面向对象开发方案,确保了系统具有高度的易用性、良好的扩展性和强大的可移植性。
“DW定点医院接口服务”完全遵守“核心平台三版”的业务指标体系和业务规范要求,并针对不同地区的业务研究分析后对业务指标体系进行了合理化扩展,实现了从软件配置上解决业务需求问题,做到快速开发、高度复用的要求。
2.2.1原定点结算系统技术框架
在实现接口服务前,地纬定点结算系统与医保核心端应用架构如下:
2.2.2接口服务技术框架
实现接口服务后,医院端与医保核心端应用架构如下:
从以上实现接口服务前后的技术框架可以看出,“DW定点医院接口服务”替代了原地纬结算系统中的应用服务层。
HIS开发商在其HIS系统中只需要将DW表示层中的相应界面展示完成后,即可实现与医保结算系统的无缝连接。
第三章接口使用说明
一、接口概述
本接口系统一共包含三个文件,分别为sei3.dll、Update.exe、dwupdate.pbd。
所有服务均集成在动态链接库sei3.dll中,这个dll文件需要注册成com组件。
Update.exe和dwupdate.pbd文件,用于接口升级。
以上三个文件必须在同一个目录中。
HIS系统只需要调用ProgramID为sei3的组件中的服务就可以了。
HIS系统完成接口调用开发以后,住院、门诊、门诊大病等主业务结算流程均完全嵌入医院HIS系统,数据传输等后台业务仍需要依靠地纬定点结算系统来完成。
下面将讲述接口的具体使用方法及例程。
(注:
本文提供的PB示例代码,作用是更直观的解释本方案内容,以方便HIS厂商进行开发,仅供参考之用。
)
二、接口环境
在运行结算系统的业务机上需要具备接口环境,具体操作如下:
1、将【接口库dll】文件夹中所有的dll文件拷入C:
\WINDOWS\system32下。
2、注册sei3.dll文件,sei3.dll为接口的类库文件,具体注册方法如下(其它dll无须注册):
3、sei3.dll注册方法:
点击开始->运行->输入regsvr32sei3.dll回车
如果显示“sei3.dll中的DLLRegisterServer”成功字样,说明注册成功。
三、接口实例创建、接口示例回收
在登陆HIS系统时需要进行接口实例的创建,创建成功以后,才能正常调用接口服务。
建议在HIS系统登陆的同时,调用接口登陆的服务,同时在退出HIS系统时,需要进行接口实例的回收,以免造成资源浪费。
1、接口实例的创建,创建ole对象
通过第二步操作,接口dll(sei3.dll)已经被注册成了COM组件。
每种开发语言都有自己调用COM组件的方式。
HIS开发人员可以根据自己所使用的开发语言来调用本接口的COM组件,创建接口对象的实例。
本接口的Programid为:
sei3,Classid为:
E734EBF4-CC87-446A-8497-B792A1BF21BD。
PB示例,各种开发语言方法不同,下面代码仅供PB程序员参考:
//创建地纬嵌入式接口对象,调用com组件
intvi
Oleobjectsei
sei=createOleobject//创建ole对象seiproxy
vi=sei.connecttonewobject('sei3')//连接com组件
ifvi<>0then
messagebox('错误','创建地纬嵌入式接口sei对象失败!
')
return
endif
2、接口实例的回收:
在不使用本接口的时候,需要回收接口实例,以免造成资源浪费。
PB示例,各种开发语言方法不同,下面代码仅供PB程序员参考:
:
//销毁地纬嵌入式接口对象
sei.DisconnectObject()//DisconnectObject方法为PB语言的系统函数
Destroysei
四、接口方法说明
本接口为您提供9个方法(见表4-1),使用这9个方法可以调用接口中的任何一个服务。
表4-1接口提供的方法
方法作用
方法名称
返回类型
说明
传入参数
resetvar
long
清空上传参数缓存区
putvarstring
long
向某个服务传入字符串类型的变量
putvardec
long
向某个服务传入数字类型的变量
putvardatetime
long
向某个服务传入时间类型的变量
执行服务
request_service
long
调用接口中的某个服务
get_errtext
string
获取服务执行过程中产生的错误
接收返回值
getvarstring
string
接受服务执行成功后返回的字符串变量
getvardec
decimal
接受服务执行成功后返回的数字变量
getvardatetime
datetime
接受服务执行成功后返回的时间变量
1、传入参数的方法
(1)方法名称:
resetvar()returnlong
方法作用:
清空上传参数缓存区
参数说明:
无
返回值说明:
0代表成功,其他代表失败
(2)方法名称:
putvarstring(stringname,stringvalue)returnlong
方法作用:
向某个服务传入字符串类型的变量
参数说明:
name传入参数的名称
value传入参数的值,字符串类型
返回值说明:
0代表成功,其他代表失败
(3)方法名称:
putvardec(stringname,decimalvalue)returnlong
方法作用:
向某个服务传入数字类型的变量
参数说明:
name传入参数的名称
value传入参数的值,数字类型
返回值说明:
0代表成功,其他代表失败
(4)方法名称:
putvardatetime(stringname,datetimevalue)returnlong
方法作用:
向某个服务传入datetime类型的变量
参数说明:
name传入参数的名称
value传入参数的值,datetime类型
返回值说明:
0代表成功,其他代表失败
2、执行服务的方法
(1)方法名称:
request_service(stringserviceName)returnlong
方法作用:
执行接口中的指定的服务
参数说明:
serviceName需要执行的服务的名称
返回值说明:
0代表成功,其他代表失败
(2)方法名称:
get_errtext()returnstring
方法作用:
当request_service的返回值不为零的时候,调用该方法,用来获取服务执行过程中的错误信息
参数说明:
无
返回值说明:
执行服务中产生的错误信息
2、接受返回值的方法
(1)方法名称:
getvarstring(stringname)returnstring
方法作用:
接受服务执行成功后返回的字符串类型变量
参数说明:
name要接受的变量的名称
返回值说明:
传入的参数名称对应的参数值
(2)方法名称:
getvardec(stringname)returndecimal
方法作用:
接受服务执行成功后返回的数字类型变量
参数说明:
name要接受的变量的名称
返回值说明:
传入的参数名称对应的参数值
(3)方法名称:
getvardatetime(stringname)returndatetime
方法作用:
接受服务执行成功后返回的时间类型变量
参数说明:
name要接受的变量的名称
返回值说明:
传入的参数名称对应的参数值
五、接口服务概述
通过调用本接口提供的相关服务,可以实现系统的登录初始化,获取参保人信息,进行住院相关业务,门诊的相关业务,个账消费的相关业务。
下图为本接口提供的部分服务的流程概括图。
1、每次调用住院相关的服务之前(除了住院登记save_zydj)都必须首先调用住院初始化服务(init_zy)。
2、每次调用门诊结算相关的服务之前都必须首先调用门诊初始化初始化服务(init_mz)。
3、每次调用个人账户消费流程之前都必须首先调用住院初始化服务(init_gz)。
4、每次调用撤销住院相关的服务之前都必须首先调用住院初始化服务(init_zy)。
第四章、业务服务应用说明
一、基础业务相关服务
1、接口登陆服务:
服务名称:
init
服务作用:
用于登陆地纬定点医疗机构结算系统。
服务返回值:
返回值
说明
0
代表成功登录地纬定点医疗机构结算系统。
-800
代表接口需要升级,请退出系统重新登录,重新登录之后会系统会自动升级
其他
代表登陆地纬定点医疗机构结算系统失败(失败原因可以通过方法get_errtext()获取)
传入参数:
参数名称
类型
中文名称
说明
yybm
string
医院编码
登录地纬系统的医院的编码
gzrybh
string
工作人员编号
医院的工作人员的编号(4位)
pwd
string
工作人员密码
用于登录地纬系统的密码
其中标注*的为必传参数禁止为空
服务说明:
如果在调用init服务之前没有传入参数yybm(医院编码),gzrybh(工作人员),pwd(密码),本接口程序会弹出结算系统的登陆界面,让操作员输入编号和密码进行登陆。
如果传入了上面的三个变量,并且工作人员编号和密码都正确,接口程序不会弹出登录界面,接口会自动登录。
在调用其他服务之前必须先调用一下该服务,用于登陆地纬医保结算系统数据库,如果登陆失败,所有业务均无法正常运行。
PB示例代码:
//登陆地纬医疗机构结算系统
sei.resetvar()
sei.putvarstring("yybm","370101")
sei.putvarstring("gzrybh","0001")
sei.putvarstring("pwd","1234")
vi=sei.request_service("init")
ifvi=-800then
//表示接口需要升级,此时应该关闭HIS程序,重新启动HIS程序后接口会自动升级
haltclose
endif
ifvi<>0then
errtext=sei.get_errtext()
messagebox('登陆失败','错误号:
'+string(vi)+'错误信息:
'+errtext)
return
endif
messagebox("信息","地纬接口登陆成功!
")
2、查询有卡人员基本信息服务
服务名称:
read_card
服务作用:
读取卡片信息,取得人员相关信息。
服务返回值:
返回值
说明
0
代表成功
其他
代表失败,请使用get_errtext()方法获取错误信息
传入参数:
参数名称
类型
中文名称
说明
yltclb
string
*医疗统筹类别
0为取卡片基本信息,1为住院,4为门诊大病(特病),6为普通门诊
jymmbz
string
校验密码标志
‘1’代表校验密码,‘0’代表不校验密码,(可选参数)
readertype
string
读卡器类型
(可选参数)
其中标注*的为必传参数禁止为空
返回结果集:
标识名
中文名称
类型
长度
说明
sbjgbh
*社保机构编号
string
8
获取持卡人所在的社保机构编号
rqlb
*人群类别
string
3
获取人群类别(A:
职工,B:
居民)
kh
*卡号
string
30
获取持卡人的卡号
grbh
*个人编号
string
18
获取持卡人的个人编号
xm
*姓名
string
50
获取持卡人的姓名
xb
性别
string
3
1:
男,2:
女,9:
不确定
ye
账户余额
decimal
16
获取持卡人的账户余额
zfbz
*灰名单标志
string
3
0代表灰名单,1代表白名单
zfsm
灰名单原因
string
无
如果是白名单该值为空
dwmc
单位名称
string
无
获取持卡人所属单位名称
ylrylb
医疗人员类别
string
20
获取持卡人的医疗人员类别(内容为汉字)
ydbz
异地标志
string
3
1代表是异地,0代表不是异地
mzdbjbs
疾病编码
string
无
获取门诊大病的疾病编码
zhzybz
住院记录
string
3
有无15(医保参数制)天内的住院记录1为有,0为无
zhzysm
住院记录说明
string
无
15(医保参数控制)天内的住院记录说明
zcyymc
转出医院名称
string
无
本结果如果不为空字符串即’’和’*’,则表示本次住院是从市内转院来的
zccyrq
转院出院日期
string
无
获取转出医院的出院日期
sfzhm
身份证号码
string
18
获取持卡人的身份证号码
csrq
出生日期
string
8
获取持卡人的出生日期(格式:
yyyymmdd)
ptmztcbz
普通门诊统筹备注
stirng
无
普通门诊统筹的地方可以接受这个变量。
如果没有普通门诊统筹,该变量返回空
sfxsptmztc
是否享受普通门诊统筹
string
无
说明该参保人是否享受普通门诊统筹。
只有普通门诊统筹的地方才能用到。
没有普通门诊统筹该变量返回空
mzdbbz
门诊大病备注
string
无
门诊大病备注信息,主要显示参保人还差多少钱到限额。
在yltclb=4的时候可以接一下这个变量,其他情况该变量为空。
Cbdsbh
参保地市编号
String
无
省异地结算标示异地人员信息
Cbjgmc
参保机构名称
String
无
省异地结算标示异地人员信息
中文名称前标注*的为HIS必须接收的结果集。
服务说明:
如果读卡仅仅是为了获取个人基本信息,如姓名、性别、医保卡号等,yltclb请传递为’0’;住院登记读卡时请传递yltclb=’1’;门诊大病读卡时请传递yltclb=’4’;普通门诊读卡时请传递yltclb=’6’。
关于疾病编码的特别说明:
由于门诊大病备案时可能备多个病种,所以读卡返回的结果疾病编码(mzdbjbs)格式是:
疾病病种的名称1+’#m’+疾病病种编码1+‘/’+疾病病种的名称2+’#m’+疾病病种编码2+‘/’+……,在此格式的基础上,请开发人员自行解析其中的编码和名称,并展示在功能界面上供操作人员选择。
(每次结算操作员只能选择一种疾病病种)
PB示例代码:
//读卡取参保人的基本信息
sei.resetvar()
sei.putvarstring('yltclb','1')
ifsei.request_service('read_card')<>0then
messagebox('调用读卡服务失败
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 定点医院 嵌入式 接口 服务 方案 核心 平台 v108
![提示](https://static.bingdoc.com/images/bang_tan.gif)