《接口方案》.doc

新农合结算系统与医院管理信息系统接口说明书北京北航冠新世纪软件有限公司二零零六年一月一日成文信息主题词新型农村合作医疗结算系统与医院管理信息系统接口说明作 者北航冠新开发部农合课题组文档类别技术文档审 核李谦批 准北京北航冠新世纪软件有限公司文档性质技术文档主 送合管中心存档日期2006年1月1日抄 送各定点医疗机构并HIS开发商发布日期2006年1月1日签收信息发送方接收方代表人：代表人：日 期：日 期：变更信息版本变更原因作者日期1.0.0原稿开发部2006年1月1日2.0.0根据合管中心要求实时传输，及相关细节改动李谦2007年4月1日目 录目 录1一、方案设计目的及原则2二、设计方案2三、功能设计5四、农合系统字典发布表结构8五、接口库表结构9一、 方案设计目的及原则 医院HIS（医院管理信息系统）与参合病人结算系统的接口方式采用的是一种嵌入方式，即两个系统的衔接基本达到一种无缝的状态，给合管中心的工作带来极大的方便，保证各类数据的准确与完整。同时，软件开发的工作也会相对较复杂。由于各县合管中心使用的都是统一的软件系统，而各定点医疗机构所使用的HIS则千差万别，所以各定点医疗机构在与参合病人结算系统接口时就需要按全局的要求出发，以满足系统正常开通运行。接口的采用将避免农合管理信息系统在进行补偿结算时重复录入医院管理信息系统已经操作的大量费用信息，农合管理信息系统和医院管理信息系统的接口功能应保证两系统业务主线的独立性，使医院管理信息系统录入的明细费用通过接口直接导入农合系统内进行结算，以提高医院工作人员的工作效率，节约医院的管理成本。说明：为方便阐述，以下“农合管理信息系统”简称农合系统，“医院管理息信息系统”简称医院系统。二、设计方案1、 制作农合补偿项目对照表农合系统提供最新的农合医药项目补偿表（Excel格式），合管中心向定点医疗机构下发，医院系统按照中心下发通知接收该表，根据该表制作出和医院系统医药项目表对应的对照表。注意事项：农合系统提供的只是补偿医药项目，凡是医院系统医药项目表不能在农合补偿表里找到对应项目的，即被当作自费项目处理。补偿表主要有三大类：药品表、诊疗（医疗）项目表、卫生（一次性）材料表。由于各医院系统定义的医药项目主键规则各不相同，项目对照表的表结构和提供给医院做项目对照的对照程序各医院系统开发商请自行设计，下面的对照表样例仅供参考。农合项目和医院项目的对照关系是一对多的对照关系，即一个农合项目可以对应多个医院项目，但医院项目最多可以对应一个农合项目。因为如果医院项目一对多，会造成重复传输项目。例如：医院的项目A对应了农合的项目1、2、3。本来应该传输一个项目，但系统会传输1、2、3三个项目，造成项目数量和金额总数错误。l 药品表样例（药品编码为农合药品唯一索引值）药品编码规范名称常用名称常用拼音码剂型药品分类氨氯西林氨氯西林alxl注射剂甲类头孢氨苄颗粒剂头孢氨苄颗粒剂tbabklj颗粒剂甲类（复方）穿心莲片炎虎宁yhn其它甲类红霉素红霉素hmszsj注射剂甲类l 医疗表样例（药品编码为农合医疗项目唯一索引值）医疗编码项目名称项目拼音财务分类代码计价单位住院诊查费zyzcfB日普通病房床位费（二人间）ptbfcwferjC日普通病房床位费（四人间以上加床）ptbfcwfsrjysjcC日普通病房床位费（三人间加床）ptbfcwfsrjjcC日l 材料表样例（药品编码为材料唯一索引值）材料编码材料名称项目拼音规格包装计价单位g一次性吸痰管(硅胶)ycxxtg个i一次性吸痰管(负压吸痰管)ycxxtg个a吸氧过滤器(吸氧面罩)xyglq个b吸氧过滤器(双腔吸氧管)xyglq条l 对照表样例： （注：项目分类中1表示药品，2表示医疗，3表示材料）项目分类农合项目编码医院项目编码1a1b122b3g101013i102122、设定接口服务器，建立接口数据库和接口表在医院设置一台服务器（物理上可以利用医院系统数据库服务器），在该服务器上建立接口数据库和数据表。医院系统负责将农合需要结算的数据实时写入，农合系统负责从该数据库接口表中取出相应的数据进行农合补偿结算，并向接口库提供结算后信息。农合系统实时通过接口库的数据采集向合管中心提交在院患者费用信息。要求：接口数据库采用SQLserver2000，接口数据库名称建议为hzyl_his，接口数据库访问用户和密码同时开放与医院管理系统与农合系统，如果希望将接口表建立在医院系统数据库内，需提供医院数据库名称、访问用户和密码。3、农合系统医药补偿表的发布与接口对照表的更新农合系统定期向医院系统发布最新农合医药补偿项目表（excel格式）。医院系统根据农合系统的最新发布，将补偿项目正确的接收到接口数据库中，同时提供前台应用，使医院人员可以调整医院医药项目表与农合补偿项目表的对照，保障医院系统提供的费用信息可以被农合系统识别。同时提供对照情况查询、打印功能，便于合管中心定期到医疗机构现场检查工作。4、两系统的数据交互农合系统与医院系统完全通过接口库进行数据交互，从逻辑上看，除农合系统在结算成功后，医院系统的门诊退费与住院招回需要得到农合系统退结的确认，两系统的业务互不干扰。医院系统登记参合人员的基本信息后，可以直接进行门诊划价收费与住院病人结算，无需农合系统的认证。门诊登记信息与费用明细一次性写入接口库。住院登记信息，住院费用明细信息实时要求下提前与病人结算信息实时写入、更新接口库，病人结算时，可重新写入接口库，保证医院系统与农合系统的数据一致性。非实时要求下，可在出院时一次性写入接口库。三、功能设计（一）医院系统功能1、在医院设置接口服务器，建立接口数据库和接口表协商医院设置一台接口服务器，（建议：一般可建立在医院系统服务器本机），按照农合系统提供的规则建立接口数据库和接口表（注：数据库名定为hzyl_his，也可将表建立在医院系统数据库），提供给农合系统访问该服务器的名称、登录数据库及访问用户名和密码，并保证农合系统具有读写该数据库接口表的权限。2、农合系统补偿项目表对照维护功能医院系统提供医院工作人员日常维护农合系统补偿项目表的对照功能。医院工作人员根据农合系统提供的补偿项目表与本院系统的医药项目表进行对照，建立对照关系表，用于医院系统写入接口库医药明细费用时区分出自费和补偿项目，作为农合系统进行补偿结算的费用明细依据。对照表由医院系统参照农合系统提供的费用表T_CON2所需信息自行设计，方案中不做硬性规定，只保证HIS系统能将费用项目准确地对应于合管中心下发的对照表项目即可。3、 参合人员门诊划价收费、住院登记时基本信息的录入鉴于农合医疗证目前以手工证为主，医院系统在门诊划价、住院登记时先将患者按照人员进行分类，人员类别分别定义为农合、城镇医保、计划生育、低保、自费等，当该患者为农合类别人员时，门诊划价收费、住院登记直接提供个人参合号的录入入口，同时登记该人员的姓名、性别、身份证号、出生日期基本信息，门诊划价收费与住院登记时向接口库门诊结算表T_con3住院登记表T_con1提供相应的参合人员基本信息，参合号、姓名、性别、身份证号、出生日期用于农合系统的身份认证。注意：使用磁卡、IC卡认证患者身份的用户需向农合开发商申请项目化处理。4、 门诊划价收费门诊划价收费成功时，将农合患者基本信息写入接口库门诊收费表T_con3，以医院系统中门诊收费发票号为主健，标明记录状态为“等待”农合系统结算。同时将费用信息根据T_con4要求写入其中。、门诊退费医院系统在门诊退费时，如果接口库门诊结算表T_con3中该患者记录仍为“等待”状态，医院系统先将该条记录连同其费用明细在中间库全部清空，在进行正常退费处理。退费后，将最新的划价收费信息按照上述第4条“门诊划价收费”要求进行接口库的写入。农合系统在结算成功时，会将补偿信息写入接口库门诊结算表T_con3中，并标识该条记录已经在农合系统中结算成功，医院系统在退费处理时，首先判断T_con3中该条记录是否是已结，如果为农合结算有效记录，医院系统将不可执行门诊退费操作。农合系统将该条结算信息退结后，回写接口库T_con3表中该条记录的状态标识为“等待”，医院系统方可按照“等待”状态执行正常退费操作。6、住院登记住院登记时将信息同时写入接口库住院登记表T_ CON1中，标识“在院”状态。在对住院登记信息进行修改的同时，更新接口库T_con1中的相应信息。删除在院患者住院登记信息时，医院系统应同时清空接口库中T_con1与T_con2中相应记录。7、住院划价 医院系统在患者住院划价成功后同时将患者费用信息根据对照字典写入接口费用表T_con2中。8、 在院病人退费 医院系统对于在院病人的费用明细退费记录作退费标识，数量以负值表示。注意：对于在院患者已写入中间库的费用记录，如果医院系统如修改某条记录，一律按照退费处理，标识退费标志。9、 病人结算医院系统在病人结算时，将最新的住院登记信息，押金信息按照住院号进行T_con1表的数据更新，押金值只要汇总数，不区分押金交款方式。同时按照住院号，将T_con2表的信息进行重写，退费作废记录保留。10、病人招回农合系统在结算成功时，会将补偿信息写入接口库住院登记表T_con1中，并标识该条记录已经在农合系统中结算成功，医院系统在做招回处理时，首先判断T_con1中该条记录是否是“已结”，如果为农合结算有效记录，医院系统将不可执行招回操作。 农合系统将该条结算信息退结后，回写接口库T_con1表中该条记录的状态标识为“未结”，医院系统方可进行召回操作。（二）农合系统1、农合系统药品、医疗、材料字典的发布功能农合系统向医院系统提供补偿项目字典（以excel格式提供）用于和医院医药项目字典对照。2、农合系统接收数据身份确认农合系统对接收数据时进行复核，对于不合法的数据（比如录入了错误的参合号，当参合人手持医疗证或身份证时必须根据接口表发票号、住院号查询出的人员基本信息做对照，如有不符按照参合人手持的医疗证号为准）需医院系统进行接口数据库的信息更正。3、农合系统结算农合系统根据接口数据库接收数据，执行补偿算法，进行参合人员医疗费用补偿结算，并向T_con1，T_con3表返回结算信息，同时更新T_con1与T_con3状态。、农合系统退结 针对门诊退费与住院招回功能，农合系统通过退结功能回执T_con1与T_con3状态标识值，农合系统退结成功后，医院系统方可执行门诊退费与住院招回。（三）注意事项、两系统交互数据的确定记录的关键字门诊流水号、住院使用住院号位。、在门诊划价收费、住院登记时录入合法的个人参合号，位长为12位。注意是个人参合号而不是家庭参合号，一般医疗证上的号码为家庭参合号，应明确患者的个人参合号再登记，并保证位长为12位，否则系统不允许录入。3、一期方案中医院系统的门诊划价收费时、住院登记、病人结算无需得到农合系统确认。保证将人员基本信息，费用信息准确写入接口数据库即可。、医院系统门诊退费、住院招回处理时必须得到农合系统该条记录的退结处理确认，方可执行。、医院系统可不提供具体的门诊退费费用明细，以门诊流水号或发票号为准重新写接口库门诊收费表与门诊费用表即可。在院退费信息需作退费标识并写入数量为负。、农合系统在结算时会相应提供补偿信息到接口库门诊费用结算表T_con3、住院登记表T_con1 ，医院系统对“已结”记录补偿信息定期收取到自身系统中，用于定点医疗机构产报。7、药品分类：1西药、2中成药、3中草药8、财务分类：A (挂号费)、B (诊查费)、C (床位费)、D (检查费)、E (治疗费)、F (护理费)、G (手术费)、H (化验费)、I (其它费用)四、农合系统字典发布表结构T_dic1（补偿药品字典）字 段 名字段含义数据类型长度主键备注dm药品代码Char20YMc1化学名称Varchar80Mc2常用名称Varchar80Py常用名称拼音Varchar40Jxmc剂型名称Varchar50Sx3药品属性Tinyint0甲类1乙类T_dic2（补偿医疗项目字典）字 段 名字段含义数据类型长度主键备注dm项目代码Char20Ymc项目名称Varchar80Py项目拼音Varchar40cwfl财务分类代码Char1Jjdw计价单位Varchar50T_dic3（补偿材料字典）字 段 名字段含义数据类型长度主键备注dm材料代码Char20Ymc材料名称Varchar80Py项名拼音Varchar40Guige规格Varchar50Bz包装Varchar50jjdw计价单位varchar50五、接口库表结构接口表名：T_ CON1 含义：住院登记表字 段 名字段含义数据类型长度主键备注Zyh住院号Char6Y必须写入六位唯一标识号ylzbh医疗证编号Char12必须写入住院登记时要以位长初步判断合法性。Djrq登记日期datetime必须写入如果医院系统没有登记日期，可以等同入院日期。Xb性别tinyint必须写入，1男，2女Hzxm患者姓名Varchar50必须写入Sfzh身份证号Char18如无则写空Csrq出生日期Datetime如无则写空Yj押金总额money必须写入患者在住院期间的所交押金的总和Z_date1入院日期Datetime必须写入Z_date2出院日期Datetime必须写入Djr登记人varChar50住院单登记人，如无则写空。nhzt农合结算状态tinyint必须写入，0在院，1已结，2错帐医院系统第一产生记录时，付默认值0，以后不可更改。Nhid农合结算号int农合系统写入，医院系统不可修改Fee1本次总费用Money农合系统写入，医院系统不可修改Fee2本次补偿额Money农合系统写入，医院系统不可修改Fee3应收现金Money农合系统写入，医院系统不可修改Chr1varchar50暂不使用Chr2varchar50暂不使用Int1int暂不使用Int2int暂不使用Mon1money暂不使用Mon2money暂不使用Dt1datetime暂不使用Dt2datetime暂不使用接口表名：T_CON2 含义：费用表（住院），每日录入的医药项目明细。字 段 名字段含义数据类型长度主键 备注id费用idintY可用于记录医院系统中费用的ID号，用于标识退费记录tf退费标识tinyint0有效、作废，作废记录一定在相应的记录上进行退费标识的改写。也可不使用该标志，将退费记录过滤后，费用传入中间库。（可暂不使用）Zyh住院号Char6必须写入Fysj登记时间datetime必须写入费用的划价时间。xmdm项目编码1Char20必须写入如果为农合补偿项目需要书写对照表中农合代码，如果是自费项目默认0。Xmdm1项目编码char20必须写入，医院系统中该项目的真实编码yyfl医药分类char1必须写入1药品2医疗项目3卫生材料Xmmc项目名称1Varchar80必须写入补偿项目写入农合项目名称，自费项目写入医院项目名称。Xmmc2项目名称Varchar80必须写入，医院系统中该项目的真实名称Xmfl1药品分类Char1如果是药品必须写入，非药品则不写入值。1西药，2中成药，3中草药Zf是否补偿项目Tinyint必须写入0补偿，1自费Dj项目单价Money必须写入Sl项目数量money必须写入je金额Money必须写入Yp_sx3药品属性Tinyint0 甲类1 乙类2 非甲乙类如果不是药品则不写入值Yp_jx药品剂型Varchar50补偿项目写入农合药品剂型，自费项目写入医院药品剂型，如无则不写入值。Yp_gg药品规格Varchar50写入医院药品规格，如无则不写入值。Yp_dw最小单位varchar50写入医院该药品单位，如无则不写入值。Yp_bz包装varchar50写入医院该药品销售包装，如无则不写入值。Yp_bl转换倍率int写入医院该药品单位包装转换倍率，如无则不写入值。Xmfl2医疗项目的财务分类Char1如果是医疗项目必须写入, 非医疗项目则不写入值。注：本分类各省情况不同，如发现不符请告知修正。A (挂号费)B (诊查费)C (床位费)D (检查费)E (治疗费)F (护理费)G (手术费)H (化验费)I (其它费用)Dw医疗项目计价单位Varchar50补偿项目写入农合医疗项目计价单位，自费项目写入医院医疗项目计价单位，如无则不写入值。Yc_gg卫生材料规格Varchar50补偿项目写入农合卫生材料规格，自费项目写入医院卫生材料规格，如无则不写入值。Yc_jjdw卫生材料单位Varcahr50补偿项目写入农合卫生材料单位，自费项目写入医院卫生材料单位，如无则不写入值。Chr1varchar50暂不使用Chr2varchar50暂不使用nt1int暂不使用Int2int暂不使用Mon1money暂不使用Mon2money暂不使用Dt1datetime暂不使用Dt2datetime暂不使用接口表名：T_ CON3 含义：门诊结算表字 段 名字段含义数据类型长度主键备注mzlsh门诊流水号varchar50Y必须写入fph发票号varchar30必须写入ylzbh个人参合号Char12必须写入住院登记时要以位长初步判断合法性。Xb性别tinyint必须写入，1男，2女Hzxm患者姓名Varchar50必须写入Sfzh身份证号Char18如无则写空Csrq出生日期Datetime如无则写空fpsj就诊日期Datetime必须写入Djr结算人varChar50如无则写空。nhzt农合结算状态tinyint必须写入，0等待，1已结，2错帐医院系统第一产生记录时，付默认值0，以后不可更改。Nhid农合结算号int农合系统写入，医院系统不可修改Fee1本次总费用Money农合系统写入，医院系统不可修改Fee2本次补偿额Money农合系统写入，医院系统不可修改Fee3应收现金Money农合系统写入，医院系统不可修改Chr1varchar50暂不使用Chr2varchar50暂不使用nt1int暂不使用Int2int暂不使用Mon1money暂不使用Mon2money暂不使用Dt1datetime暂不使用Dt2datetime暂不使用接口表名：T_CON 含义：费用表（门诊），每日录入的医药项目明细。字 段 名字段含义数据类型长度主键 备注id费用idintY可用于记录医院系统中费用的ID号mzlsh门诊流水号varchar50T_con3外健，T_con3b表保证唯一性fph发票号varChar30必须写入Fysj登记时间datetime必须写入费用的划价时间Xmdm项目编码1Char20必须写入如果为农合补偿项目需要书写对照表中农合代码，如果是自费项目默认0Xmdm2项目编码char20必须写入，医院系统中该项目的真实编码yyfl医药分类char1必须写入1药品2医疗项目3卫生材料将一次性卫生材料与药品进行区分Xmmc项目名称1Varchar80必须写入补偿项目写入农合项目名称，自费项目写入医院项目名称。Xmmc2项目名称Varchar80必须写入，医院系统中该项目的真实名称Xmfl1药品分类Char1如果是药品必须写入，非药品则不写入值。1西药，2中成药，3中草药如果不是药品则不写入Zf是否补偿项目Tinyint必须写入0补偿，1自费Dj项目单价Money必须写入Sl项目数量money必须写入je金额Money必须写入Yp_sx3药品属性Tinyint0甲类1乙类非甲乙类用药用2来标识如果不是药品则不写入值Yp_jx药品剂型Varchar50补偿项目写入农合药品剂型，自费项目写入医院药品剂型，如无则不写入值，如果不是药品则不写入Yp_gg药品规格Varchar50补偿项目写入农合药品规格，自费项目写入医院药品规格，如无则不写入值。如果不是药品则不写入Yp_dw最小单位varchar50必须写入，如果不是药品则不写入Yp_bz包装varchar50必须写入，如果不是药品则不写入Yp_bl转换倍率int必须写入，如果不是药品则不写入Xmfl2医疗项目的财务分类Char1如果是医疗项目必须写入, 非医疗项目则不写入值。注：本分类各省情况不同，如发现不符请告知修正。A (挂号费)B (诊查费)C (床位费)D (检查费)E (治疗费)F (护理费)G (手术费)H (化验费)I (其它费用)如果不是医疗项目则不写入Dw医疗项目计价单位Varchar50补偿项目写入农合医疗项目计价单位，自费项目写入医院医疗项目计价单位，如无则不写入值。如果不是医疗项目则不写入Yc_gg卫生材料规格Varchar50补偿项目写入农合卫生材料规格，自费项目写入医院卫生材料规格，如无则不写入值。如果不是一次性卫生材料则不写入Yc_jjdw卫生材料单位Varcahr50补偿项目写入农合卫生材料单位，自费项目写入医院卫生材料单位，如无则不写入值。如果不是一次性卫生材料则不写入Chr1varchar50暂不使用Chr2varchar50暂不使用nt1int暂不使用Int2int暂不使用Mon1money暂不使用Mon2money暂不使用Dt1datetime暂不使用Dt2datetime暂不使用