《定点医疗机构API开发手册实用.doc》由会员分享,可在线阅读,更多相关《定点医疗机构API开发手册实用.doc(76页珍藏版)》请在金锄头文库上搜索。
1、定点医疗机构API开发手册文档编号:12L002 分册名称:定点医疗机构API开发手册 第2.0 版定点医疗机构API开发手册软件有限公司版权声明定点医疗机构API开发手册的版权归软件有限公司所有。未经软件有限公司的书面准许,不得将本规范的任何内容以任何形式、任何手段(电子的或机械的,包括照相复制或录制)、或为任何目的,进行复制或扩散。版权所有,翻制必究。Copyright2014 软件有限公司。第73 页 共73 页 文档修改历史版本修改记录修改日期修改人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.84修
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增加错误信息列表、验收标准;住院结算函数增加入参费用总额;databas
5、e.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入院登记39
7、5.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费用明细信息表kc22结
10、构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接口数据流图定点结算系统提供API接
12、口函数供定点医疗机构HIS系统调用,以完成相应险种的数据传输与结算处理,其基本数据流图如下:说明:1、 HIS系统进行业务数据录入,将就诊信息和费用明细写入HIS接口表中,根据接口表数据,生成XML格式数据。2、 HIS系统提供对应API接口函数的入参,其中要提供定点结算系统中的登录名和密码,并提供险种的授权码,调用定点结算系统的API接口函数。3、 API接口函数在接收到HIS系统的调用请求后,进行授权码验证和用户合法性校验,然后把传入的就诊信息XML数据和费用明细XML数据传输到劳动保障系统前置机业务系统中。4、 API接口函数根据就诊信息和费用明细,按照政策要求进行相应的运算。5、 AP
13、I接口函数返回执行结果,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劳动保障系统前置机定点结算系统数据库所在服务器2预结算将未上传的费用明细传输到劳动保障系统前置机,对费用信息计算预览3定点结算系统职工医疗保险定点结算系统、居民医疗保险定点结算系统、工伤保险定点结算系统,统称这三个定点结算系统为定点结算系统。软件版权归东软公司。4HIS系统指各定点医疗机构使用的医院信息管理系统。5大医院模式在我市定点结算系统