社保系统医保接口用户操作手册浙江医保中心.docx
《社保系统医保接口用户操作手册浙江医保中心.docx》由会员分享，可在线阅读，更多相关《社保系统医保接口用户操作手册浙江医保中心.docx（76页珍藏版）》请在冰豆网上搜索。
社保系统医保接口用户操作手册浙江医保中心
省本级医保接口用户操作手册
V2.5
（药店集中前置版）
浙大网新
声明：
浙大网新版权所有，未经许可，不得以任何方式复制或抄袭本文档的任何部分。
版权所有，XX。
文档修改说明页
修订
版本
文档
状态
修改
作者
操作
时间
操作备注
1.0
创建
吴永锋
2005-11-10
创建文档
1.1
修改
吴永锋
2006-01-09
1、省直的磁条卡，刷卡由外面控制，22号用户交易的入口参数中的IC信息，需要传入刷卡获得的卡号。
2、修改了27、29和53号用户交易的入口参数。
3、住院费用提交交易增加一个传入参数：
给药方式（VC
（1）,1:
出院带药，0：
其他情况）
4、更正一个表名，42号交易，转出医院编号从Kb01查，而不是Sim_yljg查询。
5、添加了下传到医院的表:
AA10,KA26,KA27,KAB1,并修改表KA025里边AKA076字段含义
1.2
修改
吴永锋
2006-1-25
修改嵌入模块名称和配置文件名称，在后面添加了地区号，并用_分隔。
TradeCfgV2.ini->TradeCfgV2_01050.ini
BargaingApplyV2.DLL->BargaingApplyV2_01050.DLL
1．3
修改
吴永锋
2006-2-24
1，重新定义了22号交易中的读卡方式，添加了传入为20的类型
2、修改了22号交易的返回错误，添加了个人校验码
3、TradeCfgV2_01050.ini中对密码输入采用的小键盘的配置。
4、软件发布文档内容。
注：
本次修改为蓝色字体描述内容。
1.4
修改
吴永锋
2006-3-6
1、修改了HIS系统调用的交易包长度的限制，从以前的4K到目前的19K。
2、修改33号交易，住院遗嘱费用提交时，提交条数至少需要50条（建议80条），并要求His系统在提交申请前对包长度做出校验，并限制包长度在19K之内。
3、费用记帐交易不再需要申请交易号。
对于改造好上线的医院HIS系统，这个修改需要跟医保中心同步修改，对于还没改造好的HIS系统，33号交易不再需要申请交易
号。
1.5
修改
李桂
2010-8-13
1、2010年10月1日推行新版2010省本级医保药品目录。
2、交易27、28、29,、30增加自负比例后台验证
3、28、30、31、36、37结算（退费结算）交易返回中心结算日期、日对账流水号。
5、新增新版药品目录支持的费用自负比例及单价限额获取方法。
自负比例获取方法ORAFGETZFBL_NEW（10月1日启用，原方法保留）
单价限额获取方法OraFGetDjxe_NEW（10月1日启用，原方法保留）
修改
李桂
2010-8-13
新增用户交易（61、62、63、64）
1.6
修改
李桂
2010-8-24
1、修改了日对账的相关参数
2、新增66、67交易
1.7
修改
李桂
2010-09-09
1.OraFGetDjxe_NEW（）方法增加参数yybm（医院编码）
2.在62、65号交易下载信息增加了卡号,姓名,结算日期,药店就诊号。
3.在61号交易中,增加单价,数量,金额等信息.（详见最新接口文档）。
4.在药店退费交易（31、37号交易），传人参数增加操作员账号。
5.操作员日对账、下载交易（63号，62、65号），将自付费用，修改成自理费用。
1.8
修改
李桂
2010-09-15
1.在医院未结算中心已结算交易回退（64号）交易，传人参数“回退说明”修改为“回退医院药店号”。
2.操作员收费日签到（用户交易66），传人参数增加“签到类型（空：
不限制，1:
药店签到2：
住院签到）”。
1.9
修改
李桂
2010-10-15
医院未结算中心已结算交易回退（64号）交易修改调用实例，传人交易号
2.0
修改
文跃林
2012-09-11
增加关于179号文件说明
2.1
修改
文跃林
2013-05-20
增加关于生育刷卡接口调整,设计到交易：
门（急）诊（含挂号）有27、28、29、30
住院有32、34、36具体调整相见操作手册
2.2
修改
文跃林
2013-06-20
调整22号交易，对IC信息返回串中“规定病种标志”域，做返回调整及说明
2.4
修改
文跃林
2015-04-20
1.医师编码修改为全省职业医师编码（与全省职业医师库校验）
2.入院诊断、出院诊断扩大到15个
3.大病政策调整（取消原来的重大疾病补助,增加大病基金支付等）
2.5
修改
文跃林
2016-04-20
增加交易接口（专供前置机后置药店使用）：
1药品/诊疗目录下载（用户交易70）
2.获取医保目录比例（用户交易71）
3.ICD10库下载
2.5
修改
吴永锋
2016-06-22
1、调整了给新增药店大前置方式用的嵌入模块名称为BargaingApplyV2_DQZ_01050.DLL
2、去掉了第六章节中关于前置机实施安装和维护相关的内容。
3、去掉了附录中关于从前置机接口库获取字符比例的相关内容
4、去掉了第七章的系统切换方案介绍
目录
1.概述6
1.1.背景6
1.2.目标7
1.3.名词解释7
1.4.文档安排8
2.医疗机构接入准备8
2.1.硬件要求8
2.2.软件要求8
2.3.数据要求9
3.医疗机构端嵌入模块9
3.1.嵌入模块的处理模式10
3.2.嵌入模块的文件内容11
3.2.1.配置文件12
3.2.2.交易初始化和关闭函数13
3.2.3.用户交易申请函数15
3.3.参数数据格式16
3.4.IC卡数据格式17
3.5.嵌入模块的业务范围（用户交易）19
3.5.1获取参保人员信息（用户交易22）19
3.5.2申请交易号（用户交易23）22
3.5.3药店预结算（用户交易27/29）23
3.5.4药店结算（用户交易28/30）26
3.5.7药店退费（用户交易31）28
3.5.8交易结果查询交易（用户交易43）28
3.5.9交易确认（HIS事务结果）（用户交易49）29
3.5.11用药限量查询（用户交易53）33
3.5.12结算交易下载（用户交易62）34
3.5.13操作员日对账（用户交易63）35
3.5.14医院未结算中心已结算交易回退（用户交易64）37
3.5.15未确认结算交易下载（用户交易65）37
3.5.16操作员收费日签到（用户交易66）38
3.5.19药品/诊疗目录下载（用户交易70）39
3.5.20获取医保目录比例（用户交易71）42
3.5.21ICD10库下载（用户交易72）43
4.药店下载相关的数据库字典45
4.1.收费类别45
5.三大目录及实时监管方案46
5.1总体目标46
5.2功能实现47
5.2.1三大目录对照工作47
5.2.2医保中心实时监管47
6.系统管理员维护指南49
6.1软件分布及包含内容49
6.1.1.文档49
6.1.2.药店终端软件50
7.附录50
7.1IC错误代码说明50
7.2医院常见业务处理流程参考51
7.3结算方法52
1.概述
1.1.背景
加快医疗保险制度改革，保障职工基本医疗，是建立社会主义市场经济体制的客观要求和重要保障，在认真总结近年来各地医疗保险制度改革试点经验的基础上，国务院提出了在全国范围内建立城镇职工基本医疗保险制度的决定，所以各地建设医疗保险管理信息系统的任务就变得十分迫切。
医保接口系统是医保中心管理业务在定点医疗机构的体现，它将医保政策体现在具体的医疗机构中。
同时，它将参保人员在医疗机构发生的具体费用情况统计、采集到医保中心，也是医保中心管理分析参保人员就医情况、基金流动情况的必要手段。
医疗保险管理系统要通过与定点医疗机构、定点零售药店以及银行、税务等相关部门建立网络联结，改善医疗保险费用的监控手段，进而保障医疗保险基金安全运行。
目前，国内医院管理系统软件众多，他们采用的数据库平台和数据库结构各不相同，且各公司的软件都有一批用户，因为医院管理系统是一个比较大也比较复杂的系统，一旦用户已经使用，要把它换成另一个系统是比较困难的；在一个城市中，也可能存在和各家的医院系统存在数据交换。
为了保证医疗保险管理系统和医院管理信息系统的完整性和独立性以及数据的同步和一致性，需要提供一个标准的数据输入输出接口，建立一个公用的数据交换标准。
因此，开发出一套通用的适合于各种类型医疗管理机构、能嵌入各种管理软件的接口系统是保证医保顺利实施的关键。
在以下说明中，一般以医院作为医疗机构代表，特殊地方将单独注明适用范围。
1.2.目标
医保接口系统主要实现参保病人在医疗机构就医时数据的采集、审核、费用的支付、医保IC卡管理、银行IC卡管理，结算信息的实时上传以及软件版本的更新等。
根据业务类型，接口系统分三个子模块：
医疗机构接口系统、数据通讯系统、医保中心监控系统。
其中与医疗机构相关的是医疗机构接口系统。
对于已经使用HIS系统的医院，接口系统提供一套Windows标准函数完成嵌入模块功能，只要将其嵌入原医院系统既可实现医保病人的就诊。
1.3.名词解释
在本用户手册内，使用部分简略说明，其含义以本定义为准。
中心管理系统：
医保中心内部管理系统，包括信息采集、人员登记、参保登记、缴费、费用记帐、支付、综合分析等工作。
下载：
一般指两定机构从中心下载相关数据（药品目录、诊疗目录、疾病目录等）。
用户交易：
医疗机构指定业务中某一特定动作的处理。
一般是相对独立且业务完整的动作集合。
单次就诊实时监控：
是指对单次门/急诊总费用和所有项目用量进行监控
一天内不同医院多次就诊实时监控：
是指对同一医保病人一天内在不同医院门/急诊总费用和所有项目用量进行监控。
若干天内累计就诊准实时监控：
是指对医保病人若干时间段内门/急诊总费用和部分重点项目累计用量进行准实时监控。
1.4.文档安排
本文共分7章:
第一章简单介绍接口系统概念、名词，并简单介绍其业务范围。
第二章简单介绍医疗机构使用接口系统前期准备。
第三章详细介绍医疗机构端嵌入模块内容。
以及对各种业务的实现方法。
第四章介绍数据字典。
第五章介绍医疗机构系统管理员日常维护和常见问题处理等。
第六章介绍医院接口切换方案。
第七章附录。
包括IC卡错误信息、医院常见业务流程、常见错误、更新变动说明等。
2.医疗机构接入准备
2.1.硬件要求
引用接口系统嵌入模块的终端机器至少要64M内存，并有足够空间安装支持软件。
网络上要求必须能访问中心应用服务器。
2.2.软件要求
接口系统目前支持Windows95/98/2000/XP/NT系统平台下所开发的应用系统，各应用系统必须能正常调用Windows标准API函数（例如用PB、Delphi、VB、VC、CB等开发的软件都可以支持）。
根据电脑技术的发展形式，嵌入模块不支持DOS系统下开发的应用软件。
其他要求参见5.1.2。
2.3.数据要求
接口系统需要从医疗机构获得必要数据，为统一编码，录入数据尽量采用医保中心提供的编码规则，医疗机构需要根据需要将自身系统的编码做对照，对照涉及的表结构请参考相关目录下载。
医疗机构需要对照的内容包括：
1）药品目录
对于已经使用HIS系统的医院，需要建立医院药品内码和甲、乙类药品的对照表，对于要上传给医保中心的数据要统一使用标准的甲、乙类药品编码。
2）诊疗项目和医疗服务设施目录
以下简称诊疗目录。
对于已经使用HIS系统的医院，需要建立医院收费项目和医保中心诊疗项目的对照表，对于要上传给医保中心的数据要统一使用标准的医保中心诊疗项目编码。
3）疾病编码目录
医保中心采用ICD10为标准编码，对于已经使用HIS系统的医院，需要建立医院内码和医保中心疾病库ICD10码的对照表。
4）收费类别目录
药品和收费项目收费归类类别，发票以及医保报表中的项目分类均以此为标准。
5）科室目录
医保中心定义一些常见科室，HIS与自己科室对照，无法对照的科室认为科室ID=0，通过具体交易中传入的科室名称区分不同科室。
6）其它
暂无，根据需要另行定义。
3.医疗机构端嵌入模块
医疗机构端嵌入模块（以下简称嵌入模块）是整个接口系统唯一和用户交互的模块。
对于医疗机构，仅调用此模块中提供的用户交易功能既可以完成医保病人的业务处理。
嵌入模块包含若干种用户交易，对医疗机构来说，用户交易为其唯一可视交易。
3.1.嵌入模块的处理模式
嵌入模块处理模式如下：
（1）前台首先调用嵌入模块中交易初始化函数，连接远程的交易处理服务器，进行系统运行必要的初始化处理（参考3.2.2）。
（2）如果用户所作的交易需要申请交易号，则调用23号申请交易号交易（参考3.5.2）。
（3）前台根据具体业务要求调用指定交易，调用时需提供交易类型和交易数据包。
交易类型必须是系统预定义存在且医疗机构可执行的交易类型（参考3.5），交易数据包按照具体打包规则生成（参考3.3）。
（4）调用用户交易申请。
（5）医院保存交易结果和自身数据的处理，提交49号交易确认（参考3.5.20）。
（6）交易结束并返回结果后，如果交易涉及账户扣款等业务一般不可以回退，如果由于意外原因造成HIS端失败，需要通过对医保独立的退费交易回退接口正确的交易。
（7）医院对医疗业务的接入以及对嵌入模块的调用可参考如下模式：
3.2.嵌入模块的文件内容
1）针对社会保障卡
嵌入模块主文件为BargaingApplyV2_DQZ_01050.DLL，其他为配套的支持文件。
嵌入模块根据配置文件内容获取运行参数，接收用户交易并将处理结果返回给用户。
BargaingApplyV2_DQZ_01050提供外部调用的函数主要包括交易申请函数f_UserBargaingApply、交易初始化函数f_UserBargaingInit和交易关闭函数f_UserBargaingClose。
3.2.1.配置文件
1）针对社会保障卡
文件名：
TradeCfgV2_DQZ_01050.ini
说明：
须与BargaingApplyV2_DQZ_01050.DLL在同一目录下，带下划线的需要医院自行配置，其他由接口统一定义统一提供。
文件内容（带下划线部分需要各医院配置）：
[HardWare]//本机硬件设置
COM//IC卡串口位置（0表示无IC卡，1：
com1，2：
com2,5:
USB）
ReadType//读卡器类型，统一配置
CardType//卡类型，统一配置
baud=115200//波特率
OpType=0//0普通1发卡
KBDType//小键盘类型
NeedUseKdb=0//0:
杭州市民卡小键盘输入（默认）1:
原串口磁卡小键盘输入
KdbCom=
KdbBaud=
HostOutTime=
CardTimeOut=
[TRADEMANAGE]
CurrentTrade=111111*********
TradeTime=
MaxOutTime=50//交易的最大超时时间（手工配置）
[SYSTEM]
LocalIP=//医保收费终端ip
SysHaveInit=2006-2-23
AccBench=
TermLog=y//表示终端是否记录日志，’y’表示写日志，’n’或空表示不写
NativeAddress=//省本级医保集中前置机服务器IP地址，必须配置
NativeServer=HosTransmit.RModule0221//不要改变
AREAID=//地区号，不要改变
HospIp=//中心分配IP对应其医疗机构,必须严格按照中心分配的地址配置，必须正确配置，医院唯一的身份识别信息。
[TUXEDO]
……
[DATABASE]
…
[VERSION]//产品更新信息设定
产品号=产品号,产品名称,产品的当前使用版本号,产品所在的路径
如嵌入模块更新信息格式：
1050=1050,嵌入模块,02.21.04003.00.1050,D:
\ehis。
这里需要注意的是两个问题，一个是产品号不能设置错误，否则会找不到要更新的产品，另外一个是产品路径不要设置错误，否则更新的内容无法自动正确更新。
一般情况下，客户端自动更新配置项只有一个1050（嵌入模块），当医疗机构软件调用版本更新函数时能自动更新软件。
如果需要更新已经运行的软件，只能退出HIS软件再更新才能成功。
关于软件的更新，详细请参考文档5.3章节：
软件手工更新和自动更新。
3.2.2.交易初始化和关闭函数
医疗机构软件每次启动时，需要调用接口系统中用户交易初始化函数，初始化接口并获得交易参数。
如果用户终端需要长期运行，在跨日操作时，也需要重新调用交易初始化函数更新接口初始化数据。
特别：
医疗机构系统每次启动时，在调用用户交易初始化函数前请HIS先调用软件自动更新DLL（VerCtrl.dll，详细请参见5.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"BargaingApplyV2_DQZ_01050"
Ø函数原形：
intf_UserBargaingClose（constchar*Data,char*retMsg,char*Data2）
功能：
退出系统前释放资源
参数说明：
同于f_UserBargaingInit交易。
PowerBuilder中函数定义：
FUNCTIONintegerf_UserBargaingClose（stringlpData1,refstringlpMessage,stringlpData2）library"BargaingApplyV2_DQZ_01050"
Ø调用实例（其中方框内为交易返回参数，用户传递进入时为”$$3000个空格$$”）
f_UserBargaingInit（”$$$$”,”$$0~~$$”,””）
f_UserBargaingClose（”$$$$”,”$$0~~$$”,””）
Ø针对社会保障卡（IC卡）
函数原型：
IntIC_ReadCardInfoV3_01050（unsignedchar*OutData）
函数说明：
读卡信息。
输入值：
无
输出值：
OutData，返回的卡片信息，每个字段之间用“|”分隔
返回值：
=0表示成功；
<0表示失败。
OutData（输出值）：
序号
数据项
备注
1
卡的识别码
32位,前6位参保地统筹区。
2
卡的类别
社保卡
3
卡号
4
公民身份证号码
5
姓名
6
性别
7
卡机具型号
8
卡机具序列号
9
Dll版本号
10
LIB版本
11
PSAM卡编号
返回值：
状态代码
定义
0
正常
<0
异常，在OutData输出参数中，会以”ERRMSG|”为开头输入错误信息
注：
pb调用的时候一定要用Space函数为传出参数分配足够空间
PowerBuilder中函数定义：
FUNCTIONintegerIC_ReadCardInfoV3_01050（refstringlpOutData）library"BargaingApplyV3_01050.dll"
3.2.3.用户交易申请函数
●函数原型：
intf_UserBargaingApply（intCode,doubleNo,constchar*Data,char*retMsg，char*Data2）
功能：
实现具体的业务，医疗机构通过调用该函数申请相关用户交易并获取交易结果。
参数说明：
传入参数：
Code------用户交易类型号码（2位）
No--------交易流水号（<=14位）
Data------传入参数1，格式参考3.3参数数据格式
retMsg----交易返回的传出参数，格式参考3.3参数数据格式
Data2-----传入参数2，预留，传入空即可
返回值：
=0-----------成功，没有任何警告，返回信息在retMsg
>0-----------成功，但是有警告信息，警告信息在retMsg
<0-----------失败，错误信息在retMsg中
详细格式参考3.3参数数据格式
注：
pb调用的时候一定要用Space函数为传出参数分配足够空间
PowerBuilder中函数定义：
FUNCTIONintegerf_UserBargaingApply（integernTradeTypeID,doubleTradeID,stringlpData1,refstringlpMessage,stringlpData2）library"BargaingApplyV2_DQZ_01050"
3.3.参数数据格式
传递的参数使用了几个特殊符号作为分割符，因此，用户提供的参数数据中不能包含这些固定的分割符号，由于这些符号只可能出现在“名称”等固定字符串中，因此用户应在组装参数前过滤掉数据包中的可能出现的控制字符，否则交易会出现意外错误。
目前系统保留的参数保留字包括以下几个：
字符
字符说明
类型说明
$$
双美元符号
分隔符，分隔交易数据包
~
单波浪线
分隔交易包中不同域
%%
双百分比符号
分隔交易包不同域间元素
'
单引号
系统字符串分隔符，不可使用
提供给调用接口的开发商或用户使用的接口数据格式，以$$做为交换数据包的开头和结束符。
交易体中若有多个域，各域之间用~分隔。
例如：
$$111~22222$$，表示交易体中有两个域，第一个域111，第二个域22222。
$$111~$$，表示交易体中有两个域，第一个域111，第二个域为空。
$$111$$，表示交易体中有一个域，第一个域111。
$$
升级会员 