医保接口用户操作手册V30富阳116131.docx
- 文档编号:5633748
- 上传时间:2022-12-29
- 格式:DOCX
- 页数:100
- 大小:150.58KB
医保接口用户操作手册V30富阳116131.docx
《医保接口用户操作手册V30富阳116131.docx》由会员分享,可在线阅读,更多相关《医保接口用户操作手册V30富阳116131.docx(100页珍藏版)》请在冰豆网上搜索。
医保接口用户操作手册V30富阳116131
医保接口用户操作手册
V3.0
(修订版本1.16)
浙大网新
声明:
浙大网新版权所有,未经许可,不得以任何方式复制或抄袭本文档的任何部分。
版权所有,XX。
文档修改说明页
修订
版本
文档
状态
修改
作者
操作
时间
操作备注
1.0
创建
吴永锋
2006-8-19
创建了医保接口文档
1.1
修改
冯宁前
2006-10-10
修改了药品诊疗自负比例及单价限额的获取方式,改为通过58号交易完成。
修改了门诊挂号结算的传入字段。
增加了部分数据字典
1.2
修改
冯宁前
2006-10-22
增加了部分WEB数据下载格式
增加了部分数据字典
1.3
修改
吴永锋
2006-10-25
对整个接口文档进行了整理和调整。
1.4
修改
冯宁前
2006-11-6
修改了门诊预结算等交易中交易字段,修改了Clinic结构体
修改了药品/诊疗自负比例获取交易的个别字段
在医嘱上传及记帐的结构内增加了费用发生日期字段
修改了计算结果返回字段
在门诊挂号结算、门诊收费结算、住院结算、门诊退费、住院退费、交易结果查询的交易中,增加返回交易时间(结算时间)
1.5
修改
文丹
2006-11-17
修改了49号确认交易、32住院登记交易,住院登记不需确认
修改了药品诊疗目录下载文件数据项,增加了药品诊疗类别、住院限额和住院限量数据项,修改了单位字段位数(10-20)
1.6
修改
张卫红
2006-11-22
修改了58号取自负比例交易,增加了交易时间。
修改了诊疗药品目录,增加了限制使用内容
1.7
修改
张卫红
2006-11-27
增加了HIS端对于限额限量分类材料累计的控制。
详细参看附录7.2
1.8
修改
张卫红
2006-12-11
结算结果信息返回增加起伏线字段
51号交易增加对帐不一致信息
1.9
修改
张卫红
2006-12-16
WEB明细下载新增起伏线
1.9
新增
2010.4.30
规定病种结算新增透析单病种结算,增加返回医疗救助基金字段,见交易门诊挂号结算(用户交易28)
1.10
新增
李侃
2010.12.22
新增41号交易,特药申请
修改
李侃
2010.12.22
门诊预结算/结算交易传入结构体修改.
33号交易住院费用明细上传传入结构体修改.
1.11
新增
李侃
2011.03.03
新增59号交易,新农合体检用
1.12
新增
李东海
2011.07.13
22号交易,返回IC卡信息时增加证历本编号字段;数据字典,医疗人员类别增加新农医40、41、42三个人员类别;增加60号交易(取消体检登记);Ic卡数据格式,卡号长度由20扩展为50
1.13
新增
李东海
2011.07.19
结算类交易,返回信息中“结果结算信息”结构体增加民政补助基金字段和一个预留字段;
1.14
新增
魏炯男
2011.10.10
27、28号交易返回参数第八个参数[规定病种标志]增加‘3单病种结算’类型,用来区分该次结算是否是按照单病种政策结算的。
1.15
新增
魏炯男
2011.10.13
所有相关交易传入参数,【是否有医保卡】参数增加一种类型“3农保卡”,此类型时入传农保卡号,不能为空(包括22号交易)
1.16
新增
魏炯男
2012-11-20
增加35号交易
1.31
修改
魏炯男
2013-01-31
41号交易传入参数申请数量参数和传出参数审批数量增加造口袋申请说明
目录
1.概述6
1.1.背景6
1.2.目标6
1.3.名词解释7
1.4.文档安排7
2.医疗机构接入准备7
2.1.硬件要求7
2.2.软件要求8
2.3.数据要求8
3.医疗机构端嵌入模块8
3.1.嵌入模块的处理模式9
3.2.嵌入模块的文件内容10
3.2.1.配置文件11
3.2.2.交易初始化和关闭函数12
3.2.3.用户交易申请函数13
3.3.参数数据格式13
3.3.1传入参数14
3.3.2传出参数14
3.4.IC卡数据格式15
3.5.嵌入模块的业务范围(用户交易)16
3.5.1获取参保人员信息(用户交易22)17
3.5.2保留交易(用户交易23)目前不用。
19
3.5.3门诊挂号预结算(用户交易27)19
3.5.4门诊挂号结算(用户交易28)24
3.5.5门诊收费预结算(用户交易29)27
3.5.6门诊收费结算(用户交易30)27
3.5.7挂号退号/门诊退费(用户交易31)27
3.5.8住院登记(用户交易32)28
3.5.9住院医嘱录入及费用记帐(用户交易33)30
3.5.10住院预结算(用户交易34)33
3.5.11就诊疾病上传(用户交易35)35
3.5.12出院结算(用户交易36)36
3.5.13出院退费(用户交易37)39
3.5.14住院信息变动(用户交易38)40
3.5.15保留交易(用户交易39)目前不用41
3.5.16取消住院登记/医保转自费(用户交易40)42
3.5.17特检特治特药申请交易(用户交易41)43
3.5.18特检特治特药查询/取消交易(用户交易42)保留,目前不使用44
3.5.19交易结果查询交易(用户交易43)45
3.5.20交易确认(HIS事务结果)(用户交易49)47
3.5.21医保接口数据日结算(用户交易51)51
3.5.22保留交易(用户交易52)(目前不用)53
3.5.23用药限量查询(用户交易53)(目前不用)53
3.5.24住院明细查询(用户交易55)55
3.5.25住院明细删除(用户交易56)56
3.5.26匹配目录上传(用户交易57)57
3.5.27单价限额/自负比列获取(用户交易58)59
3.5.28体检登记交易(用户交易59)60
3.5.29体检登记取消交易(用户交易60)61
4.WEB服务62
4.1.WEB服务内容62
4.2.WEB服务数据下载格式63
4.3.下载文件数据项容64
5.三大目录66
5.1总体目标66
6.系统管理员维护指南67
6.1软件分布及包含内容67
6.1.1.文档67
6.1.2.医疗机构终端软件67
6.1.3.医保前置服务67
6.3接口软件安装设置以及日常维护68
6.4接口常见错误处理68
7.系统切换方案68
8.附录69
7.1IC错误代码说明69
7.2医院端限额限量等控制说明69
7.3医院常见业务处理流程参考69
7.4结算方法72
7.5文档更正说明72
7.6相关数据字典72
1.概述
1.1.背景
加快医疗保险制度改革,保障职工基本医疗,是建立社会主义市场经济体制的客观要求和重要保障,在认真总结近年来各地医疗保险制度改革试点经验的基础上,国务院提出了在全国范围内建立城镇职工基本医疗保险制度的决定,所以各地建设医疗保险管理信息系统的任务就变得十分迫切。
医保接口系统是医保中心管理业务在定点医疗机构的体现,它将医保政策体现在具体的医疗机构中。
同时,它将参保人员在医疗机构发生的具体费用情况统计、采集到医保中心,也是医保中心管理分析参保人员就医情况、基金流动情况的必要手段。
医疗保险管理系统要通过与定点医疗机构、定点零售药店以及银行、税务等相关部门建立网络联结,改善医疗保险费用的监控手段,进而保障医疗保险基金安全运行。
目前,国内医院管理系统软件众多,他们采用的数据库平台和数据库结构各不相同,且各公司的软件都有一批用户,因为医院管理系统是一个比较大也比较复杂的系统,一旦用户已经使用,要把它换成另一个系统是比较困难的;在一个城市中,也可能存在和各家的医院系统存在数据交换。
为了保证医疗保险管理系统和医院管理信息系统的完整性和独立性以及数据的同步和一致性,需要提供一个标准的数据输入输出接口,建立一个公用的数据交换标准。
因此,开发出一套通用的适合于各种类型医疗管理机构、能嵌入各种管理软件的接口系统是保证医保顺利实施的关键。
在以下说明中,一般以医院作为医疗机构代表,特殊地方将单独注明适用范围。
1.2.目标
医保接口系统主要实现参保病人在医疗机构就医时数据的采集、审核、费用的支付、医保IC卡管理、银行IC卡管理,结算信息的实时上传以及软件版本的更新等。
根据业务类型,接口系统分三个子模块:
医保交易平台、医保服务平台和医保前置服务系统。
其中与医疗机构相关的是医保前置服务系统。
对于已经使用HIS系统的医院,接口系统提供一套Windows标准函数完成嵌入模块功能,只要将其嵌入原医院系统既可实现医保病人的就诊。
1.3.名词解释
在本用户手册内,使用部分简略说明,其含义以本定义为准。
中心管理系统:
医保中心内部管理系统,包括信息采集、人员登记、参保登记、缴费、费用记帐、支付、综合分析等工作。
前置服务控制台:
简称前置机,实现医疗机构和医保中心的衔接。
前置服务器在每个医疗机构至少设置一台,社保中心根据医疗机构数目和业务量大小确定前置机数量。
前置服务器仅是逻辑机器,对于业务量很少的药店、卫生所保健站等地方,前置机也可由普通收费终端担任。
医疗机构端前置服务器完成医疗机构端数据采集、发送、接收和处理,医保中心前置服务器既系统中医保中心应用服务器,主要完成数据接收和发送及政策处理。
用户交易:
医疗机构指定业务中某一特定动作的处理。
一般是相对独立且业务完整的动作集合。
1.4.文档安排
本文共分7章:
第一章简单介绍接口系统概念、名词,并简单介绍其业务范围。
第二章简单介绍医疗机构使用接口系统前期准备。
第三章详细介绍医疗机构端嵌入模块内容。
以及对各种业务的实现方法。
第四章介绍医保前置机中数据库表的结构。
这些表有的需要用户写,有的需要用户读。
第五章介绍医疗机构系统管理员日常维护和常见问题处理等。
第六章介绍医院接口切换方案。
第七章附录。
包括IC卡错误信息、医院常见业务流程、常见错误、更新变动说明等。
2.医疗机构接入准备
2.1.硬件要求
引用接口系统嵌入模块的终端机器至少要256M内存,并有足够空间安装支持软件。
2.2.软件要求
接口系统目前支持Windows95/98/2000/XP/NT系统平台下所开发的应用系统,各应用系统必须能正常调用Windows标准API函数(例如用PB、Delphi、VB、VC、CB等开发的软件都可以支持)。
根据电脑技术的发展形式,嵌入模块不支持DOS系统下开发的应用软件。
其他要求参见6.1.2。
2.3.数据要求
接口系统需要从医疗机构获得必要数据,为统一编码,录入数据尽量采用医保中心提供的编码规则,医疗机构需要根据需要将自身系统的编码做对照,对照涉及的表结构请参考4.2。
医疗机构需要从医保中心的提供的web服务器上下载最新的目录,并跟本医疗机构使用的目录做匹配对照.需要对照的内容包括:
1)药品目录
对于已经使用HIS系统的医院,需要建立医院药品内码和甲、乙类药品的对照表,对于要上传给医保中心的数据要统一使用标准的甲、乙类药品编码。
2)诊疗项目和医疗服务设施目录
以下简称诊疗目录。
对于已经使用HIS系统的医院,需要建立医院收费项目和医保中心诊疗项目的对照表,对于要上传给医保中心的数据要统一使用标准的医保中心诊疗项目编码。
3)疾病编码目录
医保中心采用ICD10为标准编码,对于已经使用HIS系统的医院,需要建立医院内码和医保中心疾病库ICD10码的对照表。
4)收费类别目录
药品和收费项目收费归类类别,发票以及医保报表中的项目分类均以此为标准。
3.医疗机构端嵌入模块
医疗机构端嵌入模块(以下简称嵌入模块)是整个接口系统唯一和用户交互的模块。
对于医疗机构,仅调用此模块中提供的用户交易功能既可以完成医保病人的业务处理。
嵌入模块包含若干种用户交易,对医疗机构来说,用户交易为其唯一可视交易。
3.1.嵌入模块的处理模式
嵌入模块处理模式如下:
(1)前台首先调用嵌入模块中交易初始化函数,连接远程的交易处理服务器,进行系统运行必要的初始化处理(参考3.2.2)。
交易初始化函数调用失败则无法进行医保其他交易调用.
(2)前台根据具体业务要求调用对应交易,调用时需提供用户交易类型号和交易数据包。
用户交易类型号必须是接口系统定义的有效号码(参考3.5嵌入模块的业务范围),交易数据包按照具体打包规则生成(参考3.3参数数据格式)。
(3)调用用户交易申请,并等待返回结果.
(4)医疗机构系统保存医保返回交易结果,并根据交易结果对自身数据进行处理。
部分交易并不是由单一的交易存在.完成一次业务需要多个交易联合完成.如结算交易成功后需要调用49号交易进行确认等.
(5)交易结束并返回结果后,如果交易涉及账户扣款等业务一般不可以回退,如果由于意外原因造成HIS端失败,需要通过对医保独立的退费交易回退接口正确的交易。
(6)医院对医疗业务的接入以及对嵌入模块的调用可参考如下模式:
3.2.嵌入模块的文件内容
嵌入模块主文件为BargaingApplyV3_01035.DLL,其他为配套的支持文件。
嵌入模块根据配置文件内容获取运行参数,接收用户交易并将处理结果返回给用户。
BargaingApplyV3_01035提供外部调用的函数主要包括交易申请函数f_UserBargaingApply、交易初始化函数f_UserBargaingInit和交易关闭函数f_UserBargaingClose。
3.2.1.配置文件
文件名:
TradeCfgV3_01035.ini
说明:
须与BargaingApplyV3_01035.DLL在同一目录下,带下划线的需要医院自行配置,其他由接口统一定义统一提供。
文件内容(带下划线部分需要各医院配置):
[HardWare]//本机硬件设置(根据采用的卡做相应配置)
COM//IC卡串口位置(0表示无IC卡,1:
com1,2:
com2,5:
USB)
ReadType//读卡器类型,统一配置
CardType//卡类型,统一配置
baud=115200//波特率
OpType=0//0普通1发卡
KBDType//小键盘类型
NeedUseKdb=0
KdbCom=
KdbBaud=
HostOutTime=
CardTimeOut=
[TRADEMANAGE]
CurrentTrade=111111*********
TradeTime=
MaxOutTime=50//交易的最大超时时间(手工配置)
[SYSTEM]
LocalIP=//医保收费终端ip
HospID=//医院编号(保留为空)
SysHaveInit=2006-2-23
AccBench=
TermLog=y//表示终端是否记录日志,’y’表示写日志,’n’或空表示不写
NativeAddress=//前置机服务器IP地址
NativeServer=HosTransmit.RModule0221//不要改变
AREAID=01035//地区号,不要改变
[TUXEDO]
……
[DATABASE]
…
[VERSION]//产品更新信息设定
产品号=产品号,产品名称,产品的当前使用版本号,产品所在的路径
如嵌入模块更新信息格式:
1050=1050,嵌入模块,02.21.04003.00.1050,D:
\ehis。
这里需要注意的是两个问题,一个是产品号不能设置错误,否则会找不到要更新的产品,另外一个是产品路径不要设置错误,否则更新的内容无法自动正确更新。
一般情况下,客户端自动更新配置项只有一个1050(嵌入模块),当医疗机构软件调用版本更新函数时能自动更新软件。
如果需要更新已经运行的软件,只能退出HIS软件再更新才能成功。
关于软件的更新,详细请参考文档6.2章节:
软件手工更新和自动更新。
3.2.2.交易初始化和关闭函数
医疗机构软件每次启动时,需要调用接口系统中用户交易初始化函数,初始化接口并获得交易参数。
如果用户终端需要长期运行,在跨日操作时,也需要重新调用交易初始化函数更新接口初始化数据。
同样,应用软件退出时调用用户交易关闭函数释放系统资源。
Ø函数原型:
intf_UserBargaingInit(constchar*Data1,char*retMsg,char*Data2)
功能:
系统应用前初始化数据准备
参数说明:
传入参数:
Data1-------不需要传递数据
Data2-------传递医疗机构编号
retMsg----返回的信息,数据包格式参考3.3
返回值:
=0-----------成功,没有任何警告,返回信息在retMsg
>0-----------成功,但是有警告信息,警告信息在retMsg
<0-----------失败,错误信息在retMsg中
PowerBuilder中函数定义:
FUNCTIONintegerf_UserBargaingInit(stringlpData1,refstringlpMessage,stringlpData2)library"BargaingApplyV3_01035"
Ø函数原形:
intf_UserBargaingClose(constchar*Data,char*retMsg,char*Data2)
功能:
退出系统前释放资源
参数说明:
同于f_UserBargaingInit交易。
PowerBuilder中函数定义:
FUNCTIONintegerf_UserBargaingClose(stringlpData1,refstringlpMessage,stringlpData2)library"BargaingApplyV3_01035"
Ø调用实例(其中方框内为交易返回参数,用户传递进入时为”$$3000个空格$$”)
f_UserBargaingInit(”$$$$”,”$$0~~$$”,””)
f_UserBargaingClose(”$$$$”,”$$0~~$$”,””)
3.2.3.用户交易申请函数
●函数原型:
intf_UserBargaingApply(intCode,doubleNo,constchar*Data,char*retMsg,char*Data2)
功能:
实现具体的业务,医疗机构通过调用该函数申请相关用户交易并获取交易结果。
参数说明:
传入参数:
Code------用户交易类型号码(2位)
No--------交易流水号(<=14位)(目前传0)
Data------传入参数1,格式参考3.3参数数据格式
retMsg----交易返回的传出参数,格式参考3.3参数数据格式
Data2-----传递医疗机构编号
返回值:
=0-----------成功,没有任何警告,返回信息在retMsg
>0-----------成功,但是有警告信息,警告信息在retMsg
<0-----------失败,错误信息在retMsg中
详细格式参考3.3参数数据格式
注:
pb调用的时候一定要用Space函数为传出参数分配足够空间
PowerBuilder中函数定义:
FUNCTIONintegerf_UserBargaingApply(integernTradeTypeID,doubleTradeID,stringlpData1,refstringlpMessage,stringlpData2)library"BargaingApplyV3_01035"
3.3.参数数据格式
传递的参数使用了几个特殊符号作为分割符,因此,用户提供的参数数据中不能包含这些固定的分割符号,由于这些符号只可能出现在“名称”等固定字符串中,因此用户应在组装参数前过滤掉数据包中的可能出现的控制字符,否则交易会出现意外错误。
目前系统保留的参数保留字包括以下几个:
字符
字符说明
类型说明
$$
双美元符号
分隔符,分隔交易数据包
~
单波浪线
分隔交易包中不同域
%%
双百分比符号
分隔交易包不同域间元素
'
单引号
系统字符串分隔符,不可使用
提供给调用接口的开发商或用户使用的接口数据格式,以$$做为交换数据包的开头和结束符。
交易体中若有多个域,各域之间用~分隔。
例如:
$$111~22222$$,表示交易体中有两个域,第一个域111,第二个域22222。
$$111~$$,表示交易体中有两个域,第一个域111,第二个域为空。
$$111$$,表示交易体中有一个域,第一个域111。
$$$$或$$$$(中间空格可多个),表示交易体中只有一个域,该域为空。
$$~$$,表示交易体有二个域,两个域都是空。
根据数据交换的特点,数据包包括用户系统向接口系统提出的交易申请和接口系统反馈给外部用户系统的交易处理结果,不同种类的业务交易体中域的个数和含义均有所差异。
3.3.1传入参数
传入参数格式为:
$$交易体$$,用户提出交易申请时,通过外部传入数据包提供参数。
交易体前4个域固定,某些交易没有相关数据域信息时相应值填写空(域依然保留):
序号
域名
说明
1
是否有医保卡
0:
无医保卡1:
有医保卡3:
农保卡
2
IC信息
无医保卡时:
传医保编号
有医保卡时:
22号交易传空;非22号交易传IC明文串信息(参考例卡中第2个数据,22号交易时获得);
农保卡时:
传农保卡号,不能为空(包括22号交易)
3
现金支付方式
1现金2电子钱包
3银行卡其它值默认为1
4
银行卡信息
预留传空即可
3.3.2传出参数
传出参数的格式为:
$$交易体$$,其中交易体中前5个域固定,相应域信息没有时该域内容为空,但域依然保留,前面5个固定域为:
序号
域名
说明
1
交易状态
0:
成功<0:
失败>0:
成功但有警告
2
错误信息
交易状态=0:
该域为空
交易状态<0:
该域返回详细出错信息
交易状态>0:
该域返回警告信息供HIS程序显示警告
3
写医保卡结果
0:
表示写医保卡成功或者不写卡其他:
表示操作卡失败
4
扣银行卡结果
0:
表示写银行卡成功或者不写卡其他:
表示操作卡失败
5
更新后IC卡数据
预留,返回空
说明:
如果用户交易处理成功,返回给用户时交易状态:
0:
表示交易成功,此时错误信息一般为空,交易体实际格式为“$$0~~0~0~~交易结果信息$$”。
1:
表示交易成功但有警告,警告内容在错误信息中,交易体格式一般为““$$x~警告信息~交易结果信息$$””。
-1:
表示交易失败,一般只有出错信息,没有交易结果信息,格式为“$$-1~错误信息~”,当然特殊交易需要也可以既有错误信息又有交易结果信息
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 医保 接口 用户 操作手册 V30 富阳 116131