《定点医疗机构API开发手册.docx》由会员分享，可在线阅读，更多相关《定点医疗机构API开发手册.docx（113页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、文档编号：DX12L002 分册名称：定点医疗机构API开发手册 第2.0 版定点医疗机构API开发手册河北东软软件有限公司2014年1月1日版权声明定点医疗机构API开发手册的版权归河北东软软件有限公司所有。未经河北东软软件有限公司的书面准许，不得将本规范的任何内容以任何形式、任何手段（电子的或机械的，包括照相复制或录制）、或为任何目的，进行复制或扩散。版权所有，翻制必究。Copyright2014 河北东软软件有限公司。文档修改历史版本修改记录修改日期修改人0.5增加开发险种范围、安全机制、将HIS流程说明放到前面，常用API接口函数介绍2010-7-15薛亚玲0.6增加和修改文档中的部分
2、说明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读卡身份验证，增加两个返回值：结算年月，定点
3、医疗机构编号。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支持环境增加大医院模式使用oracle 10g版本2010-11-10薛亚玲0.8
4、4修改入院登记传入参数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定版0.9.0.9遗留问题：HIS传输费用明细后，如果费用等级发生变化，再次传入负记录也不能解决问题，需提供专门退费的函数来处理。接口函数增加参数中不能含有”#”;增加示例三2010-12-08薛亚玲0.91增加错误信息列表、验收标准；住院结算函数增加入参费用总额；datab
5、ase.ini改名为neuqhd.ini;增加病历号2010-12-09薛亚玲0.92修改住院费用明细修改调用流程2010-12-22陈晓明0.93门诊预结算、住院预结算增加返回参数2011-01-14陈晓明目 录第一章概述71.1背景71.2API接口开发险种范围71.3API接口开发安全机制71.4API接口数据流图81.5支持环境要求91.6术语9第二章快速上手102.1认识API接口组成102.2创建接口表112.3定点结算系统登录用户信息对照122.4ODBC配置142.5三目编码对照142.5.1药品对照152.5.2诊疗对照162.5.3疾病编码对照维护162.6示例一：入院登记
6、处理17第三章API接口函数说明183.1API函数参数说明18第四章HIS调用API接口函数流程说明204.1门诊部分204.1.1门诊结算204.1.2门诊结算回退214.2住院部分224.2.1入院登记224.2.2住院登记信息修改224.2.3住院费用录入（或执行医嘱）234.2.4住院费用明细修改244.2.5住院结算264.2.6住院结算回退274.3单据格式274.3.1门诊结算单274.3.2住院结算单29第五章常用业务协议码315.1读卡身份验证315.2读取收费项目对照信息355.3门诊预结算355.4门诊结算365.5门诊结算回退375.6门诊结算单打印385.7入院登记
7、395.8住院录费预结算405.9住院费用明细修改415.10住院结算425.11住院结算回退435.12住院结算单打印445.13无费出院45第六章定点结算系统功能介绍46第七章常见问题477.1在交易过程中，先提交哪一个系统数据库事务？477.2住院日常费用录入如何处理的？477.3如何才能查询到API接口事务是否成功或作进一步处理？477.4如果在进行his结算时，调用接口函数成功，但是his数据库突然断开，造成医保中存在结算数据，his中无结算数据，该如何处理？477.5住院录入费用过程中有没有什么限制？在正常的住院录入费用过程中，是否是每一笔处方都调一次动态库，还是录入完成之后再调一
8、次？有没有限制或者规定性内容？487.6调用API接口函数（住院录费预结算）时，提示“发送请求失败”487.7如未正常维护三目对照，会有什么影响或者问题出现？487.8项目未对照已收费，且已传输到劳动保障系统前置机中，此时将项目进行对照，但已传输过的项目收费项目等级不能修改，仍显示为丙类，该怎样处理？487.9能否医院的多个药品对应医保的某个药品？497.10读卡输入密码窗口需要HIS开发吗？497.11发生DLL调用错误怎么办？497.12进行API接口开发是否威胁到HIS系统数据安全？497.13能否由HIS系统提供接口，由定点结算系统来调用？507.14如果在住院录费预结算时费用明细传输
9、错误，该怎么处理？507.15在住院期间住院患者变更单位，原单位存在封锁，而新单位没有封锁，或者卡挂失，卡号发生变化，在HIS中该如何处理？507.16当医保/工伤等项目发生变化之后，HIS系统如何处理?507.17如何获取HIS中所有药品或所有诊疗对照医保项目的信息？507.18在进行费用录入时如何显示项目的收费项目等级？517.19在住院费用录入时录入明细大于5条后，调用API接口住院录费预结算函数时，提示存储过程失效的错误。517.20读卡身份验证都验证哪些内容？517.21如何进行API接口函数的声明引用？51第八章附录528.1病人就诊信息表kc21结构528.2费用明细信息表kc2
10、2结构538.3接口表指标代码表548.4病人就诊信息表kc21建表语句578.5费用明细信息表kc22建表语句598.6XML字符串示例608.7错误信息列表618.8验收标准65第一章 概述1.1 背景随着国家对劳动保障信息化工作的大力投入，劳动保障部门需要与定点医疗机构建立更加紧密的信息互联与交换，这就需要把定点医疗机构原来的信息管理系统（下称HIS系统）与劳动保障部门的业务系统互联。目前，劳动保障部门延伸到定点医疗机构的业务系统有：职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统，下面统称这三个定点结算系统为定点结算系统。HIS系统与劳动保障部门的业务系统互联，
11、将有助于减轻定点医疗机构的日常管理和业务经办工作量，提高工作效率。同时，也有利于劳动保障部门对基金的监督管理，有利于参保人员合法权益的保护。1.2 API接口开发险种范围序号险种是否有卡患者识别方式1职工医疗无IC卡号2城镇居民有卡CPU卡3工伤保险无社会保障号1.3 API接口开发安全机制序号机制说明1授权码API接口开发的授权码，每个险种对应一个授权码，由东软公司提供。2登录用户和口令定点结算系统中的登录用户和口令；用来确定是哪个用户/业务员传上来的数据，作为API接口的登录用户。3MAC地址通过MAC地址来限制各定点使用的终端接入和信息跟踪。1.4 API接口数据流图定点结算系统提供AP
12、I接口函数供定点医疗机构HIS系统调用，以完成相应险种的数据传输与结算处理，其基本数据流图如下：说明：1、 HIS系统进行业务数据录入，将就诊信息和费用明细写入HIS接口表中，根据接口表数据，生成XML格式数据。2、 HIS系统提供对应API接口函数的入参，其中要提供定点结算系统中的登录名和密码，并提供险种的授权码，调用定点结算系统的API接口函数。3、 API接口函数在接收到HIS系统的调用请求后，进行授权码验证和用户合法性校验，然后把传入的就诊信息XML数据和费用明细XML数据传输到劳动保障系统前置机业务系统中。4、 API接口函数根据就诊信息和费用明细，按照政策要求进行相应的运算。5、
13、API接口函数返回执行结果，HIS系统根据返回结果进行相应的判断处理，以完成相应的业务处理。至此整个调用过程结束。1.5 支持环境要求计算机至少要1G 内存，磁盘剩余空间至少1G。该API接口只支持WINDOWS 2000/XP系统平台下所开发的应用系统，各应用系统必须能正常调用接口函数，传入Windows标准API函数（例如用PB、Delphi、VB、VC、CB等开发的软件都可以支持）。不支持其他操作系统。如果为大医院模式，本地ORACLE数据库服务器端和各业务员客户端需要安装oracle 10g（10.2.0.1以上）版本。1.6 术语序号术语含义1劳动保障系统前置机定点结算系统数据库所在
14、服务器2预结算将未上传的费用明细传输到劳动保障系统前置机，对费用信息计算预览3定点结算系统职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统，统称这三个定点结算系统为定点结算系统。软件版权归东软公司。4HIS系统指各定点医疗机构使用的医院信息管理系统。5大医院模式在我市定点结算系统中，有10多家大型医院安装了本地数据库，一些没有安装本地数据库。安装了本地数据库的医院叫大医院模式，没有安装本地数据库的医院称为托管模式。大医院模式对不同的定点结算系统可能不同，如某医院可能职工定点结算系统是大医院模式，而城居和工伤定点结算系统就可能不是大医院模式，这一点要注意。第二章 快速上手
15、 本章将对API接口组成和开发前的准备工作做一下简单介绍，并用例子让开发者初步认识调用API接口函数的一般过程与方法。API授权码创建接口表定点结算系统登录用户信息对照三目编码对照HIS调用API接口程序开发API接口业务调试HIS系统定点结算系统API接口文件2.1 认识API接口组成请从东软公司获取API接口文件。该API接口文件包括如下内容：序号文件名说明1hiscomminterface.dll医保API接口2hiscomminterface.h供c开发的his系统开发使用3hiscomminterface.lib供c开发的his系统开发使用4Dcic32.dll卡相关动态库5HSMA
16、pi.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的修改项的说明见配置文件中的说明。2.2 创建接口表所谓接口
17、表，是在进行API接口开发之前，需要在HIS系统中创建的两个实体表，特指病人就诊信息表kc21和费用明细信息表kc22两张表，这两张表用于生成XML数据。具体表结构和字段含义，请参考附录病人就诊信息表kc21和费用明细信息表kc22中的描述。这里，对创建接口表作如下要求：1、接口表建在HIS系统数据库中，建在HIS系统的同一数据库用户下。 2、如果HIS系统所使用的数据库不是ORACLE，创建接口表时，把接口表的表名和字段名设置为大写。3、接口表作为HIS系统数据库的一部分，用于HIS自身的事务处理。说明：建立接口表的目的是为了在调用API接口函数时，生成接口函数所需要的XML数据， 至于哪些
18、函数需要XML数据，请参照常用业务协议码介绍。2.3 定点结算系统登录用户信息对照HIS系统在调用API接口函数时需要提供合法的登录用户和口令，如果登录用户和口令与定点结算系统中的登录用户匹配，那么可以正常调用API接口函数，否则提示用户不合法。因此，HIS系统中要提供定点结算系统中登录用户信息与HIS系统中登录用户信息对照的功能。在初次启动动态库时，操作员要使用此功能模块将定点结算系统中的登录用户和口令信息保存到HIS系统中，在日常使用过程中，如果定点结算系统中的用户信息发生变化，操作员还需要应用此模块重新进行对照，否则不能正常做医保业务。目前，定点医疗机构的业务系统有：职工医疗保险定点结算
19、系统、居民医疗保险定点结算系统、工伤保险定点结算系统，在HIS系统中需要对三套定点结算系统进行登录用户对照。下方为HIS系统社会保障系统登录用户对照功能示例，HIS可参照，也可自己开发，只要实现此功能即可。假设HIS系统中用户信息表为T_USER。1. 表结构字段类型长度是否可空主键备注LOGIN_NAMEVARCHAR2(20)否是HIS系统中用户登录名 PASSWORDVARCHAR2(20)否HIS系统中登录密码NAMEVARCHAR2(20)否操作员姓名ZGYL_LOGIN_NAMEVARCHAR2(20)否职工定点结算系统中登录名ZGYL_PASSWORDVARCHAR2(20)否职
20、工定点结算系统中密码CZJM_LOGIN_NAMEVARCHAR2(20)否城镇居民定点结算系统中登录名CZJM_PASSWORDVARCHAR2(20)否城镇居民定点结算系统中密码GS_LOGIN_NAMEVARCHAR2(20)否工伤保险定点结算系统中登录名GS_PASSWORDVARCHAR2(20)否工伤保险定点结算系统中密码黄色部分为原系统中不存在列，需要针对动态库新增2. HIS系统中原用户信息：LOGIN_NAMEPASSWORDNAMEZGYL_LOGIN_NAMEZGYL_PASSWORDCZJM_LOGIN_NAMECZJM_PASSWORD张三123456张三李四7802
21、15李四3. 动态库启动后，操作员通过用户信息对照功能模块，录入定点结算系统中登录名与密码。打开定点结算系统登录用户信息对照窗口，定点结算系统中登录用户信息部分会自动显示已维护过的信息，如果为空，证明还未进行维护。灰色字体不可录，蓝色字体为必录项。操作员填写登录用户与密码，保存即可。HIS系统存入的密码为明码值。定点结算系统登录用户信息对照 HIS系统用户信息登录用户张三定点结算系统中登录用户信息职工医疗登录用户1001zhangsan职工医疗密码*城镇居民登录用户1001zhangsan城镇居民密码*工伤保险登录用户1001zhangsan工伤保险密码*保 存关 闭就绪定点结算系统登录用户信
22、息对照4. 操作员维护后用户信息LOGIN_NAMEPASSWORDNAMEZGYL_LOGIN_NAMEZGYL_PASSWORDCZJM_LOGIN_NAMECZJM_PASSWORD张三123456张三1001zhangsan8888881001zhangsan888888李四780215李四lisi000000lisi0000005. 调用API接口函数时，HIS系统在验证其HIS系统登录安全后，再从该对照表T_USER中获取对应险种的登录名和密码（如zhangsan、888888）传给API函数，由API函数传到定点结算系统中进行医保相应的安全验证。6. 如果操作员在定点结算系统中变
23、更密码，那么须在此窗口重新维护。如果未在HIS系统中修改定点结算系统登录密码，那么在调用API接口函数时会提示用户不合法。2.4 ODBC配置定点结算系统存在本地数据库的医院需要进行ODBC配置，否则不用配置ODBC。ODBC数据源中只需录入数据源名称与TNS Service Name即可，其中TNS Service Name为客户端连接本地数据库的服务名。配置时按如下表中名称配置：险种ODBC数据源名称TNS Service Name备注职工connection_zgzgyl数据源名称需要与neuqhd.ini中对应险种的【#医保前置机连接】下的ServerName名称一致。城居connec
24、tion_cjcjyl工伤connection_gsgsyl例：客户端连接职工医疗数据库的服务名为zgyl。2.5 三目编码对照医保患者在医院就诊且发生费用时，就应该按照医保中心的相关政策对该患者在就诊期间所发生的各项费用进行结算。而各种药品、诊疗项目、病种、服务设施的相关信息在结算过程中扮演着重要角色，因此医院对医保患者进行费用结算时就必须明确告诉医保中心，自己所用的目录中的各个项目分别对应于医保中心目录中的哪一条。然而，各个医院都有自己独立的HIS系统，也有自己独立的药品、诊疗、病种，并且这些目录都有可能不同于医保中心对应的目录。所以，为了将医院目录中的各个项目与医保中心的相关目录关联起来
25、（而又不需要对医院已有的目录进行改动），就需要将医院的目录中的信息和医保中心相关信息进行对照。目录经过对照后，在医院的每一种药品、诊疗、病种就都可以在医保中心找到一条记录与之相对应，也就使得医院与医保中心的记录统一起来。这样，医院就能在通过医保接口与医保中心进行对照时，以提供对照码的方式来告诉医保中心医院所用的项目对应于中心的哪条记录。2.5.1 药品对照点击定点结算系统中【医疗信息维护】下的【药品对照】会打开下图所示的窗口：图5-1图5-2【操作流程】1. 选择批量方式对照时需要把his的药品库导入到医保库中，然后再his药品信息中选择需要对照的药品，选种该药品的同时在医保药品信息中也查出相
26、应的药品，然后再医保药品信息中选择正确的药品后点击【对照】按钮就可以把医院和医保的药品对照起来了。2. 选择单个对照方式时录入拼音码或名称后点击【检索】按钮在医保药品信息中找到该药品后同时再对照信息中插入一条该药品信息，把his的编码录入到该记录中后点击【保存】按钮，把刚才录入的信息进行保存。2.5.2 诊疗对照同【药品对照】。2.5.3 疾病编码对照维护同【药品对照】。2.6 示例一：入院登记处理通过该示例，你将学习到如何调用API接口函数，完成信息在HIS系统与定点结算系统之间的交互与处理全过程。掌握了该示例，其他的业务处理基本都相同，请认真体会。首先录入住院就诊信息，然后选择录入医疗类型
27、与医保IC卡号或社会保障号进行入院登记业务处理。以职工医保为例。ls_ywxym = “CC311001”/业务协议码 入院登记ls_ywrc = “ZY00001” /住院号ls_yllx = “0|21|0707110925|XX” /职工医保|医疗类别（普通住院）|IC卡号ls_yblongin_name = “manager” /通过HIS登录用户获取ls_yb_password = “neusoft” /通过HIS登录用户获取ls_licence = “1111111111” /由东软公司提供给HIS的职工医疗的授权码ls_jzxx = “zy000010212010-6-30201
28、0-6-30test2010-6-301test123456” /就诊信息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,ref ls_ywcc)ls_ywcc = “” /业务出参为空/后续处理HIS相关业务第三章 API接口函数说明 3.1 API函数参数说明本接口API函数只提供了一个comminterface函数，通过给该函数传入不同的业务协议码，来实现不同的业务
29、功能。因此，对于调用者，需要详细学习该函数的组成，以便灵活调用。comminterface (in业务协议码, in业务入参，in医疗类型，in 登录名,in 密码，in 授权码，in 就诊信息，in 费用明细, out业务出参) 参数描述：参数内不能带有和#标识符号列方向说明业务协议码in请参考业务协议码表中的业务协议码业务入参in请参考业务协议码表中的业务入参；医疗类型in(险种|医疗类别|患者识别信息|XX)HIS系统需要提供选择职工医保、城居医保、工伤的功能， 同时要提供录入IC卡号社会保障号的功能。险种：0-职工医保，1-城居医保，2-工伤；医疗类别：见接口代码表；患者识别信息：定点
30、机构需用读卡器读取卡上信息的此参数置为0，职工医疗不用读卡器读取卡上信息的此参数需置上参保人的医保IC卡号，对于工伤险种此参数置为工伤人员社保编号；XX:两个大写的X属于固定格式，必须放在最后；险种、医疗类别、患者识别信息、XX之间要用“|”分隔。如果使用社保卡，dll将自动区分是职工还是居民，并且在读卡身份验证业务中返回是职工还是居民，第20个参数，其他业务根据此参数判断险种为0还是1登录名in定点结算系统中登录名口令in定点结算系统中密码（密码须为明码）授权码in授权码(东软公司提供)就诊信息in根据kc21表结构生成的XML字符串。费用明细in根据kc22表结构生成的XML字符串。业务出
31、参out请参考业务协议码表中的出参格式；备注： 调用预结算、结算、住院登记协议时，就诊信息、费用明细需要传入XML字符串，其他情况可传入”0”。 XML格式要求见【XML字符串示例】返回值：返回值类型：int。1. 0 表示成功，业务出参为对应各业务协议码的业务出参。2. 当此函数返回值不等于0时，操作失败，业务出参内含有错误信息。用例：1、此人参保为城居医保，做出院结算业务，城居为有卡模式。li_res = comminterface (“CC311003”, “门诊住院号| 医疗类别|单据号”，“1|21|0|XX”,“manager”，“password”，“1234567890”，kc
32、21_xml,kc22_xml ,返回结算信息)2、此人参保为职工医保，做出院结算业务，没有读卡操作。li_res = comminterface (“CC311003”, “门诊住院号| 医疗类别|单据号”，“0|21|医保IC卡号|XX”,“manager”，“password”,“11111111111”，kc21_xml,kc22_xml,返回结算信息)3、此人为工伤患者，做出院结算业务，没有读卡操作。li_res = comminterface (“CC311003”, “门诊住院号| 医疗类别|单据号”，“2|21|社保编号|XX” ,“manager”，“password” ，“
33、2222222222”，kc21_xml,kc22_xml , 返回结算信息)第四章 HIS调用API接口函数流程说明4.1 门诊部分4.1.1 门诊结算门诊特殊病与普通门诊业务流程一样，所以放在一起介绍。普通门诊适用险种职工医疗、城镇居民、工伤门诊特殊病适用险种职工医疗、城镇居民步骤号触发业务分步详解1信息录入录入就诊信息和处方明细信息。2选择险种类型和医疗类别（普通门诊或门诊特殊病），根据API接口开发险种范围录入IC卡号、社会保障号或插入CPU卡。3预结算（可选）1. 生成kc21、kc22对应的XML字符串。调用接口函数，传入“门诊预结算(BC311002)”协议码。a) 如果接口函数
34、返回0即成功，HIS可继续完成其他业务。可将返回的计算结果显示到HIS前台系统，供操作员参考。b) 如果接口函数返回值不为0即失败，错误信息见业务返回信息，但HIS可继续做其他业务（只影响计算结果的显示）。4结算1. 写入kc21、kc22，生成XML字符串。调用接口函数，传入“门诊结算(CC311002)”协议码。a) 如果接口函数返回0即成功，HIS需更新接口表KC21、KC22中的CKC126等于1，表示已将KC21、KC22中的记录传到定点结算系统数据库中，接下来完成其他的HIS操作即可。b) 如果接口函数返回值不为0即失败，错误信息见业务返回信息，HIS事务回滚，终止HIS操作。注：
35、如果HIS系统门诊结算失败而接口交易成功即接口函数返回0，HIS需要发起反交易请求，冲掉医保的成功交易，即调用接口函数，传入门诊结算回退(DC311002)协议码，做门诊结算回退。具体处理见门诊结算回退流程。5提交提交HIS数据库。4.1.2 门诊结算回退在查询结算信息时，可不用读卡，但是在结算回退时，针对有卡的险种必须插卡，否则不能结算回退。普通门诊适用险种职工医疗、城镇居民、工伤门诊特殊病适用险种职工医疗、城镇居民步骤号触发业务分步详解1查询查询待作废的结算信息。2处理HIS门诊结算回退业务。3结算回退调用接口函数，传入“门诊结算回退(DC311002)”协议码。1. 如果接口函数返回0即
36、成功,接下来完成其他的HIS操作即可。2. 如果接口函数返回值不为0即失败，错误信息见业务返回信息，HIS事务回滚，终止HIS操作。注：如果HIS系统门诊结算回退失败而接口交易成功，那么HIS需要将HIS中的结算信息作废。4提交提交HIS数据库。4.2 住院部分4.2.1 入院登记非医保转医保业务可按入院登记步骤来操作。适用险种职工医疗、城镇居民、工伤步骤号触发业务分步详解1信息录入录入入院登记信息。2处理HIS入院登记业务。3住院登记选择险种类型，选择医疗类别（普通住院），根据API接口开发险种范围录入IC卡号、社会保障号或插入CPU卡。将入院登记信息保存到接口表KC21中, 生成就诊信息X
37、ML字符串。4住院登记调用接口函数，传入“入院登记(CC311001)”协议码。1. 如果接口函数返回0即成功，HIS可继续完成其他业务。2. 如果接口函数返回值不为0即失败，回滚HIS事务，终止HIS操作。注：如果HIS系统入院登记失败，但接口交易成功，HIS系统需要重新办理医保住院登记，不用调用API接口函数（入院登记）即可。5提交提交HIS数据库。4.2.2 住院登记信息修改办理住院登记后，如果对科室、医生、疾病等信息进行修改，或者患者基本信息发生变化，HIS需提供修改住院登记信息的功能，并实时传输到定点结算系统数据库中。如果需要修改患者基本信息，可通过读卡功能获取患者的最新信息，并更新
38、到接口表KC21中。适用险种职工医疗、城镇居民、工伤步骤号触发业务分步详解1查询查询住院登记信息2修改住院登记信息修改，修改KC21。3处理HIS住院登记信息修改业务。4生成就诊信息XML字符串。不用生成费用明细字符串。5确定调用接口函数，传入“住院录费(BC311003)”协议码，做住院登记信息修改业务。1. 如果接口函数返回0，即成功，HIS可继续完成其他业务。2. 如果接口函数返回不为0，即失败，HIS业务可继续操作，待费用录入时再将变更后的住院登记信息传输到定点结算系统数据库中。6提交提交HIS数据库。4.2.3 住院费用录入（或执行医嘱）适用险种职工医疗、城镇居民、工伤步骤号触发业务
39、分步详解1费用录入费用录入（正记录的费用录入）2处理HIS费用录入业务。3保存将划价收费明细写入KC22，单价和数量不能为负数，保存, 生成费用明细XML字符串，同时生成就诊信息XML字符串。4保存调用接口函数，传入“住院录费(BC311003)”协议码，将费用信息传到社会保障系统数据库中，并返回计算结果。1) 如果接口函数返回0即成功，HIS需置接口表kc22.ckc126为1，可继续完成HIS中其他业务操作。2) 如果接口函数返回不为0，即失败，HIS数据库回滚。5提交提交HIS 数据库4.2.4 住院费用明细修改适用险种职工医疗、城镇居民、工伤步骤号触发业务分步详解1费用退费费用删除（录
40、入的费用存在错误，需要将原费用明细删除，再录入正确的费用明细）2处理HIS费用退费业务。3保存如果整条费用明细退费，那么直接删除KC22中的数据，不用生成费用明细XMl；如果是部分退费，那么KC22中先删除原来的费用明细，再生成正记录进行保存, 将正记录生成费用明细XML字符串，同时生成就诊信息XML字符串。例：原已传输过收费项目。红色代表主键住院号处方号处方日期项目名称项目编码单价数量金额1234561234562010-12-07 8:00:00阿莫西林12345620.0010200.00现想退数量6，那么HIS应保存数量为4的数据到KC22，将新的费用明细生成XML。住院号处方号处方日
41、期项目名称项目编码单价数量金额1234561234562010-12-07 8:10:01阿莫西林12345620.00480.00调用接口函数，传入“住院费用明细修改(BC311004)”协议码，将费用信息传到社会保障系统数据库中，并返回计算结果。ls_ywxym = “BC311004”/业务协议码 住院退费预结算ls_ywrc = “00|ZY00001|21|123456|200|123456” /住院号|医疗类别|处方号|处方日期|医院收费编码ls_yllx = “0|21|0707110925|XX” /职工医保|医疗类别（普通住院）|IC卡号ls_yblongin_name = “manager” /通过HIS登录用户获取ls_yb_password = “neusof