社保系统医保接口用户操作手册浙江医保中心.docx

1、社保系统医保接口用户操作手册浙江医保中心省本级医保接口用户操作手册V2.5（药店集中前置版）浙大网新声明：浙大网新版权所有，未经许可，不得以任何方式复制或抄袭本文档的任何部分。版权所有，XX。文档修改说明页修订版本文档状态修改作者操作时间操作备注1.0创建吴永锋2005-11-10创建文档1.1修改吴永锋2006-01-091、省直的磁条卡，刷卡由外面控制，22号用户交易的入口参数中的IC信息，需要传入刷卡获得的卡号。2、修改了27、29和53号用户交易的入口参数。3、住院费用提交交易增加一个传入参数：给药方式（VC(1),1:出院带药，0：其他情况）4、更正一个表名，42号交易，转出医院编号

2、从Kb01查，而不是Sim_yljg查询。5、添加了下传到医院的表:AA10,KA26,KA27,KAB1,并修改表KA025里边 AKA076字段含义1.2修改吴永锋2006-1-25修改嵌入模块名称和配置文件名称，在后面添加了地区号，并用_分隔。TradeCfgV2.ini - TradeCfgV2_01050.iniBargaingApplyV2.DLL- BargaingApplyV2_01050.DLL13修改吴永锋2006-2-241，重新定义了22号交易中的读卡方式，添加了传入为20的类型2、修改了22号交易的返回错误，添加了个人校验码3、TradeCfgV2_01050.ini

3、中对密码输入采用的小键盘的配置。4、软件发布文档内容。注：本次修改为蓝色字体描述内容。1.4修改吴永锋2006-3-61、修改了HIS系统调用的交易包长度的限制，从以前的4K到目前的19K。2、修改33号交易，住院遗嘱费用提交时，提交条数至少需要50条(建议80条)，并要求His系统在提交申请前对包长度做出校验，并限制包长度在19K之内。3、费用记帐交易不再需要申请交易号。对于改造好上线的医院HIS系统，这个修改需要跟医保中心同步修改，对于还没改造好的HIS系统，33号交易不再需要申请交易号。1.5修改李桂2010-8-131、2010年10月1日推行新版2010省本级医保药品目录。2、交易2

4、7、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-241、 修改了日对账的相关参数2、 新增66、67 交易1.7修改李桂2010-09-091. OraFGetDjxe _NEW（）方法增加参数 yybm(医院编码)2

5、.在62、65号交易下载信息增加了卡号,姓名,结算日期,药店就诊号。 3.在61号交易中,增加单价,数量,金额等信息.(详见最新接口文档)。4.在药店退费交易（ 31、37号交易），传人参数增加操作员账号。5.操作员日对账、下载交易（63号，62、65号），将自付费用，修改成自理费用。1.8修改李桂2010-09-151.在医院未结算中心已结算交易回退（64号）交易，传人参数“回退说明”修改为“回退医院药店号”。2.操作员收费日签到（用户交易66），传人参数增加“签到类型（空：不限制，1:药店签到 2：住院签到）”。1.9修改李桂2010-10-15医院未结算中心已结算交易回退（64号）交易修

6、改调用实例，传人交易号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-201. 医师编码修改为全省职业医师编码(与全省职业医师库校验)2. 入院诊断、出院诊断扩大到15个3. 大病政策调整(取消原来的重大疾病补助,增加大病基金支付等)2.5修改文跃林2016-04-20增加交易接口(专

7、供前置机后置药店使用)：1药品/诊疗目录下载(用户交易70)2. 获取医保目录比例（用户交易71）3. ICD10库下载2.5修改吴永锋2016-06-221、 调整了给新增药店大前置方式用的嵌入模块名称为 BargaingApplyV2_DQZ_01050.DLL2、去掉了第六章节中关于前置机实施安装和维护相关的内容。3、去掉了附录中关于从前置机接口库获取字符比例的相关内容 4、去掉了第七章的系统切换方案介绍目录1. 概述 61.1. 背景 61.2. 目标 71.3. 名词解释 71.4. 文档安排 82. 医疗机构接入准备 82.1. 硬件要求 82.2. 软件要求 82.3. 数据要求

8、 93. 医疗机构端嵌入模块 93.1. 嵌入模块的处理模式 103.2. 嵌入模块的文件内容 113.2.1. 配置文件 123.2.2. 交易初始化和关闭函数 133.2.3. 用户交易申请函数 153.3. 参数数据格式 163.4. IC卡数据格式 173.5. 嵌入模块的业务范围（用户交易） 193.5.1 获取参保人员信息（用户交易22） 193.5.2 申请交易号（用户交易23） 223.5.3 药店预结算（用户交易27/29） 233.5.4 药店结算（用户交易28/30） 263.5.7 药店退费（用户交易31） 283.5.8 交易结果查询交易（用户交易43） 283.5.

9、9 交易确认（HIS事务结果）（用户交易49） 293.5.11用药限量查询（用户交易53） 333.5.12结算交易下载（用户交易62） 343.5.13 操作员日对账（用户交易63） 353.5.14医院未结算中心已结算交易回退（用户交易64） 373.5.15未确认结算交易下载（用户交易65） 373.5.16操作员收费日签到（用户交易66） 383.5.19药品/诊疗目录下载(用户交易70) 393.5.20获取医保目录比例（用户交易71） 423.5.21 ICD10库下载(用户交易72) 434. 药店下载相关的数据库字典 454.1. 收费类别 455. 三大目录及实时监管方案

10、465.1 总体目标 465.2 功能实现 475.2.1三大目录对照工作 475.2.2医保中心实时监管 476. 系统管理员维护指南 496.1 软件分布及包含内容 496.1.1. 文档 496.1.2. 药店终端软件 507. 附录 507.1 IC错误代码说明 507.2 医院常见业务处理流程参考 517.3 结算方法 521. 概述1.1. 背景加快医疗保险制度改革，保障职工基本医疗，是建立社会主义市场经济体制的客观要求和重要保障，在认真总结近年来各地医疗保险制度改革试点经验的基础上，国务院提出了在全国范围内建立城镇职工基本医疗保险制度的决定，所以各地建设医疗保险管理信息系统的任务

11、就变得十分迫切。医保接口系统是医保中心管理业务在定点医疗机构的体现，它将医保政策体现在具体的医疗机构中。同时，它将参保人员在医疗机构发生的具体费用情况统计、采集到医保中心，也是医保中心管理分析参保人员就医情况、基金流动情况的必要手段。医疗保险管理系统要通过与定点医疗机构、定点零售药店以及银行、税务等相关部门建立网络联结，改善医疗保险费用的监控手段，进而保障医疗保险基金安全运行。目前，国内医院管理系统软件众多，他们采用的数据库平台和数据库结构各不相同，且各公司的软件都有一批用户，因为医院管理系统是一个比较大也比较复杂的系统，一旦用户已经使用，要把它换成另一个系统是比较困难的；在一个城市中，也可能

12、存在和各家的医院系统存在数据交换。为了保证医疗保险管理系统和医院管理信息系统的完整性和独立性以及数据的同步和一致性，需要提供一个标准的数据输入输出接口，建立一个公用的数据交换标准。因此，开发出一套通用的适合于各种类型医疗管理机构、能嵌入各种管理软件的接口系统是保证医保顺利实施的关键。在以下说明中，一般以医院作为医疗机构代表，特殊地方将单独注明适用范围。1.2. 目标医保接口系统主要实现参保病人在医疗机构就医时数据的采集、审核、费用的支付、医保IC卡管理、银行IC卡管理，结算信息的实时上传以及软件版本的更新等。根据业务类型，接口系统分三个子模块：医疗机构接口系统、数据通讯系统、医保中心监控系统。

13、其中与医疗机构相关的是医疗机构接口系统。对于已经使用HIS系统的医院，接口系统提供一套Windows标准函数完成嵌入模块功能，只要将其嵌入原医院系统既可实现医保病人的就诊。1.3. 名词解释在本用户手册内，使用部分简略说明，其含义以本定义为准。中心管理系统：医保中心内部管理系统，包括信息采集、人员登记、参保登记、缴费、费用记帐、支付、综合分析等工作。下载：一般指两定机构从中心下载相关数据（药品目录、诊疗目录、疾病目录等）。用户交易：医疗机构指定业务中某一特定动作的处理。一般是相对独立且业务完整的动作集合。单次就诊实时监控：是指对单次门/急诊总费用和所有项目用量进行监控一天内不同医院多次就诊实时

14、监控：是指对同一医保病人一天内在不同医院门/急诊总费用和所有项目用量进行监控。若干天内累计就诊准实时监控：是指对医保病人若干时间段内门/急诊总费用和部分重点项目累计用量进行准实时监控。1.4. 文档安排本文共分7章:第一章简单介绍接口系统概念、名词，并简单介绍其业务范围。第二章简单介绍医疗机构使用接口系统前期准备。第三章详细介绍医疗机构端嵌入模块内容。以及对各种业务的实现方法。第四章介绍数据字典。第五章介绍医疗机构系统管理员日常维护和常见问题处理等。第六章介绍医院接口切换方案。第七章附录。包括IC卡错误信息、医院常见业务流程、常见错误、更新变动说明等。2. 医疗机构接入准备2.1. 硬件要求引

15、用接口系统嵌入模块的终端机器至少要64M 内存，并有足够空间安装支持软件。网络上要求必须能访问中心应用服务器。2.2. 软件要求接口系统目前支持Windows95/98/2000/XP/NT系统平台下所开发的应用系统，各应用系统必须能正常调用Windows标准API函数（例如用PB、Delphi、VB、VC、CB等开发的软件都可以支持）。根据电脑技术的发展形式，嵌入模块不支持DOS系统下开发的应用软件。其他要求参见5.1.2。2.3. 数据要求接口系统需要从医疗机构获得必要数据，为统一编码，录入数据尽量采用医保中心提供的编码规则，医疗机构需要根据需要将自身系统的编码做对照，对照涉及的表结构请参

16、考相关目录下载。医疗机构需要对照的内容包括：1） 药品目录对于已经使用HIS系统的医院，需要建立医院药品内码和甲、乙类药品的对照表，对于要上传给医保中心的数据要统一使用标准的甲、乙类药品编码。2） 诊疗项目和医疗服务设施目录以下简称诊疗目录。对于已经使用HIS系统的医院，需要建立医院收费项目和医保中心诊疗项目的对照表，对于要上传给医保中心的数据要统一使用标准的医保中心诊疗项目编码。3） 疾病编码目录医保中心采用ICD10为标准编码，对于已经使用HIS系统的医院，需要建立医院内码和医保中心疾病库ICD10码的对照表。4） 收费类别目录药品和收费项目收费归类类别，发票以及医保报表中的项目分类均以此

17、为标准。5） 科室目录医保中心定义一些常见科室，HIS与自己科室对照，无法对照的科室认为科室ID=0，通过具体交易中传入的科室名称区分不同科室。6） 其它暂无，根据需要另行定义。 3. 医疗机构端嵌入模块医疗机构端嵌入模块（以下简称嵌入模块）是整个接口系统唯一和用户交互的模块。对于医疗机构，仅调用此模块中提供的用户交易功能既可以完成医保病人的业务处理。嵌入模块包含若干种用户交易，对医疗机构来说，用户交易为其唯一可视交易。3.1. 嵌入模块的处理模式嵌入模块处理模式如下： (1) 前台首先调用嵌入模块中交易初始化函数，连接远程的交易处理服务器，进行系统运行必要的初始化处理（参考3.2.2）。(2

18、) 如果用户所作的交易需要申请交易号，则调用23号申请交易号交易（参考3.5.2）。(3) 前台根据具体业务要求调用指定交易，调用时需提供交易类型和交易数据包。交易类型必须是系统预定义存在且医疗机构可执行的交易类型（参考3.5），交易数据包按照具体打包规则生成（参考3.3）。(4) 调用用户交易申请。(5) 医院保存交易结果和自身数据的处理，提交49号交易确认（参考3.5.20）。(6) 交易结束并返回结果后，如果交易涉及账户扣款等业务一般不可以回退，如果由于意外原因造成HIS端失败，需要通过对医保独立的退费交易回退接口正确的交易。(7) 医院对医疗业务的接入以及对嵌入模块的调用可参考如下模式

19、：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_DQ

20、Z_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

21、CurrentTrade=111111*TradeTime=MaxOutTime=50 /交易的最大超时时间（手工配置）SYSTEMLocalIP= /医保收费终端ipSysHaveInit=2006-2-23AccBench=TermLog=y /表示终端是否记录日志，y表示写日志，n或空表示不写NativeAddress= / 省本级医保集中前置机服务器IP地址，必须配置NativeServer=HosTransmit.RModule0221 /不要改变AREAID= /地区号，不要改变HospIp= /中心分配IP对应其医疗机构,必须严格按照中心分配的地址配置，必须正确配置，医院唯一的身

22、份识别信息。TUXEDODATABASE VERSION /产品更新信息设定产品号=产品号,产品名称,产品的当前使用版本号,产品所在的路径如嵌入模块更新信息格式：1050=1050,嵌入模块,02.21.04003.00.1050,D:ehis。这里需要注意的是两个问题，一个是产品号不能设置错误，否则会找不到要更新的产品，另外一个是产品路径不要设置错误，否则更新的内容无法自动正确更新。一般情况下，客户端自动更新配置项只有一个1050(嵌入模块)，当医疗机构软件调用版本更新函数时能自动更新软件。如果需要更新已经运行的软件，只能退出HIS软件再更新才能成功。关于软件的更新，详细请参考文档5.3章节

23、：软件手工更新和自动更新。3.2.2. 交易初始化和关闭函数医疗机构软件每次启动时，需要调用接口系统中用户交易初始化函数，初始化接口并获得交易参数。如果用户终端需要长期运行，在跨日操作时，也需要重新调用交易初始化函数更新接口初始化数据。特别：医疗机构系统每次启动时，在调用用户交易初始化函数前请HIS先调用软件自动更新DLL（VerCtrl.dll，详细请参见5.2）以实现接口软件的自动更新。同样，应用软件退出时调用用户交易关闭函数释放系统资源。 函数原型：int f_UserBargaingInit(const char * Data1,char * retMsg,char* Data2)功能

24、：系统应用前初始化数据准备参数说明： 传入参数：Data1-不需要传递数据 Data2-不需要传递数据 retMsg - 返回的信息，数据包格式参考3.3 返回值： =0-成功，没有任何警告，返回信息在retMsg 0-成功，但是有警告信息，警告信息在retMsg 0-失败，错误信息在retMsg中PowerBuilder中函数定义：FUNCTION integer f_UserBargaingInit(string lpData1, ref string lpMessage,string lpData2) library BargaingApplyV2_DQZ_01050 函数原形：int

25、f_UserBargaingClose (const char * Data,char * retMsg,char* Data2)功能：退出系统前释放资源参数说明：同于f_UserBargaingInit交易。PowerBuilder中函数定义：FUNCTION integer f_UserBargaingClose(string lpData1, ref string lpMessage,string lpData2) library BargaingApplyV2_DQZ_01050 调用实例(其中方框内为交易返回参数，用户传递进入时为”$3000个空格$”)f_UserBargaingI

26、nit(”$”,”$0$”,”)f_UserBargaingClose(”$”,”$0$”,”) 针对社会保障卡(IC卡)函数原型：Int IC_ReadCardInfoV3_01050（unsigned char *OutData）函数说明：读卡信息。输入值： 无 输出值： OutData，返回的卡片信息，每个字段之间用“|”分隔返回值： =0表示成功； 0表示失败。Out Data（输出值）：序号数据项备注1卡的识别码32位,前6位参保地统筹区。2卡的类别社保卡3卡号4公民身份证号码5姓名6性别7卡机具型号8卡机具序列号9Dll版本号10LIB版本11PSAM卡编号返回值：状态代码定义0正

27、常 0异常，在OutData输出参数中，会以”ERRMSG|”为开头输入错误信息注：pb调用的时候一定要用Space函数为传出参数分配足够空间PowerBuilder中函数定义：FUNCTION integer IC_ReadCardInfoV3_01050（ref string lpOutData） library BargaingApplyV3_01050.dll3.2.3. 用户交易申请函数 函数原型：int f_UserBargaingApply(int Code,double No,const char * Data,char * retMsg，char* Data2)功能：实现具体

28、的业务，医疗机构通过调用该函数申请相关用户交易并获取交易结果。参数说明： 传入参数：Code-用户交易类型号码（2位） No-交易流水号（0-成功，但是有警告信息，警告信息在retMsg 0-失败，错误信息在retMsg中详细格式参考3.3参数数据格式注：pb调用的时候一定要用Space函数为传出参数分配足够空间PowerBuilder中函数定义：FUNCTION integer f_UserBargaingApply(integer nTradeTypeID,double TradeID,string lpData1, ref string lpMessage,string lpData2)

29、 library BargaingApplyV2_DQZ_010503.3. 参数数据格式传递的参数使用了几个特殊符号作为分割符，因此，用户提供的参数数据中不能包含这些固定的分割符号，由于这些符号只可能出现在“名称”等固定字符串中，因此用户应在组装参数前过滤掉数据包中的可能出现的控制字符，否则交易会出现意外错误。目前系统保留的参数保留字包括以下几个：字符字符说明类型说明$双美元符号分隔符，分隔交易数据包单波浪线分隔交易包中不同域%双百分比符号分隔交易包不同域间元素单引号系统字符串分隔符，不可使用提供给调用接口的开发商或用户使用的接口数据格式，以$做为交换数据包的开头和结束符。交易体中若有多个域，各域之间用分隔。例如：$11122222$，表示交易体中有两个域，第一个域111，第二个域22222。$111$，表示交易体中有两个域，第一个域111，第二个域为空。$111$，表示交易体中有一个域，第一个域111。$