江苏金保医保接口方案徐州.docx
《江苏金保医保接口方案徐州.docx》由会员分享，可在线阅读，更多相关《江苏金保医保接口方案徐州.docx（89页珍藏版）》请在冰豆网上搜索。
江苏金保医保接口方案徐州
江苏金保
医保接口方案
社保事业部
文件编号：
TD202
文件版次：
QMS2007
文档编号
TD202-SBH107053-JK-03
版本号
1.0
分册名称
江苏金保医保接口方案
第1册/共1册
总页数
46
正文
43
附录
编制
王春山
审批
茹彩辉
生效日期
2007-9-3
沈阳东软软件股份有限公司
修改记录
版本号
变更控制报告
编号
更改条款及内容
更改人
审批人
更改日期
0.8
讨论稿
王春山
2007-8-27
1.0
确认稿
王春山
2007-8-29
1.1
修改稿
邱伟
2009-1-19
1.2
修改稿
邱伟
2009-2-27
1.3
修改稿
邱伟
2009-6-18
1引言4
1.1文档编制目的4
1.2背景4
1.4参考资料4
2总体设计5
2.2系统运行体系5
2.2.1运行体系图5
2.3系统物理结构6
2.4技术路线6
3系统接口设计7
3.1用户接口函数7
3.2医院端调用接口交易序列图10
4接口交易详细设计12
4.1查询类12
4.1.2交易设计12
4.2认证类31
4.2.1交易功能31
4.2.2交易设计31
4.3业务类32
4.3.1交易功能32
4.3.2交易设计32
4.4动态库交易类52
4.4.1交易功能52
5数据结构与数据库设计52
6故障处理说明52
说明本系统所采用的基本错误处理方法和原则：
52
7附件53
1引言
1.1文档编制目的
本报告主要表述了江苏金保项目中医保接口设计方案，内容包含了医保接口的部署方案以及软件接口设计等内容。
本报告的阅读对象包括软件开发人员、软件设计人员、软件实施人员以及与该项目相关的其他人员等。
1.2背景
江苏金保项目涵盖了5地市社会保险五个险种（养老、医疗、失业、工伤、生育）以及劳动力市场管理，其中也包括了其他接口，如银行接口、医保接口等。
医保接口做为连接医疗保险与诸多定点医疗机构之间的桥梁，医保接口方案采用了联机处理方案.
1.3词汇表
词汇名称
词汇含义
备注
交易
医保接口客户端向接口发出的一种请求消息，接口需要作出应答
医保接口
是架在医保中心和定点医疗机构之间的一个接口系统，完成两者之间的信息传递，使定点医疗机构具备医保患者业务处理功能
1.4参考资料
编号
参考资料
备注
1
《江苏金保软件规格说明书_医疗待遇分册》
2总体设计
2.1软件体系结构
医保接口系统主要由医保交易、数据传输等子系统组成，如下图所示：
在江苏金保项目中，由于采用了联机方案，并且没有加密机所以暂不用使用圈存服务。
2.2系统运行体系
2.2.1运行体系图
医保接口系统主要由医保接口交易、社保卡交易、圈存系统、数据传输系统、数据库系统组成。
联机方案
2.3系统物理结构
硬件物理环境
联机方案
医保中心大型定点医疗机构要求以太网10兆以上局域网或宽带网。
小型定点医疗机构也建议采用宽带网，但可以采用ISDN或普通拔号上网。
软件环境
操作系统：
服务端为UNIX，客户端为WINDOWS2000以上；
应用服务器：
WEBLOGIC9以上版本；
数据库：
ORACLE10.2；
2.4技术路线
联机时：
由医保接口动态库通过向医保接口WEB应用发送HTTP请求进行交易；医保接口的事务提交则由医保接口WEB应用管理；所有业务均通过交易体现。
联机交易注意事项：
动态库返回成功，开发商才能处理，否则容易造成中心和医院事务不一致。
如果由于线路等问题，动态库无法接收web应用返回的交易处理结果，则返回失败，由动态库保证中心业务的冲正。
3系统接口设计
3.1用户接口函数
本系统提供给医院的是一个动态库接口，无用户界面，输入输出均通过DLL完成。
程序文件名：
SiInterface.dll
对外提供的接口函数：
初始化函数:
intINIT（char*pErrMsg）
功能描述：
检查整个运行环境：
包括网络环境、运行所需文件、参数等的检查
返回值：
成功：
返回0；失败：
返回-1
交易函数：
intBUSINESS_HANDLE（char*inputData,char*outputData）
输入参数：
inputData
输出参数：
outputDatachar*
返回值：
成功=0失败<0
输入参数是以“^、$、|”分割的字符串
输出也是以“^、$、|”分割的字符串
参数说明：
入参格式:
inputData
业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^联机标志^动态库参数^
业务编号（4位）
宏定义,分别对应后台的一项业务操作
医院编号（8位）
操作员编号（8位）
医院分配给操作员的唯一标识
业务周期号（最大36位）
签到时的返回的业务周期号
医院交易流水号（发送方交易流水号）（最大30位）
建议规则：
时间（14）+医院编号（8）+流水号（4）
中心编码
固定为0000
入参
以“|”分隔，详见每个交易的参数表,分项之间使用管道分割符‘|’分割，最后必须要以管道分割符号‘|’结尾，不以‘|’开始。
如果入参为多条记录，记录之间以‘$’分割，不同数据项之间以‘|’分割
联机标志
0：
脱机1:
联机。
注意：
在做读卡和门诊挂号这两个交易时，联机标识必须传1。
动态库入参
签到交易为：
客户端MAC地址|用户数目|
其他交易为：
客户端MAC地址|
出参格式:
outputDatachar*
中心交易流水号^业务周期号^输出参数^联机标志^
中心交易流水号
中心交易流水号（最大30位）中心返回
业务周期号
中心根据操作员和中心时间，生成业务周期号
输出参数
（该参数为输出参数，客户程序必须在调用本函数之前分配足够长的空间，其最小值为1024字节，如果未给本参数分配空间或分配的空间长度小于实际返回的长度，客户程序将会出现内存保护错误），最后以管道分割符号’|’结尾。
联机标志
在读卡和门诊挂号时，从动态库的返回参数中取该笔业务是联机还是脱机交易，HIS需要保存，后续的明细录入和结算交易时，需要传入该标识。
返回值说明:
0–成功，表示此次交易请求成功，业务处理也正常
<0－错误，包括系统级别错误（网络、主机、数据库）和业务级别错误，系统级别错误由动态库将错误信息写入输出参数，业务级别错误由后台通过输出参数提示错误信息。
错误输出机制说明:
Web应用返回给动态库的返回参数格式为：
中心交易流水号^业务周期号^输出参数^交易相应码^，动态库接收到返回参数后，根据交易相应码判断交易处理成功与否，交易处理成功，则动态库返回值为0，否则，将交易相应码转换为小于0的返回值。
动态库返回给开发商的出参，去掉交易相应码
交易流水号说明：
规则：
时间（14）+医院编号（8）+流水号（4），之间用-分隔
业务周期号说明：
说明：
医院编号（8）＋操作员编号（最大8位）＋时间（14）+流水号（4），之间用-分隔
注：
4位流水号可以循环使用
交易编码说明：
交易编码为四位编码，第一位标志交易性质，后面三位表示流水号
序号
交易码
功能简介
交易性质
1
1
1
0
医疗费用信息汇总
查询
1
2
1
0
明细对帐请求
查询
1
1
0
0
医疗费用信息查询
查询
1
2
0
0
费用明细信息查询
查询
1
3
0
0
信息批量下载
查询
1
4
0
0
参保人员基本信息及其医保个人帐户查询
查询
1
5
0
0
医疗待遇封锁信息查询
查询
1
6
0
0
个人审批信息
查询
9
1
0
0
签到
认证交易
9
1
1
0
签退
认证交易
2
1
0
0
读卡
主体交易
2
1
1
0
修改卡密码
主体交易
2
1
2
0
校验卡密码
动态库交易
2
2
1
0
门诊/住院登记
主体交易
2
2
3
0
登记（挂号）信息修改
主体交易
2
2
4
0
登记（挂号）撤销
主体交易
2
3
1
0
费用明细上报
主体交易
2
3
2
0
费用明细撤销
主体交易
2
4
1
0
结算
主体交易
2
4
2
0
预结算
主体交易
2
4
3
0
结算撤销/取消报销
主体交易
2
6
1
0
药店收费预结算
主体交易
2
6
2
0
药店收费结算
主体交易
2
5
1
0
中心报销保存处方
主体交易
3
1
1
0
医院审批信息上报
申报业务
3
1
2
0
医院审批信息上报撤销
申报业务
3
1
3
0
个人参加险种信息
查询
4
3
0
0
结算信息冲正
主体交易
4
5
0
0
查询系统时间
查询
5
1
0
0
将卡中密码存入数据库
主体交易
5
1
1
0
从数据库获取卡密码
查询
6
1
0
0
医疗类别变更
主体交易
5
2
0
0
医院端卡封锁
主体交易
7
1
0
0
撤销结算冲正交易
主体交易
7
0
1
0
医院项目对照上报（徐州）
申报业务
7
0
2
0
医院项目对照上报撤销（徐州）
申报业务
3.2医院端调用接口交易序列图
4接口交易详细设计
此部分主要对医保接口交易的各具体业务作详细说明。
4.1查询类
4.1.1交易功能
该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载，同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。
对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易，下载时提供以TAB分隔的TXT文件。
4.1.2交易设计
4.1.2.1批量数据查询下载（1300）
交易说明：
批量下载中心目录等基础数据，然后对中心的药品目录和诊疗项目目录在his系统进行对照，上传处方时，根据对照结果，同时上传医院编码名称和中心编码。
项目编码
项目名称
说明
01
药品目录
02
诊疗项目信息
03
费用类别信息
04
病种信息
05
项目和一次性材料对应关系
此交易为了HIS对项目与一次性材料的控制。
06
项目对照信息（徐州）
输入参数：
编号
名称
长度
约束
说明
1
项目编码
VARCHAR2（3）
NOTNULL
确定需要下载信息的种类
2
开始日期
VARCHAR2（14）
NOTNULL
YYYYMMDDHH24MISS
开始时间之后维护和发生变化的时间.
3
审核标志
VARCHAR2（3）
0未审核1审核通过
2审核未通过
输出参数:
编号
名称
长度
约束
说明
1
文件路径及文件名称
VARCHAR2（200）
参见配置信息
说明：
下载文件的路径为：
当前文件绝对路径\YBDLOAD\文件名.txt；文件名的命名规则为：
01：
YPML_下载数据开始日期；
02：
ZLXM_下载数据开始日期；
03：
SFXMBM_下载数据开始日期；
04：
BZXX_下载数据开始日期；
05:
：
XMDYGX_下载数据开始日期；
06：
XMDZXZ_下载数据开始日期；
药品目录：
编号
名称
长度
约束
说明
药品编码
VARHCAR2（20）
主键
通用名称
VARCHAR2（100）
通用名拼音码
VARCHAR2（8）
通用名五笔码
VARCHAR2（8）
通用名编码
VARCHAR2（8）
开始时间
VARCHAR2（14）
主键
YYYYMMDDHH24MISS
为目录使用的开始时间，与入参的开始时间不同
品名编码
VARHCAR2（20）
商品名
VARCHAR2（100）
商品名拼音码
VARCHAR2（8）
商品名五笔码
VARCHAR2（8）
英文名称
VARCHAR2（100）
12
收费类别
VARCHAR2（3）
11——西药
12——中成药
13——中草药
13
处方药标志
VARCHAR2（3）
0——非处方药（default）
1——处方药
14
收费项目等级
VARCHAR2（3）
1甲类、2乙类、3自费
15
标注剂型
VARCHAR2（20）
001——口服常释剂型
002——缓释控释剂型
003——口服液体剂
004——丸剂
005——颗粒剂
006——口服散剂
007——外用散剂
008——软膏剂
009——贴剂
010——外用液体剂
011——硬膏剂
012——凝胶剂
013——涂剂
014——栓剂
015——滴眼剂
016——滴耳剂
017——滴鼻剂
018——吸入剂
019——注射剂
020——种子源
999——自制剂
16
实际剂型
VARCHAR2（20）
001——片剂
002——肠溶片
003——包衣片
004——薄膜衣片
005——糖衣片
006——浸膏片
007——分散片
008——划痕片
009——硬胶囊
010——软胶囊（胶丸）
011——肠溶胶囊
012——缓释片
013——缓释包衣片
014——控释片
015——缓释胶囊
016——控释胶囊
017——含片
018——舌下片
019——咀嚼片剂
021——阴道泡腾片剂
022——阴道片剂
023——口服溶液剂
024——口服混悬剂
025——口服乳剂
026——胶浆剂
027——口服液
028——乳液
029——乳剂
030——胶体溶液
031——合剂
032——酊剂
033——滴剂
034——混悬滴剂
035——糖浆剂
036——丸剂
037——滴丸
038——颗粒剂
039——肠溶颗粒剂
040——干混悬剂
041——散剂
042——药粉
043——粉剂
044——散剂
045——粉剂
046——撒布剂
047——撒粉
048——软膏剂
049——乳膏剂
050——霜剂
051——糊剂
052——油膏剂
053——贴剂
054——贴膏剂
055——膜剂
056——透皮贴剂
057——外用溶液剂
058——洗剂
059——漱口剂
060——含漱液
061——胶浆剂
062——搽剂
063——酊剂
064——油剂
065——灌肠剂
067——溶液剂
068——外用冻干粉
069——硬膏剂
070——亲水硬膏剂
071——乳胶剂
072——凝胶剂
073——涂剂
074——涂膜剂
075——涂布剂
076——栓剂
077——肛门栓
078——阴道栓
079——滴眼剂
080——滴眼液
081——眼膏剂
082——滴耳剂
083——滴耳液
084——滴鼻剂
085——滴鼻液
086——喷剂
087——气雾剂
088——喷鼻剂
089——喷粉剂
090——喷雾剂
091——雾化吸入剂
092——雾化混悬液
093——雾化溶液剂
094——雾化吸入剂
095——吸入性粉剂
096——干粉剂
097——干粉吸入剂
098——粉末吸入剂
099——干粉吸剂
100——吸入性溶液剂
101——吸入性混悬液
103——注射剂
104——注射液
105——注射用溶液剂
106——静脉滴注用注射液
107——注射用混悬液
108——注射用无菌粉末
109——静脉注射针剂
110——水针
111——注射用乳剂
112——粉针剂
113——针剂
114——无菌粉针
115——冻干粉针
116——种子源
118——煎膏剂
119——浸膏剂
120——混悬剂
121——酒剂
901——其他
902——醑剂
17
规格
VARCHAR2（100）
18
单位
VARCHAR2（20）
19
最高限价
NUMBER（12,2）
2位小数
20
门诊自付比例
NUMBER（5,4）
21
住院自付比例
NUMBER（5,4）
22
工伤自付比例
NUMBER（5,4）
23
生育自付比例
NUMBER（5,4）
24
普通离休自付比例
NUMBER（5,4）
25
二乙自付比例
NUMBER（5,4）
26
居民自付比例
NUMBER（5,4）
27
学生自付比例
NUMBER（5,4）
28
终止时间
DATE
29
产地
VARCHAR2（100）
30
生产企业
VARCHAR2（100）
31
批准文号
VARCHAR2（30）
32
院内制剂标志
VARCHAR2（3）
0——非自制药品（default）
1——自制药品
33
定点医疗机构编号
VARCHAR2（20）
34
审批标志
VARCHAR2（3）
0——不需审批（default）
1——中心审批
2——医院审批
35
有效标志
VARCHAR2（3）
0——无效
1——有效（default）
对于有效的项目标志为1
对于无效的项目标志为0
在处方录入时，传入的药品或项目都应是有效标志为1的处方明细。
36
经办人
VARCHAR2（20）
37
经办日期
VARCHAR2（14）
YYYYMMDDHH24MISS
38
限中心使用
VARCHAR2（3）
0——通用目录（default）
1——中心使用
39
限门诊使用
VARCHAR2（3）
0——不限（default）
1——限门诊使用
40
特药标志
VARCHAR2（3）
0——普通药（default）
1——特药
41
招标价格
NUMBER（12,2）
42
地市级离休自付比例
NUMBER（5,4）
诊疗项目目录：
编号
名称
长度
约束
说明
项目编码
VARHCAR2（20）
主键
开始时间
VARCHAR2（14）
主键
YYYYMMDDHH24MISS
项目名称
VARCHAR2（100）
费用类别
VARCHAR2（3）
21检查费、22特殊检查费、23输氧费、24手术费、25化验费、26输血费、27诊查费、31治疗费、32特殊治疗费、33护理费、34、床位费、91其他费用、92挂号费、93特殊材料费、94材料费等，
说明：
可以从批量数据下载的费用类别信息来获取。
收费项目等级
VARCHAR2（3）
1甲类、2乙类、3自费
拼音助记码
VARCHAR2（8）
五笔助记码
VARCHAR2（8）
门诊自付比例
NUMBER（5,4）
住院自付比例
NUMBER（5,4）
工伤自付比例
NUMBER（5,4）
生育自付比例
NUMBER（5,4）
普通离休自付比例
NUMBER（5,4）
二乙自付比例
NUMBER（5,4）
居民自付比例
NUMBER（5,4）
学生自付比例
NUMBER（5,4）
终止时间
DATE
YYYYMMDDHH24MISS
规格
VARCHAR2（100）
审批标志
VARCHAR2（3）
0——不需审批（default）
1——中心审批
2——医院审批
经办人
VARCHAR2（20）
经办日期
VARCHAR2（14）
YYYYMMDDHH24MISS
有效标志
VARCHAR2（3）
1有效0无效
限中心使用
VARCHAR2（3）
0通用目录
1中心使用
省统一编码
VARCHAR2（20）
国产进口标志
VARCHAR2（3）
01——国产
02——进口
03——合资
地市级离休自付比例
NUMBER（5,4）
一级医院限价
NUMBER（12,2）
二级医院限价
NUMBER（12,2）
三级医院限价
NUMBER（12,2）
医院等级
VARCHAR2（3）
只有医院等级高于该医院等级的才可以使用这个项目
备注
VARCHAR2（100）
费用类别信息：
编号
名称
长度
约束
说明
费用类别编码
VARHCAR2（3）
费用类别名称
VARCHAR2（50）
收费大类编码
VARHCAR2（3）
收费大类名称
VARCHAR2（50）
病种目录：
编号
名称
长度
约束
说明
疾病编码
VARHCAR2（20）
主键
疾病种类
VARHCAR2（4）
0100心血管系统疾病
0200消化系统疾病
0300代谢内分泌疾病0400造血系统疾病
0500肾脏疾病
0600神经系统
0700免疫系统疾病
0800传染病
0900呼吸系统疾病
1000恶性肿瘤
1100精神病
1200-残疾
1300泌尿系统
1400其他
病种分类
VARCHAR2（10）
01普通病种
02职工医保门特病种
03精神病
疾病名称
VARCHAR
升级会员 