定点医疗机构API开发基础手册

文档编号：DX12L002分册名称：定点医疗机构API开发手册第2.0版定点医疗机构API开发手册河北东软软件有限公司1版权声明《定点医疗机构API开发手册》版权归河北东软软件有限公司所有。未经河北东软软件有限公司书面准许，不得将本规范任何内容以任何形式、任何手段（电子或机械，涉及照相复制或录制）、或为任何目，进行复制或扩散。版权所有，翻制必究。Copyright@河北东软软件有限公司。文档修改历史版本修改记录修改日期修改人0.5增长开发险种范畴、安全机制、将HIS流程阐明放到前面，惯用API接口函数简介-7-15薛亚玲0.6增长和修改文档中某些阐明-7-21陈晓明0.61Comminterface医疗类型入参增长医疗类别。调节API常用流程简介-7-23薛亚玲0.62接口表KC22主键去掉AAE040-7-26薛亚玲0.63预结算、结算去掉支付方式、经办人、账户支付金额；读人员审批信息去掉审批类别-8-10薛亚玲0.64将读卡、读取封锁、读取审批合并；将读药物、读诊断对照信息合并；去掉疾病和批量读取收费项目对照信息。-8-12薛亚玲0.65接口表KC22，增长每次用量单位AKA076,KC21增长患者联系电话PHONE-8-17薛亚玲0.66读卡身份验证，增长两个返回值：结算年月，定点医疗机构编号。-8-20武刚0.67修改xml字符串格式为小写-8-26陈晓明0.68修改门诊预结算和住院预结算出参-9-6陈晓明0.69修改kc22表构造，去掉aae040,zka101,aae073,ckc048,ckc125-9-13武刚0.70修改xml字符串示例，使之与kc22表构造一致-9-13武刚0.71调节kc21表构造-9-13武刚0.81读卡身份验证增长疾病编码-9-21薛亚玲0.82去掉入院登记回退业务-11-09薛亚玲0.83支持环境增长大医院模式使用oracle10g版本-11-10薛亚玲0.84修改入院登记传入参数-11-1陈晓明0.85修改xml字符串示例-11-18陈晓明0.86医疗类别去掉半途结算与年终结算，住院结算参数增长结算方式（1-普通住院结算，2-半途结算，3-年终结算）-11-19薛亚玲0.87增长医保结算成功his失败后，如何解决问题-12-01薛亚玲0.9定版0.9.0.9遗留问题：HIS传播费用明细后，如果费用级别发生变化，再次传入负记录也不能解决问题，需提供专门退费函数来解决。接口函数增长参数中不能具有”#”;增长示例三-12-08薛亚玲0.91增长错误信息列表、验收原则；住院结算函数增长入参费用总额；database.ini改名为neuqhd.ini;增长病历号-12-09薛亚玲0.92修改住院费用明细修改调用流程-12-22陈晓明0.93门诊预结算、住院预结算增长返回参数-01-14陈晓明

目 录第一章 概述 7§1.1 背景 7§1.2 API接口开发险种范畴 7§1.3 API接口开发安全机制 7§1.4 API接口数据流图 8§1.5 支持环境规定 9§1.6 术语 9第二章 迅速上手 10§2.1 结识API接口构成 10§2.2 创立接口表 11§2.3 定点结算系统登录顾客信息对照 12§2.4 ODBC配备 14§2.5 三目编码对照 14§2.5.1 药物对照 15§2.5.2 诊断对照 16§2.5.3 疾病编码对照维护 16§2.6 示例一：入院登记解决 17第三章 API接口函数阐明 18§3.1 API函数参数阐明 18第四章 HIS调用API接口函数流程阐明 20§4.1 门诊某些 20§4.1.1 门诊结算 20§4.1.2 门诊结算回退 21§4.2 住院某些 22§4.2.1 入院登记 22§4.2.2 住院登记信息修改 22§4.2.3 住院费用录入（或执行医嘱） 23§4.2.4 住院费用明细修改 24§4.2.5 住院结算 26§4.2.6 住院结算回退 27§4.3 单据格式 27§4.3.1 门诊结算单 27§4.3.2 住院结算单 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.6 XML字符串示例 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接口只支持WINDOWS/XP系统平台下所开发应用系统，各应用系统必要能正常调用接口函数，传入Windows原则API函数（例如用PB、Delphi、VB、VC、CB等开发软件都可以支持）。不支持其她操作系统。如果为大医院模式，本地ORACLE数据库服务器端和各业务员客户端需要安装oracle10g（10.2.0.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编码录入到该记录中后点击【保存】按钮，把刚才录入信息进行保存。诊断对照同【HYPERLINKCC311001”//业务合同码入院登记ls_ywrc=“ZY0001”//住院号ls_yllx=“0|21||XX”//职工医保|医疗类别（普通住院）|IC卡号ls_yblongin_name=“manager”//通过HIS登录顾客获取ls_yb_password=“neusoft”//通过HIS登录顾客获取ls_licence=“”//由东软公司提供应HIS职工医疗授权码ls_jzxx=“<rowdata><row><akc190>zy0001</akc190><aae073>0</aae073><aka130>21</aka130><akc192>-6-30</akc192><akc193></akc193><akc194>-6-30</akc194><akc195></akc195><akc196></akc196><aae011>test</aae011><aae036>-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请参照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拟定调用接口函数，传入“住院录费(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收据号34姓名Xm姓名55科别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收据号34姓名Xm姓名55科别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收据号34Xm姓名姓名55Ks科别科室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收据号34Xm姓名姓名55Ks科别科室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”，“”，“0”,“2、职工医保 li_res=comminterface(“AA311012”，“”,“0|11|医保IC卡号|XX”，“manager”，“password”,“”，“0”,“3、工伤患者 li_res=comminterface(“AA311012”，“”,“2|11|个人社保编号|XX”，“manager”，“password”,“”，“0”,“读取收费项目对照信息业务合同码BB31SFXM业务描述HIS系统可在录费时显示药物收费项目级别（甲、乙、丙）。HIS系统也可将收费项目级别存储到HIS数据库中，便于做住院费用明细查询时显示药物收费项目级别。业务入参格式药物、诊断（HIS编码）|项目分类业务入参描述项目分类：1-药物2-诊断业务出参格式及描述费用级别|门诊自付比例|住院自付比例|原则价格|XX序号字段名与否核心型字段备注1费用级别是甲类或乙类或丙类2门诊自付比例是3住院自付比例是4原则价格是用例职工医保li_res=comminterface(“BB31SFXM”，“药物HIS编码|1”，“0|||XX”，“manager”，“password”,“”，“0”,“门诊预结算业务合同码BC311002业务描述调用此合同码可以预览门诊报销成果。业务入参格式门诊住院号|医疗类别|疾病编码业务入参描述门诊住院号详见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连接医院数据库，如果ODBCORACLE版本过低，动态库中有某些新功能在低版本下不能使用。读卡身份验证都验证哪些内容？答：详见【错误信息列表】。如何进行API接口函数声明引用？答：下面示例在PB9.0中函数调用声明，其她开发语言请参照相应资料：FUNCTIONintcomminterface(stringywxym,stringywrc,stringyllx,stringloginname,stringpassword,stringlicence,stringjzxx,stringfymx，refstringywcc)Library"hiscomminterface.dll"HIS传入XML字符串中禁止浮现字符动态库接口中使用了某些特殊字符作为分隔符，HIS在调用接口函数，传入入参中不能具有如下字符：冒号（：）、#号（#）。“<”、“>”和“&”是XML中语法核心字，故HIS形成XML字符串中除了用于标记字段“<”“>”外，其她地方不能浮现这两个字符。关于字符集问题医保数据库使用ORACLE数据库，字符集为SIMPLIFIEDCHINESE，若HIS系统字符集和医保不符，则在调用接口函数时应当一方面切换成符合医保字符集，否则调用时会报错。附录病人就诊信息表kc21构造表构造详细建表语句，可参照附录HYPERLINK病人就诊信息表kc21建表语句字段类型长度与否可空主键备注AKC190VARCHAR2(18)否是门诊（住院）号，医院用于区别每次就诊或住院唯一标记1AKA130VARCHAR2(3)否医疗类别详见HYPERLINK费用明细信息表kc22建表语句字段类型长度与否可空主键备注AKC190VARCHAR2(18)否是门诊（住院）号，医院用于区别每次就诊或