梅河口市社会医疗保险管理系统医院接口说明V13.docx
《梅河口市社会医疗保险管理系统医院接口说明V13.docx》由会员分享，可在线阅读，更多相关《梅河口市社会医疗保险管理系统医院接口说明V13.docx（176页珍藏版）》请在冰豆网上搜索。
梅河口市社会医疗保险管理系统医院接口说明V13
梅河口市社会医疗保险管理系统
定点机构就医结算服务接口
说明书
修改记录
版本号
变更控制
报告编号
更改条款及内容
更改人
审批人
更改日期
1.0
梅河口市社会医疗保险管理系统医院接口说明1.0
2015-01-23
1.1
增加一卡通的支持：
1）修改1.3.1读卡（IC卡加密字符串校验）增加一卡通信息，
2）增加交易方法：
1.3.19交易验证（一卡通），使用一卡通结算时，先调用一卡通交易函数DoDebit函数，将该交易返回的串进行交易验证，验证成功后进行结算收费（住院结算、门诊结算、药店结算）保存。
2015-05-18
1.2
修改第二章2.27KC21View，增加属性：
YKC006（VARCHAR2（3））卡模式：
0：
医保IC卡；1：
医保磁卡；3：
医保证
2015-07-08
1.3
增加：
1.是否扣除起付点说明：
KC21View的AKC666;1：
扣除2：
不扣起付点默认为扣起付。
不扣起伏点需要调整接口：
1.3.11（住院费用计算）和1.3.12（住院结算保存）中的KC21View传AKC666为2。
2.增加接口1.3.20查询费用明细信息
3.增加接口1.3.21查询处方汇总信息
4.增加支付审批表说明，详见附录一
2015-11-04
第一章接口描述
结算端初始化
医疗机构注册
接口命名
medOrganRegister
描述
医院端注册
医院端处理
医院端注册,返回医院注册信息
接口处理
查询医院信息
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
out
2
KB17View
JAVABEAN
请求关键属性
HospUserView中的AKB020等
输出关键属性
KB17View
HospUserView需传入以下值：
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
返回（KB17View）中信息：
序号
需要信息
信息说明
数据类型
1
AKB020
服务机构编号
varchar
2
BKB026
密码（加密）
varchar
3
BKB027
用户许可数（加密）
varchar
4
BKB028
许可证号
varchar
5
BKB029
发证日起
varchar
6
BKB030
有效日期
varchar
7
BKB031
收费金额
varchar
8
BKB032
结算软件维护员
varchar
9
BKB033
维护员电话
varchar
10
BKB034
结算软件版本类型
varchar
11
BKB035
结算软件注册标志
varchar
12
BKB036
结算软件最近签到日期
varchar
16
BKB043
软件发布版本号
varchar
医院基本信息查询
接口命名
findKB01Info
描述
查询定点医疗机构信息
医院端处理
传入医院编号查询定点医疗机构信息
接口处理
查询定点医疗机构信息
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
akb020
String
out
3
KB01View
JAVABEAN
请求关键属性
HospUserView中的AKB020等；aka020（即服务机构编号）;
输出关键属性
KB01View中全部属性
HospUserView需传入以下值：
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
输出关键属性
KB01View中全部属性
指标体系下载
接口命名
downLoadCode
描述
下载指标体系代码
医院端处理
传入条件查询出指标并保存
接口处理
查询指标体系
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
HisParmDLView
JAVABEAN
out
3
CodeView[]
JAVABEAN[]
请求关键属性
HospUserView中的AKB020等；HisParmDLView中全部属性
输出关键属性
CodeView中全部属性
HospUserView需传入以下值：
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
HisParmDLView需传入以下值：
序号
需要信息
信息说明
数据类型
备注
1
LastChgDate
最后版本操作时间
varchar
系统时间
2
LastChgUser
最后版本操作用户
varchar
3
ParmName
参数名称
varchar
代码
4
ParmType
参数类型
varchar
001
Ø返回数据定义：
返回CodeView中主要信息：
序号
需要信息
信息说明
数据类型
1
codeType
代码名称
varchar
2
value
代码值
varchar
3
Name
代码描述
varchar
数据库升级信息下载
接口命名
findDataUpdateInfo
描述
数据库升级
医院端处理
传入条件查询出数据库升级信息
接口处理
查询数据库升级信息
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
KB20View[]
JAVABEAN[]
out
3
KB20View[]
JAVABEAN[]
请求关键属性
HospUserView中的AKB020等；KB20View中的BKB051
输出关键属性
KB20View中全部属性
HospUserView需传入以下值
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
KB20View需传入以下值
序号
需要信息
信息说明
数据类型
备注
1
BKB051
数据库版本号（取自增流水号）
int
Ø返回数据定义：
返回（KB20View）中信息：
序号
需要信息
信息说明
数据类型
1
BKB051
数据库版本号
varchar
2
AKB020
服务机构编号
varchar
3
BKB052
升级更新脚本
varchar
4
AAE011
发布人
varchar
5
AAE036
发布时间
varchar
6
BKB053
发布升级原因
varchar
7
BKB054
升级操作人（结算软件端必填数据）
varchar
8
BKB055
升级时间（结算软件端必填数据）
varchar
数据库升级执行结果上传
接口命名
uploadDataUpdateResult
描述
数据库升级后的结果上传到中心端
医院端处理
传入条件查询出数据库升级信息并保存
接口处理
保存数据库升级信息
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
KB21View[]
JAVABEAN[]
请求关键属性
HospUserView中的AKB020等；KB21View中的全部信息
输出关键属性
HospUserView需传入以下值
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
KB21View需传入以下值
序号
需要信息
信息说明
数据类型
长度
备注
1
BKB051
数据库版本号（取自增流水号）
int
2
AKB020
医疗机构编号
varchar
8
3
BKB056
执行结果
varchar
3
1成功，2失败
4
BKB057
错误信息
varchar
500
5
BKB054
升级操作人（结算软件端必填数据）
varchar
10
6
BKB055
升级时间（结算软件端必填数据）
varchar
19
读取医保卡信息
接口命名
根据实际要求自定义读卡方法名称
描述
将ActiveFormProj1.ocx文件引入工程
医院端处理
将返回的医保卡号进行保存。
接口处理
实例：
publicvoidReadCard（refReturnValuereturnValue）
{
ActiveFormProj1.ActiveFormXobj=newActiveFormProj1..ActiveFormX（）;
try
{
//打开卡机端口
obj.cardComCreate
（1）;
//获得卡机状态
intcardStateIndex=obj.getCardState（）;
if（cardStateIndex==0||cardStateIndex==4）
{
returnValue.ErrorFlag=0;
returnValue.ErrorMsg=obj.cardread（）;
}
else
{
If（cardStateIndex==7）
{
returnValue.ErrorMsg=“无法打开端口”;
}
elseif（cardStateIndex==6）
{
returnValue.ErrorMsg=“无法识别的卡”;
}
elseif（cardStateIndex==5）
{
returnValue.ErrorMsg=“该卡是新卡”;
}
elseif（cardStateIndex==1）
{
returnValue.ErrorMsg=“卡片没有放好”;
}
.returnValue.ErrorFlag=-1;
}
}
catch（Exceptionex）
{
returnValue.ErrorFlag=-1;
returnValue.ErrorMsg=ex.Message;
}
Finally
{
obj.cardComDestroy（）;
}
returnreturnValue;
}
目录管理
药品目录下载
接口命名
downLoadLeechdom
描述
下载医保药品目录
医院端处理
传入需要的条件查询出医保药品目录并保存
接口处理
查询出医保药品目录
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
HisParmDLView
JAVABEAN
out
3
KA02View[]
JAVABEAN[]
请求关键属性
HospUserView中的AKB020等；HisParmDLView中全部属性
输出关键属性
KA02View中全部属性
HospUserView需传入以下值：
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
HisParmDLView需传入以下值：
序号
需要信息
信息说明
数据类型
备注
1
LastChgDate
最后版本操作时间
varchar
系统时间
2
LastChgUser
最后版本操作用户
varchar
3
ParmName
参数名称
varchar
传入值：
医保药品目录
4
ParmType
参数类型
varchar
传入值：
002
5
startRowNum
开始记录数
Int
开始下载的记录数，默认0
6
rows
记录数
Int
当返回数小于rows说明已经下载完毕
Ø返回数据定义：
返回KA02View中信息
序号
需要信息
信息说明
数据类型（长度）
备注
1
AKA060
药品编码
varchar
2
AKA061
中文名称
varchar
3
AKA062
英文名称
varchar
4
AKA063
收费类别
varchar
01西药，02中药，03草药，04诊查费，08治疗费，09化验费，10手术费，13血费，17床位费，19护理费，20检查费，21调温费，22特殊材料费，24其他费，30挂号费
5
BKA246
一级目录类别
varchar
可查询字典表jwhat_dd_static_code
6
BKA247
二级目录类别
varchar
可查询字典表jwhat_dd_static_code
7
BKA260
三级目录类别
varchar
可查询字典表jwhat_dd_static_code
8
AKA064
处方药标志
varchar
0非处方药，1处方药
9
AKA065
收费项目等级
varchar
1甲类，2乙类，3丙类，4乙类（50）
10
AKA066
助记码
varchar
11
AKA067
单位
varchar
12
AKA068
标准价格
double（15,5）
13
AKA070
剂型
varchar
14
AKA071
每次用量
double（15,2）
15
AKA072
使用频次
varchar
16
AKA073
用法
varchar
17
AKA074
规格
varchar
18
AKA215
限制类用药标志
varchar
1普通，2限制类用药
19
AAE013
备注
varchar
20
AAE011
经办人
varchar
21
AAE036
经办日期
varchar
22
BAA001
数据分区编号
varchar
23
AAE100
当前有效标志
varchar
0无效，1有效
24
BKA001
三大目录使用范围
varchar
25
BKA152
药品编码（卫生系统使用）
varchar
26
BKA151
常用名
varchar
27
BAE031
版本号
varchar
28
AKE004
生产地类别
varchar
29
AKA022
医疗使用标志
varchar
1是，2否
30
AMA011
生育使用标志
varchar
1是，2否
31
AKA109
药品生产企业
varchar
药品目录对应申请上传
接口命名
upLoadLeechdomMap
描述
医院端上传对应的医保药品目录
医院端处理
传入医保药品目录
接口处理
保存医院端上传的医保药品目录
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
KB05View[]
JAVABEAN[]
in
3
KA17View[]
JAVABEAN[]
请求关键属性
HospUserView中的AKB020等；KB05View中全部属性；KA17View中全部属性
输出关键属性
HospUserView需传入以下值
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
5
baa001
数据分区编码
varchar
KB05View需传入以下值
序号
需要信息
信息说明
数据类型
最大长度
备注
1
AKB020
服务机构编号
Varchar
8
2
AKA060
药品编码
varchar
20
3
AKA061
中文名称
varchar
255
4
AKA062
英文名称
varchar
255
5
AKA066
助记码
varchar
50
6
AKB120
单价
double
15,5
7
AKA070
剂型
varchar
50
8
AKA071
每次用量
double
9,0
9
AKA074
规格
varchar
50
10
AAE013
备注
varchar
100
11
AKA224
上传时间
varchar
19
12
AKA109
药品生产企业
varchar
200
KA17View需传入以下值
序号
需要信息
信息说明
数据类型
最大长度
备注
1
BKA261
医保三大目录项目编码
varchar
20
2
BKA263
（医保）目录名称
varchar
3
BKA262
医院三大目录项目编码
varchar
20
4
BKA264
目录名称（医院目录商品名）
varchar
5
AKA213
目录类别
varchar
3
1：
药品，2：
诊疗项目，3：
服务设施
6
AKC175
审批标志
varchar
3
0：
未复核，1：
已复核，3：
未通过
7
AAE011
经办人
varchar
10
8
AAE036
经办日期
varchar
19
9
BAA001
数据分区编号
varchar
10
10
AKA221
下载标志
varchar
3
0未下载，1已下载
11
AKA223
下载时间
varchar
19
12
BKC067
上传状态标志
varchar
3
0:
等待上传,1:
上传成功,2:
上传失败
13
AKA224
上传时间
varchar
14
AAE073
目录对应流水号
int
15
AKB020
服务机构编号
varchar
8
16
AKA220
目录对应拒绝原因
varchar
3
1价格不符，2内容不符，3其他
17
AAE140
险种类型
varchar
3
10:
大额医疗补助，3：
城镇职工基本医疗保险，390：
城镇居民基本医疗保险，4：
工伤保险，5：
生育保险
诊疗目录下载
接口命名
downLoadDiagnosis
描述
下载诊疗目录
医院端处理
传入需要的条件查询出诊疗目录并保存
接口处理
查询出诊疗目录
参数
类型
编号
名称
类型
in
1
HospUserView
JAVABEAN
in
2
HisParmDLView
JAVABEAN
out
3
KA03View[]
JAVABEAN[]
请求关键属性
HospUserView中的AKB020等；HisParmDLView中全部属性
输出关键属性
KA03View中全部属性
HospUserView需传入以下值
序号
需要信息
信息说明
数据类型
1
BKB034
结算软件版本类型
varchar
2
VERSION
版本号
varchar
3
AKB020
服务机构编号
varchar
4
BKB026
密码
varchar
HisParmDLView需传入以下值
序号
需要信息
信息说明
数据类型
备注
1
LastChgDate
最后版本操作时间
varchar
系统时间
2
LastChgUser
最后版本操作用户
varchar
3
ParmName
参数名称
varchar
医保诊疗项目信息
4
ParmType
参数类型
varchar
003
5
startRowNum
开始记录数
Int
开始下载的记录数，默认0
6
rows
记录数
Int
当返回数小于rows说明已经下载完毕
Ø返回数据定义：
返回KA03View中信息：
序号
需要信息
信息说明
数据类型（长度）
备注
1
AKA090
项目编码
varchar
2
AKA101
医院等级
varchar
2省级，5市级，8县级，13定点药店，14乡镇卫生院，15社区
3
AKA091
项目名称
varchar
4
AKA063
收费类别
varchar
数据字典表中可查询
5
AKA065
收费项目等级
varchar
1甲类，2乙类，3丙类，4乙类（50）
6
BKA246
一级目录类别
varchar
数据字典表中可查询
7
BKA247
二级目录类别
varchar
数据字典表中可查询
8
BKA260
三级目录类别
varchar
数据字典表中可查询
9
BKA001
三大目录使用范围
varchar
10
AKA066
助记码
varchar
11
AKA06
升级会员 