南通项目医保接口用户手册0723.docx
- 文档编号:28906394
- 上传时间:2023-07-20
- 格式:DOCX
- 页数:152
- 大小:83.55KB
南通项目医保接口用户手册0723.docx
《南通项目医保接口用户手册0723.docx》由会员分享,可在线阅读,更多相关《南通项目医保接口用户手册0723.docx(152页珍藏版)》请在冰豆网上搜索。
南通项目医保接口用户手册0723
(南通医保接口)
用户手册
(政府事业部)
文件编号:
TD202
文件版次:
QMS2005
文档编号
版本号
1.16
分册名称
南通医保接口用户手册
第1册/共1册
总页数
84
正文
69
附录
15
编制
审批
生效日期
2011-06-01
东软集团股份有限公司
修改记录
版本号
变更控制报告
编号
更改条款及内容
更改人
审批人
更改日期
1.0
创建南通用户手册文档
曹兴
2011-05-28
1.01
1、修改操作员编号最大长度为20
2、添加8106通知信息查询交易
曹兴
2011-08-11
1.02
1、修改读卡交易,添加“上年结转金额”,“本年新增金额”,“慢性病病种编码”
2、入院登记信息修改交易和结算交易如果是生育类医疗类别是疾病编码入参规则要按入院登记时生育病种的规则传给中心。
3、入院登记和结算时病种编码可以为空。
4、上传诊断信息如果是生育类医疗类别不要用此交易。
5、增加生育病种名称传入说明:
病种名称只传一个生育病种名称就行了,如果没有就默认传第一个不为空的名称就行了
6、增加妇科普查医疗类别和生育病种
曹兴
2011-09-27
1.03
1、3180交易增加入参“准生胎次”为必录项项
2、交易编码说明中通知信息下载改为8106
曹兴
2012-03-20
1.04
1、修改1300交易下载收费项目分类编码,增加了出参“收费大类编码”
曹兴
2012-03-21
1.05
1、修改读卡出参,增加社保卡内卡号,本年进入统筹累计,本年进入大额累计
曹兴
2012-03-26
1.06
1、3170和3180交易将准生胎次改成胎次
曹兴
2012-03-26
1.07
1、1730交易将“准生胎次”改为“胎次”
曹兴
2012-03-30
1.08
1、1100交易添加出参“业务周期号”
曹兴
2012-04-04
1.09
1、修改结算银行信息出参长度及说明
曹兴
2012-04-11
1.10
1、修改住院登记生育医疗类别上传病种的说明
曹兴
2012-04-11
1.11
1、增加药品目录下载和诊疗目录下载的职工等级、居民等级、少儿的等级和一类限价和二类限价、三类限价
曹兴
2012-04-16
1.12
1、1700交易增加出参
2、1750交易“生育疾病大类编码”多加了SY22
曹兴
2012-04-21
1.13
1、1700交易出参148门诊账户支出和150、累计门诊账户支出去掉
2、对照信息上传交易,入参的开始日期必须传
曹兴
2012-04-22
1.14
1、生育病种编码表中“妊娠并发症需要登记类别”全部改成类型二
曹兴
2012-04-26
1.15
1、2610、2620交易入参第6、7改为疾病编码、疾病名称
曹兴
2012-05-03
1.16
1、修改所有出参的“剂型”,由以前的二级代码改为长度为20的字符。
曹兴
2012-5-18
1引言5
1.1文档编制目的5
1.2背景5
1.3词汇表5
2系统接口设计5
2.1初始化函数6
2.2交易函数6
3.3POS接口函数8
3接口交易详细设计10
医院就医流程描述10
查询类11
3.1.1交易功能11
3.1.2交易设计11
3.1.2.1批量数据查询下载(1300)11
3.1.2.2医疗费信息对帐(1120)15
3.1.2.3明细对帐请求(1210)16
3.1.2.4医疗费信息查询(1100)16
3.1.2.5费用明细信息查询(1200)18
3.1.2.6查询医疗待遇资格(1500)20
3.1.2.7参保人员基本信息及其医保个人帐户查询(1400)21
3.1.2.8历年帐户余额及健身卡消费查询(1420)21
3.1.2.9个人审批信息查询(1600)21
3.1.2.10查询医护人员信息(1610)22
3.1.2.11组套信息查询(1620)23
3.1.2.11组套对应项目信息查询(1630)23
3.1.2.12查询健身卡月结算明细信息(1650)23
3.1.2.13月结医疗费用明细信息查询(1700)24
3.1.2.14生育登记信息查询(1730)29
3.1.2.15生育结算信息查询(1740)30
3.1.2.16生育月结算明细信息查询(1750)30
3.1.2.17总量指标告知书下载(1760)31
3.1.2.18年度总量使用情况告知书下载(1770)31
3.1.2.19获取中心端时间(1800)32
3.1.2.20对照信息下载(4400)32
3.1.2.21通知信息查询(8106)33
3.2认证类33
3.2.1交易功能33
3.2.2交易设计34
3.2.2.1签到(9100)34
3.2.2.2签退(9110)34
3.3业务类34
3.3.1交易功能34
3.3.2交易设计34
3.3.2.1读卡(2100)34
3.3.2.2门诊/住院登记(2210)35
3.3.2.3登记(挂号)信息修改(2230)37
3.3.2.4诊断信息维护(2231)37
3.3.2.5登记(挂号)撤销(2240)38
3.3.2.6处方明细上报(2310)38
3.3.2.7处方明细撤销(2320)39
3.3.2.8费用预结算(2420)40
3.3.2.9费用结算(2410)40
3.3.2.10费用结算撤销(2430)43
3.3.2.11药店收费/购买健身卡预结算(2610)43
3.3.2.12药店收费/购买健身卡结算(2620)49
3.3.2.13冲正交易(2421)49
3.4数据上传业务类49
3.4.1医院审批信息上报(3110)49
3.4.2医院审批信息上报撤销(3120)50
3.4.3对照信息批量上传(3130)50
3.4.4自制药品上传(3140)51
3.4.5医护人员信息上传(3150)52
3.4.6药品进销存信息上传(3160)53
3.4.7生育登记信息上传(3170)53
3.4.8生育登记附加信息上传(3180)54
4仿真POS交易说明55
4.1函数定义55
4.2参数定义55
4.3交易码定义55
4.4交易报文56
4.4.1操作员签到56
4.4.2操作员签退56
4.4.3余额查询56
4.4.4消费扣款撤消57
4.4.5总帐结帐57
4.4.6明细帐结帐58
4.4.7查询交易明细61
调用说明61
5尚需解决的问题62
6附录62
6.1二级代码表62
6.2生育病种编码表71
6.3特殊病门诊、居民大病审批虚拟病种表72
6.4工伤虚拟病种表73
1引言
1.1文档编制目的
医保接口用户手册主要表述了医保接口设计方案和对外交易描述。
本报告的阅读对象主要包括用户方相关人员、定点医疗机构软件开发人员相关的其他人员等。
1.2背景
本接口设计报告在核心平台三版医保接口设计报告的基础上,基于南通项目设计。
医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁,除要满足南通项目的医疗待遇算法和医院端需求外,还需要考虑医院端连接银行软POS的接口,以及中心和医院的对帐方式。
基于南通项目的建设背景,南通金保的医保接口采用了联机模式。
1.3词汇表
词汇名称
词汇含义
备注
交易
医保接口客户端向接口发出的一种请求消息,接口需要作出应答
医保接口
医保中心向定点医疗机构公开的服务,是架在医保中心和定点医疗机构之间的一个接口系统,完成两者之间的信息传递,使定点医疗机构具备医保患者业务处理功能
2系统接口设计
本系统提供给医院的是一个动态库接口,无用户界面,输入输出均通过DLL完成。
程序文件名:
SiInterface.dll
对外提供的接口函数:
1.
2.
3.
3.1.
2.1初始化函数
intINIT(char*pErrMsg)
功能描述:
检查整个运行环境:
包括网络环境、运行所需文件、参数等的检查,HIS系统在调用交易函数之前,必须先调用初始化函数。
返回值:
成功:
返回0;失败:
返回-1
2.2交易函数
intBUSINESS_HANDLE(char*inputData,
char*outputData)
功能描述:
HIS系统开发商需要向医保中心发送业务请求的通用函数
输入参数:
inputData
输出参数:
outputDatachar*
返回值:
成功=0失败<0
输入输出参数是以“^、$、|”分割的字符串
参数说明:
入参格式:
inputData
交易编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^联机标志^
业务编号
宏定义,分别对应后台的一项业务操作,具体见下面的交易编码说明
医疗机构编号
操作员编号(最大20位)
医院分配给操作员的唯一标识
业务周期号
操作员签到时,中心返回给his的业务周期号。
医院交易流水号(发送方交易流水号)(最大30位)
建议规则:
时间(14)+医院编号(8)+流水号(4)
例:
20060101083030-10011001-0001
中心编码
0000
入参
以“|”分隔,详见每个交易的参数表,分项之间使用管道分割符‘|’分割,最后必须要以管道分割符号‘|’结尾,不以‘|’开始。
如果入参为多条记录,记录之间以‘$’分割,不同数据项之间以‘|’分割
说明:
中心修改参数的原则:
只增不减,增加的参数加在参数列表的最后,不在中间插入参数。
联机标志
固定传1。
出参格式:
outputDatachar*
中心交易流水号^联脱机标志^输出参数^
中心交易流水号
中心交易流水号(最大30位)中心返回
联脱机标志
南通不用。
输出参数
输出参数的规则同入参格式中的输入参数说明
返回值说明:
0–成功,表示此次交易请求成功,业务处理也正常
<0-错误,包括系统级别错误(网络、主机、数据库)和业务级别错误,系统级别错误由动态库将错误信息写入输出参数,业务级别错误由后台通过输出参数提示错误信息。
交易流水号说明:
说明:
交易流水号必须是每一次交易的唯一标识,在整个系统中是唯一的,因此开发商应严格按照建议规则生成交易流水号
规则:
时间(14)+医院编号(8)+流水号(4),之间用-分隔
例:
20060101083030-10011001-0001
业务周期号说明:
说明:
医院编号(8)+操作员编号(最大8位)+时间(8)+流水号(4),之间用-分隔
例:
10011001-99999999-20110101-0001
注:
业务周期号在签到交易由中心生成传给his系统。
交易编码说明:
序号
交易编号
交易名称
交易类型
交易说明
1
1100
医疗费用信息查询
查询
2
1120
医疗费信息对账
查询
3
1200
费用明细信息查询
查询
4
1210
明细对帐请求
查询
5
1300
信息批量下载
查询
6
1400
参保人员基本信息及其医保个人帐户查询
查询
7
1420
历年帐户余额及健身卡消费查询
查询
用于定点健身场馆
8
1500
查询医疗待遇资格
查询
9
1600
个人审批信息查询
查询
10
1610
查询医护人员信息
查询
11
1620
组套信息查询
查询
12
1630
组套对应项目信息查询
查询
13
1650
查询健身卡月结算明细信息
查询
用于定点健身场馆月结算
14
1700
月结医疗费用明细信息查询
查询
月结算使用
15
1730
生育登记信息查询
查询
生育使用
16
1740
生育结算信息查询
查询
生育使用
17
1750
生育月结算明细信息查询
查询
月结算使用
18
1800
获取中心端时间
查询
19
4400
对照信息下载
查询
20
2100
读卡
主体交易
21
2210
门诊/住院登记
主体交易
门诊、住院使用
22
2230
登记(挂号)信息修改
主体交易
门诊、住院使用
23
2231
诊断信息上传
主体交易
门诊、住院使用
24
2240
登记(挂号)撤销
主体交易
门诊、住院使用
25
2310
费用明细上报
主体交易
门诊、住院使用
26
2320
费用明细撤销
主体交易
门诊、住院使用
27
2410
结算
主体交易
门诊、住院使用
28
2420
预结算
主体交易
门诊、住院使用
29
2421
冲正交易
主体交易
门诊、住院使用
30
2430
结算撤销/取消报销
主体交易
门诊、住院使用
31
2610
药店收费/购买健身卡预结算
主体交易
供药店或健身房等不区分挂号和结算业务的定点医疗机构使用
32
2620
药店收费结算
主体交易
供药店或健身房等不区分挂号和结算业务的定点医疗机构使用
33
3110
医院审批信息上报
申报业务
34
3120
医院审批信息上报撤销
申报业务
35
3130
对照信息批量上传
申报业务
36
3140
自制药品上传
申报业务
37
3150
医护人员信息上传
申报业务
38
3160
药品进销存信息上传
申报业务
49
3170
生育登记信息上传
申报业务
生育使用
40
3180
生育登记附加信息上传
申报业务
生育使用
41
9100
签到
认证交易
42
9110
签退
认证交易
43
8106
通知信息查询
查询
3.3POS接口函数
intPOS_Trans(char*cInput,intinLen,char*cOutput,intoutLen);
功能描述:
POS交易函数,供医院完成POS交易使用。
参数说明:
cInput:
入参,POS交易输入参数,详见POS交易接口文档
inLen:
入参,cInput输入串的长度。
outLen:
入参,为cOutput预分配的空间大小,不得小于2048。
cOutput:
出参,POS交易输出参数,成功时为返回信息,失败时为错误信息。
返回值说明:
00:
成功
其它值:
失败,原因参见错误信息
3接口交易详细设计
此部分主要对医保接口交易的各具体业务作详细说明。
医院就医流程描述
说明:
上图以门诊为例说明医院就医的业务流程,住院业务与门诊业务的区别是,在就诊登记后,费用结算前,任何一个环节,都可以选择进行住院登记信息修改。
说明:
以上流程可以供药店或健身房等不区分挂号和结算业务的定点医疗机构使用。
查询类
3.1.1交易功能
该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载,同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。
对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等大数据量的查询交易,下载时提供以TAB分隔的TXT文件。
3.1.2交易设计
3.1.2.1批量数据查询下载(1300)
交易说明:
批量下载中心目录等基础数据,然后对中心的药品目录和诊疗项目目录在his系统进行对照,上传处方时,根据对照结果,同时上传医院编码名称和中心编码。
输入参数:
编号
名称
长度
约束
说明
1
项目编码
VARCHAR2(3)
NOTNULL
01药品目录02诊疗项目信息04收费项目分类编码信息05病种信息
2
开始日期
VARCHAR2(14)
NOTNULL
YYYYMMDDHH24MISS
输出参数:
编号
名称
长度
约束
说明
1
文件路径及文件名称
VARCHAR2(200)
参见配置信息
下载文件为TXT文件,每条记录一行数据,不同数据项之间以TAB键分割,针对不同项目的下载,具体格式说明如下:
⏹药品目录:
编号
名称
长度
约束
说明
1
药品编码
VARHCAR2(20)
非空
2
药品名称
VARCHAR2(100)
3
英文名称
VARCHAR2(300)
4
处方药标志
VARCHAR2(3)
二级代码
5
拼音码
VARCHAR2(50)
6
五笔助记码
VARCHAR2(50)
7
药品剂量单位
VARCHAR2(20)
8
剂型
VARCHAR2(20)
9
每次用量
VARCHAR2(16)
2位小数
10
使用频次
VARCHAR2(100)
11
单位
VARCHAR2(20)
12
规格
VARCHAR2(100)
13
开始时间
VARCHAR2(14)
YYYYMMDDHH24MISS
14
终止时间
VARCHAR2(14)
YYYYMMDDHH24MISS
15
备注
VARCHAR2(100)
16
收费类别
VARCHAR2(3)
为“收费项目分类编码”下载的收费类别代码
17
收费项目等级
VARCHAR2(3)
二级代码
18
物价限价
VARCHAR2(16)
2位小数
19
院内制剂标志
VARCHAR2(3)
二级代码
20
定点医疗机构编号
VARCHAR2(20)
21
是否需要审批标志
VARCHAR2(3)
二级代码
22
用法
VARCHAR2(200)
23
限定天数
VARCHAR2(8)
24
药厂名称
VARCHAR2(100)
25
国药准字
VARCHAR2(100)
26
自定义码
VARCHAR2(10)
27
国家目录编码
VARCHAR2(20)
28
产地
VARCHAR2(3)
二级代码
29
工伤使用标志
VARCHAR2(3)
二级代码,备用
30
生育使用标志
VARCHAR2(3)
二级代码,备用
31
基本医疗使用标识
VARCHAR2(3)
二级代码
32
药品分类编号
VARCHAR2(20)
33
限制使用范围
VARCHAR2(100)
34
药品通用名
VARCHAR2(100)
35
中草药管理办法
VARCHAR2(3)
二级代码
36
社会保险经办机构编码
VARCHAR2(16)
37
超限价管理办法
VARCHAR2(3)
二级代码
38
单处方限制数量
VARCHAR2(16)
39
医院申报药品状态
VARCHAR2(3)
二级代码
40
标注剂型
VARCHAR2(50)
41
医保限价
VARCHAR2(16)
二位小数
42
少儿使用标志
VARCHAR2(3)
二级代码
43
通用药品编码
VARCHAR2(20)
44
门诊特殊药品标识
VARCHAR2(3)
二级代码
45
通用名拼音助记码
VARCHAR2(50)
46
药监局编码
VARCHAR2(20)
47
物价编码
VARCHAR2(20)
48
在职人员自付比例
VARCHAR2(5)
4位小数
49
二乙人员自付比例
VARCHAR2(5)
4位小数
50
退休人员自付比例
VARCHAR2(5)
4位小数
51
离休人员自付比例
VARCHAR2(5)
4位小数
52
居民自付比例
VARCHAR2(5)
4位小数
53
少儿自付比例
VARCHAR2(5)
4位小数
54
工伤保险自付比例
VARCHAR2(5)
4位小数
55
生育保险自付比例
VARCHAR2(5)
4位小数
56
经办日期
VARCHAR2(14)
YYYYMMDDHH24MISS
57
有效标志
VARCHAR2(3)
二级代码,中心删除的数据,通过有效标志为无效下传给医院
58
职工等级
VARCHAR2(3)
二级代码(同收费项目等级)
59
居民等级
VARCHAR2(3)
二级代码(同收费项目等级)
60
少儿等级
VARCHAR2(3)
二级代码(同收费项目等级)
⏹诊疗项目目录:
编号
名称
长度
约束
说明
1
项目编码
VARHCAR2(20)
2
开始时间
VARCHAR2(14)
YYYYMMDDHH24MISS
3
项目名称
VARCHAR2(100)
4
收费类别
VARCHAR2(3)
为“收费项目分类编码”下载的收费类别代码
5
收费项目等级
VARCHAR2(3)
二级代码
6
特检特治标志
VARCHAR2(3)
二级代码
7
物价限价
VARCHAR2(16)
二位小数
8
单位
VARCHAR2(20)
9
拼音助记码
VARCHAR2(50)
10
五笔助记码
VARCHAR2(50)
11
自定义码
VARCHAR2(10)
12
终止日期
VARCHAR2(14)
YYYYMMDDHH24MISS
13
备注
VARCHAR2(300)
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 南通 项目 医保 接口 用户手册 0723