定点医疗机构API开发手册

定点医疗机构API开发手册PAGE第74页共74页文档编号：12L002分册名称：定点医疗机构API开发手册第2.0版定点医疗机构API开发手册软件有限公司版权声明《定点医疗机构API开发手册》的版权归软件有限公司所有。未经软件有限公司的书面准许，不得将本规范的任何内容以任何形式、任何手段（电子的或机械的，包括照相复制或录制）、或为任何目的，进行复制或扩散。版权所有，翻制必究。Copyright@2014软件有限公司。文档修改历史版本修改记录修改日期修改人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-17陈晓明0.85修改xml字符串示例2010-11-18陈晓明0.86医疗类别去掉中途结算与年终结算，住院结算参数增加结算方式（1-普通住院结算，2-中途结算，3-年终结算）2010-11-19薛亚玲0.87增加医保结算成功his失败后，如何处理的问题2010-12-01薛亚玲0.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.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接口只支持WINDOWS2000/XP系统平台下所开发的应用系统，各应用系统必须能正常调用接口函数，传入Windows标准API函数（例如用PB、Delphi、VB、VC、CB等开发的软件都可以支持）。不支持其他操作系统。如果为大医院模式，本地ORACLE数据库服务器端和各业务员客户端需要安装oracle10g（以上）版本。术语序号术语含义劳动保障系统前置机HYPERLINK定点结算系统数据库所在服务器预结算将未上传的费用明细传输到劳动保障系统前置机，对费用信息计算预览定点结算系统职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统，统称这三个定点结算系统为定点结算系统。软件版权归东软公司。HIS系统指各定点医疗机构使用的医院信息管理系统。大医院模式在我市定点结算系统中，有10多家大型医院安装了本地数据库，一些没有安装本地数据库。安装了本地数据库的医院叫大医院模式，没有安装本地数据库的医院称为托管模式。大医院模式对不同的定点结算系统可能不同，如某医院可能职工定点结算系统是大医院模式，而城居和工伤定点结算系统就可能不是大医院模式，这一点要注意。快速上手本章将对API接口组成和开发前的准备工作做一下简单介绍，并用例子让开发者初步认识调用API接口函数的一般过程与方法。API授权码API授权码创建接口表定点结算系统登录用户信息对照三目编码对照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=“ZY0100000000000001”//住院号ls_yllx=“0|21|0707110925|XX”//职工医保|医疗类别（普通住院）|IC卡号ls_yblongin_name=“manager”//通过HIS登录用户获取ls_yb_password=“neusoft”//通过HIS登录用户获取ls_licence=“1111111111”//由东软公司提供给HIS的职工医疗的授权码ls_jzxx=“<rowdata><row><akc190>zy0100000000000001</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”//费用明细为’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封顶线上自付Fys封顶线上自负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封顶线上自付Fys封顶线上自负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乙类药品自负乙类药自负3028Fszf封顶线上自负封顶线上自负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乙类药品自负乙类药自负3028Fszf封顶线上自负封顶线上自负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”,“0”,返回人员信息字符串)2、职工医保 li_res=comminterface(“AA311012”,“”,“0|11|医保IC卡号|XX”,“manager”，“password”,“1111111111”，“0”,“0”,返回人员信息字符串)3、工伤患者 li_res=comminterface(“AA311012”,“”,“2|11|个人社保编号|XX”,“manager”，“password”,“2222222222”，“0”,“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”,“0”,返回药品详细信息字符串)门诊预结算业务协议码BC311002业务描述调用此协议码可以预览门诊报销结果。业务入参格式门诊住院号|医疗类别|疾病编码业务入参描述门诊住院号详见HYPERLINK\l"_病人就诊信息表kc21结构"医保接口表kc21.akc190介绍；医疗类别详见HYPERLINK\l"_接口表指标代码表_1"接口表指标代码表中的医疗类别用法说明门诊特殊病时要传入HIS疾病编码，否则可以为空业务出参格式及描述本次统筹支出|本次现金支付|本次账户支付|本次进入大病金额|结算前账户余额|结算前本年统筹支出累计|结算前本年门诊特殊病统筹支出累计|结算后账户余额|结算后本年统筹支出累计|结算后本年门诊特殊病统筹支出累计|XX序号字段名是否关键字段备注1本次统筹支出是2本次现金支付是3本次账户支付是4本次进入大病金额是普通门诊时返回05结算前账户余额是6结算前本年统筹支出累计是7结算前本年门诊特殊病统筹支出累计是普通门诊时返回08结算后账户余额是9结算后本年统筹支出累计是10结算后本年门诊特殊病统筹支出累计是普通门诊时返回0用例职工医保li_res=comminterface(“BC311002”,“门诊住院号|医疗类别”，“0|11|医保IC卡号|XX”,“manager”，“password”,“1111111111”，就诊信息XML字符串,费用明细XML字符串,返回预结算信息字符串)门诊结算业务协议码CC311002业务描述调用此协议码可产生门诊结算最终结果；此协议码功能可做普通门诊和特殊病门诊结算业务入参格式门诊住院号|医疗类别|单据号|疾病编码业务入参描述门诊住院号详见HYPERLINK\l"_病人就诊信息表kc21结构"医保接口表kc21.akc190介绍；医疗类别详见HYPERLINK\l"_接口表指标代码表_1"接口表指标代码表中的医疗类别用法说明单据号即对于一次结算生成的收据号不同于住院（门诊号）的唯一表示号码；门诊特殊病时要传入HIS疾病编码，否则可以为空业务出参格式及描述医疗费用总额|本次符合基本医疗保险费用金额|……|本年历次大病支付累计|XX序号字段名是否关键字段备注1医疗费用总额是2本次符合基本医疗保险费用金额是3本次符合基本医疗保险外自费金额是4本次特检自付金额5本次特检统筹支付金额6本次特治自付金额7本次特治统筹支付金额8本次个人帐户支付金额是9本次统筹支付金额是10本次现金支付金额是11本次公务员补助支出金额是12结算后IC卡余额是13本次帐户应支付14本次进入大病部分是15本次大病支付金额16本次超过大病封顶线17本年历次大病支付累计用例职工医保li_res=comminterface(“CC311002”,“门诊住院号|医疗类别|单据号”，“0|11|医保IC卡号|XX”,“manager”，“password”,“1111111111”，就诊信息XML字符串,费用明细XML字符串,返回结算信息字符串)门诊结算回退业务协议码DC311002业务描述HIS结算后发现结算金额有误或其他原因需要作废结算结果，可调用此协议码取消结算结果。业务入参格式门诊住院号|单据号业务入参描述无出参格式及描述医疗费用总额|本次现金支付金额|结算后IC卡余额|XX序号字段名是否关键字段备注1医疗费用总额是2本次现金支付金额是3结算后IC卡余额是用例职工医保li_res=comminterface(“DC311002”,“门诊住院号|单据号”，“0|11|医保IC卡号|XX”,“manager”，“password”,“1111111111”，“0”,“0”,返回结算回退信息字符串)门诊结算单打印业务协议码BB310002业务描述门诊结算后，打印门诊结算单。业务入参格式门诊住院号|单据号业务入参描述无业务出参格式及描述医