南平医保医院接口规范

一、接口设计主体思路：

采用文本文件交换信息的方式，每个业务接口主要步骤均为：医院程序删除应答文件（如果存在），提交一个请求文件，医保程序检测到后自动解释，生成一个回答文件，并删除原来的请求文件，医院程序检测到应答文件生成后就去读取医保程序返回的信息。

文件的结构主要借鉴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=

bckbcs=

zyksmc=

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=

;各个发票项目费用，分医保和非医保两种

[yb0000]

西药费=

成药费=

.

.

.

[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=

医保收费接口规范