北京医疗保险信息系统医院端外挂接口规范.docx
《北京医疗保险信息系统医院端外挂接口规范.docx》由会员分享，可在线阅读，更多相关《北京医疗保险信息系统医院端外挂接口规范.docx（24页珍藏版）》请在冰豆网上搜索。
北京医疗保险信息系统医院端外挂接口规范
1、引言2
1.1编写目的2
2、外挂接口规范概述2
2.1接口模式2
2.3约定3
2.4数据接口内容：
3
2.5数据接口文件格式4
北京医疗保险信息系统医院端外挂接口规范
（草稿）
1、引言
1.1编写目的
《北京医疗保险信息系统医院端接口规范》自2001年11月份发布以来，在近一年的使用中发现部分HIS开发商在按其进行系统改造过程中进度缓慢。
为此，我们设计了北京医保系统医院端的外挂接口，并制定此外挂接口规范，以加速北京医疗保险改革的进行。
2、外挂接口规范概述
2.1接口模式
北京医保系统医院端外挂接口提供了一组软件模块，软件模块通过与医院HIS系统进行部分数据的交换，实现了北京医疗保险系统医院端业务的各项功能，包括医保目录对照、费用审核结算、医保票据打印、医保上传数据的生成、医保下载数据的接收、各种医保报表的生成等各项功能。
2.2应用环境
此外挂接口支持的应用环境有：
1.可支持Windows98、Windows2000等操作系统。
2.建议客户机配置为：
CPU为P
400以上、内存为64M以上、硬盘可用空间至少100M。
2.3约定
外挂接口与HIS系统交换的数据以文本文件的形式交换，文本文件中各字段间以“|”分隔，文本的一行对应一条数据，每行文本之间以换行符分隔。
示例：
●结尾字段为空的例子：
3||140150416010101|卡托普利片|0|0101|A01|12.500mg|片|2.4200|1|2.4200|20020412102122|
●结尾字段非空的例子：
3||140150416010101|卡托普利片|0|0101|A01|12.500mg|片|0.1125|1|0.1125|20020412|0
●中间字段为空的例子：
3|D123456||卡托普利片|0|||12.500mg|片|2.42|1|2.42|20020412|0
文件格式说明分为三部分：
“说明”部分、“文件名”部分和“文件格式”部分。
其中“文件格式”用表格来表示。
在“文件格式”表格的“说明”字段中，所有指定的标准请参照附录中“北京地方标准体系”；在“类型”字段中为Number的数据项，所对应“最大长度”字段中的前一个数字为数字位（不包括小数点）最大长度，后一个数字为小数位最大长度。
例如N（8,2）表明其整数位最大为6位，小数位最大为2位，即最大可为999999.99。
2.4数据接口内容：
Ø导入文件：
由HIS生成，导入到外挂接口中的文件。
Ø导出文件：
由外挂接口生成，从外挂接口导出的文件。
接口文件列表如下：
文件分类
文件名称
说明
导入文件
目录信息
yp.in
药品导入文件
sfxm.in
收费项目导入文件
费用信息
zyfy+住院病案号.in
住院费用导入文件，以病人为单位，每个病人每次住院生成一个住院费用导入文件，外挂接口支持追加导入。
zyjd+住院病案号.in
住院出院诊断信息导入文件，以病人为单位，每个病人每次住院生成一个住院出院诊断信息导入文件。
mzfy+收费流水号+姓名.in
门诊（特殊病）费用导入文件，以病人为单位，每个病人每次门诊生成一个门诊（特殊病）费用导入文件，外挂接口支持追加导入。
导出文件
结算信息
zyjs+住院病案号.out
住院结算信息导出文件，以病人为单位，对应每个住院费用导入文件生成一个住院结算信息导出文件，HIS拿到此文件后自行处理，医保不做强制要求。
mzjs+收费流水号+姓名.out
门诊（特殊病）结算信息导出文件，以病人为单位，对应每个门诊（特殊病）费用导入文件生成一个门诊（特殊病）结算信息导出文件，HIS拿到此文件后自行处理，医保不做强制要求。
预分解信息
zyfj+住院病案号.out
住院预分解信息导出文件，与住院结算信息导出文件内容完全相同，仅文件名前缀不同。
mzfj+收费流水号+姓名.out
门诊（特殊病）预分解信息导出文件，与门诊（特殊病）结算信息导出文件内容完全相同，仅文件名前缀不同。
2.5数据接口文件格式
2.5.1目录对照导入文件
1）药品导入文件
文件名：
yp.in
说明：
由HIS系统生成，将HIS系统的药品目录导入外挂接口。
序号
数据项
类型
最大长度
说明
1
HIS药品编码
VARCHAR
20
非空，不可重复
2
HIS药品名称
VARCHAR
100
非空
3
对照的医保药品编码
VARCHAR
20
HIS系统未做对照则为空 ,如果不为空，则外挂接口会将此对照关系予以继承。
4
规格
VARCHAR
20
可空
5
计量单位
VARCHAR
20
可空
6
价格
NUMBER
10,4
可空
2）收费项目导入文件
文件名：
sfxm.in
说明：
由HIS系统生成，将HIS系统的收费项目（非药品）导入外挂接口。
序号
数据项
类型
最大长度
说明
1
HIS项目编码
VARCHAR
10
非空，不可重复
2
HIS项目名称
VARCHAR
100
非空
3
对照的医保项目编码
VARCHAR
20
HIS系统未做对照则为空，,如果不为空，则外挂接口会将此对照关系予以继承。
4
计量单位
VARCHAR
20
可空
5
价格
NUMBER
10,4
可空
2.5.2费用信息导入文件
1）住院费用导入文件
文件名建议使用“zyfy+住院病案号.in”，系统默认会自动在交换目录中查找相应文件。
说明：
在医保病人出院结算前将病人费用由HIS系统导入外挂接口中，进行费用审核结算。
文件分两部分，第一行为本次交易说明信息，用来标识交易，格式为：
序号
数据项
类型
最大长度
说明
1
住院流水号
VARCHAR
20
非空（HIS中标识病人本次住院的流水号，可与病案号相同）
2
姓名
VARCHAR
20
非空
3
性别
VARCHAR
1
可空。
1-男,2-女,9-未知
4
身份证号
VARCHAR
18
可空
第二行起为病人费用信息，格式为：
序号
数据项
类型
最大长度
说明
1
项目序号
VARCHAR
9
流水号
2
HIS系统项目代码
VARCHAR
20
如不采用外挂接口中的目录对照则为空，否则非空
3
医保项目代码
VARCHAR
20
如采用了外挂接口中的目录对照则为空，否则非空
4
项目名称
VARCHAR
100
非空
5
项目类别
VARCHAR
3
非空;
如采用外挂接口中的目录对照则：
0-药品，1-非药品;
如不采用外挂接口中的目录对照，则：
0-药品，1-诊疗项目，2－服务设施;
8
收费类别
VARCHAR
4
如不采用外挂接口中的目录对照则非空，否则可空，参见标准AKA063
9
剂型
VARCHAR
3
可空，参见标准AKA070
10
规格
VARCHAR
40
可空
11
单位
VARCHAR
20
可空
12
单价
NUMBER
10,4
非空
13
数量
NUMBER
8,2
非空
14
金额
NUMBER
10,4
非空
15
费用发生时间
DATETIME
14
非空,格式为
”YYYYMMDDHHMMSS”
16
是否出院带药
VARCHAR
1
可空。
0-是，1-否。
默认为否
17
特需标识
VARCHAR
1
1-否（普通费用）
2-成人用（标识医保单病种及生育保险类住院费用按定额方式结算时应病人负责的本人用费用）
3-婴儿用（标识生育保险类住院费用按定额方式结算时需病人负担的婴儿费用）
2）住院出院诊断信息导入文件
文件名建议使用“zyjd+住院病案号.in”，系统默认会自动在交换目录中查找相应文件。
说明：
该文件记录住院患者出院时的诊断情况，包括病人出院时的科别、主要疾病诊断、手术名称、出院情况等基本信息。
需与住院费用导入文件中的信息通过住院流水号关联在一起，本导入文件不强制生成，当未生成此导入文件时，操作员需要在外挂接口中手工录入相关信息。
序号
数据项名称
类型
最大长度
说明
1
住院流水号
VARCHAR
20
HIS生成，与该病人住院费用导入文件中的住院流水号相同
2
出院科别编码
VARCHAR
4
出院科室名称，参见标准BKC053
3
主要诊断
VARCHAR
100
出院第一诊断
4
主要疾病编码
VARCHAR
20
出院第一诊断疾病编码，参见标准AKC196
5
手术名称
VARCHAR
100
手术名称，如有手术费用则手术名称应为必填项。
6
手术名称编码
VARCHAR
20
与手术名称对应的ICD—10—1999国际疾病分类
7
出院情况编码
VARCHAR
3
转归情况，参见标准AKC195
3）门诊（特殊病）费用导入文件
文件名建议使用“mzfy+收费流水号+姓名.in”，系统默认会自动在交换目录中查找相应文件。
说明：
在门诊（特殊病）病人结算前将病人费用由HIS系统导入外挂接口中，进行费用审核结算。
文件分两部分，第一行为本次交易说明信息，用来标识交易，格式为：
序号
数据项
类型
最大长度
说明
1
收费流水号
VARCHAR
20
非空。
如无收费流水号，可采用挂号流水号、门诊病案号等。
2
姓名
VARCHAR
20
非空
3
性别
VARCHAR
1
可空。
1-男,2-女,9-未知
4
身份证号
VARCHAR
18
可空
第二行起为病人费用信息，格式为：
序号
数据项
类型
最大长度
说明
1
项目序号
VARCHAR
9
流水号
2
HIS系统项目代码
VARCHAR
20
如不采用外挂接口中的目录对照则为空，否则非空
3
医保项目代码
VARCHAR
20
如采用了外挂接口中的目录对照则为空，否则非空
4
项目名称
VARCHAR
100
非空
5
项目类别
VARCHAR
3
非空
如采用外挂接口中的目录对照则：
0-药品，1-非药品;
如不采用外挂接口中的目录对照则：
0-药品，1-诊疗项目，2－服务设施;
8
收费类别
VARCHAR
4
如不采用外挂接口中的目录对照则非空，否则可空，参见标准AKA063
9
剂型
VARCHAR
3
可空，参见标准AKA070
10
规格
VARCHAR
40
可空
11
单位
VARCHAR
20
可空
12
单价
NUMBER
10,4
非空
13
数量
NUMBER
8,2
非空
14
金额
NUMBER
10,4
非空
15
费用发生时间
DATETIME
14
可空;对于普通门诊，以该时间作为交易发生时间，如为空，则以外挂接口实际结算时间为准;对于门诊特殊病，无论是否为空，均以外挂接口进行结算业务的时间为准。
2.5.3结算信息导出文件
1）住院结算信息导出文件
文件名为“zyjs+住院病案号.out”，外挂接口在住院结算后会自动在交换目录中生成该文件。
说明：
医保病人住院费用经外挂接口进行费用审核结算后将结算信息导出，HIS系统可导入此信息后在HIS系统内部进行结算。
首行：
住院费用的结算结果，HIS可据此与病人结算，具体格式：
序号
数据项
类型
最大长度
说明
1
住院流水号
VARCHAR
20
非空，与该病人住院费用导入文件中的住院流水号相对应。
2
姓名
VARCHAR
20
非空
3
性别
VARCHAR
1
可空。
1-男,2-女,9-未知
4
身份证号
VARCHAR
18
可空
5
费用总金额
NUMBER
8,2
非空
6
医保基金支付金额
NUMBER
8,2
非空
7
个人帐户支付金额
NUMBER
8,2
非空
8
现金支付金额
NUMBER
8,2
非空
次行：
住院费用分解的具体内容，便于医院与区县医保中心对帐进使用，具体格式：
序号
数据项
类型
最大长度
说明
1
费用总金额
NUMBER
8,2
2
普通门诊医保内费用
NUMBER
8,2
3
普通门诊医保外费用
NUMBER
8,2
4
统筹支付金额
NUMBER
8,2
5
统筹自付金额
NUMBER
8,2
6
大额/公务员支付金额
NUMBER
8,2
7
大额/公务员自付金额
NUMBER
8,2
8
个人应付总金额
NUMBER
8,2
9
个人自付二金额
NUMBER
8,2
乙类项目按比例个人负担部分
10
本次交易统筹封顶后医保内金额
NUMBER
8,2
2）门诊（特殊病）结算信息导出文件
文件名为“mzjs+收费流水号+姓名.out”，外挂接口在门诊特殊病结算后会自动在交换目录中生成该文件。
说明：
医保病人门诊特殊病费用经外挂接口进行费用审核结算后将结算信息导出，HIS系统可导入此信息后在HIS系统内部进行结算。
首行：
门特费用的结算结果，HIS可据此与病人结算，具体格式：
序号
数据项
类型
最大长度
说明
1
收费流水号
VARCHAR
20
非空。
与该病人门诊费用导入文件中的收费流水号相对应
2
姓名
VARCHAR
20
非空
3
性别
VARCHAR
1
可空。
1-男,2-女,9-未知
4
身份证号
VARCHAR
18
可空
5
费用总金额
NUMBER
8,2
非空
6
医保基金支付金额
NUMBER
8,2
非空
7
个人帐户支付金额
NUMBER
8,2
非空
8
现金支付金额
NUMBER
8,2
非空
次行：
门特费用分解的具体内容，便于医院与区县医保中心对帐进使用，具体格式：
序号
数据项
类型
最大长度
说明
1
费用总金额
NUMBER
8,2
2
普通门诊医保内费用
NUMBER
8,2
3
普通门诊医保外费用
NUMBER
8,2
4
统筹支付金额
NUMBER
8,2
5
统筹自付金额
NUMBER
8,2
6
大额/公务员支付金额
NUMBER
8,2
7
大额/公务员自付金额
NUMBER
8,2
8
个人应付总金额
NUMBER
8,2
9
个人自付二金额
NUMBER
8,2
乙类项目按比例个人负担部分
10
本次交易统筹封顶后医保内金额
NUMBER
8,2
2.5.4申请信息导出文件
1）医保病人申报信息导出文件
文件名为“qbxx_yb”+生成日期+“.out”，外挂接口在费用上传后可以按申报批次生成该文件。
说明：
定点医院在医保病人住院费用打包上传后，可将上传的申报信息导出，HIS系统可导入此信息后在HIS系统内部进行处理。
（普通离休病人的申报费用能过该接口导出）
序号
数据项
类型
最大长度
说明
1
报销地区编码
CHAR
4
非空
2
交易流水号
VARCHAR
20
非空
3
病案号
VARCHAR
15
非空
4
入院日期
DATE
8
非空
5
姓名
VARCHAR
20
非空
6
参保人员类别
VARCHAR
50
非空
7
公民身份号码
VARCHAR
18
可空
8
医保手册号
VARCHAR
12
非空
9
费用总金额
NUMBER
10,2
非空
10
医保范围内
NUMBER
10,2
非空
11
医保范围外
NUMBER
10,2
非空
12
床位费
NUMBER
10，2
非空
13
西药费
NUMBER
10，2
非空
14
中药费
NUMBER
10，2
非空
15
检查治疗费
NUMBER
10，2
非空
16
其它费用
NUMBER
10，2
非空
17
统筹基金支付费用
NUMBER
10，2
非空
18
个人帐户支付费用
NUMBER
10，2
非空
19
公务员医疗补助支付费用
NUMBER
10，2
非空
20
大额支付费用
NUMBER
10，2
非空
21
个人自付自费费用
NUMBER
10，2
非空
22
基金差
NUMBER
10，2
非空
9=10+11=12+13+14+15+16=17+18+19+20+21+22
2）生育病人申报信息导出文件
文件名为“qbxx_sy”+生成日期+“.out”，外挂接口在费用上传后可以按申报批次生成该文件。
说明：
定点医院在生育保险参保病人住院费用打包上传后，可将上传的申报信息导出，HIS系统可导入此信息后在HIS系统内部进行处理。
序号
数据项
类型
最大长度
说明
1
报销地区编码
CHAR
4
非空
2
交易流水号
VARCHAR
20
非空
3
病案号
VARCHAR
15
非空
4
入院日期
DATE
8
非空
5
姓名
VARCHAR
20
非空
6
公民身份号码
VARCHAR
18
可空
7
医保手册号
VARCHAR
12
非空
8
缴费区县
VARCHAR
50
非空
9
费用总金额
NUMBER
10,2
非空
10
床位费
NUMBER
10，2
非空
11
西药费
NUMBER
10，2
非空
12
中药费
NUMBER
10，2
非空
13
检查治疗费
NUMBER
10，2
非空
14
材料费
NUMBER
10，2
非空
15
其它费用
NUMBER
10，2
非空
16
生育保险基金支付费用
NUMBER
10，2
非空
17
个人自费费用
NUMBER
10，2
非空
18
基金差
NUMBER
10，2
非空
字段间关系：
9=10+11+12+13+14+15=16+17+18
3）公疗病人申报信息导出文件
文件名为“qbxx_gl”+生成日期+“.out”，外挂接口在费用上传后可以按申报批次生成该文件。
说明：
定点医院在公费医疗病人住院费用打包上传后，可将上传的申报信息导出，HIS系统可导入此信息后在HIS系统内部进行处理。
序号
数据项
类型
最大长度
说明
1
报销地区编码
CHAR
4
非空
2
交易流水号
VARCHAR
20
非空
3
病案号
VARCHAR
15
非空
4
入院日期
DATE
8
非空
5
姓名
VARCHAR
20
非空
6
医照人员类别
VARCHAR
20
非空
7
公民身份号码
VARCHAR
18
可空
8
就医凭证号
VARCHAR
12
非空
9
费用总金额
NUMBER
10,2
非空
10
公费范围内
NUMBER
10，2
非空
11
公费范围外
NUMBER
10，2
非空
12
床位费
NUMBER
10，2
非空
13
西药费
NUMBER
10，2
非空
14
中药费
NUMBER
10，2
非空
15
检查治疗费
NUMBER
10，2
非空
16
其它费用
NUMBER
10，2
非空
17
公费医疗支付
NUMBER
10，2
非空
18
自付费用
NUMBER
10，2
非空
字段间关系：
9=10+11=12+13+14+15+16=17+18
2.5.5
预分解信息导出文件
为方便医院和HIS系统在正式结算前了解病人的费用分解情况，外挂接口在分解后可生成预分解信息导出文件。
1）住院预分解信息导出文件
文件名为“zyfj+住院病案号.out”。
说明：
医保病人住院费用经外挂接口进行费用分解后将分解信息导出，HIS系统可导入此信息后在HIS系统内部进行处理。
首行：
住院费用的结算结果，HIS可据此与病人结算，具体格式：
序号
数据项
类型
最大长度
说明
1
住院流水号
VARCHAR
20
非空，与该病人住院费用导入文件中的住院流水号相对应
2
姓名
VARCHAR
20
非空
3
性别
VARCHAR
1
可空。
1-男,2-女,9-未知
4
身份证号
VARCHAR
18
可空
5
费用总金额
NUMBER
8,2
非空
6
医保基金支付金额
NUMBER
8,2
非空
7
个人帐户支付金额
NUMBER
8,2
非空
8
现金支付金额
NUMBER
8,2
非空
次行：
住院费用分解的具体内容，医院可据此了解医保基金的垫付内容，，具体格式：
序号
数据项
类型
最大长度
说明
1
费用总金额
NUMBER
8,2
2
普通门诊医保内费用
NUMBER
8,2
3
普通门诊医保外费用
NUMBER
8,2
4
统筹支付金额
NUMBER
8,2
5
统筹自付金额
NUMBER
8,2
6
大额/公务员支付金额
NUMBER
8,2
7
大额/公务员自付金额
NUMBER
8,2
8
个人应付总金额
NUMBER
8,2
9
个人自付二金额
NUMBER
8,2
乙类项目按比例个人负担部分
10
本次交易统筹封顶后医保内金额
NUMBER
8,2
2）门诊（特殊病）预分解信息导出文件
文件名为“mzfj+收费流水号+姓名.out”，外挂接口在门诊特殊病结算后会自动在交换目录中生成该文件。
说明：
医保病人门诊特殊病费用经外挂接口进行费用审核结算后将结算信息导出，HIS系统可导入此信息后在HIS系统内部进行结算：
首行：
门特费用的结算结果，HIS可据此与病人结算，具体格式：
序号
升级会员 