梅河口市社会医疗保险管理系统医院接口说明V13.docx

《梅河口市社会医疗保险管理系统医院接口说明V13.docx》由会员分享，可在线阅读，更多相关《梅河口市社会医疗保险管理系统医院接口说明V13.docx（96页珍藏版）》请在三一办公上搜索。

1、定点机构就医结算服务接口说明书 梅河口市社会医疗保险管理系统定点机构就医结算服务接口说明书 目 录修改记录1第一章接口描述21.1结算端初始化21.1.1医疗机构注册21.1.2医院基本信息查询31.1.3指标体系下载31.1.4数据库升级信息下载41.1.5数据库升级执行结果上传51.1.6读取医保卡信息61.2目录管理71.2.1药品目录下载71.2.2药品目录对应申请上传91.2.3诊疗目录下载111.2.4诊疗项目目录对应申请上传121.2.5服务设施目录下载141.2.6服务设施目录对应申请上传161.2.7三大目录审核结果下载171.2.8病种代码下载191.2.9控制表信息下载2

2、01.2.10病种信息（国家标准）下载221.2.11医保中心通告信息下载231.3就医结算管理241.3.1读卡（IC卡加密字符串校验）241.3.2获取参保人员基本信息271.3.3查询就医信息291.3.4校验参保人员就诊资格291.3.5查询个人特殊病种备案信息列表301.3.6住院登记信息保存331.3.7登记信息修改351.3.8登记撤销（住院与门诊共用）361.3.9住院处方明细信息上传（废弃）391.3.10明细数据删除391.3.11住院费用计算391.3.12住院结算保存431.3.13住院结算撤销461.3.14处方明细对照目录上传（住院门诊共用）471.3.15门诊结算

3、撤销 （废弃）501.3.16门诊结算费用计算511.3.17门诊结算保存541.3.18特殊门诊结算撤销611.3.19交易验证（一卡通）611.4月度结算管理621.4.1就医登记下载621.4.2明细信息下载621.4.3普通住院结算审核信息下载63kc21View需要传入的参数631.4.4门诊结算审核信息下载641.4.5取得门诊结算信息64第二章参数说明682.1AC01View682.2CodeView682.3HisParmDLView682.4HisRequestView692.5HospitalCodeView702.6HospUserView702.7ICStatusVi

4、ew712.8KA02View712.9KA03View722.10KA04View732.11KA06View732.12KA07View742.13KA17View742.14KA20View752.15KA21View752.16KA23View752.17KA24View762.18KB01View762.19KB05View772.20KB06View782.21KB07View782.22KB16View782.23KB17View782.24KB20View792.25KB71View792.26KB72View802.27KC21View802.28KC22View822.29

5、KC23View842.30KC30View842.31KC32View852.32KC38View87II修改记录版本号变更控制报告编号更改条款及内容更改人审批人更改日期1.0梅河口市社会医疗保险管理系统医院接口说明1.02015-01-231.1增加一卡通的支持：1）修改1.3.1读卡（IC卡加密字符串校验）增加一卡通信息，2）增加交易方法：1.3.19交易验证（一卡通），使用一卡通结算时，先调用一卡通交易函数DoDebit函数，将该交易返回的串进行交易验证，验证成功后进行结算收费（住院结算、门诊结算、药店结算）保存。2015-05-181.2修改第二章2.27 KC21View，增加属性

6、：YKC006 （VARCHAR2(3)） 卡模式：0：医保IC卡；1：医保磁卡；3：医保证2015-07-081.3增加：1. 是否扣除起付点说明：KC21View的AKC666; 1：扣除 2：不扣起付点 默认为扣起付。不扣起伏点需要调整接口： 1.3.11（住院费用计算）和1.3.12（住院结算保存）中的KC21View传AKC666为2。2. 增加接口1.3.20 查询费用明细信息3. 增加接口 1.3.21 查询处方汇总信息4. 增加支付审批表说明，详见附录一2015-11-04第一章 接口描述1.1 结算端初始化1.1.1 医疗机构注册接口命名medOrganRegister描述医

7、院端注册医院端处理医院端注册,返回医院注册信息接口处理查询医院信息参数类型编号名称类型in1HospUserViewJAVABEANout2KB17ViewJAVABEAN请求关键属性HospUserView中的AKB020等输出关键属性KB17ViewHospUserView需传入以下值：序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varchar返回 (KB17View)中信息：序号需要信息信息说明数据类型1AKB020服务机构编号varchar2BKB026密码（加密）

8、varchar3BKB027用户许可数（加密）varchar4BKB028许可证号varchar5BKB029发证日起varchar6BKB030有效日期varchar7BKB031收费金额varchar8BKB032结算软件维护员varchar9BKB033维护员电话varchar10BKB034结算软件版本类型varchar11BKB035结算软件注册标志varchar12BKB036结算软件最近签到日期varchar16BKB043软件发布版本号varchar1.1.2 医院基本信息查询接口命名findKB01Info描述查询定点医疗机构信息医院端处理传入医院编号查询定点医疗机构信息接口

9、处理查询定点医疗机构信息参数类型编号名称类型in1HospUserViewJAVABEANin2akb020Stringout3KB01ViewJAVABEAN请求关键属性HospUserView中的AKB020等； aka020（即服务机构编号）;输出关键属性KB01View中全部属性HospUserView需传入以下值：序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varchar输出关键属性KB01View中全部属性1.1.3 指标体系下载接口命名downLoadCode

10、描述下载指标体系代码医院端处理传入条件查询出指标并保存接口处理查询指标体系参数类型编号名称类型in1HospUserViewJAVABEANin2HisParmDLViewJAVABEANout3CodeViewJAVABEAN请求关键属性HospUserView中的AKB020等； HisParmDLView中全部属性输出关键属性CodeView中全部属性HospUserView需传入以下值：序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varcharHisParmDLVi

11、ew需传入以下值：序号需要信息信息说明数据类型备注1LastChgDate最后版本操作时间varchar系统时间2LastChgUser最后版本操作用户varchar3ParmName参数名称varchar代码4ParmType参数类型varchar001 返回数据定义：返回 CodeView中主要信息：序号需要信息信息说明数据类型1codeType代码名称varchar2value代码值varchar3Name代码描述varchar1.1.4 数据库升级信息下载接口命名findDataUpdateInfo描述数据库升级医院端处理传入条件查询出数据库升级信息接口处理查询数据库升级信息参数类型编

12、号名称类型in1HospUserViewJAVABEANin2KB20View JAVABEANout3KB20View JAVABEAN请求关键属性HospUserView中的AKB020等； KB20View中的BKB051输出关键属性KB20View中全部属性HospUserView需传入以下值序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varcharKB20View需传入以下值序号需要信息信息说明数据类型备注1BKB051数据库版本号(取自增流水号)int 返回数据

13、定义：返回 (KB20View)中信息：序号需要信息信息说明数据类型1BKB051数据库版本号varchar2AKB020服务机构编号varchar3BKB052升级更新脚本varchar4AAE011发布人varchar5AAE036发布时间varchar6BKB053发布升级原因varchar7BKB054升级操作人(结算软件端必填数据)varchar8BKB055升级时间 (结算软件端必填数据)varchar1.1.5 数据库升级执行结果上传接口命名uploadDataUpdateResult描述数据库升级后的结果上传到中心端医院端处理传入条件查询出数据库升级信息并保存接口处理保存数据库

14、升级信息参数类型编号名称类型in1HospUserViewJAVABEANin2KB21View JAVABEAN请求关键属性HospUserView中的AKB020等； KB21View中的全部信息输出关键属性HospUserView需传入以下值序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varcharKB21View需传入以下值序号需要信息信息说明数据类型长度备注1BKB051数据库版本号(取自增流水号)int2AKB020医疗机构编号varchar83BKB056执行

15、结果varchar31成功，2失败4BKB057错误信息varchar5005BKB054升级操作人(结算软件端必填数据)varchar106BKB055升级时间 (结算软件端必填数据)varchar191.1.6 读取医保卡信息接口命名根据实际要求自定义读卡方法名称描述将ActiveFormProj1.ocx文件引入工程医院端处理将返回的医保卡号进行保存。接口处理实例：public void ReadCard(ref ReturnValue returnValue)ActiveFormProj1.ActiveFormX obj = new ActiveFormProj1. .ActiveFo

16、rmX();try/打开卡机端口obj.cardComCreate(1); /获得卡机状态int cardStateIndex = obj.getCardState(); if(cardStateIndex = 0 | cardStateIndex = 4)returnValue.ErrorFlag = 0;returnValue.ErrorMsg = obj.cardread();elseIf(cardStateIndex = 7)returnValue. ErrorMsg = “无法打开端口”;else if(cardStateIndex = 6)returnValue. ErrorMsg

17、 = “无法识别的卡”;else if(cardStateIndex = 5)returnValue. ErrorMsg = “该卡是新卡”;else if(cardStateIndex = 1)returnValue. ErrorMsg = “卡片没有放好”;. returnValue. ErrorFlag = -1;catch(Exception ex)returnValue. ErrorFlag = -1;returnValue. ErrorMsg = ex.Message;Finallyobj.cardComDestroy();return returnValue;1.2 目录管理1.

18、2.1 药品目录下载接口命名downLoadLeechdom描述下载医保药品目录医院端处理传入需要的条件查询出医保药品目录并保存接口处理查询出医保药品目录参数类型编号名称类型in1HospUserViewJAVABEANin2HisParmDLViewJAVABEANout3KA02ViewJAVABEAN请求关键属性HospUserView中的AKB020等； HisParmDLView中全部属性输出关键属性KA02View中全部属性HospUserView需传入以下值：序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020

19、服务机构编号varchar4BKB026密码varcharHisParmDLView需传入以下值：序号需要信息信息说明数据类型备注1LastChgDate最后版本操作时间varchar系统时间2LastChgUser最后版本操作用户varchar3ParmName参数名称varchar传入值：医保药品目录4ParmType参数类型varchar传入值：0025startRowNum开始记录数Int开始下载的记录数，默认06rows记录数Int当返回数小于rows说明已经下载完毕 返回数据定义：返回KA02View中信息序号需要信息信息说明数据类型（长度）备注1AKA060药品编码varchar

20、2AKA061中文名称varchar3AKA062英文名称varchar4AKA063收费类别varchar01西药，02中药，03草药，04诊查费，08治疗费，09化验费，10手术费，13血费，17床位费，19护理费，20检查费，21调温费，22特殊材料费，24其他费，30挂号费5BKA246一级目录类别varchar可查询字典表jwhat_dd_static_code6BKA247二级目录类别varchar可查询字典表jwhat_dd_static_code7BKA260三级目录类别varchar可查询字典表jwhat_dd_static_code8AKA064处方药标志varchar0非

21、处方药 ，1处方药9AKA065收费项目等级varchar1甲类，2乙类，3丙类，4乙类（50）10AKA066助记码varchar11AKA067单位varchar12AKA068标准价格double(15,5)13AKA070剂型varchar14AKA071每次用量double(15,2)15AKA072使用频次varchar16AKA073用法varchar17AKA074规格varchar18AKA215限制类用药标志varchar1普通，2限制类用药19AAE013备注varchar20AAE011经办人varchar21AAE036经办日期varchar22BAA001数据分区编

22、号varchar23AAE100当前有效标志varchar0无效，1有效24BKA001三大目录使用范围varchar25BKA152药品编码（卫生系统使用）varchar26BKA151常用名varchar27BAE031版本号varchar28AKE004生产地类别varchar29AKA022医疗使用标志varchar1是，2否30AMA011生育使用标志varchar1是，2否31AKA109药品生产企业varchar1.2.2 药品目录对应申请上传接口命名upLoadLeechdomMap描述医院端上传对应的医保药品目录医院端处理传入医保药品目录接口处理保存医院端上传的医保药品目录参

23、数类型编号名称类型in1HospUserViewJAVABEANin2KB05ViewJAVABEANin3KA17ViewJAVABEAN请求关键属性HospUserView中的AKB020等； KB05View中全部属性； KA17View中全部属性输出关键属性HospUserView需传入以下值序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varchar5baa001数据分区编码varcharKB05View需传入以下值序号需要信息信息说明数据类型最大长度备注1AKB0

24、20服务机构编号Varchar82AKA060药品编码varchar203AKA061中文名称varchar2554AKA062英文名称varchar2555AKA066助记码varchar506AKB120单价double15,57AKA070剂型varchar508AKA071每次用量double9,09AKA074规格varchar5010AAE013备注varchar10011AKA224上传时间varchar1912AKA109药品生产企业varchar200KA17View需传入以下值序号需要信息信息说明数据类型最大长度备注1BKA261医保三大目录项目编码varchar202BK

25、A263(医保)目录名称varchar3BKA262医院三大目录项目编码varchar204BKA264目录名称(医院目录商品名)varchar5AKA213目录类别varchar31：药品，2：诊疗项目，3：服务设施6AKC175审批标志varchar30：未复核，1：已复核，3：未通过7AAE011经办人varchar108AAE036经办日期varchar199BAA001数据分区编号varchar1010AKA221下载标志varchar30未下载，1已下载11AKA223下载时间varchar1912BKC067上传状态标志varchar30:等待上传,1:上传成功,2:上传失败13

26、AKA224上传时间varchar14AAE073目录对应流水号int15AKB020服务机构编号varchar816AKA220目录对应拒绝原因varchar31价格不符，2内容不符，3其他17AAE140险种类型varchar310:大额医疗补助，3：城镇职工基本医疗保险，390：城镇居民基本医疗保险，4：工伤保险，5：生育保险1.2.3 诊疗目录下载接口命名downLoadDiagnosis描述下载诊疗目录医院端处理传入需要的条件查询出诊疗目录并保存接口处理查询出诊疗目录参数类型编号名称类型in1HospUserViewJAVABEANin2HisParmDLViewJAVABEANou

27、t3KA03ViewJAVABEAN请求关键属性HospUserView中的AKB020等； HisParmDLView中全部属性输出关键属性KA03View中全部属性HospUserView需传入以下值序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varcharHisParmDLView需传入以下值序号需要信息信息说明数据类型备注1LastChgDate最后版本操作时间varchar系统时间2LastChgUser最后版本操作用户varchar3ParmName参数名称va

28、rchar医保诊疗项目信息4ParmType参数类型varchar0035startRowNum开始记录数Int开始下载的记录数，默认06rows记录数Int当返回数小于rows说明已经下载完毕 返回数据定义：返回KA03View中信息：序号需要信息信息说明数据类型（长度）备注1AKA090项目编码varchar2AKA101医院等级varchar2省级，5市级，8县级，13定点药店，14乡镇卫生院，15社区3AKA091项目名称varchar4AKA063收费类别varchar数据字典表中可查询5AKA065收费项目等级varchar1甲类，2乙类，3丙类，4乙类（50）6BKA246一级目

29、录类别varchar数据字典表中可查询7BKA247二级目录类别varchar数据字典表中可查询8BKA260三级目录类别varchar数据字典表中可查询9BKA001三大目录使用范围varchar10AKA066助记码varchar11AKA068标准价格double(15,5)12AKA104基础支付标准double (8,2)13AAE011经办人varchar14AAE036经办日期varchar15BAA001数据分区编号varchar16AAE100当前有效标志varchar0无效，1有效17BAE031版本号varchar18AAE013备注varchar19AKE004生产地类

30、别varchar20AKA022医疗使用标志varchar1是，2否21AMA011生育使用标志varchar1是，2否1.2.4 诊疗项目目录对应申请上传接口命名upLoadDiagnosisMap描述医院端上传对应的疗项目目录医院端处理传入医保疗项目目录接口处理保存疗项目目录参数类型编号名称类型in1HospUserViewJAVABEANin2KB06ViewJAVABEANin3KA17ViewJAVABEAN请求关键属性HospUserView中的AKB020； KB06View中全部属性；KA17View中全部属性输出关键属性HospUserView需传入以下值序号需要信息信息说明

31、数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varchar5baa001数据地区编号varcharKB06View需传入以下值序号需要信息信息说明数据类型最大长度备注1AKB020服务机构编号varchar82AKA090项目编码varchar203AKA091项目名称varchar2554AKA066助记码varchar2555AKB120单价double15,56AKB067上传状态标志varchar30:等待上传,1:上传成功,2:上传失败KA17View需传入以下值序号需要信息信息说明

32、数据类型最大长度备注1BKA261医保三大目录项目编码varchar202BKA263(医保)目录名称varchar3BKA262医院三大目录项目编码varchar204BKA264目录名称(医院目录商品名)varchar5AKA213目录类别varchar31：药品，2：诊疗项目，3：服务设施6AKC175审批标志varchar30：未复核，1：已复核，3：未通过7AAE011经办人varchar108AAE036经办日期varchar199BAA001数据分区编号varchar1010AKA221下载标志varchar30未下载，1已下载11AKA223下载时间varchar1912BKC

33、067上传状态标志varchar30:等待上传,1:上传成功,2:上传失败13AKA224上传时间varchar14AAE073目录对应流水号int15AKB020服务机构编号varchar816AKA220目录对应拒绝原因varchar31价格不符，2内容不符，3其他17AAE140险种类型varchar310:大额医疗补助，3：城镇职工基本医疗保险，390：城镇居民基本医疗保险，4：工伤保险，5：生育保险1.2.5 服务设施目录下载接口命名downLoadService描述下载服务设施目录医院端处理传入需要的条件查询出服务设施目录保存接口处理查询出服务设施目录参数类型编号名称类型in1Ho

34、spUserViewJAVABEANin2HisParmDLViewJAVABEANout3KA04View JAVABEAN请求关键属性HospUserView中的AKB020等； HisParmDLView中全部属性； 输出关键属性KA04View中全部属性实体类(HospUserView)，需传入以下值序号需要信息信息说明数据类型1BKB034结算软件版本类型varchar2VERSION版本号varchar3AKB020服务机构编号varchar4BKB026密码varchar返回 HisParmDLView中主要信息：序号需要信息信息说明数据类型备注1LastChgDate最后版本操

35、作时间varchar系统时间2LastChgUser最后版本操作用户varchar3ParmName参数名称varchar医保医疗服务设施信息4ParmType参数类型varchar004 返回数据定义：返回KA04View中信息：序号字段名字段说明数据类型（长度，精度）备注1AKA100医疗服务设施编码varchar2AKA101医院等级varchar2省级，5市级，8县级，13定点药店，14乡镇卫生院，15社区3AKA102服务设施名称varchar4AKA063收费类别varchar数据字典表中可查询5BKA246一级目录类别varchar数据字典表中可查询6BKA247二级目录类别va

36、rchar数据字典表中可查询7BKA260三级目录类别varchar数据字典表中可查询8BKA001三大目录使用范围varchar9AKA103病床等级varchar1普通病床，2 CCU病床，3 ICU病床，4麻醉病床10AKA066助记码varchar11AKA068标准价格double12AAE011经办人varchar13AAE036经办日期varchar14BAA001数据分区编号varchar15AKA104基础支付标准double16AAE100当前有效标志varchar0无效，1有效17AKA065收费项目等级varchar1甲类，2乙类，3丙类，4乙类（50）18BAE031版本号varchar19AAE013备注varchar20AKE004生产地类别varchar21AKA022医疗使用标志varchar22AMA011生育使用标志varchar1.2.6 服务设施目录对应申请上传接口命名upLoadServiceMap描述医院端上传对应的服务设施目录医院端处理传入医保服务设施目录接口处理保存服务设施目录参数类型编号名称类型in1HospUserViewJAVABEANin2KB07ViewJAVABEANin3KA17ViewJAVABEAN请求关键属性HospUserView中的AKB020等； KB07View中全部属性；KA17View中全部属性输出