更新福建省新农合医院信息系统接口技术规范1.docx
《更新福建省新农合医院信息系统接口技术规范1.docx》由会员分享,可在线阅读,更多相关《更新福建省新农合医院信息系统接口技术规范1.docx(29页珍藏版)》请在冰豆网上搜索。
更新福建省新农合医院信息系统接口技术规范1
福建省新农合医院信息系统医院接口技术规范
2008年9月
版本
时间
作者
说明
V1.1
2009-12-18
江秋
蓝色字样为本次修改内容
一、接口设计主体思路:
采用文本文件交换信息的方式,每个业务接口主要步骤均为:
医院程序删除应答文件(如果存在),提交一个请求文件,医保程序检测到后自动解释,生成一个回答文件,并删除原来的请求文件,医院程序检测到应答文件生成后就去读取医保程序返回的信息。
文件的结构主要借鉴Windows系统通用的信息文件格式(*.ini)。
为安全起见,每一个涉及收费的接口均需校验卡号。
为方便起见,对交换文件不进行加密处理,采用文本文件。
为了全省数据的一致性,病种编码,发票项目编码、药品项目和诊疗项目编码将统一标准。
注:
如果医保政策或实施细则有变化,本规范将作相应调整。
二、医院程序设计注意事项:
1.发出请求前,应当删除应答文件;
(否则医保程序将不会响应应答文件。
)
2.发出请求文件时,填写request字段的内容应填写完参数后进行;
(最好采用独占方式(LOCKREADWRITE!
)打开文件,一次性写完后关闭。
)
3.检测应答文件时,应当等到应答文件的reply=TRUE时,方可进行读取工作。
4.写文件时,如用powerbuilder编程,不要用setprofilestring函数进行文件操作,必须使用fileopen,fileclose,filewrite,fileread等函数。
5.读结果文件时,可以和发送的信息进行一些简单的校验(例如接口发送和接收的处方数目,明细,总金额等是否一致等),保证程序正确运行。
三、各个具体业务的接口文件结构:
如无特殊说明,以下提及的各个文件均放在医保安装目录(缺省为C:
\medicare\hospital)
下的sfjk目录下。
请求文件名为:
request.txt接口返回的文件名为:
reply.txt
请求和应答文件中英文字段意义说明:
(C代表字符类型N代表数值类型N5,2代表取值0.00到999.99)(字段意义如文件中另有说明的除外)
文件中字段名字
位数或取值范围
字段意义
Request
TRUEorFALSE
各种业务接口请求文件的开始请求标志;=TRUE时表示请求文件可以开始被读取
Reply
TRUEorFALSE
各种业务接口返回文件的回答标志;=TRUE时表示应答文件可以开始读取
Success
TRUEorFALSE
操作结果成功否
Error
VarChar2(400)
操作失败原因
Cardno
C18
医保IC卡号
Id0000
C19
医疗保险号
Xming0
C8
姓名
Xbie00
C10男1女可能为空
性别
Brnl00
N3
年龄
Dwmc00
C30
单位名称
Icztmc
C20
IC卡状态名称
Gzztmc
C30
工作状态名称
Dqmc00
C20
投保人所属地区名称
Fzxmc0
C20
投保人所属分中心名称
Ghksmc
C10
挂号科室名称
Ghfy00
N5,2
挂号费用
Ghlsh0
C18
挂号流水号
Ghrq00
C8
挂号日期
Ghsj00
C4
挂号时间
Cxlsh0
C18
冲销流水号
Grzhye
N8,2
个人帐户余额
Bqbm00
C20
病种编码
Cfxms0
N3
收费项目数
Djlsh0
C18
单据流水号
Mzlsh0
C18
门诊流水号
Bckbcs
N3
本次看病次数(即视同住院次数)
Sftsmz
C1Y是N否
是否特殊门诊
Sftsbz
C1
是否特殊病种
Zhzfe0
N8,2
帐户支付额
Grzfe0
N8,2
个人现金支付额
Jjzfe0
N8,2
基金支付额
Bcbxf0
N8,2
总费用
Sfrq00
C8
收费日期
Sfsj00
C4
收费时间
Sfrxm0
C8
收费人姓名
Cxdjh0
C18
冲销单据号
Ryrq00
C8
入院日期
Rysj00
C4
入院时间
Ryksmc
C10
入院科室名称
Rylb00
C8’普通’或’家庭病床’
住院类别
Zylsh0
C18
入院登记流水号
Rydjr0
C8
入院登记人
Zyksmc
C10
住院科室名称
Cydjr0
C8
出院登记人
Cyrq00
C8
出院日期
Cysj00
C4
出院时间
Valid0
TrueorFalse
是否可以入院登记或是否可以挂号
Bnghyy
Varchar2(400)
病人不能挂号原因
Bndjyy
Varchar2(400)
病人不能入院登记原因
无
C20
<<处方明细信息>>中医院收费项目在医保中心的编号
无
C1YorN
<<处方明细信息>>中是否医保项目
无
C20
<<处方明细信息>>中医院收费项目在医保中心的发票项目名称
无
C50
<<处方明细信息>>中医院收费项目在医保中心的名称
无
C20
<<处方明细信息>>中医院收费项目在医保中心的规格
无
C20
<<处方明细信息>>中医院收费项目在医保中心的单位
无
N10,4
<<处方明细信息>>中医院收费项目在医保中心的单价
无
N8,2
<<处方明细信息>>中数量
无
N8,2
<<处方明细信息>>中金额
无
C8
<<处方明细信息>>中医生姓名
无
N5,4
<<处方明细信息>>中个人自付比例
bcyljz
N8,2
民政救助总额
jsjzze
N8,2
计生救助总额
cljzze
N8,2
残联救助总额
yy_xming0
C20
病人姓名
yy_djlsh0
C16
医院_单据流水号
mzlx00
C1
P-普通门诊T-特殊门诊
cslx00
C1
传送类型M-传明细S-实时结算,不设置,接口按照系统设置的传送类型进行结算
注意:
1、jjzfe0是指新农合补偿金额+民政救助总额+计生救助总额+残联救助总额,
新农合补偿金额:
基金支付额-民政救助总额-计生救助总额-残联救助总额,bcyljz是指民政救助总额,jsjzze是指计生救助总额,cljzze是指残联救助总额,实时结算模式,医院垫付金额=新农合补偿金额+民政救助总额+计生救助总额+残联救助总额。
2、处方明细信息增加收费日期(sfrq00),用于传送每条处方明细的收费日期。
四、《特殊病种编码表》
00000001
结核病门诊初治涂阳病人
00000002
结核病门诊初治涂阴病人
00000003
恶性肿瘤门诊化疗和放疗
00000004
尿毒症透析
00000005
器官移植抗排斥反应
00000006
糖尿病
00000007
脑中风
00000008
精神分裂症
00000009
心脑血管病
00000010
结核病规范治疗
00000011
再生障碍性贫血
00000012
系统性红斑狼疮
00000013
高血压病
00000014
结核病门诊复治涂阳病人
00000015
结核病门诊复治涂阴病人
00000016
癫痫病
00000017
慢性心功能不全
00000018
高血压并发心,脑,肾疾病
00000019
危重病的抢救
00000020
慢性心功能衰竭
00000021
先天性无丙种球蛋白血症
00000022
结核病辅助治疗
00000023
儿童听力障碍(干预)
00000024
苯丙酮尿症(食疗)
00000025
血友病
00000026
支气管哮喘
00000027
白血病
00000028
甲状腺功能亢进
00000029
重症肌无力
00000030
类风湿关节炎
00000031
强直性脊柱炎
00000032
肺结核
00000033
骨折中医手法复位
00000034
基本药品目录内中草药饮片治疗
00000035
慢性肾炎
00000036
肝硬化
00000037
脑卒中及后遗症
注1:
接口应答文件返回时如有参保人信息,都有参保人的各种信息如:
姓名、性别、年龄、单位、ic卡状态、工作状态、个人账户余额、地区、分中心等;下面的接口说明均以“<<参保人其他信息>>”字样代表:
xming0=
xbie00=
brnl00=
dwmc00=
icztmc=
gzztmc=
grzhye=
dqmc00=
fzxmc0=
注2:
接口应答文件返回时如有处方明细信息,都有收费项目的各种信息如:
名称、规格等;下面的接口说明均以“<<处方明细信息>>”字样代表:
医院收费项目在医保中心的编号
是否医保项目
医院收费项目在医保中心的发票项目名称
医院收费项目在医保中心的名称
医院收费项目在医保中心的规格
医院收费项目在医保中心的单位
医院收费项目在医保中心的单价
数量
金额
医生姓名
此外,接口返回的收费文件的<<处方明细信息>>除有以上信息外,还增加一行信息,为医院收费项目在医保中心的个人自付比例(0到1)。
注3:
返回文件中的发票项目均分解到[yb0000]和[fyb000]两个小节中,分别代表按政策医保项目费用和按政策规定个人自付项目费用。
注4:
各医院HIS系统必须要有以下规范的独立请求模块。
◆门诊挂号:
1.医院程序形成"读卡请求"文件:
[mzghsk]
request=TRUE
cardno=
yy_xming0=
医保程序接受请求后将填写结果文件,并将原来的请求文件删除,此时医院程序检测到应答文件生成后(文件中reply=TRUE),就可以读取结果文件,读取完后将结果文件删除后,才可以发出下一个请求。
(以下各个接口也须照此处理)
[mzghsk]
reply=TRUE
success=
error=
cardno=
id0000=
;病人是否可以门诊挂号(TRUEorFALSE)
valid0=
;病人不能挂号原因
bnghyy=
医院程序读取"读卡结果"文件,如果读卡正常,且允许挂号,则录入挂号科室,挂号费,然后进行下一步请求。
2.医院程序形成"挂号提交请求"文件,内容如下:
[mzgh]
request=TRUE
success=
error=
cardno=
ghksmc=
ghfy00=
;医院门诊挂号流水号
yy_ghlsh0=
yy_xming0=
mzlx00=;注释:
P-普通门诊T-特殊门诊
bqbm00=;如果是特殊门诊,必须传特殊病种编码,特殊病种编码参看《特殊病种编码表》
cslx00=
医保程序接受请求后并生成结果文件,内容如下:
[mzgh]
reply=TRUE
success=
error=
cardno=
ghlsh0=
ghrq00=
ghsj00=
ghksmc=
ghfy00=
id0000=
<<参保人其他信息>>
;病人是否可以门诊挂号(TRUEorFALSE)
valid0=
;病人不能挂号原因
bnghyy=
注:
本步骤医保程序仍需读卡并校验卡号是否与请求文件中的卡号一致,
所以投保人的IC卡必须放在读卡机内。
◆门诊挂号冲销:
医院程序形成"挂号冲销请求"文件,内容如下:
[mzghcx]
request=TRUE
cardno=
ghlsh0=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[mzghcx]
reply=TRUE
success=
error=
cardno=
ghlsh0=
cxlsh0=
;冲销挂号日期
ghrq00=
;冲销挂号时间
ghsj00=
ghksmc=
ghfy00=
id0000=
<<参保人其他信息>>
◆门诊收费
1.医院程序形成"读卡请求"文件,内容如下:
[mzsfsk]
request=TRUE
cardno=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[mzsfsk]
reply=TRUE
success=
error=
cardno=
id0000=
;挂号科室(如有多个用;隔开)
ghksmc=
.
.
2.医院程序形成"门诊收费请求"文件
内容:
请求,IC卡号,门诊流水号,病情编码,处方数,各个发票项目金额,
处方项目明细,包括(编号、发票项目编号、名称、规格、单位、
单价、数量、金额、医生姓名)
[mzsf]
request=TRUE
success=
error=
cardno=
mzlsh0=
bqbm00=
cfxms0=
;医院门诊收费单据号
yy_djlsh0=
mzlx00=;门诊类型是特殊门诊的,bqbm00必须是《特殊病情编码表》中的编码
;各个发票项目费用,分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb0000]
西药费=
成药费=
.
.
.
;处方明细(如cfxms0>0)
[mzsfmx]
;按<<处方明细信息>>说明中的顺序排列,每项内容占一行,一个处方项目共10行
<<处方明细信息>>
.
.
.
医保程序接受请求后并生成结果文件,内容如下:
[mzsf]
reply=TRUE
success=
error=
djlsh0=
mzlsh0=
id0000=
cardno=
xming0=
xbie00=
brnl00=
bckbcs=
ghksmc=
bqbm00=
sftsmz=
sftsbz=
zhzfe0=
grzfe0=
jjzfe0=
bcbxf0=
sfrq00=
sfsj00=
sfrxm0=
cfxms0=
bcyljz=
jsjzze=
cljzze=
;各个发票项目费用,分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb0000]
西药费=
成药费=
.
.
.
;明细(可能没有,如cfxms0为零)
[mzsfmx]
;按<<处方明细信息>>说明中的顺序排列,每项内容占一行,一个处方项目共11行
<<处方明细信息>>
.
.
.
◆门诊收费冲销
医院程序形成"门诊收费冲销请求"文件,内容如下:
[mzsfcx]
request=TRUE
cardno=
cxdjh0=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[mzsfcx]
reply=TRUE
success=
error=
;单据号
djlsh0=
;被冲销的单据号
cxdjh0=
mzlsh0=
id0000=
cadno=
xming0=
xbie00=
brnl00=
bckbcs=
ghksmc=
bqbm00=
sftsmz=
sftsbz=
zhzfe0=
grzfe0=
jjzfe0=
bcbxf0=
sfrq00=
sfsj00=
sfrxm0=
cfxms0=
bcyljz=
jsjzze=
cljzze=
;各个发票项目费用,分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb0000]
西药费=
成药费=
.
.
.
;明细(可能没有,如cfxms0为零)
[mzsfmx]
;按<<处方明细信息>>说明中的顺序排列,每项内容占一行,一个处方项目共11行
<<处方明细信息>>
.
.
.
◆住院登记
1.医院程序形成"读卡请求"文件:
[rydjsk]
request=TRUE
cardno=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[rydjsk]
reply=TRUE
success=
error=
cardno=
id0000=
<<参保人其他信息>>
;可否入院登记(TRUEORFALSE)
valid0=
;不能入院登记原因
bndjyy=
医院程序读取"读卡结果"文件,如果读卡正常,且允许登记,
则录入科室,住院类别,住院日期,然后进行下一步请求。
2.医院程序形成"入院登记提交请求"文件
内容:
请求,IC卡号,入院日期,科室名称,住院类别(普通或家庭病床)
[rydj]
request=TRUE
success=
error=
cardno=
ryrq00=
rysj00=
ryksmc=
rylb00=
;医院系统的住院流水号
yy_zylsh0=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[rydj]
reply=TRUE
success=
error=
cardno=
zylsh0=
bckbcs=
ryrq00=
rysj00=
ryksmc=
rylb00=
id0000=
<<参保人其他信息>>
;可否入院登记(TRUEorFALSE)
valid0=
;不能入院登记原因
bndjyy=
rydjr0=
◆取消入院登记
医院程序形成"冲销请求"文件
内容:
请求,IC卡号,住院流水号
[rydjcx]
request=TRUE
cardno=
;要冲销的住院流水号
cxlsh0=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[rydjcx]
reply=TRUE
success=
error=
cardno=
;冲销流水号
zylsh0=
;被冲销的住院号
cxlsh0=
bckbcs=
ryrq00=
rqsj00=
ryksmc=
rylb00=
id0000=
<<参保人其他信息>>
rydjr0=
◆住院收费
1.医院程序形成"读卡请求"文件,内容如下:
[zysfsk]
request=TRUE
cardno=
yy_xming0=
医保程序接受请求后并生成结果文件,内容如下:
[zysfsk]
reply=TRUE
success=
error=
cardno=
id0000=
<<参保人其他信息>>
zylsh0=
zyksmc=
;发票项目编码(编号;名称)
[fpxmbm]
;如以下
01;西药费
02;成药费
.
.
.
2.医院程序形成"住院收费请求"文件
内容:
请求,IC卡号,住院流水号,病情编码,普通病床天数,传染病床天数,
处方数,各个发票项目金额,处方项目明细,包括(编号、发票项目
编号、名称、规格、单位、单价、数量、金额、医生姓名)
[zysf]
request=TRUE
success=
error=
cardno=
zylsh0=
bqbm00=
;普通病床天数
ptbcts=
;传染病床天数
crbcts=
cfxms0=
;医院系统住院收费单据号
yy_djlsh0=
yy_xming0=
cslx00=
;各个发票项目费用,分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb0000]
西药费=
成药费=
.
.
.
;处方明细(如cfxms0>0)
[zysfmx]
;按<<处方明细信息>>说明中的顺序排列,每项内容占一行,一个处方项目共11行
<<处方明细信息>>
医保程序接受请求后并生成结果文件,内容如下:
[zysf]
reply=TRUE
success=
error=
djlsh0=
zylsh0=
id0000=
cardno=
xming0=
xbie00=
brnl00=
bckbcs=
zyksmc=
bqbm00=
sftsbz=
;普通病床天数
ptbcts=
;传染病床天数
crbcts=
zhzfe0=
grzfe0=
jjzfe0=
bcbxf0=
sfrq00=
sfsj00=
sfrxm0=
cfxms0=
bcyljz=
jsjzze=
cljzze=
;各个发票项目费用,分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb0000]
西药费=
成药费=
.
.
.
;明细(可能没有,如cfxms0为零)
[zysfmx]
;按<<处方明细信息>>说明中的顺序排列,每项内容占一行,一个处方项目共11行
<<处方明细信息>>
.
.
.
◆住院收费冲销
医院程序形成"住院收费冲销请求"文件,内容如下:
[zysfcx]
request=TRUE
cardno=
;要冲销单据号
cxdjh0=
医保程序接受请求后并生成结果文件,内容如下:
[zysfcx]
reply=TRUE
success=
error=
;单据号
djlsh0=
;被冲销的单据号
cxdjh0=
zylsh0=
id0000=
cadno=
xming0=
xbie00=
brnl00=