定点医疗机构API开发手册范本

./文档编号：DX12L002分册名称：定点医疗机构API开发手册第2.0版定点医疗机构API开发手册东软软件201声明《定点医疗机构API开发手册》的归东软软件所有。未经东软软件的书面准许,不得将本规的任何容以任何形式、任何手段〔电子的或机械的,包括照相复制或录制、或为任何目的,进行复制或扩散。所有,翻制必究。Copyright2014东软软件。.文档修改历史版本修改记录修改日期修改人0.5增加开发险种围、安全机制、将HIS流程说明放到前面,常用API接口函数介绍2010-7-15薛亚玲0.6增加和修改文档中的部分说明2010-7-21晓明0.61Comminterface医疗类型入参增加医疗类别。调整API常见流程介绍2010-7-23薛亚玲0.62接口表KC22主键去掉AAE0402010-7-26薛亚玲0.63预结算、结算去掉支付方式、经办人、账户支付金额；读人员审批信息去掉审批类别2010-8-10薛亚玲0.64将读卡、读取封锁、读取审批合并；将读药品、读诊疗对照信息合并；去掉疾病和批量读取收费项目对照信息。2010-8-12薛亚玲0.65接口表KC22,增加每次用量单位AKA076,KC21增加患者联系PHONE2010-8-17薛亚玲0.66读卡身份验证,增加两个返回值：结算年月,定点医疗机构编号。2010-8-20武刚0.67修改xml字符串格式为小写2010-8-26晓明0.68修改门诊预结算和住院预结算出参2010-9-6晓明0.69修改kc22表结构,去掉aae040,zka101,aae073,ckc048,ckc1252010-9-13武刚0.70修改xml字符串示例,使之与kc22表结构一致2010-9-13武刚0.71调整kc21表结构2010-9-13武刚0.81读卡身份验证增加疾病编码2010-9-21薛亚玲0.82去掉入院登记回退业务2010-11-09薛亚玲0.83支持环境增加大医院模式使用oracle10g版本2010-11-10薛亚玲0.84修改入院登记传入参数2010-11-1晓明0.85修改xml字符串示例2010-11-18晓明0.86医疗类别去掉中途结算与年终结算,住院结算参数增加结算方式〔1-普通住院结算,2-中途结算,3-年终结算2010-11-19薛亚玲0.87增加医保结算成功his失败后,如何处理的问题2010-12-01薛亚玲0.9定版.9遗留问题：HIS传输费用明细后,如果费用等级发生变化,再次传入负记录也不能解决问题,需提供专门退费的函数来处理。接口函数增加参数中不能含有"#";增加示例三2010-12-08薛亚玲0.91增加错误信息列表、验收标准；住院结算函数增加入参费用总额；database.ini改名为neuqhd.ini;增加病历号2010-12-09薛亚玲0.92修改住院费用明细修改调用流程2010-12-22晓明0.93门诊预结算、住院预结算增加返回参数2011-01-14晓明目 录第一章概述7§1.1背景7§1.2API接口开发险种围7§1.3API接口开发安全机制7§1.4API接口数据流图8§1.5支持环境要求9§1.6术语9第二章快速上手10§2.1认识API接口组成10§2.2创建接口表11§2.3定点结算系统登录用户信息对照12§2.4ODBC配置14§2.5三目编码对照14药品对照15诊疗对照16疾病编码对照维护16§2.6示例一：入院登记处理17第三章API接口函数说明18§3.1API函数参数说明18第四章HIS调用API接口函数流程说明20§4.1门诊部分20门诊结算20门诊结算回退21§4.2住院部分22入院登记22住院登记信息修改22住院费用录入〔或执行医嘱23住院费用明细修改24住院结算26住院结算回退27§4.3单据格式27门诊结算单27住院结算单29第五章常用业务协议码31§5.1读卡身份验证31§5.2读取收费项目对照信息35§5.3门诊预结算35§5.4门诊结算36§5.5门诊结算回退37§5.6门诊结算单打印38§5.7入院登记39§5.8住院录费预结算40§5.9住院费用明细修改41§5.10住院结算42§5.11住院结算回退43§5.12住院结算单打印44§5.13无费出院45第六章定点结算系统功能介绍46第七章常见问题47§7.1在交易过程中,先提交哪一个系统数据库事务？47§7.2住院日常费用录入如何处理的？47§7.3如何才能查询到API接口事务是否成功或作进一步处理？47§7.4如果在进行his结算时,调用接口函数成功,但是his数据库突然断开,造成医保中存在结算数据,his中无结算数据,该如何处理？47§7.5住院录入费用过程中有没有什么限制？在正常的住院录入费用过程中,是否是每一笔处方都调一次动态库,还是录入完成之后再调一次？有没有限制或者规定性容？48§7.6调用API接口函数〔住院录费预结算时,提示"发送请求失败"48§7.7如未正常维护三目对照,会有什么影响或者问题出现？48§7.8项目未对照已收费,且已传输到劳动保障系统前置机中,此时将项目进行对照,但已传输过的项目收费项目等级不能修改,仍显示为丙类,该怎样处理？48§7.9能否医院的多个药品对应医保的某个药品？49§7.10读卡输入密码窗口需要HIS开发吗？49§7.11发生DLL调用错误怎么办？49§7.12进行API接口开发是否威胁到HIS系统数据安全？49§7.13能否由HIS系统提供接口,由定点结算系统来调用？50§7.14如果在住院录费预结算时费用明细传输错误,该怎么处理？50§7.15在住院期间住院患者变更单位,原单位存在封锁,而新单位没有封锁,或者卡挂失,卡号发生变化,在HIS中该如何处理？50§7.16当医保/工伤等项目发生变化之后,HIS系统如何处理?50§7.17如何获取HIS中所有药品或所有诊疗对照医保项目的信息？50§7.18在进行费用录入时如何显示项目的收费项目等级？51§7.19在住院费用录入时录入明细大于5条后,调用API接口住院录费预结算函数时,提示存储过程失效的错误。51§7.20读卡身份验证都验证哪些容？51§7.21如何进行API接口函数的声明引用？51第八章附录52§8.1病人就诊信息表kc21结构52§8.2费用明细信息表kc22结构53§8.3接口表指标代码表54§8.4病人就诊信息表kc21建表语句57§8.5费用明细信息表kc22建表语句59§8.6XML字符串示例60§8.7错误信息列表61§8.8验收标准65概述背景随着国家对劳动保障信息化工作的大力投入,劳动保障部门需要与定点医疗机构建立更加紧密的信息互联与交换,这就需要把定点医疗机构原来的信息管理系统〔下称HIS系统与劳动保障部门的业务系统互联。目前,劳动保障部门延伸到定点医疗机构的业务系统有：职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统,下面统称这三个定点结算系统为定点结算系统。HIS系统与劳动保障部门的业务系统互联,将有助于减轻定点医疗机构的日常管理和业务经办工作量,提高工作效率。同时,也有利于劳动保障部门对基金的监督管理,有利于参保人员合法权益的保护。API接口开发险种围序号险种是否有卡患者识别方式1职工医疗无IC卡号2城镇居民有卡CPU卡3工伤保险无社会保障号API接口开发安全机制序号机制说明1授权码API接口开发的授权码,每个险种对应一个授权码,由东软公司提供。2登录用户和口令定点结算系统中的登录用户和口令；用来确定是哪个用户/业务员传上来的数据,作为API接口的登录用户。3MAC地址通过MAC地址来限制各定点使用的终端接入和信息跟踪。API接口数据流图HYPERLINK定点结算系统提供API接口函数供定点医疗机构HIS系统调用,以完成相应险种的数据传输与结算处理,其基本数据流图如下：说明：HIS系统进行业务数据录入,将就诊信息和费用明细写入HIS接口表中,根据接口表数据,生成XML格式数据。HIS系统提供对应API接口函数的入参,其中要提供HYPERLINK定点结算系统中的登录名和密码,并提供险种的授权码,调用HYPERLINK定点结算系统的API接口函数。API接口函数在接收到HIS系统的调用请求后,进行授权码验证和用户合法性校验,然后把传入的就诊信息XML数据和费用明细XML数据传输到劳动保障系统前置机业务系统中。API接口函数根据就诊信息和费用明细,按照政策要求进行相应的运算。API接口函数返回执行结果,HIS系统根据返回结果进行相应的判断处理,以完成相应的业务处理。至此整个调用过程结束。支持环境要求计算机至少要1G存,磁盘剩余空间至少1G。该API接口只支持WINDOWS2000/XP系统平台下所开发的应用系统,各应用系统必须能正常调用接口函数,传入Windows标准API函数〔例如用PB、Delphi、VB、VC、CB等开发的软件都可以支持。不支持其他操作系统。如果为大医院模式,本地ORACLE数据库服务器端和各业务员客户端需要安装oracle10g〔.1以上版本。术语序号术语含义劳动保障系统前置机HYPERLINK定点结算系统数据库所在服务器预结算将未上传的费用明细传输到劳动保障系统前置机,对费用信息计算预览定点结算系统职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统,统称这三个定点结算系统为定点结算系统。软件归东软公司。HIS系统指各定点医疗机构使用的医院信息管理系统。大医院模式在我市定点结算系统中,有10多家大型医院安装了本地数据库,一些没有安装本地数据库。安装了本地数据库的医院叫大医院模式,没有安装本地数据库的医院称为托管模式。大医院模式对不同的定点结算系统可能不同,如某医院可能职工定点结算系统是大医院模式,而城居和工伤定点结算系统就可能不是大医院模式,这一点要注意。.快速上手本章将对API接口组成和开发前的准备工作做一下简单介绍,并用例子让开发者初步认识调用API接口函数的一般过程与方法。APIAPI授权码创建接口表定点结算系统登录用户信息对照三目编码对照HIS调用API接口程序开发API接口业务调试HIS系统定点结算系统API接口文件认识API接口组成请从东软公司获取API接口文件。该API接口文件包括如下容：序号文件名说明1hiscomminterface.dll医保API接口2hiscomminterface.h供c开发的his系统开发使用3hiscomminterface.lib供c开发的his系统开发使用4Dcic32.dll卡相关动态库5HSMApi.dll卡相关动态库6LSCard.dll卡相关动态库7TYICAPI.dll卡相关动态库8TYICRD.dll卡相关动态库9TYReader.dll卡相关动态库10eapagent.dll医保相关动态库11Hdcrw.dll卡相关动态库12Mwic_32.dll卡相关动态库13SSSE32.dll卡相关动态库14ICCARD.dll卡相关动态库15neuqhd.ini配置文件16eapagent.ini配置文件〔医院不能修改请将以上从东软公司获取的API接口文件保存到HIS系统前端程序的安装目录下,配置文件neuqhd.ini的修改项的说明见配置文件中的说明。创建接口表所谓接口表,是在进行API接口开发之前,需要在HIS系统中创建的两个实体表,特指病人就诊信息表kc21和费用明细信息表kc22两表,这两表用于生成XML数据。具体表结构和字段含义,请参考附录HYPERLINK病人就诊信息表kc21和HYPERLINK费用明细信息表kc22中的描述。这里,对创建接口表作如下要求：1、接口表建在HIS系统数据库中,建在HIS系统的同一数据库用户下。2、如果HIS系统所使用的数据库不是ORACLE,创建接口表时,把接口表的表名和字段名设置为大写。3、接口表作为HIS系统数据库的一部分,用于HIS自身的事务处理。说明：建立接口表的目的是为了在调用API接口函数时,生成接口函数所需要的XML数据,至于哪些函数需要XML数据,请参照HYPERLINK常用业务协议码介绍。定点结算系统登录用户信息对照HIS系统在调用API接口函数时需要提供合法的登录用户和口令,如果登录用户和口令与HYPERLINK定点结算系统中的登录用户匹配,那么可以正常调用API接口函数,否则提示用户不合法。因此,HIS系统中要提供HYPERLINK定点结算系统中登录用户信息与HIS系统中登录用户信息对照的功能。在初次启动动态库时,操作员要使用此功能模块将定点结算系统中的登录用户和口令信息保存到HIS系统中,在日常使用过程中,如果定点结算系统中的用户信息发生变化,操作员还需要应用此模块重新进行对照,否则不能正常做医保业务。目前,定点医疗机构的业务系统有：职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统,在HIS系统中需要对三套定点结算系统进行登录用户对照。下方为HIS系统社会保障系统登录用户对照功能示例,HIS可参照,也可自己开发,只要实现此功能即可。假设HIS系统中用户信息表为T_USER。表结构字段类型长度是否可空主键备注LOGIN_NAMEVARCHAR2<20>否是HIS系统中用户登录名PASSWORDVARCHAR2<20>否HIS系统中登录密码NAMEVARCHAR2<20>否操作员ZGYL_LOGIN_NAMEVARCHAR2<20>否职工定点结算系统中登录名ZGYL_PASSWORDVARCHAR2<20>否职工定点结算系统中密码CZJM_LOGIN_NAMEVARCHAR2<20>否城镇居民定点结算系统中登录名CZJM_PASSWORDVARCHAR2<20>否城镇居民定点结算系统中密码GS_LOGIN_NAMEVARCHAR2<20>否工伤保险定点结算系统中登录名GS_PASSWORDVARCHAR2<20>否工伤保险定点结算系统中密码…………黄色部分为原系统中不存在列,需要针对动态库新增HIS系统中原用户信息：LOGIN_NAMEPASSWORDNAMEZGYL_LOGIN_NAMEZGYL_PASSWORDCZJM_LOGIN_NAMECZJM_PASSWORD……三123456三四780215四…………动态库启动后,操作员通过用户信息对照功能模块,录入定点结算系统中登录名与密码。打开定点结算系统登录用户信息对照窗口,定点结算系统中登录用户信息部分会自动显示已维护过的信息,如果为空,证明还未进行维护。灰色字体不可录,蓝色字体为必录项。操作员填写登录用户与密码,保存即可。HIS系统存入的密码为明码值。定点结算系统登录用户信息对照—□×HIS系统用户信息登录用户三定点结算系统中登录用户信息职工医疗登录用户1001zhangsan职工医疗密码******城镇居民登录用户1001zhangsan城镇居民密码******工伤保险登录用户1001zhangsan工伤保险密码******保存关闭就绪定点结算系统登录用户信息对照操作员维护后用户信息LOGIN_NAMEPASSWORDNAMEZGYL_LOGIN_NAMEZGYL_PASSWORDCZJM_LOGIN_NAMECZJM_PASSWORD……三123456三1001zhangsan8888881001zhangsan888888四780215四lisi000000lisi000000…………调用API接口函数时,HIS系统在验证其HIS系统登录安全后,再从该对照表T_USER中获取对应险种的登录名和密码〔如zhangsan、888888传给API函数,由API函数传到定点结算系统中进行医保相应的安全验证。如果操作员在定点结算系统中变更密码,那么须在此窗口重新维护。如果未在HIS系统中修改定点结算系统登录密码,那么在调用API接口函数时会提示用户不合法。ODBC配置定点结算系统存在本地数据库的医院需要进行ODBC配置,否则不用配置ODBC。ODBC数据源中只需录入数据源名称及TNSServiceName即可,其中TNSServiceName为客户端连接本地数据库的服务名。配置时按如下表中名称配置：险种ODBC数据源名称TNSServiceName备注职工connection_zgzgyl数据源名称需要与neuqhd.ini中对应险种的[#医保前置机连接]下的ServerName名称一致。城居connection_cjcjyl工伤connection_gsgsyl例：客户端连接职工医疗数据库的服务名为zgyl。三目编码对照医保患者在医院就诊且发生费用时,就应该按照医保中心的相关政策对该患者在就诊期间所发生的各项费用进行结算。而各种药品、诊疗项目、病种、服务设施的相关信息在结算过程中扮演着重要角色,因此医院对医保患者进行费用结算时就必须明确告诉医保中心,自己所用的目录中的各个项目分别对应于医保中心目录中的哪一条。然而,各个医院都有自己独立的HIS系统,也有自己独立的药品、诊疗、病种,并且这些目录都有可能不同于医保中心对应的目录。所以,为了将医院目录中的各个项目与医保中心的相关目录关联起来〔而又不需要对医院已有的目录进行改动,就需要将医院的目录中的信息和医保中心相关信息进行对照。目录经过对照后,在医院的每一种药品、诊疗、病种就都可以在医保中心找到一条记录与之相对应,也就使得医院与医保中心的记录统一起来。这样,医院就能在通过医保接口与医保中心进行对照时,以提供对照码的方式来告诉医保中心医院所用的项目对应于中心的哪条记录。药品对照点击定点结算系统中[医疗信息维护]下的[药品对照]会打开下图所示的窗口：图5-1图5-2[操作流程]选择批量方式对照时需要把his的药品库导入到医保库中,然后再his药品信息中选择需要对照的药品,选种该药品的同时在医保药品信息中也查出相应的药品,然后再医保药品信息中选择正确的药品后点击[对照]按钮就可以把医院和医保的药品对照起来了。选择单个对照方式时录入拼音码或名称后点击[检索]按钮在医保药品信息中找到该药品后同时再对照信息中插入一条该药品信息,把his的编码录入到该记录中后点击[保存]按钮,把刚才录入的信息进行保存。诊疗对照同[HYPERLINKHYPERLINKCC311001"//业务协议码入院登记ls_ywrc="ZY00001"//住院号ls_yllx="0|21|0707110925|XX"//职工医保|医疗类别〔普通住院|IC卡号ls_yblongin_name="manager"//通过HIS登录用户获取ls_yb_password="neusoft"//通过HIS登录用户获取ls_licence="1111111111”ls_jzxx="<rowdata><row><akc190>zy00001</akc190><aae073>0</aae073><aka130>21</aka130><akc192>2010-6-30</akc192><akc193></akc193><akc194>2010-6-30</akc194><akc195></akc195><akc196></akc196><aae011>test</aae011><aae036>2010-6-30</aae036><aka121></aka121><ckc126>1</ckc126><zkc271></zkc271><zkc272>test</zkc272><zkc274></zkc274><zkc275></zkc275><zkc276></zkc276><zkc277></zkc277><zkc278></zkc278><zkc279></zkc279><zkc280></zkc280><zkc281></zkc281><zkc282></zkc282><cka040></cka040><cka041></cka041><zhuzhi></zhuzhi><zhiye></zhiye><phone></phone><blh>123456</blh></row></rowdata>"//就诊信息xmlls_fymx="0”//费用明细为’//调用API函数li_res=comminterface<ls_ywxym,ls_ywrc,ls_yllx,ls_yblongin_name,ls_yb_password,ls_licence,ls_jzxx,ls_fymx,refls_ywcc>ls_ywcc=""//业务出参为空//后续处理HIS相关业务API接口函数说明API函数参数说明本接口API函数只提供了一个comminterface函数,通过给该函数传入不同的业务协议码,来实现不同的业务功能。因此,对于调用者,需要详细学习该函数的组成,以便灵活调用。comminterface<in业务协议码,in业务入参,in医疗类型,in登录名,in密码,in授权码,in就诊信息,in费用明细,out业务出参>参数描述：参数不能带有和#标识符号列方向说明业务协议码in请参考HYPERLINK定点结算系统中登录名口令inHYPERLINK定点结算系统中密码〔密码须为明码授权码in授权码<东软公司提供>就诊信息in根据kc21表结构生成的XML字符串。费用明细in根据kc22表结构生成的XML字符串。业务出参out请参考HYPERLINK,"manager","password","2222222222”HIS调用API接口函数流程说明门诊部分门诊结算门诊特殊病与普通门诊业务流程一样,所以放在一起介绍。普通门诊适用险种职工医疗、城镇居民、工伤门诊特殊病适用险种职工医疗、城镇居民步骤号触发业务分步详解1信息录入录入就诊信息和处方明细信息。2选择险种类型和医疗类别〔普通门诊或门诊特殊病,根据HYPERLINKAPI接口开发险种围录入IC卡号、社会保障号或插入CPU卡。3预结算〔可选生成kc21、kc22对应的XML字符串。调用接口函数,传入"门诊预结算<HYPERLINKBC311002>"协议码。如果接口函数返回0即成功,HIS可继续完成其他业务。可将返回的计算结果显示到HIS前台系统,供操作员参考。如果接口函数返回值不为0即失败,错误信息见业务返回信息,但HIS可继续做其他业务〔只影响计算结果的显示。4结算写入kc21、kc22,生成XML字符串。调用接口函数,传入"门诊结算<HYPERLINKCC311002>"协议码。如果接口函数返回0即成功,HIS需更新接口表KC21、KC22中的CKC126等于1,表示已将KC21、KC22中的记录传到定点结算系统数据库中,接下来完成其他的HIS操作即可。如果接口函数返回值不为0即失败,错误信息见业务返回信息,HIS事务回滚,终止HIS操作。注：如果HIS系统门诊结算失败而接口交易成功即接口函数返回0,HIS需要发起反交易请求,冲掉医保的成功交易,即调用接口函数,传入门诊结算回退<HYPERLINKDC311002>协议码,做门诊结算回退。具体处理见HYPERLINK门诊结算回退流程。5提交提交HIS数据库。门诊结算回退在查询结算信息时,可不用读卡,但是在结算回退时,针对有卡的险种必须插卡,否则不能结算回退。普通门诊适用险种职工医疗、城镇居民、工伤门诊特殊病适用险种职工医疗、城镇居民步骤号触发业务分步详解1查询查询待作废的结算信息。2处理HIS门诊结算回退业务。3结算回退调用接口函数,传入"门诊结算回退<HYPERLINKDC311002>"协议码。如果接口函数返回0即成功,接下来完成其他的HIS操作即可。如果接口函数返回值不为0即失败,错误信息见业务返回信息,HIS事务回滚,终止HIS操作。注：如果HIS系统门诊结算回退失败而接口交易成功,那么HIS需要将HIS中的结算信息作废。4提交提交HIS数据库。住院部分入院登记非医保转医保业务可按入院登记步骤来操作。适用险种职工医疗、城镇居民、工伤步骤号触发业务分步详解1信息录入录入入院登记信息。2处理HIS入院登记业务。3住院登记选择险种类型,选择医疗类别〔普通住院,根据HYPERLINKAPI接口开发险种围录入IC卡号、社会保障号或插入CPU卡。将入院登记信息保存到接口表KC21中,生成就诊信息XML字符串。4住院登记调用接口函数,传入"入院登记<HYPERLINKCC311001>"协议码。如果接口函数返回0即成功,HIS可继续完成其他业务。如果接口函数返回值不为0即失败,回滚HIS事务,终止HIS操作。注：如果HIS系统入院登记失败,但接口交易成功,HIS系统需要重新办理医保住院登记,不用调用API接口函数〔入院登记即可。5提交提交HIS数据库。住院登记信息修改办理住院登记后,如果对科室、医生、疾病等信息进行修改,或者患者基本信息发生变化,HIS需提供修改住院登记信息的功能,并实时传输到定点结算系统数据库中。如果需要修改患者基本信息,可通过读卡功能获取患者的最新信息,并更新到接口表KC21中。适用险种职工医疗、城镇居民、工伤步骤号触发业务分步详解1查询查询住院登记信息2修改住院登记信息修改,修改KC21。3处理HIS住院登记信息修改业务。4生成就诊信息XML字符串。不用生成费用明细字符串。5确定调用接口函数,传入"住院录费<HYPERLINK//职工医保|医疗类别〔普通住院|IC卡号ls_yblongin_name="manager"//通过HIS登录用户获取ls_yb_password="neusoft"//通过HIS登录用户获取ls_licence="1111111111”ls_jzxx="<rowdata><row><akc190>zy00001</akc190><aae073>0</aae073><aka130>21</aka130><akc192>2010-6-30</akc192><akc193></akc193><akc194>2010-6-30</akc194><akc195></akc195><akc196></akc196><aae011>test</aae011><aae036>2010-6-30</aae036><aka121></aka121><ckc126>1</ckc126><zkc271></zkc271><zkc272>test</zkc272><zkc274></zkc274><zkc275></zkc275><zkc276></zkc276><zkc277></zkc277><zkc278></zkc278><zkc279></zkc279><zkc280></zkc280><zkc281></zkc281><zkc282></zkc282><cka040></cka040><cka041></cka041><zhuzhi></zhuzhi><zhiye></zhiye><phone></phone><blh>123456</blh></row></rowdata>"//就诊信息xmlls_fymx="<rowdata><row><akc190>ZY00001</akc190><akc220>123456</akc220><akc221>2010-12-07下午03:00<akc515>123456</akc515><akc223>阿莫西林</akc223><akc224>1</akc224><akc225>20.0000</akc225><akc226>4.000</akc226><akc227>80.00</akc227><aka070></aka070><aka071></aka071><aka076></aka076><aka072></aka072><aka073></aka073><akc229></akc229><zka100></zka100><ckc126></ckc126></row></rowdata>"//10盒阿莫西林退掉6盒为例,只需将4盒的阿莫西林生成费用明细XML//调用API函数li_res=comminterface<ls_ywxym,ls_ywrc,ls_yllx,ls_yblongin_name,ls_yb_password,ls_licence,ls_jzxx,ls_fymx,refls_ywcc>ls_ywcc="200|100|100”////后续处理HIS将费用信息保存到HIS系统中后提交数据库。如果接口函数返回0即成功,HIS需置接口表kc22.ckc126为1,可继续完成HIS中其他业务操作。如果接口函数返回不为0,即失败,回退HIS数据库,KC22中的数据不进行删除。注：如果调用API接口函数成功,HIS系统处理失败,HIS数据库回滚,如果是部分退费,还应将后收取的费用再调用"住院费用明细修改<HYPERLINKBC311003>"协议码。如果接口函数返回0即成功,HIS需将接口表kc22.ckc126=0的费用明细置为1,可继续完成HIS中其他业务操作。如果接口函数返回不为0,即失败,HIS事务回滚,终止HIS操作。6结算如果预结算结果无误,可调用接口函数,传入"住院结算<HYPERLINKCC311003>"协议码。如果接口函数返回0即成功,HIS需将接口表kc22.ckc126=0的费用明细置为1,表示已将KC22中的记录传到定点结算系统数据库中,接下来完成其他的HIS操作即可。如果接口函数返回值不为0即失败,HIS事务回滚,终止HIS操作。注：如果HIS系统住院结算失败而接口交易成功,HIS需要发起反交易请求,冲掉定点结算系统中的成功交易,即调用接口函数,传入"住院结算回退HYPERLINKDC311003"协议码,做住院结算回退。具体处理见HYPERLINK住院结算回退流程。注：再次出院结算时的单据号应换号,不能与上次结算的相同。7提交提交HIS数据库。住院结算回退在查询结算信息时,可不用读卡,但是在结算回退时,针对有卡的险种必须插卡,否则不能结算回退。适用险种职工医疗、城镇居民、工伤步骤号触发业务分步详解1查询查询待作废结算信息。2处理HIS住院结算回退业务。3结算回退调用接口函数,传入"住院结算回退HYPERLINKDC311003"协议码。如果接口函数返回0即成功,接下来完成其他的HIS操作即可。如果接口函数返回值不为0即失败,错误信息见业务返回信息,HIS事务回滚,终止HIS操作。注：如果HIS系统门诊结算回退失败而接口交易成功,那么HIS需要将HIS中的结算信息作废。4提交提交HIS数据库。单据格式职工医疗、城镇居民、工伤单据格式一样,只是返回的数值不一样。单据格式由HIS提供,API只提供结算单上的数据。门诊结算单A：其他类型发票发票与函数返回值对应关系序号发票上列名称发票上列名函数返回值列〔序号备注1门诊类别Fph门诊类别292社会保障号Zgbh个人编号73NONo收据号34Xm55科别Ks科室46编号Zyh住院号67收费项目Xmmc项目名称258金额Xmje项目金额269RylbRylb人员类别910合计Fyhj费用合计1911门诊慢性病Mxb特殊病标志2712起付额累计Qfxlj起付线累计2813统筹金累计Ndtc本年统筹基金累计支付1214个人余额Zhye本次结算后余额1515合计〔大写Gf_daxie<fyhj>由HIS转化16本次统筹金支付Tczf统筹基金支付1117个人支付Grzhzf个人支付1418个人现金支付Grzfxj现金支付1619本次起付额Qfbz起付标准1020统筹围自负Tczifu统筹自负金额2121封顶线上自付Fdxys封顶线上自负2422非医保费用Fybfy非医保费用2223特检特治自负Tjtzzf特检特治自付2024乙类药品自负Ylyzf乙类药自负2325普通门诊应付普通门诊账户if<特殊病标志='是',0,个人支付>26经办人Jbr经办人1727日期日期经办日期18年月日由HIS转化B：普通非营利性发票[注]

1、其中的xmmc1xmmc2xmje1

xmje2

是由返回值中的xmmcxmje处理得到的。

处理规则举例：返回值xmmc中序号为奇数的放在xmmc1中,偶数个的放在xmmc2中。发票与函数返回值对应关系序号发票上列名称发票上列名函数返回值列〔序号备注1门诊类别Fph门诊类别292社会保障号Zgbh个人编号73NONo收据号34Xm55科别Ks科室46编号Zyh住院号67收费项目Xmmc项目名称258金额Xmje项目金额269医保类型Rylb医保类型910合计Fyhj费用合计1911门诊慢性病Mxb特殊病标志2712起付额累计Qfxlj起付线累计2813统筹金累计Ndtc本年统筹基金累计支付1214个人余额Zhye本次结算后余额1515合计〔大写Gf_daxie<fyhj>由HIS转化16本次统筹金支付Tczf统筹基金支付1117个人支付Grzhzf个人支付1418个人现金支付Grzfxj现金支付1619本次起付额Qfbz起付标准1020统筹围自负Tczifu统筹自负金额2121封顶线上自付Fdxys封顶线上自负2422非医保费用Fybfy非医保费用2223特检特治自负Tjtzzf特检特治自付2024乙类药品自负Ylyzf乙类药自负2325普通门诊应付普通门诊账户if<特殊病标志='是',0,个人支付>26经办人Jbr经办人1727日期日期经办日期18年月日由HIS转化28性别Xb性别30住院结算单A：其他类型发票发票与函数返回值对应关系序号发票上列名发票上列名称函数返回值列〔序号备注1FphFph门诊类别342Zgbh社会保障号个人编号103NoNO收据号34Xm55Ks科别科室46Zyh住院号住院号67住院日期入院日期入院日期7出院日期住院日期88Zyts共住天数住院天数99Xmmc收费项目项目名称3210Xmje金额项目金额3311ZhyeIC卡余额本次支付后账户余额1812Zycs出院结算、中间结算次数住院次数2513Fyhj合计合计2614Tczf统筹基金支付统筹基金支付1415Fyhj-tczf自费总金额Fyhj-tczf16Grzhzf个人支付个人账户支付1717Grzfxj个人现金支付个人支付现金1918Gf_daxie<fyhj>合计〔大写由HIS转化19Yj押金总额20Bxj应补交金额21Txj应退金额22Ndtc统筹基金累计已支付本年度统筹基金支付1523Tjtzzf特检特治自负特检特治自负2724Qfbz起付额支付起付标准1325Tczifu统筹自负金额统筹自负金额2826Fybfy非医保费用非医保费用2927Ylyzf乙类药品自负乙类药自负3028Fdxszf封顶线上自负封顶线上自负3129Jbr经办人经办人2330日期日期结算日期2431rylb人员类别人员类别12B：普通非营利性发票[注]

1、其中的xmmc1xmmc2xmje1

xmje2

是由返回值中的xmmcxmje处理得到的。

处理规则举例：返回值xmmc中序号为奇数的放在xmmc1中,偶数个的放在xmmc2中。

2、"个人自付"=

fyhj

-

tczf

-

fybfy

医院垫支为常量0,这个固定在结算单据上即可,接口没有返回这个字段。发票与函数返回值对应关系序号发票上列名发票上列名称函数返回值列〔序号备注1FphFph门诊类别342Zgbh社会保障号个人编号103NoNO收据号34Xm55Ks科别科室46Zyh住院号住院号67住院日期入院日期入院日期7出院日期住院日期88Zyts共住天数住院天数99Xmmc收费项目项目名称3210Xmje金额项目金额3311ZhyeIC卡余额本次支付后账户余额1812Zycs出院结算、中间结算次数住院次数2513Fyhj合计合计2614Tczf统筹基金支付统筹基金支付1415Fyhj-tczf自费总金额Fyhj-tczf16Grzhzf个人支付个人账户支付1717Grzfxj个人现金支付个人支付现金1918Gf_daxie<fyhj>合计〔大写由HIS转化19Yj押金总额20Bxj应补交金额21Txj应退金额22Ndtc统筹基金累计已支付本年度统筹基金支付1523Tjtzzf特检特治自负特检特治自负2724Qfbz起付额支付起付标准1325Tczifu统筹自负金额统筹自负金额2826Fybfy非医保费用非医保费用2927Ylyzf乙类药品自负乙类药自负3028Fdxszf封顶线上自负封顶线上自负3129Jbr经办人经办人2330日期日期结算日期2431rylb医保类型医保类型1232XB性别性别35.常用业务协议码下面根据业务协议码分别介绍,对应comminterface函数的业务入参及业务出参。出参格式描述中的序号代表‘|’的位置。读卡身份验证业务协议码AA311012业务描述用于划卡的读卡身份验证,返回参保人员的的基本信息、账户信息以及中心的相关审批信息。HIS程序可通过此业务将参保人的信息保存到HIS系统中,用于数据查询及应用。如果是门诊特殊病要提前录入病种业务入参格式疾病编码业务入参描述门诊特殊病必须传入HIS疾病编码,普通门诊及住院可以不用传。业务出参格式及描述个人编号|号|单位编号|……|转外门诊符合基本医疗|XX出参中每个字段具体描述见下表：序号字段名是否关键型字段备注1个人编号是2号是3单位编号是4IC卡号是5是6性别是7出生日期是8人员类别是9参保日期是10人员状态是11变更日期12定点医院113定点医院214定点医院315定点医院416定点医院517出院日期18住院状态是19预留字段20人员性质是0-职工,1-居民21预留字段22区号23单位类型24预留字段25公务员是26缴费月数27职务级别离休人员使用〔有/无28定点医院名129定点医院名230定点医院名331慢性病医院132慢性病医院233慢性病医院334慢性病医院435慢性病医院536定点医院名437定点医院名538老医保编号39单位名称是40行政级别41预留字段42预留字段43灵活就业标志是44逻辑卡号45预留字段46是否基残人员47个人ID48单位ID49参加工作日期是50结算年月51医疗机构编号52年度53历年结转54本年注入55刷新时间56费用合计57住院次数是58支出累计是59统筹支出累计是60个人支付累计61符合基本医疗累计是62结转金累计63住院统筹64门诊大病统筹65门诊特殊统筹累计66门诊特殊疾病起付标准累计67门诊统筹余额居民使用68符合基本医疗累计69进入统筹累计70预留字段71公务员统筹累计是72预留字段73门诊慢性病统筹支付累计74预留字段75住院符合基本医疗76慢性病起付标准77慢性病符合基本医疗78大型检查统筹累计79大型检查符合基本医疗80门诊特殊病符合基本医疗是81转外门诊统筹累计82转外门诊符合基本医疗说明：调用此协议码时,如果此参保人存在封锁统筹的封锁时,动态库中弹出提示信息"封锁原因为……,统筹支出暂时不能使用,被封锁。个人可使用。可以继续操作！",但可以继续做业务；如果存在封锁账户和统筹的封锁时,动态库返回-1,不能继续其他业务。用例1、城居医保li_res=comminterface<"AA311012”,"","1|11|0|XX","manager","password","1234567890”,"0”2、职工医保li_res=comminterface<"AA311012”,"","0|11|医保IC卡号|XX","manager","password","1111111111”,"0”3、工伤患者li_res=comminterface<"AA311012”,"","2|11|个人社保编号|XX","manager","password","2222222222”,"0”读取收费项目对照信息业务协议码BB31SFXM业务描述HIS系统可在录费时显示药品的收费项目等级〔甲、乙、丙。HIS系统也可将收费项目等级存储到HIS数据库中,便于做住院费用明细查询时显示药品的收费项目等级。业务入参格式药品、诊疗〔HIS编码|项目分类业务入参描述项目分类：1-药品2-诊疗业务出参格式及描述费用等级|门诊自付比例|住院自付比例|标准价格|XX序号字段名是否关键型字段备注1费用等级是甲类或乙类或丙类2门诊自付比例是3住院自付比例是4标准价格是用例职工医保li_res=comminterface<"BB31SFXM","药品HIS编码|1”,"0|||XX","manager","password","1111111111”,"0”门诊预结算业务协议码BC311002业务描述调用此协议码可以预览门诊报销结果。业务入参格式门诊住院号|医疗类别|疾病编码业务入参描述门诊住院号详见HYPERLINK,"manager","password","1111111111”门诊结算业务协议码CC311002业务描述调用此协议码可产生门诊结算最终结果；此协议码功能可做普通门诊和特殊病门诊结算业务入参格式门诊住院号|医疗类别|单据号|疾病编码业务入参描述门诊住院号详见HYPERLINK,"manager","password","1111111111”门诊结算回退业务协议码DC311002业务描述HIS结算后发现结算金额有误或其他原因需要作废结算结果,可调用此协议码取消结算结果。业务入参格式门诊住院号|单据号业务入参描述无出参格式及描述医疗费用总额|本次现金支付金额|结算后IC卡余额|XX序号字段名是否关键字段备注1医疗费用总额是2本次现金支付金额是3结算后IC卡余额是用例职工医保li_res=comminterface<"DC311002”,"门诊住院号|单据号","0|11|医保IC卡号|XX","manager","password","1111111111”,"0”门诊结算单打印业务协议码BB310002业务描述门诊结算后,打印门诊结算单。业务入参格式门诊住院号|单据号业务入参描述无业务出参格式及描述医保中心名称|收据号|……|本年门诊统筹支付累计|XX序号字段名是否关键字段备注1定点医疗机构名称是2医院住院号是3收据号是4科室是5是6住院号是7个人编号是8IC卡号是9人员类别是10起付标准是11统筹基金支付是12本年统筹基金累计支付是13自付自费金额合计是14个人支付是15本次结算后余额是16现金支付是17经办人是18经办日期是YYYYMMDD19费用合计是20特检特治自付是21统筹自负金额是22非医保费用是23乙类药自负是24封顶线上自负是25项目名称是26项目金额是27特殊病标志是28起付线累计是29门诊类别是30性别是说明：项目名称与项目金额为本次结算结算费用分类的集合,名称与数值用","分隔。用例职工医保li_res=comminterface<"BB310002”,"门诊住院号|单据号","0|11|医保IC卡号|XX","manager","password","1111111111”,"0”,"0入院登记业务协议码CC311001业务描述HIS录入患者就诊信息,调用此协议码将就诊信息传到劳动保障系统前置机中。非医保转医保同入院登记业务入参格式住院号|意外伤害标志业务入参描述住院号详见HYPERLINK,"manager","password","1111111111”,就诊信息XML字符串,"住院录费预结算业务协议码BC311003业务描述对在院患者费用进行预结算的功能请根据读卡身份验证读出的人员性质传入险种。业务入参格式住院号|医疗类别业务入参描述住院号详见HYPERLINK,"manager","password","1111111111”住院费用明细修改业务协议码BC311004业务描述对已经传输到医保数据库中的费用明细,发现费用等级、单价等信息错误时,可以调用此函数将已经传输的医保数据库中的费用明细进行删除。业务入参格式住院号|医疗类别|处方号|处方日期|医院收费编码业务入参描述住院号详见HYPERLINK,"manager","password","1111111111住院结算业务协议码CC311003业务描述住院结算包括"普通住院结算","中途结算","年终结算"三类业务。普通住院结算：患者入院后只做一次出院结算,完成一次住院。中途结算：由于有些医保患者住院时间较长并且医疗费用由医院垫付,医院为减轻资金压力会对这部分患者定期做一次结算,然后医院到医保中心报销,以减轻医院资金压力。年终结算：由于医保政策规定医疗费用报销按年度划分,所以跨年住院患者到年底必须做年终结算,结清上一年医疗费用。下一年做最终出院结算时只结算下一年产生的医疗费用即可。在医院结算时要提供选择住院结算方式的功能。业务入参格式住院号|医疗类别|单据号|结算方式|费用总额|本次结算使用账户金额业务入参描述住院号详见HYPERLINK,"manager","password","1111111111”住院结算回退业务协议码DC311003业务描述HIS结算后发现结算金额有误或其他原因需要作废结算结果,可调用此协议码取消结算结果。业务入参格式住院号|单据号业务入参描述住院号详见HYPERLINK,"manager","password","1111111111”,"0”住院结算单打印业务协议码BB310003业务描述住院结算后,打印住院结算单。业务入参格式门诊住院号|单据号|住院押金业务入参描述无业务出参格式及描述医保中心名称|收据号|……|本年门诊统筹支付累计|XX序号字段名是否关键字段备注1定点医疗机构名称是2医院住院号是3收据号是4科室是5是6住院号是7入院日期是YYYYMMDD8出院日期是YYYYMMDD9住院天数是10职工编号是11IC卡号是12人员类别是13起付标准是14统筹基金支付是15本年度统筹基金支付是16自付自费金额合计是17个人账户支付是18本次支付后账户余额是19个人支付现金是20押金是21退现金是22补现金是23经办人是24经办日期是YYYYMMDD25住院次数是26合计是27特检特治自负是28统筹自负金额是29非医保费用是30乙类药自负是31封顶线上自负是32项目名称是33项目金额是34与中心是否断网是35性别是说明：项目名称与项目金额为本次结算结算费用分类的集合,名称与数值用","分隔。用例职工医保li_res=comminterface<"BB310003”,"门诊住院号|单据号|1000”,"0|21|医保IC卡号|XX","manager","password","1111111111”,"0”无费出院〔入院登记回退业务协议码DC311001业务描述HIS录入患者的就诊信息和处方信息,在没有进行结算之前可以进行取消操作。业务入参格式住院号业务入参描述住院号详见HYPERLINK,"manager","password","1111111111”,"0”定点结算系统功能介绍一级菜单二级功能模块简单说明基本信息维护药品对照实现医院药品与医保中心药品对照的功能。能够将多个医院药品对照到医保中心的一个药品上。对照时只需录入医院药品编码即可。可将医院药品目录导出XLS格式,导入到医保结算系统中,采用拼音码查询,双向模糊查询医院药品与医保中心药品,实现快速对照。诊疗对照同药品信息维护。病种对照完成病种的对照功能,同药品信息维护。信息查询门诊人员信息查询可根据结算日期围、IC卡号对门诊结算信息进行查询门诊结算信息查询住院人员信息查询可根据结算日期围、IC卡号对住院结算信息进行查询住院结算信息查询定点医疗机构月末结算定点医疗机构每月与医保中心对账用。常见问题在交易过程中,先提交哪一个系统数据库事务？答：HIS在操作过程中,先处理HIS业务,如果处理成功,调用医保接口函数,医保接口函数返回值为0时〔如果返回值为0,证明医保已提交数据库,HIS再提交数据库,否则进行回滚。住院日常费用录入如何处理的？答：一般情况下,要求HIS在日常费用录入时,每次录入处方后要调用住院录费预结算函数,将日常费用传输到劳动保障系统前置机。调用预结算时会返回计算结果,HIS可以将计算结果存储到HIS数据库中,便于实时查询到患者费用,用于住院押金的收取；如何才能查询到API接口事务是否成功或作进一步处理？答：在定点医疗机构结算系统时,可在[门诊人员信息查询]和[住院人员信息查询]查询到发生的费用。如果在劳动保障系统前置机中存在结算数据,而在HIS中未存在结算数据,那么需要HIS提供医保反交易的功能,具体调用方法按照HYPERLINK[门诊结算回退]和HYPERLINK[住院结算回退]执行。如果在进行his结算时,调用接口函数成功,但是his数据库突然断开,造成医保中存在结算数据,his中无结算数据,该如何处理？答：his中应提供医保结算退费的功能,用于处理此种情况,同上述问题。住院录入费用过程中有没有什么限制？在正常的住院录入费用过程中,是否是每一笔处方都调一次动态库,还是录入完成之后再调一次？有没有限制或者规定性容？答：费用明细中字段中不能包含"#"号。一般情况下,住院录入费用过程中,录入完成后调用动态库,进行数据传输。不建议每一笔处方就调一次动态库,那样的话HIS的事务控制复杂。在每次调用预结算时,费用明细不能超过50条数据。如果HIS系统录入明细大于50条,那么HIS需要50条循环调用API接口函数。调用API接口函数〔住院录费预结算时,提示"发送请求失败"答：请检查费用明细中的项目名称是否存在乱码或者是否包含"#",费用明细各数据项不能包含"#"。如未正常维护三目对照,会有什么影响或者问题出现？答：医院药品与医保药品的对照信息存储到劳动保障系统前置机的药品对照表中,在医院录费过程中,要把医院药品编码存储到费用明细中,在进行医保结算时,根据费用明细中的医院药品编码到劳动保障系统前置机中的药品对照表中查询对照信息,如果能够查询到,然后对照表中的收费项目等级参与计算,否则按照丙类处理。所以医院要对本医院的所有药品信息与医保中心药品进行对照,如果在医保中心药品目录中找不到,那么不用进行对照,接口系统将按照丙类处理。项目未对照已收费,且已传输到劳动保障系统前置机中,此时将项目进行对照,但已传输过的项目收费项目等级不能修改,仍显示为丙类,该怎样处理？答：在HIS系统中将已传输过的错误的项目进行退费,方法见"HYPERLINK定点结算系统来调用？答：劳动保障业务多年来一直不断完善,不断变化,政策也会在不同时间进行相应的调整。为确保对定点HIS系统影响最小,由HYPERLINK定点结算系统提供API接口函数供HIS系统调用,能够确保最大稳定性。这样,当政策发生变化的情况下,通常可修改API接口函数的部实现,确保接口不变的情况下,完成政策的调整,而HIS系统不需要调整。如果在住院录费预结算时费用明细传输错误,该怎么处理？答：在HIS系统中将已传输过的错误的项目进行退费,方法见"HYPERLINK住院费用明细修改"。在住院期间住院患者变更单位,原单位存在封锁,而新单位没有封锁,或者卡挂失,卡号发生变化,在HIS中该如何处理？答：请在HIS中提供变更住院就诊信息功能,更改接口表KC21中的单位编号、IC卡号等信息的功能,在调用住院录费预结算时便可将变更的就诊信息传输到劳动保障系统前置机。当医保/工伤等项目发生变化之后,HIS系统如何处理?答：如果医保中心有新增项目,那么医院需要将本医院的项目与中心项目做对照；如果此项目医院已经进行过对照,那么项目发生变化后〔如：收费项目等级、自付比例、限价发生变化,HIS系统不用重新维护,动态库会在下次调用时自动按照新的政策进行结算,但是已传输过的项目仍按原政策执行。如何获取HIS中所有药品或所有诊疗对照医保项目的信息？答：可在HYPERLINK定点结算系统中的[药品对照]和[诊疗对照]进行查询,也可进行导出。在进行费用录入时如何显示项目的收费项目等级？答：调用接口函数"HYPERLINK读取收费项目对照信息"读取药品信息和读取诊疗信息,获取项目收费等级,然后将收费项目等级存储到HIS系统中,在费用录入时,显示项目的收费等级。也可在定点结算系统中导出对照信息,然后由HIS系统将导出的对照信息保存到HIS系统中。在住院费用录入时录入明细大于5条后,调用API接口住院录费预结算函数时,提示存储过程失效的错误。答：请确认客户端ORACLE版本不能低于ORACLE10g,因为大医院模式通过ODBC连接医院数据库,如果ODBC的ORACLE版本过低,动态库中有一些新功能在低版本下不能使用。读卡身份验证都验证哪些容？答：详见[错误信息列表]。如何进行API接口函数的声明引用？答：下面示例在PB9.0中的函数调用声明,其他开发语言请参考相应资料：FUNCTIONintcomminterface<stringywxym,stringywrc,stringyllx,stringloginname,stringpassword,stringlicence,stringjzxx,stringfymx,refstringywcc>Library"hiscomminterface.dll"HIS传入XML字符串中禁止出现的字