荆门金保医保接口用户参考手册.docx
- 文档编号:12157117
- 上传时间:2023-06-04
- 格式:DOCX
- 页数:81
- 大小:44.72KB
荆门金保医保接口用户参考手册.docx
《荆门金保医保接口用户参考手册.docx》由会员分享,可在线阅读,更多相关《荆门金保医保接口用户参考手册.docx(81页珍藏版)》请在冰点文库上搜索。
荆门金保医保接口用户参考手册
(荆门金保医保接口)
用户参考手册
(社保事业部)
文件编号:
TD202
文件版次:
QMS2005
文档编号
SBH6070221-SDR-04
版本号
1.0
分册名称
第1册/共1册
总页数
正文
附录
编制
审批
生效日期
沈阳东软软件股份有限公司
修改记录
版本号
变更控制报告
编号
更改条款及内容
更改人
审批人
更改日期
0.9
创建
线延鹏
2008-10-15
目录
1引言5
1.1文档编制目的5
1.2背景5
1.3词汇表5
2系统接口设计5
2.1用户接口说明5
2.2用户接口函数5
3接口交易详细设计8
3.1查询类8
3.1.1交易功能8
3.1.2交易设计9
3.1.2.1批量数据查询下载9
3.1.2.2医疗费信息汇总16
3.1.2.3明细对帐请求17
3.1.2.4医疗费信息查询17
3.1.2.5医疗费用明细信息查询19
3.1.2.6医疗待遇封锁信息查询21
3.1.2.7医疗待遇审批信息查询21
3.2认证类22
3.2.1交易功能22
3.2.2交易设计22
3.2.2.1签到22
3.2.2.2签退22
3.2.2.3获取中心系统时间22
3.3业务类22
3.3.1交易功能22
3.3.2交易设计23
3.3.2.1读卡交易23
3.3.2.2居民获取基本信息26
3.3.2.3修改卡密码26
3.3.2.4门诊/住院登记26
3.3.2.5住院登记修改28
3.3.2.6出院登记28
3.3.2.7登记撤销29
3.3.2.8登记(挂号)冲正29
3.3.2.9处方明细上报29
3.3.2.10处方明细撤销30
3.3.2.11处方明细更改31
3.3.2.12费用预结算31
3.3.2.13费用结算32
3.3.2.14费用结算撤销32
3.3.2.15费用结算冲正33
3.3.2.16结算单信息查询33
3.3.2.17药店收费预结算34
3.3.2.18药店收费结算36
3.3.2.19医院审批信息上报37
3.3.2.20医院审批信息上报撤销38
3.3.2.21医院项目对照上报39
3.3.2.22医院项目对照上报撤销39
1引言
1.1文档编制目的
本报告主要表述了荆门金保项目中医保接口设计方案,内容包含了医保接口的部署方案以及软件接口设计等内容。
本报告的阅读对象包括软件开发人员、软件设计人员、软件实施人员以及与该项目相关的其他人员等。
1.2背景
1.3词汇表
词汇名称
词汇含义
备注
交易
医保接口客户端向接口发出的一种请求消息,接口需要作出应答
医保接口
是架在医保中心和定点医疗机构之间的一个接口系统,完成两者之间的信息传递,使定点医疗机构系统具备结算医保患者的业务处理功能
2系统接口设计
2.1用户接口说明
动态库返回成功,开发商才能处理his系统的业务,his业务处理失败造成的事务不一致由开发商负责。
如果由于线路等问题,动态库无法接收web应用返回的交易处理结果,则返回失败,由动态库保证中心业务的回退。
2.2用户接口函数
本系统提供给医院的是一个动态库接口,无用户界面,输入输出均通过DLL完成。
程序文件名:
SiInterface.dll
对外提供的接口函数:
⏹初始化函数:
intINIT(char*pErrMsg)
功能描述:
检查整个运行环境:
包括网络环境、运行所需文件、参数等的检查
返回值:
成功:
返回0;失败:
返回-1
⏹交易函数:
intBUSINESS_HANDLE(char*inputData,
char*outputData)
输入参数:
inputData
输出参数:
outputDatachar*
返回值:
成功=0失败<0
输入参数是以“^、$、|”分割的字符串
输出也是以“^、$、|”分割的字符串
参数说明:
入参格式:
inputData
业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^动态库参数^
业务编号(4位)
宏定义,分别对应后台的一项业务操作
医院编号(8位)
操作员编号(8位)
医院分配给操作员的唯一标识
业务周期号(最大34位)
为空
医院交易流水号(发送方交易流水号)(最大30位)
建议规则:
时间(14)+医院编号(8)+流水号(4)
例:
20060101083030-10011001-0001
中心编码
固定为0000
入参
以“|”分隔,详见每个交易的参数表,分项之间使用管道分割符‘|’分割,最后必须要以管道分割符号‘|’结尾,不以‘|’开始。
如果入参为多条记录,记录之间以‘$’分割,不同数据项之间以‘|’分割
动态库入参
签到交易为:
客户端MAC地址|用户数目|
其他交易为:
客户端MAC地址|
出参格式:
outputDatachar*
中心交易流水号^业务周期号^输出参数^
中心交易流水号
中心交易流水号(最大30位)中心返回
业务周期号
中心根据操作员和中心时间,生成业务周期号
输出参数
(该参数为输出参数,客户程序必须在调用本函数之前分配足够长的空间,其最小值为1024字节,如果未给本参数分配空间或分配的空间长度小于实际返回的长度,客户程序将会出现内存保护错误),最后以管道分割符号’|’结尾。
动态库参数
客户端MAC地址|
返回值说明:
0–成功,表示此次交易请求成功,业务处理也正常
<>0-错误,包括系统级别错误(网络、主机、数据库)和业务级别错误,系统级别错误由动态库将错误信息写入输出参数,业务级别错误由后台通过输出参数提示错误信息。
错误输出机制说明:
Web应用返回给动态库的返回参数格式为:
中心交易流水号^业务周期号^输出参数^交易相应码^,动态库接收到返回参数后,根据交易相应码判断交易处理成功与否,交易处理成功,则动态库返回值为0,否则,将交易相应码转换为小于0的返回值。
动态库返回给开发商的出参,去掉交易相应码
交易流水号说明:
说明:
交易流水号必须是每一次交易的唯一标识,在整个系统中是唯一的,因此开发商应严格按照建议规则生成交易流水号
规则:
时间(14)+医院编号(8)+流水号(4),之间用-分隔
例:
20060101083030-10011001-0001
业务周期号说明:
说明:
医院编号(8)+操作员编号(最大8位)+时间(14)+流水号(4),之间用-分隔
例:
10011001-99999999-20060101083030-0001
注:
4位流水号可以循环使用
交易编码说明:
交易编码为四位编码,第一位标志交易性质,后面三位表示流水号
序号
交易码
功能简介
交易性质
1
1
1
1
0
医疗费用信息汇总
查询
2
1
2
1
0
明细对帐请求
查询
3
1
1
0
0
医疗费用信息查询
查询
4
1
2
0
0
费用明细信息查询
查询
5
1
3
0
0
信息批量下载
查询
6
1
5
0
0
查询医疗待遇资格
查询
7
1
6
0
0
个人审批信息查询
查询
8
1
7
0
0
住院登记信息查询
查询
9
1
8
0
0
查询卡号信息
查询
10
1
9
0
0
当天消费查询
查询
11
9
1
0
0
签到
认证交易
12
9
1
1
0
签退
认证交易
13
9
1
2
0
获取中心系统时间
主体交易
14
2
1
0
0
读卡
主体交易
15
2
1
1
0
修改卡密码
主体交易
16
2
1
4
0
居民获取基本信息
主体交易
17
2
2
1
0
门诊/住院登记
主体交易
18
3
2
3
0
登记(挂号)信息修改
主体交易
19
2
2
2
0
出院登记
主体交易
20
2
2
4
0
登记(挂号)撤销
主体交易
21
2
2
5
0
登记(挂号)冲正
主体交易
22
2
3
1
0
费用明细上报
主体交易
23
2
3
2
0
费用明细撤销
主体交易
24
2
3
3
0
费用明细更改
主体交易
25
2
3
4
0
取消报销
主体交易
26
2
4
1
0
结算
主体交易
27
2
4
2
0
预结算
主体交易
28
2
4
3
0
结算撤销
主体交易
29
2
4
4
0
结算冲正
主体交易
30
2
5
4
0
结算信息查询
查询交易
31
2
6
1
0
药店收费预结算
主体交易
32
2
6
2
0
药店收费结算
主体交易
33
3
1
1
0
医院审批信息上报
申报业务
34
3
1
2
0
医院审批信息上报撤销
申报业务
35
3
4
5
0
医院项目对照上报
申报业务
36
3
4
6
0
医院项目对照上报撤销
申报业务
37
2
3
5
0
费用明细删除
主体交易
3接口交易详细设计
此部分主要对医保接口交易的各具体业务作详细说明。
3.1查询类
3.1.1交易功能
该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载,同时还包括审批信息、封锁信息等的查询业务。
对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易,下载时提供以TAB分隔的TXT文件。
3.1.2交易设计
3.1.2.1批量数据查询下载
交易说明:
批量下载中心目录等基础数据,然后对中心的药品目录和诊疗项目目录在his系统进行对照,上传处方时,根据对照结果,同时上传医院编码名称和中心编码。
项目编码
项目名称
说明
01
药品目录
02
诊疗项目信息
03
医疗服务设施信息
04
费用类别信息
05
病种信息
06
项目对照信息
08
病种定额信息
输入参数:
编号
名称
长度
约束
说明
1
项目编码
VARCHAR2(3)
NOTNULL
确定需要下载信息的种类
2
开始日期
VARCHAR2(14)
NOTNULL
YYYYMMDDHH24MISS
输出参数:
编号
名称
长度
约束
说明
1
文件路径及文件名称
VARCHAR2(200)
参见配置信息
说明:
下载文件的路径为:
当前文件绝对路径\YBDLOAD\文件名.txt;文件名的命名规则为:
01:
YPML_下载数据开始日期;
02:
ZLXM_下载数据开始日期;
03:
FWSS_下载数据开始日期;
04:
SFXMBM_下载数据开始日期;
05:
BZML_下载数据开始日期;
06:
SPXX_下载数据开始日期;
08:
BZDE_下载数据开始时间;
⏹药品目录:
编号
名称
长度
约束
说明
1
药品编码
VARHCAR2(20)
AKA060
2
通用名称
VARCHAR2(100)
AKA061
3
英文名称
VARCHAR2(100)
AKA062
4
收费类别
VARCHAR2(3)
AKA063
11西药、12中成药、13中草药
说明:
可以从批量数据下载的费用类别信息来获取。
5
处方药标志
VARCHAR2(3)
AKA064
1处方药、0非处方药
6
收费项目等级
VARCHAR2(3)
AKA065
1甲类、2乙类、3自费4丁类
7
拼音码
VARCHAR2(8)
AKA066
8
药品剂量单位
VARCHAR2(20)
AKA067
9
最高限价
VARCHAR2(20)
AKA068
2位小数
10
个人自付比例职工
VARCHAR2(8)
AKA069
4位小数
11
院内制剂标志
VARCHAR2(3)
AKA084
0非自制、1自制
12
定点医疗机构编码
VARCHAR2(20)
AKB020
13
是否需要审批标志
VARCHAR2(3)
AKC173
0不需要、1需要
14
剂型
VARCHAR2(20)
AKA070
15
五笔助记码
VARCHAR2(8)
AKA074
16
单位
VARCHAR2(10)
AKA076
17
规格
VARCHAR2(100)
AKA077
18
经办人
VARCHAR2(20)
AAE011
19
经办日期
VARCHAR2(14)
AAE036
YYYYMMDDHH24MISS
20
开始时间
VARCHAR2(14)
AAE030
YYYYMMDDHH24MISS
21
终止时间
VARCHAR2(14)
AAE031
YYYYMMDDHH24MISS
22
备注
VARCHAR2(100)
AAE013
23
产地
VARCHAR2(3)
AKA616
0国产1进口2合资
24
最小医院等级
VARCHAR2(3)
AKA101
00中医院01一级医院
02二级医院03三级医院
25
离休支付标志
VARCHAR2(3)
AKA094
0不支付、1支付
26
特殊用药标志
VARCHAR2(3)
AKA095
0普通药品、1二线用药、2适应症用药
27
工伤用药标志
VARCHAR2(3)
AKA092
0否、1是
28
药品商品名
VARCHAR2(100)
AKA079
29
超限价个人负担比例
VARCHAR2(8)
AKA096
4位小数
30
超限价医院负担比例
VARCHAR2(8)
AKA132
4位小数
31
个人自付比例居民
VARCHAR2(8)
AKA269
4位小数
32
限工伤标志
VARCHAR2(3)
AKA093
0为不限制,1为限制
33
限门诊标志
VARCHAR2(3)
AKA351
0为不限制,1为限制
34
限儿童标志
VARCHAR2(3)
AKA353
0为不限制,1为限制
35
限病种标志
VARCHAR2(3)
AKA352
0为不限制,1为限制
36
二乙限价
VARCHAR2(20)
AKA357
2位小数
37
工伤限价
VARCHAR2(20)
AKA355
2位小数
38
生育限价
VARCHAR2(20)
AKA356
2位小数
39
离休限价
VARCHAR2(20)
AKA108
2位小数
⏹诊疗项目目录:
编号
名称
长度
约束
说明
1
项目编码
VARHCAR2(20)
AKA090
2
开始时间
VARCHAR2(14)
AAE030
YYYYMMDDHH24MISS
3
项目名称
VARCHAR2(100)
AKA091
4
费用类别
VARCHAR2(3)
AKA063
11西药
12中成药
13中草药
14血费
21检查费
22特殊检查费
23放射费
24化验费
25CT
26磁共震
31治疗费
32特殊治疗费
33手术费
34输血费
35输氧费
36麻醉费
37诊查费
38护理费
41特殊材料费
42普通材料费
43其它
51床位费
52冷暖费
说明:
可以从批量数据下载的费用类别信息来获取。
5
收费项目等级
VARCHAR2(3)
AKA065
1甲类、2乙类、3自费、4丁类
6
是否需要审批标志
VARCHAR2(3)
AKC173
0不需要、1需要
7
特检特制标志
VARCHAR2(3)
AKA629
0普通项目,1特检特制项目
8
最高价格
VARCHAR2(20)
AKA068
2位小数
9
个人自付比例
VARCHAR2(8)
AKA069
4位小数
10
离休自付比例
VARCHAR2(8)
AKA086
4位小数
11
工伤自付比例
VARCHAR2(8)
AKA087
4位小数
12
生育自付比例
VARCHAR2(8)
AKA088
4位小数
13
1-6级伤残军人自付比例
VARCHAR2(8)
AKA089
4位小数
14
单位
VARCHAR2(10)
AKA076
15
拼音助记码
VARCHAR2(8)
AKA066
16
五笔助记码
VARCHAR2(8)
AKA074
17
自定义码
VARCHAR2(8)
AKA605
18
经办人
VARCHAR2(20)
AAE011
19
经办日期
VARCHAR2(14)
AAE036
YYYYMMDDHH24MISS
20
终止时间
VARCHAR2(14)
AAE031
YYYYMMDDHH24MISS
21
备注
VARCHAR2(100)
AAE013
22
产地
VARCHAR2(3)
AKA616
同药品
23
工伤限价
VARCHAR2(20)
AKA098
2位小数
24
限离休标志
VARCHAR2(3)
AKA114
0不限制1有限制
25
医院等级
VARCHAR2(3)
AKA101
同药品
26
限工伤
VARCHAR2(3)
AKA093
0为不限制,1为限制
27
生育限价
VARCHAR2(20)
AKA356
2位小数
28
二乙限价
VARCHAR2(20)
AKA357
2位小数
29
离休限价
VARCHAR2(20)
AKA108
2位小数
30
超限价个人负担比例
VARCHAR2(8)
AKA096
4位小数
31
超限价医院负担比例
VARCHAR2(8)
AKA132
4位小数
⏹服务设施目录:
编号
名称
长度
约束
说明
1
服务设施编码
VARHCAR2(20)
AKA100
2
服务设施名称
VARCHAR2(100)
AKA102
3
开始时间
VARCHAR2(14)
AAE030
YYYYMMDDHH24MISS
4
费用类别
VARCHAR2(3)
AKA063
51床位费
5
病床等级
VARCHAR2(3)
AKA103
01--单人间
02--双人间
03--干部病房
6
基本医疗报销限价
VARCHAR2(20)
AKA068
2位小数
7
离休最高限价
VARCHAR2(20)
AKA108
2位小数
8
拼音助记码
VARCHAR2(8)
AKA066
9
五笔助记码
VARCHAR2(8)
AKA074
10
限制使用范围
VARCHAR2(100)
AKA613
11
终止时间
VARCHAR2(14)
AAE031
YYYYMMDDHH24MISS
12
经办人
VARCHAR2(20)
AAE011
13
经办时间
VARCHAR2(14)
AAE036
YYYYMMDDHH24MISS
14
工伤限价
VARCHAR2(20)
AKA098
2位小数
15
二乙限价
VARCHAR2(20)
AKA113
2位小数
16
工伤床位费标志
VARCHAR2(3)
AKA134
0否、1是
17
医院等级
VARCHAR2(3)
AKA101
同药品
18
超限价个人负担比例
VARCHAR2(8)
AKA096
4位小数
19
超限价医院负担比例
VARCHAR2(8)
AKA132
4位小数
20
厅级干部限价
VARCHAR2(20)
AKA358
4位小数
⏹费用类别信息:
编号
名称
长度
约束
说明
1
费用类别编码
VARHCAR2(3)
AKA063
2
费用类别名称
VARCHAR2(50)
AKA110
3
收费大类编码
VARHCAR2(3)
AKA111
4
收费大类名称
VARCHAR2(50)
AKA112
⏹病种目录:
编号
名称
长度
约束
说明
1
疾病编码
VARHCAR2(20)
AKA120
2
疾病种类
VARHCAR2(10)
AKA122
221传染性疾病
222循环系统疾病
223呼吸系统疾病
224消化系统疾病
225泌尿及性生殖系统疾病
226血液系统疾病
227风湿类疾病
228内分泌系统及代谢疾病
229神经精神类疾病
230骨关节系统疾病与创伤
231妇科疾病
232眼科疾病
233口腔疾病
234耳鼻喉科疾病
235皮肤及烧伤疾病
3
职工病种分类
VARCHAR2(3)
AKA123
01普通病种02门诊慢性病种
05特殊病种06地方病种
07其它
4
疾病名称
VARCHAR2(100)
AKA121
5
病种报销标志
VARCHAR2(3)
AKA128
0不可报销、1可报销
6
慢性病分类
VARCHAR2(3)
AKA628
0普通特病、1癌症、2精神病
、3尿毒症、4组织器官移植
7
拼音助记码
VARCHA
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 荆门 医保 接口 用户 参考手册