医院医保结算系统
0.
地纬定点医院医保结算系统
接口服务方案
（版本）
山东地纬计算机软件有限公司
2011年1月
第一章背景介绍...............................................错误!未定义书签。
金保工程.................................................错误!未定义书签。
核心平台二版（）..........................................错误!未定义书签。
核心平台二版的技术架构....................................错误!未定义书签。
核心平台二版的技术路线....................................错误!未定义书签。第二章接口设计方案...........................................错误!未定义书签。
接口开发遵循的规范和标准..................................错误!未定义书签。
接口技术架构设计方案......................................错误!未定义书签。
原定点结算系统技术框架....................................错误!未定义书签。
接口服务技术框架..........................................错误!未定义书签。第三章接口服务说明...........................................错误!未定义书签。
一、接口概述..............................................错误!未定义书签。
二、接口环境..............................................错误!未定义书签。
三、接口实例创建、接口登陆、接口示例回收..................错误!未定义书签。
四、接口服务概况图........................................错误!未定义书签。第四章、业务服务应用说明......................................错误!未定义书签。
1、取参服务...............................................错误!未定义书签。
2、查询账户余额服务(山东滨州、东营使用) ...................错误!未定义书签。
3、读卡服务...............................................错误!未定义书签。
4、门诊初始化服务.........................................错误!未定义书签。
5、生成门诊费用服务.......................................错误!未定义书签。
6、门诊结算服务...........................................错误!未定义书签。
7、撤销门诊结算服务.......................................错误!未定义书签。
8、个人账户消费初始化服务.................................错误!未定义书签。
9、个人账户消费服务.......................................错误!未定义书签。
10、个人账户退费服务......................................错误!未定义书签。
11、无凭单消费个账扣款(威海、廊坊) ........................错误!未定义书签。
12、普通住院登记服务......................................错误!未定义书签。
13、住院初始化服务........................................错误!未定义书签。
14、生成住院费用信息服务..................................错误!未定义书签。
15、删除住院费用信息服务..................................错误!未定义书签。
16、出院结算服务（出院结算并打印结算单）..................错误!未定义书签。
17、在调用打印之前调用以下方法：..........................错误!未定义书签。
18、撤销出院服务..........................................错误!未定义书签。
19、撤销住院登记服务......................................错误!未定义书签。
20、目录管理相关服务......................................错误!未定义书签。
21、查询无卡人员基本信息服务..............................错误!未定义书签。
22、修改卡片密码服务......................................错误!未定义书签。
23、上传住院费用服务......................................错误!未定义书签。
24、生成住院电子病历服务..................................错误!未定义书签。
25、查询在院病人信息......................................错误!未定义书签。
26、打印住院告知单服务....................................错误!未定义书签。
27、查询在院病人费用明细..................................错误!未定义书签。
28、读卡器选择服务........................................错误!未定义书签。第五章业务流程构建说明.......................................错误!未定义书签。
一、门诊大病结算流程说明..................................错误!未定义书签。
二、普通门诊结算流程说明..................................错误!未定义书签。
三、急诊结算流程说明......................................错误!未定义书签。
四、普通住院流程说明......................................错误!未定义书签。
五、个人账户消费流程说明..................................错误!未定义书签。
六、目录管理流程说明......................................错误!未定义书签。第六章关于其他问题的处理方案.................................错误!未定义书签。
一、关于科室、医师相关问题的说明..........................错误!未定义书签。
二、关于操作员相关问题的说明..............................错误!未定义书签。第七章用户收益...............................................错误!未定义书签。第八章附录...................................................错误!未定义书签。
一、电子病历参数说明......................................错误!未定义书签。
二、代码含义..........................................错误!未定义书签。
第一章背景介绍
金保工程
进入二十一世纪以来，计算机技术、通信技术和网络技术的高速发展，加快了社会经济的信息化进程，信息化已经成为当今世界经济和社会发展的大趋势。劳动保障信息化建设是我国政府信息化建设的重要组成部分，一直受到党中央和各级政府部门的高度重视。根据中办发〔2002〕17号文件精神，在全面总结劳动保障信息化工作多年经验的基础上，按照劳动保障事业发展的总体目标，以全国电子政务建设规划为指导，劳动保障部设计编制了金保工程项目建议书，于2002年递交国家发改委（原国家计委），正式向国家提出立项申请。2003年8月，经国务院总理办公会讨论通过，金保工程正式获准国家立项，标志着我国劳动保障信息化工作进入了一个新的历史时期。
核心平台二版（）
金保工程的主要内容包括两大系统即社会保险信息系统和劳动力市场信息系统，三级网络即市、省、中央三级数据库及其信息交互，四大功能即业务经办、公共服务、基金管理和决策支持。
核心平台二版是定位于城市级的社会保险管理信息系统，支持城市级的业务经办和基金管理，并通过其统计查询功能为决策支持提供服务，通过与劳动保障电话咨询中心及网站的连接提供公共服务，通过为市、省、中央三级网络及资源数据库提供数据源完成三级数据网建设。
核心平台二版的技术架构
针对各地社会保险业务处理的特殊性，核心平台二版提供了适合社会保险业务的技术框架SIEAF，其中包括安全、日志、交易、接口等服务。在此技术框架之上，核心平台二版提供了社会保险业务的原子级业务处理。
同时，核心平台二版对于外部系统提供统一的接口方案，使得开发更加灵活，系统易于管理。
核心平台二版的技术路线
1．核心平台二版开发采用架构驱动的设计思想和开发方法，按照CMM的要求制定一系列开发规范，并通过质量保证小组最大程度地保证了核心平台二版的总体质量。
2．核心平台二版采用面向对象的分析和设计方法，在对指标体系改动最小的基础上，利用面向对象分析设计的优势，对不同层次采用不同的设计模式进行设计，即MVC模式。
3．核心平台二版采用统一的对外接口服务，无论是参保企业、银行、税务、劳动力市场还是医院、药店，都可以通过“接口服务”很快完成与核心平台二版的接口设计和开发。
4．核心平台二版采用J2EE体系架构，并且参考了当前主流的Web应用框架（struts、WAF），实现了适用于社会保险的企业级应用框架（SIEAF）。采用三层架构将业务逻辑处理集中到应用服务器，应用服务器具有良好的可扩展性，大大提高了系统的并发处理能力。
第二章接口设计方案
定点医疗机构业务是社会保险体系中的重要组成部分，定点医疗机构结算系统更是核心平台二版的核心外围业务系统之一。为了更好的实现定点医疗机构结算系统与医院自身信息管理系统的对接，地纬公司研制设计了本接口系统。
“DW定点医院接口服务系统”是在地纬公司Dweaf快速开发框架的基础上，采用面向服务的应用程序开发（Services-oriented development of application，SODA）使定点医院医保结算系统转换到面向服务架构
（service-oriented architecture，SOA）。
“DW定点医院接口服务系统”集成了医疗保险定点医疗机构的所有结算业务服务（函数），这些函数供HIS系统调用，并支持重要结算信息的返回。将该接口嵌入原医院管理系统后，医院管理系统可无缝连接到医疗保险网络信息系统。
接口完成以后，住院、门诊、门诊大病等主业务结算流程均完全嵌入医院HIS系统，通过DW定点医院接口，为各定点机构搭建了一个高品质、可管理、高可用性的信息集成平台，能够为HIS系统提供全面高效的服务。
接口开发遵循的规范和标准
地纬公司在“DW定点医院接口服务系统”开发过程中，完全遵从金保工程“核心平台二版”的技术架构、指标体系和业务规范，系统符合《山东省劳动和社会保障管理信息系统总体方案》和劳动保障部关于核心平台二版信息系统建设的有关要求，可以完全实现医院自身信息管理系统与医保结算系统的无缝连接。接口开发采用的产品、网络体系结构和通信协议采用国家相关标准、部门专业标准以及国际通用的工业标准，服从国家管理信息系统的规划和有关规定。
项目开发过程中所遵循的标准规范主要有：
劳动和社会保险管理信息系统信息结构通则（LB001—2000）
社会保险管理信息系统指标体系—业务部分（LB101-2000）
《金保工程劳动力市场信息系统建设指导意见》
ISO 9000-3-97质量管理和质量保证标准
规范
GB/T 17859—1999 计算机信息系统安全保护等级划分准则
GB/T17900—1999 网络代理服务器的安全技术要求
GB/T 16680—1996 软件文档管理指南
GB/T 14079—1993 软件维护指南
GB/T 14394—1993 计算机软件可靠性和可维护性管理
GB/T 12504—1990 计算机软件质量保证计划规范
GB/T 12505—1990 计算机软件配置管理计划规范
GB 1526-1989信息处理-数据流图、程序流程图、系统流程图、程序
网络图和系统资源图的文件编制符号及约定
GB/T 8567—1988 计算机软件产品开发文件编制指南
GB/T 9385—1988 计算机软件需求说明编制指南
GB/T 9386—1988 计算机软件测试文件编制规范
GB/T 10114—1988 县以下行政区代码编制规则
GB/T 4754—1994 国民经济行业分类与代码
《山东地纬计算机软件有限公司质量体系程序文件》
接口技术架构设计方案
“DW定点医院接口服务系统”是严格遵守“核心平台二版”的技术框架，采用基于Dweaf平台的多层体系结构模式，以集中式数据资源共享为基础，采用先进的O/R Mapping映射机制实现了优良的面向对象开发方案，确保了系统具有高度的易用性、良好的扩展性和强大的可移植性。
“DW定点医院接口服务”完全遵守“核心平台二版”的业务指标体系和业务规范要求，并针对不同地区的业务研究分析后对业务指标体系进行了合理化扩展，实现了从软件配置上解决业务需求问题，做到快速开发、高度复用的要求。
原定点结算系统技术框架
在实现接口服务前，地纬定点结算系统与医保核心端应用架构如下：
接口服务技术框架
实现接口服务后，医院端与医保核心端应用架构如下：
从以上实现接口服务前后的技术框架可以看出，“DW定点医院接口服务”替代了原地纬结算系统中的应用服务层。HIS开发商在其HIS系统中只需要将DW 表示层中的相应界面展示完成后，即可实现与医保结算系统的无缝连接。
第三章接口服务说明
一、接口概述
本接口系统为、类库。所有服务均集成在这些类库中。
同时接口系统中包含、和文件，用于接口升级，此三个文件可以从地纬定点医疗机构结算管理系统所在目录中找到。接口系统包含的五个文件必须在同一个目录下。
接口完成以后，住院、门诊、门诊大病等主业务结算流程均完全嵌入医院HIS系统，数据传输等后台业务仍需要依靠地纬定点结算系统来完成。
下面将讲述接口的具体使用方法及例程。
（注：本文提供的PB示例代码，作用是更直观的解释本方案内容，以方便HIS厂商进行开发，仅供参考之用。）
本接口文档支持嵌入式接口及其以后版本。
二、接口环境
在运行结算系统的业务机上需要具备接口环境，具体操作如下：
1、将【接口库】文件夹中所有的dll文件拷入 \winnt\system32下。
2、注册和文件，和为接口的类库文件,具体注册方法如下（其它dll无须注
册）：
3、注册方法：
点击开始－> 运行－>输入 regsvr32 回车
如果显示“中的DLLRegisterServer”成功字样，说明注册成功。
注册方法：
点击开始－> 运行－>输入 regsvr32 回车
如果显示“中的DLLRegisterServer”成功字样，说明注册成功。
三、接口实例创建、接口登陆、接口示例回收
在登陆HIS系统时需要进行接口实例的创建，创建成功以后，才能正常调用接口服务。建议在HIS系统登陆的同时，调用接口登陆的服务，同时在退出HIS 系统时，需要进行接口实例的回收，以免造成资源浪费。
（1）接口实例的创建（pb示例，各种开发工具方法不同）：
Oleobject seiproxy
seiproxy =create oleobject
vi= (‘seiproxy’)
if vi<>0 then
messagebox(‘’,‘注册失败’)
return
end if
（2）接口登陆：
服务名称: initialize (pstr) returns long
服务作用：用于登陆结算系统数据库。
服务返回值：0代表成功，
-800 表示接口需要升级，请退出系统重新登录，重新登录之后会
自动升级
其它为获取失败，
失败原因可以用get_errtext()获取。
传递参数：pstr string pstr是一个字符串，其规则如下：
Pstr=’参数1#参数值1|参数2#参数值2|参数3#参数值3|参数4#参数值4|‘目前该字符串包含四个参数，分别为gzrybh,yybm,passwd,syzhlx;
初始化时gzrybh,yybm,passwd请传递’’,这些信息登录时由操作员填写。
syzhlx:0 不用卡；1 银行卡；2 IC卡；3 联机卡； syzhlx必须填写。
例如：pstr='gzrybh#|yybm#370101|passwd#|syzhlx#3|'
返回参数：
返回接口登陆界面，让操作员进行登陆。
备注：接口实例创建后，必须先调用一下该服务，用于登陆地纬医保结算系统数据库，如果登陆失败，所有业务均无法正常运行。
Pb示例：
vi=seiproxy. Initialize('gzrybh#|yybm#|passwd#|syzhlx#3|')
if vi<>0 then
messagebox(‘医保接口登陆失败’,vi)
return
end if
（3）接口实例的回收：（pb示例，各种开发工具方法不同）
()
Destroy seiproxy
四、接口服务概况图
每次调用住院相关的业务之前(除了住院登记save_zydj)都必须首先调用住院初始化服务(init_zy)。
每次调用门诊结算相关的服务之前都必须首先调用门诊初始化初始化服务(init_mzmg)。
每次调用个人账户消费流程之前都必须首先调用住院初始化服务(init_gz)。每次调用撤销住院相关的服务之前都必须首先调用住院初始化服务(init_zy)。
第四章、业务服务应用说明
1、取参服务
(1)服务名称：result_s(string p_var_name) returns string
服务作用：取得结果集中指定字符串变量的值
服务返回值：无
传递参数：p_var_name
pb示例：
vxm =(‘xm’) get_sscard_balance()<>0 then
说明：如果读卡仅仅是为了获取个人基本信息，如姓名、性别、医保卡号等，yltclb请传递为’0’;住院登记读卡请传递yltclb=’1’;门诊大病
读卡请传递yltclb=’4’;普通门诊读卡请传递yltclb=’6’。
返回结果集：（其中标注*的为HIS必须接收的结果集）
vylzbh =(‘ylzbh’) *医保卡号
vxm =(‘xm’) *姓名
vxb =(‘xb’) 性别,1:男,2:女,9:不确定
vshbzhm=(‘shbzhm’) *社会保障号码
vzfbz =(‘zfbz’) *灰白名单标志:0 代表灰名单,
1 白名单
vzfsm =(‘zfsm’) 灰名单原因(如果是白名单该值
为空)
vdwmc =(‘dwmc’) 单位名称
vylrylb=(‘ylrylb’) 人员类别(汉字)
vydbz =(‘ydbz’) 是否为异地人员 (1:是,0: 否)
vjbbms = (‘mzdbjbs’) *疾病编码
vsbjbm=(‘sbjbm’) *社保局编码,山东省直为379902
vzhzybz= (‘zhzybz’) 有无15(医保参数制)天内的住
院记录1:有 ,0 :无
vzhzysm= (‘zhzysm’) 15(医保参数控制)天内的住院记
录说明
zcyymc=(‘zcyymc’) 转出医院名称(如果zcyymc不
为’’,则表示本次住院时候市
内转院来的)
Zccyrq= (‘zccyrq’) 转出医院出院日期
Ye= (‘ye’) 账户余额
sbjglx= (‘sbjglx’) *机构类型(A：职工，B：居民)
关于疾病编码的特别说明:
由于门诊大病备案时可能备多个病种,所以读卡返回的结果格式是:
疾病病种的名称1 +’#m’+疾病病种编码1 + ‘/’ + 疾病病种的名称2 +’#m’+疾病病种编码 2 + ‘/’ + ……,在此格式的基础上,请开发人员自行解析其中的编码和名称,并展示在功能界面上供操作人员选择。（每次结算只能选择一种疾病病种）
pb示例：
vi=();
if vi<>0 then
messagebox(‘读卡失败’,())
return
end if
4、门诊初始化服务
服务名称:
init_mzmg(p_sbjbm,p_yltclb,p_grbh,p_xm,p_xb,p_zylsh,p_fyrq,p_ysbm, p_jbbm,p_syzhlx,p_ylzbh,p_xzbz,p_bcxm) return long
服务作用: 初始化门诊大病或普通门诊结算信息
服务返回值: 0 表示该过程正常。
其它表示该过程出现错误，错误数据由get_errtext()获取传递参数（其中标注*的为HIS必须传递的非空参数）：
P_sbjbm varchar2(6); *社保局编码
P_yltclb char(1) *医疗统筹类别 yltclb:4 门诊大病，
6普通门诊
P_grbh varchar2(18); *社会保障号码
P_xm varchar2(40); *姓名
P_xb varchar2(3); 性别
P_zylsh varchar2(20); *病历号
P_fyrq date; *费用录入日期(精确到天)
P_ysbm varchar2(40); *医师编码（HIS必须传入一个非空的医师
编码，并且保证医师有资格，HIS系统需
要与地纬结算系统编码保持一致）
P_jbbm varchar2(20); *疾病编码(yltclb=’4’时，必须传递；
yltclb=’6’时，xzbz=’C’传递’’,
xzbz=’D’或xzbz=’E’，必须传递)
P_syzhlx char(1); *使用账户类型;0 不使用,1银行卡,
2 cpu 卡，
3 联机卡
P_ylzbh varchar2(30); *医保卡编号(读卡必须传递，不读卡传’’) P_xzbz varchar2(30); *险种标志（医疗 C）（工伤 D）（生育 E）
P_bcxm varchar2(30); 补充项目信息（扩展使用）
返回结果集：无
参数p_bcxm说明：p_bcxm string p_bcxm是一个字符串，其规则如下：p_bcxm='参数1#参数值1|参数2#参数值2|参数3#参数值3|参数4#参数值4|'例如：p_bcxm='gzrybh#|yybm#370101|passwd#|syzhlx#3|',参数为空传递’’.
如果本次门诊为’异地就医’，则需要输入’外地就医类别’和’就医医院编码’，如下所示:P_bcxm=’wdjylb#10|jyyybm#就医医院编码|’
WDJYLB代码说明：‘01’本地定点就医
‘10’异地治疗
Pb示例：
Vi=(p_sbjbm,p_yltclb,p_grbh,p_xm,p_xb,p_zylsh,
p_fyrq,p_ysbm,p_jbbm,p_syzhlx,p_ylzbh,p_xzbz,p_bcxm)
if vi<>0 then
messagebox(‘门诊初始化失败’,())
return
end if
5、生成门诊费用服务
需要在循环内部顺序调用下面的三个服务。
(1)服务名称：new_mzmg_item() returns long
服务作用：新增一行空的门诊凭单信息，并将凭单指针指向新增的该行凭单,每插入一行凭单信息前，都要先调用该服务，用于生成一行保存凭单信息的记录。
服务返回值：0; 表示该过程正常。
其它表示该过程出现错误，错误数据由get_errtext()获取
传递参数：无
返回结果集：无
(2)服务名称：
set_mzmg_item_string(p_xm,p_value) returns long yyxmmc char(200); 医院项目名称
返回结果集：无
(3)服务名称：save_mzmg_item() returns long
服务作用：结束门诊费用凭单录
服务返回值：0; 表示该过程正常。
其它表示该过程出现错误，错误数据由get_errtext()获取
传递参数：无
返回结果集：无
Pb示例：
一张费用凭单信息可能会包含多种费用信息，该处需要循环调用产生凭单的
服务。首先需要新增一条凭单记录，然后向当前凭单插入需要的项目，依次循环。
for
() 9、个人账户消费服务
需要顺序调用以下两个服务：
（1）服务名称：settle_gz(string p_sbjbm,string p_ylzbh) returns long
服务作用: 对初始化的个人账户的费用进行结算
服务返回值: 0 表示该过程正常。
其它表示该过程出现错误，错误数据由get_errtext()获取
传递参数：p_ sbjbm string 该服务用于纯粹的个人账户扣款.例如门诊