韶关医保医院接口规范.doc

韶关医保医院接口规范 (修正版)2007年12月本次接口规范修改说明：新订接口规范和原来的接口规范不同在于：在接口软件产生的收费返回文件里增加了十一个字段，在字段意义表里已用红色标记出来。一、接口设计主体思路：采用文本文件交换信息的方式，每个业务接口主要步骤均为：医院程序删除应答文件（如果存在），提交一个请求文件，医保程序检测到后自动解释，生成一个应答文件，并删除原来的请求文件，医院程序检测到应答文件生成后就去读取医保程序返回的信息。文件的结构主要借鉴Windows系统通用的信息文件格式（*.ini）。为安全起见，每一个涉及收费的接口均需校验卡号。为方便起见，对交换文件不进行加密处理，采用文本文件。为了全市数据的一致性，病种编码，发票项目编码、药品项目和诊疗项目编码将统一标准。 注：如果医保政策或实施细则有变化，本规范将作相应调整。二、医院程序设计注意事项：1.发出请求前，应当删除应答文件； （否则医保程序将不会响应应答文件。）2.发出请求文件时，填写request字段的内容应填写完参数后进行； （最好采用独占方式(LOCKREADWRITE!)打开文件,一次性写完后关闭。）3.检测应答文件时，应当等到应答文件的reply=TRUE时，方可进行读取工作。4.写文件时，如用powerbuilder编程，不要用setprofilestring函数进行文件操作，必须使用fileopen,fileclose,filewrite,fileread等函数。5.读结果文件时，可以和发送的信息进行一些简单的校验（例如接口发送和接收的处方数目，明细，总金额等是否一致等），保证程序正确运行。 三、各个具体业务的接口文件结构：如无特殊说明，以下提及的各个文件均放在医保安装目录(缺省为C:program filesyyjk)下的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 C12个人IC卡编号Id0000C19个人参保号Xming0 C8姓名Xbie00C1 1男2女可能为空性别Brnl00N5,2年龄Dwmc00C30单位名称IcztmcC20IC卡状态名称GrsfenC20个人身份名称GzztmcC30工作状态名称Dqmc00C20投保人所属地区名称Fzxmc0C20投保人所属分中心名称GhksmcC10挂号科室名称Ghfy00N 5,2挂号费用Ghlsh0C16挂号流水号Ghrq00C8挂号日期Ghsj00C4挂号时间Cxlsh0C16冲销流水号GrzhyeN8,2个人帐户余额Bqbm00C20病种编码Cfxms0N3收费项目数Djlsh0C16单据流水号Mzlsh0C16门诊(药店)流水号SfydsfC1 Y是 N否是否药店收费BckbcsN3本次看病次数(即视同住院次数)SftsmzC1 Y是 N否是否特殊门诊SftsbzC1是否特殊病种Yely00C1金额来源（1预缴；2消费；3退款；4结欠）Zhzfe0N8,2帐户支付额Grzfe0N8,2个人现金支付额Jjzfe0N8,2基金支付额YlzfjeN8,2乙类自付金额Bcbxf0N8,2总费用Sfrq00C8收费日期Sfsj00C4收费时间Sfrxm0C8收费人姓名Cxdjh0C16冲销单据号Ryrq00C8入院日期Rysj00C4入院时间RyksmcC10入院科室名称Rylb00C8 普通或家庭病床住院类别Zylsh0C16入院登记流水号Rydjr0C8入院登记人ZyksmcC10住院科室名称Cydjr0C8出院登记人Cyrq00C8出院日期Cysj00C4出院时间Valid0True or False是否可以入院登记或是否可以挂号BnghyyVarchar2(400)病人不能挂号原因BndjyyVarchar2(400)病人不能入院登记原因Cyzd00C20出院诊断Ryzd00C20入院诊断DbzhzfN8,2大病互助帐户支付DbgrzfN8,2大病互助个人支付DbjjzfN8,2大病互助基金支付Gwybz0N8,2公务员补助MkbxjjN8,2煤矿保险基金支付Mk14jjN8,2煤矿保险（1-4级工残人员）基金支付LjjbjjN8,2累计统筹基金支付LjdbjjN8,2累计大病基金支付Ljgwy0N8,2累计公务员基金支付LjmkbxN8,2累计煤矿保险基金支付Ljmk14N8,2累计煤矿14工残基金支付DwbcbzN10,2单位补充保险基金支付JmjfnxC1居民缴费年限（1、2、3）Grsf00C1居民身份（X居民成年人W居民未成年人，其余为城镇职工身份）无C20中医院收费项目在医保中心的编号无C1 Y or N中是否医保项目无C20中医院收费项目在医保中心的发票项目名称无C100中医院收费项目在医保中心的名称无C20中医院收费项目在医保中心的规格无C20中医院收费项目在医保中心的单位无N10,4中医院收费项目在医保中心的单价无N8,2中数量无N8,2中金额无C8中医生姓名无N5,4中个人自付比例注1：接口应答文件返回时如有参保人信息，都有参保人的各种信息如：姓名、性别、年龄、单位、ic卡状态、工作状态、个人账户余额、地区、分中心等；下面的接口说明均以“”字样代表： xming0= xbie00= brnl00= dwmc00= icztmc= gzztmc= grzhye= dqmc00= fzxmc0=注2：接口应答文件返回时如有处方明细信息，都有收费项目的各种信息如：名称、规格等；下面的接口说明均以“”字样代表： 医院收费项目在医保中心的编号 是否医保项目 医院收费项目在医保中心的发票项目名称 医院收费项目在医保中心的名称 医院收费项目在医保中心的规格 医院收费项目在医保中心的单位 医院收费项目在医保中心的单价 数量 金额 医生姓名此外，接口返回的收费文件的除有以上信息外，还增加一行信息，为医院收费项目在医保中心的个人自付比例（0 到1）。在收费时会对传送的收费明细进行校验，即明细数量明细单价明细金额。否则无法进行正常收费。对于单价的设定，我们是设定四位小数，即单价可以为0.0001，如果小数后超过四位，收费时可能会报错。请注意. 注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 cardno= id0000= ghksmc= ghfy00=ryzd00= 医保程序接受请求后并生成结果文件，内容如下: mzgh reply=TRUE success= error= cardno= ghlsh0= ghrq00= ghsj00= ghksmc= ghfy00= id0000= ;病人是否可以门诊挂号(TRUE or FALSE) valid0= ;病人不能挂号原因 bnghyy= grzhye= sfrxm0= grsf00=jmjfnx=ljjbjj= 注: 本步骤医保程序仍需读卡并校验卡号是否与请求文件中的卡号一致， 所以投保人的IC卡必须放在读卡机内。 门诊挂号冲销: 医院程序形成挂号冲销请求文件，内容如下： mzghcx request=TRUE cardno= id0000= ghlsh0= 医保程序接受请求后并生成结果文件，内容如下: mzghcx reply=TRUE success= error= cardno= ghlsh0= cxlsh0= ;冲销挂号日期 ghrq00= ;冲销挂号时间 ghsj00= ghksmc= ghfy00= id0000= 门诊收费医院程序形成门诊收费请求文件 内容:请求，IC卡号, 门诊流水号,病情编码,处方数,各个发票项目金额， 处方项目明细，包括（编号、发票项目编号、名称、规格、单位、单价、数量、金额、医生姓名） mzsf request=TRUE cardno=id0000= mzlsh0= bqbm00= cfxms0= ;处方明细（如cfxms00） mzsfmx ;按说明中的顺序排列，每项内容占一行，一个处方项目共10行 . . . 医保程序接受请求后并生成结果文件，内容如下: mzsf reply=TRUEsuccess=djlsh0=mzlsh0=id0000=cardno=xming0=xbie00=brnl00=bckbcs=ghksmc=zhzfe0=grzfe0=jjzfe0=bcbxf0=sfrq00=sfsj00=sfrxm0=cfxms0=dbzhzf=dbgrzf=dbjjzf=gwybz0=mkbxjj=mk14jj=ljjbjj=ljdbjj=ljgwy0=ljmkbx=ljmk14= Dwbcbz ;各个发票项目费用，分医保和非医保两种 yb0000 西药费= 成药费= . . . fyb000 西药费= 成药费=. .;明细（可能没有，如cfxms0为零）mzsfmx;按说明中的顺序排列，每项内容占一行，一个处方项目共11行. 门诊收费冲销 医院程序形成门诊收费冲销请求文件，内容如下： mzsfcx request=TRUE cardno= id0000= cxdjh0= 医保程序接受请求后并生成结果文件，内容如下: mzsfcxreply=TRUEsuccess=error=; 被冲销的单据号djlsh0= mzlsh0=id0000=cadno=xming0=xbie00=brnl00=bckbcs=ghksmc=bqbm00=sftsmz=sftsbz=zhzfe0=grzfe0=jjzfe0=bcbxf0=sfrq00=sfsj00=sfrxm0=cfxms0= . . 住院登记(修改：增加医疗保险号)1医院程序形成读卡请求文件 : rydjsk request=TRUE 医保程序接受请求后将填写结果文件，并将原来的请求文件删除，此时医院程序检测到应答文件生成后（文件中reply=TRUE），就可以读取结果文件，读取完后将结果文件删除后，才可以发出下一个请求。（以下各个接口也须照此处理） rydjsk reply=TRUE success= error= cardno= id0000= ;病人是否可以入院登记(TRUE or FALSE) valid0= 医院程序读取读卡结果文件, 如果读卡正常, 且允许入院登记,然后进行下一步请求。2.医院程序形成入院登记提交请求文件 内容:请求，医疗保险号，IC卡号,入院日期， 科室名称,住院类别（普通或家庭病床） rydjrequest=TRUE id0000= cardno=ryrq00=rysj00=ryksmc=rylb00= ryzd00= 医保程序接受请求后并生成结果文件，内容如下: rydj reply=TRUEsuccess=error=cardno=zylsh0=bckbcs=ryrq00=rysj00=ryksmc=rylb00=id0000=;可否入院登记(TRUE or FALSE)valid0=;不能入院登记原因bndjyy= grzhye=rydjr0=ryzd00=grsf00=jmjfnx=ljjbjj= 取消入院登记(修改：增加医疗保险号) 医院程序形成冲销请求文件 内容:请求，IC卡号, 住院流水号 rydjcx request=TRUE id0000= cardno= ;要冲销的住院流水号 cxlsh0= 医保程序接受请求后并生成结果文件，内容如下: rydjcx reply=TRUEsuccess=error=cardno= ;冲销流水号zylsh0=;被冲销的住院号cxlsh0= bckbcs=ryrq00=rysj00=ryksmc=rylb00=id0000=rydjr0= 住院收费(修改：增加医疗保险号)医院程序形成住院收费请求文件 内容:请求，医疗保险号，IC卡号,住院流水号,病情编码,普通病床天数，传染病床天数， 处方数,各个发票项目金额，处方项目明细，包括（编号、医保项目、发票项目编号、名称、规格、单位、单价、数量、金额、医生姓名） zysf request=TRUEid0000= cardno= zylsh0= bqbm00= ;普通病床天数 ptbcts= ;传染病床天数 crbcts= ;处方项目数 cfxms0= ;处方明细（如cfxms00） zysfmx ;按说明中的顺序排列，每项内容占一行，一个处方项目共10行 医保程序接受请求后并生成结果文件，内容如下: 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= dbzhzf=dbgrzf=dbjjzf=gwybz0=mkbxjj=mk14jj=ljjbjj=ljdbjj=ljgwy0=ljmkbx=ljmk14=Dwbcbz=jmjfnx=;各个发票项目费用，分医保和非医保两种 yb0000 西药费= 成药费= . . . fyb000 西药费= 成药费=. .;明细（可能没有，如cfxms0为零）zysfmx;按说明中的顺序排列，每项内容占一行，一个处方项目共11行. 住院收费冲销(修改：增加医疗保险号) 医院程序形成住院收费冲销请求文件，内容如下： zysfcx request=TRUE id0000= cardno= ;要冲销单据号 cxdjh0= 医保程序接受请求后并生成结果文件，内容如下: zysfcxreply=TRUEsuccess=error=;单据号djlsh0=;被冲销的单据号cxdjh0= zylsh0=id0000=cardno=xming0=xbie00=brnl00=bckbcs=zyksmc=bqbm00=sftsbz= ;普通病床天数ptbcts=;传染病床天数crbcts= zhzfe0=grzfe0=jjzfe0=bcbxf0=sfrq00=sfsj00=sfrxm0=cfxms0= dbzhzf=dbgrzf=dbjjzf=gwybz0=mkbxjj=mk14jj=ljjbjj=ljdbjj=ljgwy0=ljmkbx=ljmk14=Dwbcbz=. 出院登记(修改：增加医疗保险号)1医院程序形成读卡请求文件 : cydjsk request=TRUE医保程序接受请求后并生成结果文件，内容如下:cydjsk reply=TRUE success= error= cardno= id0000= 2.医院程序形成出院登记提交请求文件，内容如下：cydjrequest=TRUE id0000=cardno=zylsh0=cyrq00=cysj00=cyzd00= 医保程序接受请求后并生成结果文件，内容如下: cydj reply=TRUEsuccess=error=cardno=zylsh0=bckbcs=ryrq00=rysj00=cyrq00=cysj00=ryksmc=rylb00=id0000=rydjr0=cydjr0= 取消出院登记(修改：增加医疗保险号) 医院程序形成冲销请求文件，内容如下： cydjcx request=TRUE id0000= cardno= ;要取消出院的住院流水号 zylsh0= 医保程序接受请求后并生成结果文件，内容如下: cydjcx reply=TRUEsuccess=error=cardno=zylsh0=bckbcs=ryrq00=rqsj00=;出院日期（如成功的话为*）cyrq00=cysj00=ryksmc=rylb00=id0000=grzhye=rydjr0=cydjr0=-关于此接口规范的一点说明：如果没有问题，这个应该是最新版本的接口规范，我接手医保时就用这个接口了，没有什么改动。针对以前其它一些软件公司开发的接口存在的一些问题，我提出几点建议：1、在收费生成请求文件（request）时，一些药品的名字含有特殊字符或者括号，如果处理不当，会产生空格，一般一个项目（药品）的各种数据是十行，如果在这十行中间产生了空格，则请求文件不能被接受。2、传两次的问题。有的医院的接口程序是自己开发的，程序的健壮性不是很好，不知是操作上（他们说这个控制的很严，绝对不可能，我没有分析过他们的程序）还是设计上的问题，同一笔收费他们的接口程序在同一个时间里面传了两次，我们也接受了两次（社保的接口程序对此不控制），结果导致病人的费用翻倍，需要用我们的住院系统冲销，比较麻烦。3、超时的问题。所谓的超时是因为一些软件公司的接口在设计时加入了时间判断，结果是社保的程序还在读接口文件的时候它就判断超时。为了能使我们的接口程序能更稳定得运行，以上是在使用这个接口过程中存在的一些问题，我对此提出的开发建议。希望你们斟酌。有不太明白的地方，加强联系。 二三年七月二十六日星期六二：注意：早些的接口规范里面有这两项，其实应该是没有的，应该是当初不小心写进来的。这个是已经向实达公司证实了的，这两项应该是在返回文件里面。success=error=这两项在请求文件里面是没有，所以所有的请求文件都删除这两项。二五年一月十九日星期三三、2005年医保政策调整时分别在办理入院时添加了“入院诊断”字段，和在办理出院时添加了“出院诊断”字段。二五年六月二十二日星期三四、在2005年7月至9月，关于实时传送，我们和各家医院及其开发商进行了多次讨论，并最终确定了解决方案。现详细进行说明。在接口传送的内容上，除了第三点提到的增加了入院诊断和出院诊断外，没有进行其它内容方面的任何修改。实时传送只是针对传送规则的制定。实时传送定义为每天（即每24小时）向医保传送收费明细，特殊情况下不超过三天。粤北三院和复退军人医院由于特殊情况则区别对待。由于实时传送后，医院的医嘱可能会进行修改而导致需要冲销，我们约定的规则如下：假定从1号到5号，某医院进行了五笔收费，为方便描述说明，省略医嘱项目明细，其单据号、金额如下： 顺序号 单据号 金额 冲销金额 实际金额 A 420.00 0.00 420.00 B 280.00 0.00 280.00 C 330.00 -30.00 300.00 D 270.00 0.00 270.00 E 350.00 0.00 350.00在进行第六笔收费时，医院系统对第三笔收费进行了30元的冲减。造成医院数据与医保数据不一致。医院接口程序在每次收费前应对之前的收费进行检查，如发现有冲销的记录，则从后往前依次发送冲销请求，即先发送冲销第五笔的请求，然后依次是第四笔，第三笔。冲销完成之后，依次从第三笔收费直到第六笔。以上的红色描述部分全部基于医院接口程序实现，无需人工参与。对于此种方法的改进建议：1、在完成第三笔收费C的冲销之后，第三至第六笔的收费可以合并为一笔进行发送收费请求。新的收费记录为： A 420.00 0.00 420.00 B 280.00 0