福建省新农合医院信息系统接口技术规范2011年初接口定义修改.doc

福建省新农合医院信息系统医院接口技术规范 2008年9月版本时间作者说明V1.12009-12-18江秋蓝色字样为本次修改内容一、接口设计主体思路：采用文本文件交换信息的方式，每个业务接口主要步骤均为：医院程序删除应答文件（如果存在），提交一个请求文件，医保程序检测到后自动解释，生成一个回答文件，并删除原来的请求文件，医院程序检测到应答文件生成后就去读取医保程序返回的信息。文件的结构主要借鉴Windows系统通用的信息文件格式（*.ini）。为安全起见，每一个涉及收费的接口均需校验卡号。为方便起见，对交换文件不进行加密处理，采用文本文件。为了全省数据的一致性，病种编码，发票项目编码、药品项目和诊疗项目编码将统一标准。 注：如果医保政策或实施细则有变化，本规范将作相应调整。二、医院程序设计注意事项：1.发出请求前，应当删除应答文件； （否则医保程序将不会响应应答文件。）2.发出请求文件时，填写request字段的内容应填写完参数后进行； （最好采用独占方式(LOCKREADWRITE!)打开文件,一次性写完后关闭。）3.检测应答文件时，应当等到应答文件的reply=TRUE时，方可进行读取工作。4.写文件时，如用powerbuilder编程，不要用setprofilestring函数进行文件操作，必须使用fileopen,fileclose,filewrite,fileread等函数。5.读结果文件时，可以和发送的信息进行一些简单的校验（例如接口发送和接收的处方数目，明细，总金额等是否一致等），保证程序正确运行。 三、各个具体业务的接口文件结构：如无特殊说明，以下提及的各个文件均放在医保安装目录(缺省为C:medicarehospital)下的sfjk目录下。请求文件名为:request.txt 接口返回的文件名为:reply.txt请求和应答文件中英文字段意义说明：(C代表字符类型 N代表数值类型 N5,2代表取值0.00到999.99) (字段意义如文件中另有说明的除外) 文件中字段名字位数或取值范围字段意义RequestTRUE or FALSE各种业务接口请求文件的开始请求标志；=TRUE时表示请求文件可以开始被读取ReplyTRUE or FALSE各种业务接口返回文件的回答标志；=TRUE时表示应答文件可以开始读取Success TRUE or FALSE操作结果成功否ErrorVarChar2(400)操作失败原因Cardno C18医保IC卡号Id0000C19医疗保险号Xming0 C8姓名Xbie00C1 0男1女可能为空性别Brnl00N3年龄Dwmc00C30单位名称IcztmcC20IC卡状态名称GzztmcC30工作状态名称Dqmc00C20投保人所属地区名称Fzxmc0C20投保人所属分中心名称GhksmcC10挂号科室名称Ghfy00N 5,2挂号费用Ghlsh0C18挂号流水号Ghrq00C8挂号日期Ghsj00C4挂号时间Cxlsh0C18冲销流水号GrzhyeN8,2个人帐户余额Bqbm00C20病种编码Cfxms0N3收费项目数Djlsh0C18单据流水号Mzlsh0C18门诊流水号BckbcsN3本次看病次数(即视同住院次数)SftsmzC1 Y是 N否是否特殊门诊SftsbzC1是否特殊病种Zhzfe0N8,2帐户支付额Grzfe0N8,2个人现金支付额Jjzfe0N8,2基金支付额Bcbxf0N8,2总费用Sfrq00C8收费日期Sfsj00C4收费时间Sfrxm0C8收费人姓名Cxdjh0C18冲销单据号Ryrq00C8入院日期Rysj00C4入院时间RyksmcC10入院科室名称Rylb00C8 普通或家庭病床住院类别Zylsh0C18入院登记流水号Rydjr0C8入院登记人ZyksmcC10住院科室名称Cydjr0C8出院登记人Cyrq00C8出院日期Cysj00C4出院时间Valid0True or False是否可以入院登记或是否可以挂号BnghyyVarchar2(400)病人不能挂号原因BndjyyVarchar2(400)病人不能入院登记原因无C20中医院收费项目在医保中心的编号无C1 Y or N中是否医保项目无C20中医院收费项目在医保中心的发票项目名称无C50中医院收费项目在医保中心的名称无C20中医院收费项目在医保中心的规格无C20中医院收费项目在医保中心的单位无N10,4中医院收费项目在医保中心的单价无N8,2中数量无N8,2中金额无C8中医生姓名无N 5,4中个人自付比例bcyljzN8,2民政救助总额jsjzzeN8,2计生救助总额cljzzeN8,2残联救助总额yy_xming0C20病人姓名yy_djlsh0C16医院_单据流水号mzlx00C1P-普通门诊 T特殊门诊fyfsrqC8费用发生日期注意：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两个小节中，分别代表按政策医保项目费用和按政策规定个人自付项目费用。 门诊挂号:1.医院程序形成读卡请求文件 : mzghsk request=TRUE cardno= yy_xming0= 医保程序接受请求后将填写结果文件，并将原来的请求文件删除，此时医院程序检测到应答文件生成后（文件中reply=TRUE），就可以读取结果文件，读取完后将结果文件删除后，才可以发出下一个请求。（以下各个接口也须照此处理） mzghsk reply=TRUE success= error= cardno= id0000= ;病人是否可以门诊挂号(TRUE or FALSE) valid0= ;病人不能挂号原因 bnghyy= 医院程序读取读卡结果文件, 如果读卡正常, 且允许挂号, 则录入挂号科室, 挂号费,然后进行下一步请求。 2.医院程序形成挂号提交请求文件，内容如下： mzgh request=TRUE success= error= cardno= ghksmc= ghfy00= ;医院门诊挂号流水号 yy_ghlsh0= yy_xming0=mzlx00= ;注释：P普通门诊 T特殊门诊 bqbm00= ；如果是特殊门诊，必须传特殊病种编码，特殊病种编码参看特殊病种编码表 医保程序接受请求后并生成结果文件，内容如下: mzgh reply=TRUE success= error= cardno= ghlsh0= ghrq00= ghsj00= ghksmc= ghfy00= id0000= ;病人是否可以门诊挂号(TRUE or FALSE) 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= ;门诊流水号(如有多个用;隔开) mzlsh0= ;挂号科室(如有多个用;隔开) ghksmc= ;发票项目编码(编号；名称)例如： fpxmbm 01;西药费 02;成药费 . . . 2.医院程序形成门诊收费请求文件 内容:请求，IC卡号, 门诊流水号,病情编码,处方数,各个发票项目金额， 处方项目明细，包括（编号、发票项目编号、名称、规格、单位、 单价、数量、金额、医生姓名） mzsf request=TRUE success= error= cardno= mzlsh0= bqbm00= cfxms0= ;医院门诊收费单据号yy_djlsh0=mzlx00= ;门诊类型是特殊门诊的，bqbm00必须是特殊病情编码表中的编码 ;各个发票项目费用，分医保和非医保两种 yb0000 西药费= 成药费= . . . fyb0000 西药费= 成药费= . . . ;处方明细（如cfxms00） mzsfmx ;按说明中的顺序排列，每项内容占一行，一个处方项目共11行 . . . 医保程序接受请求后并生成结果文件，内容如下: mzsf reply=TRUEsuccess=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= 医保程序接受请求后并生成结果文件，内容如下: mzsfcxreply=TRUEsuccess=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= 医保程序接受请求后并生成结果文件，内容如下: rydjskreply=TRUEsuccess=error=cardno=id0000=;可否入院登记(TRUE OR FALSE)valid0=;不能入院登记原因bndjyy= 医院程序读取读卡结果文件, 如果读卡正常, 且允许登记, 则录入科室,住院类别，住院日期,然后进行下一步请求。 2.医院程序形成入院登记提交请求文件 内容:请求，IC卡号,入院日期， 科室名称,住院类别（普通或家庭病床） rydjrequest=TRUEsuccess= error=cardno=ryrq00=rysj00=ryksmc=rylb00= ;医院系统的住院流水号 yy_zylsh0= yy_xming0= 医保程序接受请求后并生成结果文件，内容如下: rydj reply=TRUEsuccess=error=cardno=zylsh0=bckbcs=ryrq00=rysj00=ryksmc=rylb00=id0000=;可否入院登记(TRUE or FALSE)valid0=;不能入院登记原因bndjyy=rydjr0= 取消入院登记 医院程序形成冲销请求文件 内容:请求，IC卡号, 住院流水号 rydjcx request=TRUE cardno= ;要冲销的住院流水号 cxlsh0= yy_xming0= 医保程序接受请求后并生成结果文件，内容如下: rydjcx reply=TRUEsuccess=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= ;各个发票项目费用，分医保和非医保两种 yb0000 西药费= 成药费= . . . fyb0000 西药费= 成药费= . . . ;处方明细（如cfxms00） zysfmx ;按说明中的顺序排列，每项内容占一行，一个处方项目共11行 医保程序接受请求后并生成结果文件，内容如下: zysf reply=TRUEsuccess=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= 医保程序接受请求后并生成结果文件，内容如下: zysfcxreply=TRUEsuccess=error=;单据号djlsh0=;被冲销的单据号cxdjh0=zylsh0=id0000=cadno=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行. 出院登记1.医院程序形成读卡请求文件，内容如下： cydjsk request=TRUE cardno= yy_xming0= 医保程序接受请求后并生成结果文件，内容如下: cydjskreply=TRUEsuccess=error=cardno=id0000=zylsh0=ryksmc= 医院程序读取读卡结果文件, 如果读卡正常, 进行下一步请求。 2.医院程序形成出院登记提交请求文件，