沈阳医保接口用户手册.docx

1、沈阳医保接口用户手册（沈阳医保接口）用户手册（政府事业部）文件编号：TD202文件版次：QMS2005文档编号版本号1.10分册名称第1册/共1册总页数正文附录编制审批生效日期东软集团股份有限公司修改记录版本号变更控制报告编号更改条款及内容更改人审批人更改日期1.01建立文档曹兴2012-08-091.021、1300病种目录和病种识别吗目录下载出参“居民特病适用范围”字段长度都改为varchar2(5)。2、1300部位码下载出参添加“经办人”，“经办日期”。3、1300体检套餐下载出参增加“医疗机构编码”曹兴2012-09-251.03 1、修改“对账结果”二级代码，0：失败，1：成功曹兴

2、2012-10-091.04 1、修改“精神病家庭病床”医疗类别二级代码，由“20”改为“33”曹兴2012-10-121.051、1440定点医疗机构信息查询交易，医院等级改成“职工医院等级”，“居民医院等级”，“生育医院等级”。2、增加3510门诊统筹病历信息上传交易曹兴2012-10-151.061、2310交易的“医师违规标志”改为4个码值。曹兴2012-10-221.071、 2421冲正交易：增加了对药店结算和门诊结算的冲正2、 增加特殊说明：日期格式中，凡是要求精确到秒YYYYMMDDHH24MISS的地方，请严格按照医保精确到秒。3、 3410电子病历人员基本信息上传：“医疗付

3、费方式”不能为空。曹兴2012-10-261.081、 3420、3430交易增加了几个对入参的非空项的限制。2、 2210：“入院登记交易”增加了出参。3、 对特殊说明进行了补充。4、 对2310处方上传交易通过录负数量退处方时单据号进行了修改说明。曹兴2012-10-261.091、 “精神病家庭病床”医疗类别二级代码，调整为20。2、 新增“精神病特殊住院”医疗类别二级代码。3、 、“适用范围”二级代码进行了调整4、 “病种分类“、”病种类别“、”收费类别“的二级代码进行了调整曹兴2012-11-11.101、 所有交易的“剂型”都改成Vatchar2(50),并且不是二级代码而是汉字。

4、2、 “药品信息下载”和“药品信息查询交易” ，出参“医保目录药物大分类”长度改为varchar(50)3、 由于别的项目出现了同一家医院有多个开发商的收费端，多个开发商开发的系统操作员编号也可能相同，在对账的时候会出现把另外系统的数据查询出来，撤销或冲正的时候也可能把别的系统上传的数据给撤销或冲正了的情况，所以做出以下调整：（1）1120、1100、2410、2420、2430、2610、2620、2710、2720交易增加入参开发商标志,长度为Varchar2(20)，例如webhis的开发商标志可以传“WEBHIS”，每个开发商传一个能够区分不同开发商的英文标志就可以。（2）冲正交易（2

5、421）增加冲正原因和开发商标志4、 3300对照信息上传：增加入参“医院批准文号”。曹兴2012-11-61.11就诊信息查询(1390)出参加发送方交易流水号参数张宏林2012-11-151.12就诊信息查询(1390)增加入参。药店收费预结算/药店收费结算/门诊收费预结算/门诊收费结算：处方录入部分增加说明 李玉春2012-11-15目 录1 引言 51.1 文档编制目的 51.2 背景 51.3 词汇表 51.4 参考资料 62 接口流程设计 72.1 医院就医流程设计 72.2 药店购药流程 83 系统接口设计 83.1 用户接口函数 83.2 交易编码说明 103.3 医院端调用接

6、口交易序列图 134 接口交易详细设计 154.1 查询类 154.1.1 交易功能 154.1.2 交易设计 154.1.2.1 批量数据查询下载（1300） 154.1.2.2 医疗费信息对帐(1120) 234.1.2.3 明细对帐请求(1210) 244.1.2.4 医疗费信息查询(1100) 254.1.2.5 医疗费用明细信息查询(1200) 274.1.2.6 参保人员基本信息及其医保个人帐户查询（1400） 284.1.2.7 医疗待遇审批信息查询(1600) 294.1.2.8 中心通知信息查询(1731) 304.1.2.9 获取中心端时间查询(1800) 304.1.2.

7、10 对照信息批量下载(1310) 304.1.2.11 月结算汇总信息查询(1330) 324.1.2.12 月结算详细信息查询(1340) 344.1.2.13 月结算错误信息查询(1350) 364.1.2.14 定点医护人员信息查询(1360) 374.1.2.15 医师处方权信息查询(1370) 384.1.2.16 封锁详细信息查询(1380) 384.1.2.17 就诊信息查询(1390) 394.1.2.18 药品信息查询(1410) 404.1.2.19 诊疗项目信息查询(1420) 424.1.2.20 服务设施信息查询(1430) 444.1.2.21 定点医疗机构信息查

8、询(1440) 454.1.2.22 结算信息查询(1450) 464.2 认证类 484.2.1 交易功能 484.2.2 交易设计 494.2.2.1 签到(9100) 494.2.2.2 签退(9110) 494.3 业务类 494.3.1 交易功能 494.3.2 交易设计 494.3.2.1 读卡交易(2100) 494.3.2.2 修改卡密码(2110) 504.3.2.3 门诊/住院登记(2210) 514.3.2.4 住院登记修改(2230) 524.3.2.5 登记撤销(2240) 534.3.2.6 诊断信息维护(2231) 534.3.2.7 手术信息上传(2232) 5

9、44.3.2.8 处方明细上报(2310) 544.3.2.9 处方明细撤销(2320) 564.3.2.10 费用预结算(2420) 564.3.2.11 费用结算(2410) 584.3.2.12 费用结算撤销(2430) 594.3.2.13 药店收费预结算(2610) 604.3.2.14 药店收费结算(2620) 634.3.2.15 门诊收费预结算(2710) 644.3.2.16 门诊收费结算(2720) 674.3.2.17 药店月结算确认(2810) 694.3.2.18 冲正交易(2421) 694.4 数据上传类 694.4.1 医院审批信息上报(3110) 694.4.

10、2 医院审批信息上报撤销(3120) 704.4.3 医院医护人员信息上报(3220) 714.4.4 对照信息批量上传(3300) 724.4.5 电子病历人员基本信息上传(3410) 724.4.6 电子病历病历信息上传(3420) 744.4.7 电子病历诊断信息上传(3430) 754.4.8 电子病历手术信息上传(3440) 754.4.9 电子病历结算信息上传(3450) 764.4.10 体检套餐上传(3460) 774.4.11 体检套餐明细信息上传(3470) 774.4.12 体检基本信息上传(3480) 784.4.13 体检结果上传(3490) 784.4.14 门诊统

11、筹病历信息上传(3510) 785 数据结构与数据库设计 806 尚需解决的问题 807 附件 801 引言1.1 文档编制目的医保接口用户手册主要表述了医保接口设计方案和对外交易描述。项目的用户手册的阅读对象主要包括用户方相关人员、定点医疗机构软件开发人员相关的其他人员等。沈阳用户手册主要供本项目设计开发人员建立本地化项目接口手册参考使用。1.2 背景本接口设计报告在核心平台三版医保接口设计的基础上，基于沈阳项目设计。医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，除要满足沈阳项目的医疗待遇算法和医院端需求外，还需要考虑医院端的连接方式、对定点医疗机构用户数目的限制以及中心和医院的对帐

12、方式。基于沈阳项目的建设背景，医保接口采用了联机模式。1.3 词汇表词汇名称词汇含义备注交易医保接口客户端向接口发出的一种请求消息，接口需要作出应答医保接口医保中心向定点医疗机构公开的服务，是架在医保中心和定点医疗机构之间的一个接口系统，完成两者之间的信息传递，使定点医疗机构具备医保患者业务处理功能联机模式患者在定点医疗机构享受医保待遇时，医保接口由中心直接提供服务，又称实时系统。脱机模式医保中心通过在定点医疗机构设置前置机，由医保前置机向定点医疗机构提供医保接口服务的方式，是脱机模式，即非实时系统。联脱机混合模式医保接口自动进行判断，当网络连通时，使用联机模式进行消费，当定点医疗机构与中心网

13、络不通时，连接前置机进行脱机消费。HIS系统包括定点医疗机构的医院管理信息系统和收费端两种系统，这两种情况都需要调用医保接口动态库完成定点医疗机构的医保收费。本文档中提到的开发商也是指HIS系统的软件开发商1.4 参考资料编号参考资料备注1社保卡整合过渡方案2医保接口对账方案3医保接口用户数控制方案4核心平台医保接口设计报告2 接口流程设计2.1 医院就医流程设计说明：上图以门诊为例说明医院就医的业务流程，住院业务与门诊业务的区别是，在就诊登记后，费用结算前，任何一个环节，都可以选择进行住院登记信息修改。2.2 药店购药流程3 系统接口设计3.1 用户接口函数本系统提供给医院的是一个动态库接口

14、，无用户界面，输入输出均通过DLL完成。程序文件名：SiInterface.dll对外提供的接口函数： 初始化函数:int INIT(char * pErrMsg)参数说明：pErrMsg：动态库初始化错误信息。功能描述：检查整个运行环境：包括网络环境、运行所需文件、参数等的检查本地临时文件的清除，比如获取照片信息交易所生成的本地jpg文件。返回值： 成功：返回0 ； 失败：返回 -1 交易函数：int BUSINESS_HANDLE( char* inputData, char* outputData)功能描述：HIS系统开发商需要向医保中心发送业务请求的通用函数输入参数：inputData

15、 输出参数：outputData char* 返回值：成功：返回0 ； 失败：返回 0输入输出参数是以“、$、|”分割的字符串参数说明：入参格式: inputData 业务编号医疗机构编号操作员编号业务周期号医院交易流水号中心编码入参联机标志业务编号（4位）宏定义, 分别对应后台的一项业务操作定点医疗机构编号操作员编号(8位)医院分配给操作员的唯一标识业务周期号(最大36位)操作员签到时，中心返回给his的业务周期号。医院交易流水号(发送方交易流水号)(最大30位)建议规则：时间(14)+医院编号(8)+流水号(4)例：20120101083030-10011001-0001 中心编码0000

16、入参以“|”分隔，详见每个交易的参数表, 分项之间使用管道分割符|分割，最后必须要以管道分割符号|结尾，不以|开始。如果入参为多条记录，记录之间以$分割，不同数据项之间以|分割说明：中心修改参数的原则：只增不减，增加的参数加在参数列表的最后，不在中间插入参数。联机标志0：脱机 1:联机。沈阳传1，因为本系统全是联机模式。出参格式: outputData char*中心交易流水号联脱机标志输出参数中心交易流水号中心交易流水号(最大30位)中心返回联脱机标志本项目是联机项目，所以该字段不用。输出参数该参数为输出参数，客户程序必须在调用本函数之前分配足够长 的空间，其最小值为1024字节，如果未给本

17、参数分配空间或分配的空间长度小于实际返回的长度，客户程序将会出现内存保护错误输出参数的规则同入参格式中的输入参数说明返回值说明 : 0 成功，表示此次交易请求成功，业务处理也正常 0 错误，包括系统级别错误（网络、主机、数据库）和业务级别错误，错误信息通过输出参数提示出来。其中： -1系统级别错误，HIS系统提示错误信息后，需要进行冲正等后续业务操作处理； -2业务处理错误，HIS系统直接将输出参数的错误信息提示给操作员即可。 交易流水号说明：说明：交易流水号必须是每一次交易的唯一标识，在整个系统中是唯一的，因此开发商应严格按照建议规则生成交易流水号规则：时间(14)+医院编号(8)+流水号(

18、4)，之间用-分隔例：20120101083030-10011001-0001业务周期号说明：说明：医院编号(8)操作员编号(最大8位)时间(14)+流水号(3)，之间用-分隔例：10011001-99999999-20060101083030-001注：业务周期号在签到交易由中心生成传给his系统。3.2 交易编码说明交易码为四位编码，开发商调用不同的交易通过交易编码区分序号交易码交易名称交易类型交易说明1 1100医疗费用信息查询 查询对账使用2 1120医疗费信息对账查询对账使用3 1200费用明细信息查询查询对账使用4 1210明细对帐请求查询对账使用5 1300信息批量下载查询6 1

19、310对照信息批量下载查询7 1330月结算汇总信息查询查询月结算使用8 1340月结算详细信息查询查询月结算使用9 1350月结算错误信息查询查询月结算使用10 1360医师操作员信息查询查询11 1370医师处方权信息查询查询12 1380封锁详细信息查询查询13 1390就诊信息查询查询14 1410药品信息查询查询15 1420诊疗项目信息查询查询16 1430服务设施信息查询查询17 1440定点服务机构信息查询查询18 1450结算信息查询查询19 1600个人审批信息查询查询20 1731中心通知信息查询查询21 1800获取中心端时间查询22 2100读卡主体交易23 2110

20、修改卡密码主体交易24 2210门诊/住院登记主体交易25 2230登记(挂号)信息修改主体交易26 2231多诊断信息上传主体交易27 2232手术信息上传主体交易28 2240登记(挂号)撤销主体交易29 2310费用明细上报主体交易30 2320费用明细撤销主体交易31 2410结算主体交易32 2420预结算主体交易33 2421冲正交易主体交易34 2430结算撤销/取消报销主体交易35 2610药店收费预结算主体交易不区分挂号和结算的药店使用36 2620药店收费结算主体交易不区分挂号和结算的药店使用37 2710门诊收费预结算主体交易38 2720门诊收费结算主体交易39 281

21、0药店月结算确认主体交易40 3110医院审批信息上报申报业务41 3120医院审批信息上报撤销申报业务42 3220医护人员信息上传申报业务43 3300对照信息批量上传申报业务44 3410电子病历人员基本信息45 3420电子病历病历信息上传46 3430电子病历诊断信息上传47 3440电子病历手术信息上传48 3450电子病历结算信息上传49 3460上传体检套餐基本信息50 3470上传体检套餐明细信息51 3480上传体检基本信息52 3490上传体检结果53 3510门诊统筹病历信息上传54 9100签到认证交易55 9110签退认证交易特殊说明：1、日期格式中，凡是要求精确到

22、秒YYYYMMDDHH24MISS的地方，请严格按照医保精确到秒。 2、单据号不要传BBBB,以免和挂号费结算信息弄混。3.3 医院端调用接口交易序列图4 接口交易详细设计此部分主要对医保接口交易的各具体业务作详细说明。4.1 查询类4.1.1 交易功能该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。4.1.2 交易设计批量数据查询下载（1300）交易说明：批量下载中心目录等基础数据，然后对中心的药品

23、目录和诊疗项目目录在his系统进行对照，上传处方时，根据对照结果，同时上传医院编码名称和中心编码。输入参数：编号名称长度约束说明1批量下载数据类别VARCHAR2(3)NOT NULL确定需要下载信息的种类：01-药品目录02-诊疗项目目录03-医疗服务设施目录05-病种信息06-手术码07-部位码08-病种识别码09-体检套餐明细10-备用2开始日期VARCHAR2(14)NOT NULLYYYYMMDDHH24MISS，每次下载完成开发商记录下载时间，下次下载的开始日期为上次的下载时间。输出参数:编号名称长度约束说明1文件路径及文件名称VARCHAR2(200)批量下载的数据保存的文件路径

24、和文件名称 药品目录：编号名称长度约束说明1 药品编码VARHCAR2(20)2 通用名称VARCHAR2(100)3 英文名称VARCHAR2(300)4 商品名VARCHAR2(200)5 商品名称助记码VARCHAR2(50)6 通用名称助记码VARCHAR2(50)7 基本医疗保险药品代码VARHCAR2(20)8 药监编码VARHCAR2(50)9 药监本位码VARHCAR2(50)10 收费类别VARCHAR2(3)11西药、12中成药、13中草药11 收费项目等级VARCHAR2(3)二级代码12 处方药标志VARCHAR2(3)二级代码13 药品注册剂型VARCHAR2(50)

25、14 药品剂量单位VARCHAR2(20)15 每次用量VARCHAR2(8)2位小数16 使用频次VARCHAR2(100)17 单位VARCHAR2(20)18 规格VARCHAR2(100)19 院内制剂标志VARCHAR2(3)二级代码20 定点医疗机构编号VARCHAR2(20)21 特药标志VARCHAR2(3)二级代码22 用法VARCHAR2(200)23 限定天数VARCHAR2(8)24 生产单位VARCHAR2(100)25 国药准字VARCHAR2(100)26 产地VARCHAR2(100)27 计价单位VARCHAR2(20)28 医保目录药物小分类VARCHAR2

26、(50)29 医保目录药物大分类VARCHAR2(50)30 工伤使用标志VARCHAR2(3)二级代码31 生育使用标志VARCHAR2(3)二级代码32 基本医疗使用标志VARCHAR2(3)二级代码33 账户可支付标志VARCHAR2(3)二级代码34 药店使用标识VARCHAR2(3)二级代码35 门诊统筹可用标志VARCHAR2(3)二级代码36 通用码标识VARCHAR2(3)37 药品种类VARCHAR2(3)38 国产/进口标识VARCHAR2(3)二级代码39 药品特殊限制标志VARCHAR2(3)40 药品特殊限制范围VARCHAR2(100)41 药品一级分类VARCHAR2(100)42 药品二级分类VARCHAR2(100)43 药品三级分类VARCHAR2(100)44 药品四级分类VARCHAR2(100)45 开始时间VARCHAR2(14)YYYYMMDDHH24MISS46 终止时间VARCHAR2(14)YYYYMMDDHH24MISS47 有效标志VARCHAR2(3)二级代码48 备注VARCHAR2(100)49 经办人VARC