《定点医疗机构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大医院模式在我市定点结算系统
