医保收费接口规范
南平医保医院接口规范
一、接口设计主体思路：
采用文本文件交换信息的方式，每个业务接口主要步骤均为：医院程序删除应答文件（如果存在），提交一个请求文件，医保程序检测到后自动解释，生成一个回答文件，并删除原来的请求文件，医院程序检测到应答文件生成后就去读取医保程序返回的信息。
文件的结构主要借鉴Windows 系统通用的信息文件格式（*.ini）。为安全起见，每一个涉及收费的接口均需校验卡号。为方便起见，对交换文件不进行加密处理，采用文本文件。
为了全省数据的一致性，病种编码，发票项目编码、药品项目和诊疗项目编码将统一标准。
注：如果医保政策或实施细则有变化，本规范将作相应调整。
二、医院程序设计注意事项：
1. 发出请求前，应当删除应答文件，（否则医保程序将不会响应应答文件。）
2. 发出请求文件时，填写request 字段的内容应填写完参数后进行；
（** 无论对或写，务必采用独占方式(LOCKREADWRITE!)打开文件。）
3. 检测应答文件时，应当等到应答文件的reply=TRUE时，方可进行读取工作。
4. 读结果文件时，可以和发送的信息进行一些简单的校验（例如接口发送和接收的处方数目，明细，总金额等是否一致等），保证程序正确运行。
三、各个具体业务的接口文件结构：
请求文件名为:request.txt 接口返回的文件名为:reply.txt
请求和应答文件中英文字段意义说明：(C代表字符类型 N代表数值类型 例如N5,2代表取值0.00到999.99) (字段意义如文件中另有说明的除外)
注1：接口应答文件返回时如有参保人信息，都有参保人的各种信息如：姓名、性别、年龄、单位、ic 卡状态、工作状态、个人账户余额、地区、分中心等；下面的接口说明中均以“>”字样代表：
xming0=
xbie00= brnl00=
dwmc00=
icztmc=
gzztmc=
grzhye=
dqmc00=
fzxmc0=
注2：接口应答文件返回时如有处方明细信息，都有收费项目的各种信息如：名称、规格等；下面的接口说明中均以“>”字样代表：
医院收费项目在医保中心的编号
是否医保项目
医院收费项目在医保中心的发票项目名称
医院收费项目在医保中心的名称
医院收费项目在医保中心的规格
医院收费项目在医保中心的单位
医院收费项目在医保中心的单价
医院收费项目的数量
医院收费项目的金额
医院收费项目的医生姓名
此外，接口返回的收费文件的>除有以上信息外，还增加一行信息，为医院收费项目在医保中心的个人自付比例（0 到1）。
注3：返回文件中的发票项目均分解到[yb0000]和[fyb000]两个小节中，分别代表按政策医保项目费用和按政策规定个人自付项目费用。
◆ 门诊挂号:
1. 医院程序形成" 读卡请求" 文件 :
[mzghsk]
request=TRUE
医保程序接受请求后将填写结果文件，并将原来的请求文件删除，此时医院程序检测到应答文件生成后（文件中reply=TRUE），就可以读取结果文件，读取完后将结果文件删除后，才可以发出下一个请求。（以下各个接口也须照此处理）
[mzghsk]
reply=TRUE
success=
error=
cardno=
id0000=
>
; 病人是否可以门诊挂号(TRUE or FALSE)
valid0=
; 病人不能挂号原因
bnghyy=
医院程序读取" 读卡结果" 文件, 如果读卡正常, 且允许挂号, 则录入挂号科室, 挂号费, 然后进行下一步请求。
2.医院程序形成" 挂号提交请求" 文件，内容如下：
[mzgh]
request=TRUE
success=
error=
cardno=
ghksmc=
ghfy00=
医保程序接受请求后并生成结果文件，内容如下:
[mzgh]
reply=TRUE
success=
error=
cardno=
ghlsh0=
ghrq00=
ghsj00=
ghksmc=
ghfy00=
id0000=
>
; 病人是否可以门诊挂号(TRUE or FALSE)
valid0=
; 病人不能挂号原因
bnghyy=
sfrxm0=
注: 本步骤医保程序仍需读卡并校验卡号是否与请求文件中的卡号一致，
所以投保人的IC 卡必须放在读卡机内。
◆ 门诊挂号冲销:
医院程序形成" 挂号冲销请求" 文件，内容如下：
[mzghcx]
request=TRUE
cardno=
ghlsh0=
医保程序接受请求后并生成结果文件，内容如下:
[mzghcx]
reply=TRUE
success=
error=
cardno=
ghlsh0=
cxlsh0=
; 冲销挂号日期
ghrq00=
; 冲销挂号时间
ghsj00=
ghksmc=
ghfy00=
id0000=
>
◆ 门诊收费
1. 医院程序形成" 读卡请求" 文件，内容如下：
[mzsfsk]
request=TRUE
医保程序接受请求后并生成结果文件，内容如下:
[mzsfsk]
reply=TRUE
success=
error=
cardno=
id0000=
>
; 门诊流水号(如有多个用; 隔开)
mzlsh0=
; 挂号科室(如有多个用; 隔开)
ghksmc=
; 发票项目编码(编号；名称) 例如：
[fpxmbm]
01; 西药费
02; 成药费
.
.
.
2.医院程序形成" 门诊收费请求" 文件
内容:请求，IC 卡号, 门诊流水号, 病情编码, 处方数, 各个发票项目金额， 处方项目明细，包括（编号、发票项目编号、名称、规格、单位、 单价、数量、金额、医生姓名）
[mzsf]
request=TRUE
success=
error=
cardno=
mzlsh0=
bqbm00=
cfxms0=
; 各个发票项目费用，分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb000]
西药费=
成药费=
.
.
.
; 处方明细（如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=
grzhye=
sfrq00=
sfsj00=
sfrxm0=
cfxms0=
;各个发票项目费用，分医保和非医保两种
[yb0000]
西药费=
成药费= .
.
.
[fyb000]
西药费=
成药费=
.
.
; 明细（可能没有，如cfxms0为零）
[mzsfmx]
; 按>说明中的顺序排列，每项内容占一行，一个处方项目共11行 >
.
◆ 门诊收费冲销
医院程序形成" 门诊收费冲销请求" 文件，内容如下：
[mzsfcx]
request=TRUE
cardno=
cxdjh0=
医保程序接受请求后并生成结果文件，内容如下:
[mzsfcx]
reply=TRUE
success=
error=
; 单据号
djlsh0=
; 被冲销的单据号
cxdjh0=
mzlsh0=
id0000=
cadno=
xming0=
xbie00=
brnl00=
bckbcs=
ghksmc=
bqbm00=
sftsmz=
sftsbz=
zhzfe0=
grzfe0=
jjzfe0=
bcbxf0=
grzhye=
sfrq00=
sfsj00=
sfrxm0=
cfxms0=
;各个发票项目费用，分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb000]
西药费=
成药费=
.
.
.
; 明细（可能没有，如cfxms0为零）
[mzsfmx]
; 按>说明中的顺序排列，每项内容占一行，一个处方项目共11行 >
.
.
.
◆ 住院登记
1. 医院程序形成" 读卡请求" 文件 :
[rydjsk]
request=TRUE
医保程序接受请求后并生成结果文件，内容如下:
[rydjsk]
reply=TRUE
success=
error=
cardno=
id0000=
>
; 可否入院登记(TRUE OR FALSE)
valid0=
; 不能入院登记原因
bndjyy=
医院程序读取" 读卡结果" 文件, 如果读卡正常, 且允许登记,
则录入科室, 住院类别，住院日期, 然后进行下一步请求。
2.医院程序形成" 入院登记提交请求" 文件
内容:请求，IC 卡号, 入院日期， 科室名称, 住院类别（普通或家庭病床）
[rydj]
request=TRUE
success=
error=
cardno=
ryrq00=
rysj00=
ryksmc=
rylb00=
医保程序接受请求后并生成结果文件，内容如下:
[rydj]
reply=TRUE
success=
error=
cardno=
zylsh0=
bckbcs=
ryrq00=
rysj00=
ryksmc=
rylb00=
id0000=
>
; 可否入院登记(TRUE or FALSE)
valid0=
; 不能入院登记原因
bndjyy=
rydjr0=
◆ 取消入院登记
医院程序形成" 冲销请求" 文件
内容:请求，IC 卡号, 住院流水号
[rydjcx]
request=TRUE
cardno=
; 要冲销的住院流水号
cxlsh0=
医保程序接受请求后并生成结果文件，内容如下:
[rydjcx]
reply=TRUE
success=
error=
cardno=
; 冲销流水号
zylsh0=
; 被冲销的住院号
cxlsh0=
bckbcs=
ryrq00= rqsj00=
ryksmc=
rylb00=
id0000=
>
rydjr0=
◆ 住院收费
1. 医院程序形成" 读卡请求" 文件，内容如下：
[zysfsk]
request=TRUE
医保程序接受请求后并生成结果文件，内容如下:
[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=
; 各个发票项目费用，分医保和非医保两种
[yb0000]
西药费=
成药费=
.
.
.
[fyb000]
西药费=
成药费=
.
.
.
; 处方明细（如cfxms0>0）
[zysfmx]
; 按>说明中的顺序排列，每项内容占一行，一个处方项目共10行 >
医保程序接受请求后并生成结果文件，内容如下:
[zysf]
reply=TRUE
success=
error=
djlsh0=
zylsh0=
id0000=
cardno= xming0=
xbie00=
brnl00=
bqbm00= sftsbz= ; 普通病床天数 ptbcts= ; 传染病床天数 crbcts= zhzfe0= grzfe0= jjzfe0= bcbxf0= grzhye= sfrq00= sfsj00= sfrxm0= cfxms0= ;各个发票项目费用，分医保和非医保两种 [yb0000] 西药费= 成药费= . . . [fyb000] 西药费= 成药费= .
.
.
; 明细（可能没有，如cfxms0为零）
[zysfmx]
; 按>说明中的顺序排列，每项内容占一行，一个处方项目共11行 >
.
.
.
◆ 住院收费冲销
医院程序形成" 住院收费冲销请求" 文件，内容如下：
[zysfcx]
request=TRUE
cardno=
; 要冲销单据号
cxdjh0=
医保程序接受请求后并生成结果文件，内容如下:
[zysfcx]
reply=TRUE
success=
error=
; 单据号
djlsh0=
; 被冲销的单据号
cxdjh0=
zylsh0=
id0000=
cadno=
xming0=
xbie00=
brnl00=
bckbcs=
zyksmc=
bqbm00=
sftsbz=
; 普通病床天数
ptbcts=
; 传染病床天数
crbcts=
zhzfe0=
grzfe0=
jjzfe0=
bcbxf0=
grzhye=
sfrq00= sfsj00=
sfrxm0=
cfxms0=
西药费= 成药费= . . . [fyb000] 西药费= 成药费= .
.
.
; 明细（可能没有，如cfxms0为零）
[zysfmx]
; 按>说明中的顺序排列，每项内容占一行，一个处方项目共11行 >
.
.
.
◆ 出院登记
1. 医院程序形成" 读卡请求" 文件，内容如下：
[cydjsk]
request=TRUE
医保程序接受请求后并生成结果文件，内容如下:
[cydjsk]
reply=TRUE
success=
error=
cardno=
id0000=
>
zylsh0=
ryksmc=
医院程序读取" 读卡结果" 文件, 如果读卡正常, 进行下一步请求。
2. 医院程序形成" 出院登记提交请求" 文件，内容如下：
[cydj]
request=TRUE
success=
error=
cardno=
zylsh0=
cyrq00=
cysj00=
医保程序接受请求后并生成结果文件，内容如下:
[cydj]
reply=TRUE
success=
error=
cardno=
zylsh0=
bckbcs=
ryrq00=
rysj00=
cyrq00=
cysj00=
ryksmc=
rylb00=
id0000=
cyzd00=
>
rydjr0=
cydjr0=
◆ 取消出院登记
医院程序形成" 冲销请求" 文件，内容如下：
[cydjcx]
request=TRUE
cardno= ; 要取消出院的住院流水号
zylsh0=
医保程序接受请求后并生成结果文件，内容如下:
[cydjcx]
reply=TRUE
success=
error=
cardno=
zylsh0=
bckbcs=
ryrq00=
rqsj00=
; 出院日期（如成功的话为"*"） cyrq00=
cysj00=
ryksmc=
rylb00=
id0000=
> rydjr0=
cydjr0=