沈阳市定点医疗机构医保接口改造文档319.docx
《沈阳市定点医疗机构医保接口改造文档319.docx》由会员分享，可在线阅读，更多相关《沈阳市定点医疗机构医保接口改造文档319.docx（192页珍藏版）》请在冰豆网上搜索。
沈阳市定点医疗机构医保接口改造文档319
（沈阳医保接口）
用户手册
（政府事业部）
文件编号：
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
2421冲正交易：
增加了对药店结算和门诊结算的冲正
增加特殊说明：
日期格式中，凡是要求精确到秒YYYYMMDDHH24MISS的地方，请严格按照医保精确到秒。
3410电子病历人员基本信息上传：
“医疗付费方式”不能为空。
曹兴
2012-10-26
1.08
3420、3430交易增加了几个对入参的非空项的限制。
2210：
“入院登记交易”增加了出参。
对特殊说明进行了补充。
对2310处方上传交易通过录负数量退处方时单据号进行了修改说明。
曹兴
2012-10-26
1.09
“精神病家庭病床”医疗类别二级代码，调整为‘20’。
新增“精神病特殊住院”医疗类别二级代码。
、“适用范围”二级代码进行了调整
“病种分类“、”病种类别“、”收费类别“的二级代码进行了调整
曹兴
2012-11-1
1.10
所有交易的“剂型”都改成Vatchar2（50）,并且不是二级代码而是汉字。
“药品信息下载”和“药品信息查询交易”，出参“医保目录药物大分类”长度改为varchar（50）
由于别的项目出现了同一家医院有多个开发商的收费端，多个开发商开发的系统操作员编号也可能相同，在对账的时候会出现把另外系统的数据查询出来，撤销或冲正的时候也可能把别的系统上传的数据给撤销或冲正了的情况，所以做出以下调整：
（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.13
修改1300交易和药品信息和1410交易的药店使用标识为药店使用标识（药店通用标识）
张宏林
2012-11-17
1.14
修改医院医护人员信息上报（3220）的约束和说明
张宏林
2012-11-22
1.15
登记交易2210和门诊结算交易2720,门诊预结算交易:
2710,增加入参:
个人编号,该项必须录入
李玉春
2012-11-23
1.16
对照信息批量上传（3300），加医院医用材料医保类别参数
2．1300交易，诊疗项目目录加医院端医用材料医保类别参数
3.月结算汇总信息查询（1330）加账户相关三个参数：
法人代表、银行户名、银行账号
张宏林
2012-11-27
1.17
1、2210入院登记交易增加两个入参：
备用、开发商标识
曹兴
2012-11-29
1.18
统一医师编号的口径：
医师编号指的是医师执业证书编号。
孙岩
2012-11-29
1.19
1、1100医疗费信息查询交易入参增加业务周期号查询条件，出参增加开发商标识和业务周期号
2、门诊结算交易开发商必录。
曹兴
2012-11-29
1.20
在系统接口设计部分增加对业务周期号的使用说明。
李玉春
2012-12-06
1.21
增加接口交易（1460）
李文军
2012-12-12
1.22
月结算详细信息查询（1340）交易加结算标识出参
参保人上次住院信息查询（1460）加开始时间入参
张宏林
2012-12-15
1.23
3110交易增加两个入参数，医院联系电话和入院日期
李清朋
2012-12-18
1.24
医疗类别29不再使用
李玉春
2012-12-19
1.25
1、1330交易增加入参：
定点医疗机构编码
2、1330交易增加出参：
定点医疗机构编码、定点医疗机构名称、银行行号
3、扩展出参中银行户名的长度。
孙岩
2012-12-25
1.26
修改医院医护人员信息上报（3220）的约束（新增5个约束）
修改电子病历诊断信息上传（3430）的约束（去掉4个约束）
李清朋
2013-1-21
1.27
1、增加接口交易1470
2、增加二级码签到标志
李文军
2013-1-21
1.28
1、门诊统筹病历信息上传（3510）扩展部分字段长度
李清朋
2013-1-23
1.29
2720交易第5个入参数，加NOTNULL
李文军
2013-1-24
1.30
1、增加接口交易1480，1490
李文军
2013-1-25
1.31
1、增加接口交易1101
李文军
2013-2-19
1.32
3300交易第6个入参数长度由14变500
李文军
2013-2-25
1.33
增加：
1100交易第55个出参“产检补贴”，1101交易第14个入参“发送方产检补贴”、第11个出参“接收方产检补贴”，1450交易第52个出参“产检补贴”，1490交易第18个出参“产检补贴”，2420交易第44出参“产检补贴”
李文军
2013-3-5
1.34
增加1331交易。
用于药店年结算汇总查询。
医院不用开发该交易。
李玉春
2013-3-14
1.35
2310、2610、2620、2710、2720交易增加两个出参：
自付比例、门诊统筹可用标志。
张宏林
2013-4-17
1.36
1450交易增加第13个入参就诊流水号
李清朋
2013-4-25
1.37
新增1610交易门诊统筹定点签约人数查询
李清朋
2013-6-24
1.38
3440交易增加第14入参
李清朋
2013-6-24
1.39
增加1461交易：
急救中心个人就诊查询
张宏林
2013-7-23
1.40
增加1620交易：
特殊解封锁信息查询
李清朋
2013-12-30
1.41
2420、2410、2610、2620、2710、2720交易：
增加出参：
进入大病费用、大病支付金额，本年进入大病费用累计；
1120医疗费对账交易：
增加入参：
发送方大病基金支付合计，增加出参：
接收方大病基金支付合计；
1100医疗费信息查询交易：
增加出参：
大病支付金额。
1101医疗费结算信息对账查询关易：
增加入参：
发送方大病基金支付合计，增加出参：
接收方大病基金支付合计；
1330月结算汇总信息查询交易，1340月结算详细信息查询交易：
增加出参：
大病实际支付金额、大病调整金额、大病预留金额、病应付金额、大病扣款金额、大病基金支付金额、大病发生人次；
张宏林
2014-2-20
1.42
1330月结算汇总信息查询交易：
增加输出参数中账户调整金额的说明信息。
王金茗
2014-6-26
1.43
完善接口文档将封锁类别的代码和注释在接口文档中完善
王金茗
2014-7-7
1.44
新增1335门诊规定病种批量下载交易
王金茗
2014-7-23
1.45
2310处方明细上报
增加材料部位码的备注说明
原处方上报时，对于统筹基金单独支付诊疗项目，院端需上传项目对应的部位编码。
现调整为：
处方上报时，部分统筹基金单独支付诊疗项目，系统将根据传入项目编码自动默认部位码，院端可不用上传部位编码（材料部位码数据项可不填）。
王金茗
2014-10-22
1.46
新增交易3111死亡人员解卡封锁上报
王金茗
2014-11-25
1.47
新增1333网上结算申报交易
张骥
2014/9/18
1.48
新增1334网上结算申报比对结果查询交易
张骥
2014/9/18
1.49
一、调整下载交易：
医疗费信息查询（1100）1、增加入参：
医疗待遇类别、医疗类别。
2、增加出参：
医疗待遇类别、医疗类别。
二、结算信息查询（1450）增加出参：
医疗待遇类别、医疗类别。
王金茗
2015/2/3
1.50
1333网上结算申报交易：
结算类型为居民基本医疗和居民精神病增加入参：
门诊大病基金支付、其中门诊规定病种大病基金支付、其中急诊急救大病基金支付、住院大病基金支付、其中家庭病床大病基金支付、门诊补充基金支付、其中门诊规定病种补充基金支付、其中急诊急救补充基金支付、住院补充基金支付、其中家庭病床补充基金支付等10项金额。
1334查询网上结算申报结果交易：
结算类型为居民基本医疗和居民精神病返回参数增加以上10项。
赵跃
2015/3/20
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）
例：
030--0001
中心编码
0000
入参
以“|”分隔，详见每个交易的参数表,分项之间使用管道分割符‘|’分割，最后必须要以管道分割符号‘|’结尾，不以‘|’开始。
如果入参为多条记录，记录之间以‘$’分割，不同数据项之间以‘|’分割
说明：
中心修改参数的原则：
只增不减，增加的参数加在参数列表的最后，不在中间插入参数。
联机标志
0：
脱机1:
联机。
沈阳传‘1’，因为本系统全是联机模式。
出参格式:
outputDatachar*
中心交易流水号^联脱机标志^输出参数^
中心交易流水号
中心交易流水号（最大30位）中心返回
联脱机标志
本项目是联机项目，所以该字段不用。
输出参数
该参数为输出参数，客户程序必须在调用本函数之前分配足够长的空间，其最小值为1024字节，如果未给本参数分配空间或分配的空间长度小于实际返回的长度，客户程序将会出现内存保护错误
输出参数的规则同入参格式中的输入参数说明
返回值说明:
0–成功，表示此次交易请求成功，业务处理也正常
<0－错误，包括系统级别错误（网络、主机、数据库）和业务级别错误，错误信息通过输出参数提示出来。
其中：
-1－系统级别错误，HIS系统提示错误信息后，需要进行冲正等后续业务操作处理；
-2－业务处理错误，HIS系统直接将输出参数的错误信息提示给操作员即可。
交易流水号说明：
说明：
交易流水号必须是每一次交易的唯一标识，在整个系统中是唯一的，因此开发商应严格按照建议规则生成交易流水号
规则：
时间（14）+医院编号（8）+流水号（4），之间用-分隔
例：
030--0001
业务周期号说明：
说明：
医院编号（8）＋操作员编号（最大8位）＋时间（14）+流水号（3），之间用-分隔
例：
--030-001
注：
业务周期号在签到交易由中心生成传给his系统。
3.2交易编码说明
交易码为四位编码，开发商调用不同的交易通过交易编码区分
序号
交易码
交易名称
交易类型
交易说明
1
1100
医疗费用信息查询
查询
对账使用
2
1101
医疗费结算信息对账查询
查询
对账使用
3
1120
医疗费信息对账
查询
对账使用
4
1200
费用明细信息查询
查询
对账使用
5
1210
明细对帐请求
查询
对账使用
6
1300
信息批量下载
查询
7
1310
对照信息批量下载
查询
8
1330
月结算汇总信息查询
查询
月结算使用
9
1331
药店年结算汇总查询
查询
年结算使用
10
1340
月结算详细信息查询
查询
月结算使用
11
1350
月结算错误信息查询
查询
月结算使用
12
1360
医师操作员信息查询
查询
13
1370
医师处方权信息查询
查询
14
1380
封锁详细信息查询
查询
15
1390
就诊信息查询
查询
16
1410
药品信息查询
查询
17
1420
诊疗项目信息查询
查询
18
1430
服务设施信息查询
查询
19
1440
定点服务机构信息查询
查询
20
1450
结算信息查询
查询
21
1461
急救中心个人就诊查询
查询
22
1470
操作员签到和签退查询
查询
23
1480
冲正日志查询
查询
24
1490
结算冲正数据查询
查询
25
1600
个人审批信息查询
查询
26
1731
中心通知信息查询
查询
27
1800
获取中心端时间
查询
28
2100
读卡
主体交易
29
2110
修改卡密码
主体交易
30
2210
门诊/住院登记
主体交易
31
2230
登记（挂号）信息修改
主体交易
32
2231
多诊断信息上传
主体交易
33
2232
手术信息上传
主体交易
34
2240
登记（挂号）撤销
主体交易
35
2310
费用明细上报
主体交易
36
2320
费用明细撤销
主体交易
37
2410
结算
主体交易
38
2420
预结算
主体交易
39
2421
冲正交易
主体交易
40
2430
结算撤销/取消报销
主体交易
41
2610
药店收费预结算
主体交易
不区分挂号和结算的药店使用
42
2620
药店收费结算
主体交易
不区分挂号和结算的药店使用
43
2710
门诊收费预结算
主体交易
44
2720
门诊收费结算
主体交易
45
2810
药店月结算确认
主体交易
46
3110
医院审批信息上报
申报业务
47
3120
医院审批信息上报撤销
申报业务
48
3220
医护人员信息上传
申报业务
49
3300
对照信息批量上传
申报业务
50
3410
电子病历人员基本信息
51
3420
电子病历病历信息上传
52
3430
电子病历诊断信息上传
53
3440
电子病历手术信息上传
54
3450
电子病历结算信息上传
55
3460
上传体检套餐基本信息
56
3470
上传体检套餐明细信息
57
3480
上传体检基本信息
58
3490
上传体检结果
59
3510
门诊统筹病历信息上传
60
9100
签到
认证交易
61
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
收费项目等级
升级会员 