《韶关医保医院接口规范》由会员分享，可在线阅读，更多相关《韶关医保医院接口规范（19页珍藏版）》请在金锄头文库上搜索。
1、韶关医保医院接口规范 (修正版)2007年12月本次接口规范修改说明：新订接口规范和原来的接口规范不同在于：在接口软件产生的收费返回文件里增加了十一个字段，在字段意义表里已用红色标记出来。一、接口设计主体思路：采用文本文件交换信息的方式，每个业务接口主要步骤均为：医院程序删除应答文件（如果存在），提交一个请求文件，医保程序检测到后自动解释，生成一个应答文件，并删除原来的请求文件，医院程序检测到应答文件生成后就去读取医保程序返回的信息。文件的结构主要借鉴Windows系统通用的信息文件格式（*.ini）。为安全起见，每一个涉及收费的接口均需校验卡号。为方便起见，对交换文件不进行加密处理，采用文本
2、文件。为了全市数据的一致性，病种编码，发票项目编码、药品项目和诊疗项目编码将统一标准。 注：如果医保政策或实施细则有变化，本规范将作相应调整。二、医院程序设计注意事项：1.发出请求前，应当删除应答文件； （否则医保程序将不会响应应答文件。）2.发出请求文件时，填写request字段的内容应填写完参数后进行； （最好采用独占方式(LOCKREADWRITE!)打开文件,一次性写完后关闭。）3.检测应答文件时，应当等到应答文件的reply=TRUE时，方可进行读取工作。4.写文件时，如用powerbuilder编程，不要用setprofilestring函数进行文件操作，必须使用fileopen,
3、fileclose,filewrite,fileread等函数。5.读结果文件时，可以和发送的信息进行一些简单的校验（例如接口发送和接收的处方数目，明细，总金额等是否一致等），保证程序正确运行。 三、各个具体业务的接口文件结构：如无特殊说明，以下提及的各个文件均放在医保安装目录(缺省为C:program filesyyjk)下的sfjk目录下。请求文件名为:request.txt 接口返回的文件名为:reply.txt请求和应答文件中英文字段意义说明：(C代表字符类型 N代表数值类型 N5,2代表取值0.00到999.99) (字段意义如文件中另有说明的除外) 文件中字段名字位数或取值范围字段
4、意义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工作状态名称Dqmc0
5、0C20投保人所属地区名称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结欠）Zhzfe0
6、N8,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是否可以入院登记或是否可以挂号Bnghy
7、yVarchar2(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
8、单位补充保险基金支付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卡状态、工作状态、个人账
9、户余额、地区、分中心等；下面的接口说明均以“”字样代表： xming0= xbie00= brnl00= dwmc00= icztmc= gzztmc= grzhye= dqmc00= fzxmc0=注2：接口应答文件返回时如有处方明细信息，都有收费项目的各种信息如：名称、规格等；下面的接口说明均以“”字样代表： 医院收费项目在医保中心的编号 是否医保项目 医院收费项目在医保中心的发票项目名称 医院收费项目在医保中心的名称 医院收费项目在医保中心的规格 医院收费项目在医保中心的单位 医院收费项目在医保中心的单价 数量 金额 医生姓名此外，接口返回的收费文件的除有以上信息外，还增加一行信息，为医
10、院收费项目在医保中心的个人自付比例（0 到1）。在收费时会对传送的收费明细进行校验，即明细数量明细单价明细金额。否则无法进行正常收费。对于单价的设定，我们是设定四位小数，即单价可以为0.0001，如果小数后超过四位，收费时可能会报错。请注意. 注3：返回文件中的发票项目均分解到yb0000和fyb000两个小节中，分别代表按政策医保项目费用和按政策规定个人自付项目费用。门诊挂号:1.医院程序形成读卡请求文件 : mzghsk request=TRUE 医保程序接受请求后将填写结果文件，并将原来的请求文件删除，此时医院程序检测到应答文件生成后（文件中reply=TRUE），就可以读取结果文件，读
11、取完后将结果文件删除后，才可以发出下一个请求。（以下各个接口也须照此处理） mzghsk reply=TRUE success= error= cardno= id0000= ;病人是否可以门诊挂号(TRUE or FALSE) valid0= ;病人不能挂号原因 bnghyy= 医院程序读取读卡结果文件, 如果读卡正常, 且允许挂号, 则录入挂号科室, 挂号费,然后进行下一步请求。 2.医院程序形成挂号提交请求文件，内容如下： mzgh request=TRUE cardno= id0000= ghksmc= ghfy00=ryzd00= 医保程序接受请求后并生成结果文件，内容如下: mzg
12、h 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= id0
