沈阳医保接口用户手册.docx
《沈阳医保接口用户手册.docx》由会员分享，可在线阅读，更多相关《沈阳医保接口用户手册.docx（182页珍藏版）》请在冰点文库上搜索。
沈阳医保接口用户手册
（沈阳医保接口）
用户手册
（政府事业部）
文件编号：
TD202
文件版次：
QMS2005
文档编号
版本号
1.10
分册名称
第1册/共1册
总页数
正文
附录
编制
审批
生效日期
东软集团股份有限公司
修改记录
版本号
变更控制报告
编号
更改条款及内容
更改人
审批人
更改日期
1.01
建立文档
曹兴
2012-08-09
1.02
1、1300病种目录和病种识别吗目录下载出参“居民特病适用范围”字段长度都改为varchar2（5）。
2、1300部位码下载出参添加“经办人”，“经办日期”。
3、1300体检套餐下载出参增加“医疗机构编码”
曹兴
2012-09-25
1.03
1、修改“对账结果”二级代码，0：
失败，1：
成功
曹兴
2012-10-09
1.04
1、修改“精神病家庭病床”医疗类别二级代码，由“20”改为“33”
曹兴
2012-10-12
1.05
1、1440定点医疗机构信息查询交易，医院等级改成“职工医院等级”，“居民医院等级”，“生育医院等级”。
2、增加3510门诊统筹病历信息上传交易
曹兴
2012-10-15
1.06
1、2310交易的“医师违规标志”改为4个码值。
曹兴
2012-10-22
1.07
1、2421冲正交易：
增加了对药店结算和门诊结算的冲正
2、增加特殊说明：
日期格式中，凡是要求精确到秒YYYYMMDDHH24MISS的地方，请严格按照医保精确到秒。
3、3410电子病历人员基本信息上传：
“医疗付费方式”不能为空。
曹兴
2012-10-26
1.08
1、3420、3430交易增加了几个对入参的非空项的限制。
2、2210：
“入院登记交易”增加了出参。
3、对特殊说明进行了补充。
4、对2310处方上传交易通过录负数量退处方时单据号进行了修改说明。
曹兴
2012-10-26
1.09
1、“精神病家庭病床”医疗类别二级代码，调整为‘20’。
2、新增“精神病特殊住院”医疗类别二级代码。
3、、“适用范围”二级代码进行了调整
4、“病种分类“、”病种类别“、”收费类别“的二级代码进行了调整
曹兴
2012-11-1
1.10
1、所有交易的“剂型”都改成Vatchar2（50）,并且不是二级代码而是汉字。
2、“药品信息下载”和“药品信息查询交易”，出参“医保目录药物大分类”长度改为varchar（50）
3、由于别的项目出现了同一家医院有多个开发商的收费端，多个开发商开发的系统操作员编号也可能相同，在对账的时候会出现把另外系统的数据查询出来，撤销或冲正的时候也可能把别的系统上传的数据给撤销或冲正了的情况，所以做出以下调整：
（1）1120、1100、2410、2420、2430、2610、2620、2710、2720交易增加入参开发商标志,长度为Varchar2（20），例如webhis的开发商标志可以传“WEBHIS”，每个开发商传一个能够区分不同开发商的英文标志就可以。
（2）冲正交易（2421）增加冲正原因和开发商标志
4、3300对照信息上传：
增加入参“医院批准文号”。
曹兴
2012-11-6
1.11
就诊信息查询（1390）出参加发送方交易流水号参数
张宏林
2012-11-15
1.12
就诊信息查询（1390）增加入参。
药店收费预结算/药店收费结算/门诊收费预结算/门诊收费结算：
处方录入部分增加说明
李玉春
2012-11-15
目录
1引言5
1.1文档编制目的5
1.2背景5
1.3词汇表5
1.4参考资料6
2接口流程设计7
2.1医院就医流程设计7
2.2药店购药流程8
3系统接口设计8
3.1用户接口函数8
3.2交易编码说明10
3.3医院端调用接口交易序列图13
4接口交易详细设计15
4.1查询类15
4.1.1交易功能15
4.1.2交易设计15
4.1.2.1批量数据查询下载（1300）15
4.1.2.2医疗费信息对帐（1120）23
4.1.2.3明细对帐请求（1210）24
4.1.2.4医疗费信息查询（1100）25
4.1.2.5医疗费用明细信息查询（1200）27
4.1.2.6参保人员基本信息及其医保个人帐户查询（1400）28
4.1.2.7医疗待遇审批信息查询（1600）29
4.1.2.8中心通知信息查询（1731）30
4.1.2.9获取中心端时间查询（1800）30
4.1.2.10对照信息批量下载（1310）30
4.1.2.11月结算汇总信息查询（1330）32
4.1.2.12月结算详细信息查询（1340）34
4.1.2.13月结算错误信息查询（1350）36
4.1.2.14定点医护人员信息查询（1360）37
4.1.2.15医师处方权信息查询（1370）38
4.1.2.16封锁详细信息查询（1380）38
4.1.2.17就诊信息查询（1390）39
4.1.2.18药品信息查询（1410）40
4.1.2.19诊疗项目信息查询（1420）42
4.1.2.20服务设施信息查询（1430）44
4.1.2.21定点医疗机构信息查询（1440）45
4.1.2.22结算信息查询（1450）46
4.2认证类48
4.2.1交易功能48
4.2.2交易设计49
4.2.2.1签到（9100）49
4.2.2.2签退（9110）49
4.3业务类49
4.3.1交易功能49
4.3.2交易设计49
4.3.2.1读卡交易（2100）49
4.3.2.2修改卡密码（2110）50
4.3.2.3门诊/住院登记（2210）51
4.3.2.4住院登记修改（2230）52
4.3.2.5登记撤销（2240）53
4.3.2.6诊断信息维护（2231）53
4.3.2.7手术信息上传（2232）54
4.3.2.8处方明细上报（2310）54
4.3.2.9处方明细撤销（2320）56
4.3.2.10费用预结算（2420）56
4.3.2.11费用结算（2410）58
4.3.2.12费用结算撤销（2430）59
4.3.2.13药店收费预结算（2610）60
4.3.2.14药店收费结算（2620）63
4.3.2.15门诊收费预结算（2710）64
4.3.2.16门诊收费结算（2720）67
4.3.2.17药店月结算确认（2810）69
4.3.2.18冲正交易（2421）69
4.4数据上传类69
4.4.1医院审批信息上报（3110）69
4.4.2医院审批信息上报撤销（3120）70
4.4.3医院医护人员信息上报（3220）71
4.4.4对照信息批量上传（3300）72
4.4.5电子病历人员基本信息上传（3410）72
4.4.6电子病历病历信息上传（3420）74
4.4.7电子病历诊断信息上传（3430）75
4.4.8电子病历手术信息上传（3440）75
4.4.9电子病历结算信息上传（3450）76
4.4.10体检套餐上传（3460）77
4.4.11体检套餐明细信息上传（3470）77
4.4.12体检基本信息上传（3480）78
4.4.13体检结果上传（3490）78
4.4.14门诊统筹病历信息上传（3510）78
5数据结构与数据库设计80
6尚需解决的问题80
7附件80
1引言
1.1文档编制目的
医保接口用户手册主要表述了医保接口设计方案和对外交易描述。
项目的用户手册的阅读对象主要包括用户方相关人员、定点医疗机构软件开发人员相关的其他人员等。
沈阳用户手册主要供本项目设计开发人员建立本地化项目接口手册参考使用。
1.2背景
本接口设计报告在核心平台三版医保接口设计的基础上，基于沈阳项目设计。
医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，除要满足沈阳项目的医疗待遇算法和医院端需求外，还需要考虑医院端的连接方式、对定点医疗机构用户数目的限制以及中心和医院的对帐方式。
基于沈阳项目的建设背景，医保接口采用了联机模式。
1.3词汇表
词汇名称
词汇含义
备注
交易
医保接口客户端向接口发出的一种请求消息，接口需要作出应答
医保接口
医保中心向定点医疗机构公开的服务，是架在医保中心和定点医疗机构之间的一个接口系统，完成两者之间的信息传递，使定点医疗机构具备医保患者业务处理功能
联机模式
患者在定点医疗机构享受医保待遇时，医保接口由中心直接提供服务，又称实时系统。
脱机模式
医保中心通过在定点医疗机构设置前置机，由医保前置机向定点医疗机构提供医保接口服务的方式，是脱机模式，即非实时系统。
联脱机混合模式
医保接口自动进行判断，当网络连通时，使用联机模式进行消费，当定点医疗机构与中心网络不通时，连接前置机进行脱机消费。
HIS系统
包括定点医疗机构的医院管理信息系统和收费端两种系统，这两种情况都需要调用医保接口动态库完成定点医疗机构的医保收费。
本文档中提到的开发商也是指HIS系统的软件开发商
1.4参考资料
编号
参考资料
备注
1
《社保卡整合过渡方案》
2
《医保接口对账方案》
3
《医保接口用户数控制方案》
4
《核心平台医保接口设计报告》
2接口流程设计
2.1医院就医流程设计
说明：
上图以门诊为例说明医院就医的业务流程，住院业务与门诊业务的区别是，在就诊登记后，费用结算前，任何一个环节，都可以选择进行住院登记信息修改。
2.2药店购药流程
3系统接口设计
3.1用户接口函数
本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过DLL完成。
程序文件名：
SiInterface.dll
对外提供的接口函数：
⏹初始化函数:
intINIT（char*pErrMsg）
参数说明：
pErrMsg：
动态库初始化错误信息。
功能描述：
检查整个运行环境：
包括网络环境、运行所需文件、参数等的检查
本地临时文件的清除，比如获取照片信息交易所生成的本地jpg文件。
返回值：
成功：
返回0；失败：
返回-1
⏹交易函数：
intBUSINESS_HANDLE（char*inputData,
char*outputData）
功能描述：
HIS系统开发商需要向医保中心发送业务请求的通用函数
输入参数：
inputData
输出参数：
outputDatachar*
返回值：
成功：
返回0；失败：
返回<0
输入输出参数是以“^、$、|”分割的字符串
参数说明：
入参格式:
inputData
业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^联机标志^
业务编号（4位）
宏定义,分别对应后台的一项业务操作
定点医疗机构编号
操作员编号（8位）
医院分配给操作员的唯一标识
业务周期号（最大36位）
操作员签到时，中心返回给his的业务周期号。
医院交易流水号（发送方交易流水号）（最大30位）
建议规则：
时间（14）+医院编号（8）+流水号（4）
例：
20120101083030-10011001-0001
中心编码
0000
入参
以“|”分隔，详见每个交易的参数表,分项之间使用管道分割符‘|’分割，最后必须要以管道分割符号‘|’结尾，不以‘|’开始。
如果入参为多条记录，记录之间以‘$’分割，不同数据项之间以‘|’分割
说明：
中心修改参数的原则：
只增不减，增加的参数加在参数列表的最后，不在中间插入参数。
联机标志
0：
脱机1:
联机。
沈阳传‘1’，因为本系统全是联机模式。
出参格式:
outputDatachar*
中心交易流水号^联脱机标志^输出参数^
中心交易流水号
中心交易流水号（最大30位）中心返回
联脱机标志
本项目是联机项目，所以该字段不用。
输出参数
该参数为输出参数，客户程序必须在调用本函数之前分配足够长的空间，其最小值为1024字节，如果未给本参数分配空间或分配的空间长度小于实际返回的长度，客户程序将会出现内存保护错误
输出参数的规则同入参格式中的输入参数说明
返回值说明:
0–成功，表示此次交易请求成功，业务处理也正常
<0－错误，包括系统级别错误（网络、主机、数据库）和业务级别错误，错误信息通过输出参数提示出来。
其中：
-1－系统级别错误，HIS系统提示错误信息后，需要进行冲正等后续业务操作处理；
-2－业务处理错误，HIS系统直接将输出参数的错误信息提示给操作员即可。
交易流水号说明：
说明：
交易流水号必须是每一次交易的唯一标识，在整个系统中是唯一的，因此开发商应严格按照建议规则生成交易流水号
规则：
时间（14）+医院编号（8）+流水号（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
1310
对照信息批量下载
查询
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
修改卡密码
主体交易
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
2810
药店月结算确认
主体交易
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、日期格式中，凡是要求精确到秒YYYYMMDDHH24MISS的地方，请严格按照医保精确到秒。
2、单据号不要传‘BBBB’,以免和挂号费结算信息弄混。
3.3医院端调用接口交易序列图
4接口交易详细设计
此部分主要对医保接口交易的各具体业务作详细说明。
4.1查询类
4.1.1交易功能
该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。
对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。
4.1.2交易设计
批量数据查询下载（1300）
交易说明：
批量下载中心目录等基础数据，然后对中心的药品目录和诊疗项目目录在his系统进行对照，上传处方时，根据对照结果，同时上传医院编码名称和中心编码。
输入参数：
编号
名称
长度
约束
说明
1
批量下载数据类别
VARCHAR2（3）
NOTNULL
确定需要下载信息的种类：
01-药品目录
02-诊疗项目目录
03-医疗服务设施目录
05-病种信息
06-手术码
07-部位码
08-病种识别码
09-体检套餐明细
10-备用
2
开始日期
VARCHAR2（14）
NOTNULL
YYYYMMDDHH24MISS，每次下载完成开发商记录下载时间，下次下载的开始日期为上次的下载时间。
输出参数:
编号
名称
长度
约束
说明
1
文件路径及文件名称
VARCHAR2（200）
批量下载的数据保存的文件路径和文件名称
⏹药品目录：
编号
名称
长度
约束
说明
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）
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（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）
YYYYMMDDHH24MISS
46
终止时间
VARCHAR2（14）
YYYYMMDDHH24MISS
47
有效标志
VARCHAR2（3）
二级代码
48
备注
VARCHAR2（100）
49
经办人
VARC
升级会员 