梅河口市社会医疗保险管理系统医院接口说明V13.docx
《梅河口市社会医疗保险管理系统医院接口说明V13.docx》由会员分享，可在线阅读，更多相关《梅河口市社会医疗保险管理系统医院接口说明V13.docx（176页珍藏版）》请在冰豆网上搜索。
梅河口市社会医疗保险管理系统医院接口说明V13
梅河口市社会医疗保险管理系统
定点机构就医结算服务接口
说明书
目录
修改记录1
第一章接口描述2
1.1结算端初始化2
1.1.1医疗机构注册2
1.1.2医院基本信息查询3
1.1.3指标体系下载3
1.1.4数据库升级信息下载4
1.1.5数据库升级执行结果上传5
1.1.6读取医保卡信息6
1.2目录管理7
1.2.1药品目录下载7
1.2.2药品目录对应申请上传9
1.2.3诊疗目录下载11
1.2.4诊疗项目目录对应申请上传12
1.2.5服务设施目录下载14
1.2.6服务设施目录对应申请上传16
1.2.7三大目录审核结果下载17
1.2.8病种代码下载19
1.2.9控制表信息下载20
1.2.10病种信息（国家标准）下载22
1.2.11医保中心通告信息下载23
1.3就医结算管理24
1.3.1读卡（IC卡加密字符串校验）24
1.3.2获取参保人员基本信息27
1.3.3查询就医信息29
1.3.4校验参保人员就诊资格29
1.3.5查询个人特殊病种备案信息列表30
1.3.6住院登记信息保存33
1.3.7登记信息修改35
1.3.8登记撤销（住院与门诊共用）36
1.3.9住院处方明细信息上传（废弃）39
1.3.10明细数据删除39
1.3.11住院费用计算39
1.3.12住院结算保存43
1.3.13住院结算撤销46
1.3.14处方明细对照目录上传（住院门诊共用）47
1.3.15门诊结算撤销（废弃）50
1.3.16门诊结算费用计算51
1.3.17门诊结算保存54
1.3.18特殊门诊结算撤销61
1.3.19交易验证（一卡通）61
1.4月度结算管理62
1.4.1就医登记下载62
1.4.2明细信息下载62
1.4.3普通住院结算审核信息下载63
kc21View需要传入的参数63
1.4.4门诊结算审核信息下载64
1.4.5取得门诊结算信息64
第二章参数说明68
2.1AC01View68
2.2CodeView68
2.3HisParmDLView68
2.4HisRequestView69
2.5HospitalCodeView70
2.6HospUserView70
2.7ICStatusView71
2.8KA02View71
2.9KA03View72
2.10KA04View73
2.11KA06View73
2.12KA07View74
2.13KA17View74
2.14KA20View75
2.15KA21View75
2.16KA23View75
2.17KA24View76
2.18KB01View76
2.19KB05View77
2.20KB06View78
2.21KB07View78
2.22KB16View78
2.23KB17View78
2.24KB20View79
2.25KB71View79
2.26KB72View80
2.27KC21View80
2.28KC22View82
2.29KC23View84
2.30KC30View84
2.31KC32View85
2.32KC38View87
修改记录
版本号
变更控制
报告编号
更改条款及内容
更改人
审批人
更改日期
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
下载标志
va
升级会员 