北航冠新新农合结算系统与医院管理信息系统接口说明书.docx
《北航冠新新农合结算系统与医院管理信息系统接口说明书.docx》由会员分享，可在线阅读，更多相关《北航冠新新农合结算系统与医院管理信息系统接口说明书.docx（46页珍藏版）》请在冰豆网上搜索。
北航冠新新农合结算系统与医院管理信息系统接口说明书
新农合结算系统与医院管理信息系统
接口说明书
北京北航冠新世纪软件有限公司
二零一二年一月一十四日
成文信息
主题词
新型农村合作医疗结算系统与医院管理信息系统接口说明
作
者
北航冠新开发部农合课题组
文档类别
技术文档
审
核
谷贺
批
准
北京北航冠新世纪软件有限公司
文档性质
技术文档
主
送
合管中心
存档日期
2012年1月14日
抄
送
各定点医疗机构并HIS开发商
发布日期
2012年1月14日
签收信息
发送方
接收方
代表人：
代表人：
日
期：
日期：
变更信息
版本
变更原因
作者
日期
1.0.0
原稿
北航冠新开发部
2006年1月1日
2.0.0
根据合管中心要求在院患者信
北航冠新开发部
2007年7月1日
息传输，及相关细节改动
3.0.0
《接口文档
》
北航冠新开发部
2010年7月16日
2.0（2007-07-01）.doc
《接口文档2.0》（2009-08-20）.doc
整合
4.0.0
1．广西田东需要把门诊结算跟
T_CON2增加
2010年11月23日
HIS对接，使用HIS打印发票。
2．河北青州需要实现门诊结算
床位号、主治医生、
跟HIS系统对接。
科室
5.0.0
增加“联系方式”t_con1.lxdh字
北航冠新开发部
2011年6月23日
新农合定点医疗机构收费软件接口说明书
段
6.0.0Xmmc1项目名称
1长度改为200
北航冠新开发部
2011年9月20日
Xmmc2项目名称
2长度改为200
Mc1化学名称长度改为
200
Mc2常用名称长度改为
200
Mc项目名称长度改为
200
Mc材料名称长度改为
200
Py项目拼音长度改为
200
Py常用名称拼音长度改为200
7.0.0增加“优惠金额”t_con2.yhje字北航冠新开发部
2012年1月14日
北京北航冠新世纪软件有限公司第1页
新农合定点医疗机构收费软件接口说明书
目录..............................................................................................................................2
一、方案设计目的及原则2
二、设计方案3
三、功能设计6
四、农合系统字典发布表结构10
五、接口库表结构11
一、方案设计目的及原则
新农合结算系统与医院管理系统接口的采用用于避免农合管理信息系统在进
行补偿结算时重复录入医院管理信息系统已经操作的大量费用信息，提高医院工作人员的工作效率，节约医院的管理成本。
医院管理信息系统与参合病人结算系统的接口方式采用的是一种外挂方式，即
北京北航冠新世纪软件有限公司第2页
新农合定点医疗机构收费软件接口说明书
两个系统的通过外部接口数据库进行数据交互，达到一种数据准确传递状态。
此项设计不仅给合管中心的工作带来极大的方便，保证各类数据交互的准确与完整。
同时，也避免HIS厂商开发复杂度，大大缩短接口的调试时间。
由于各县合管中心使用的都是统一的软件系统，而各定点医疗机构所使用的HIS则千差万别，所以定点医疗机构在与参合病人结算系统接口时就需要按全局的要求出发，以满足系统正常开通运行。
农合管理信息系统和医院管理信息系统的接口功能应保证两系统业务主线的独立性，使医院管理信息系统录入的明细费用通过接口直接导入农合系统内进行结算，两系统仅以中间数据载体进行交互，不参与其各自程序的执行。
说明：
为方便阐述，以下“农合管理信息系统”简称农合系统，“医院管理信息系统”简称医院系统。
二、设计方案
1、设置接口服务器，建立接口数据库和接口表
（1）在医院设置一台服务器（物理上可以利用医院系统数据库服务器），在该服务器上建立接口数据库和数据表（也称中间表）。
（2）医院系统负责将农合需要结算的数据按照合管中心的要求按照两种方式将参合病人登记、费用信息写入接口库中间表，一是：
出院结算后写入，用于农合系统的结算；二是实时写入或是每天定时写入，用于医院每天定时向合管中心上报在院患者登记及费用信息。
（3）农合系统负责从该数据库接口表中取出相应的数据，提供合管中心在院患者审核功能及农合系统补偿结算功能，并向接口库回写结算信息。
（4）接口库要求：
接口数据库采用SqlServer2000，接口数据库名称建议为
hzyl_his，接口数据库访问用户和密码同时开放与医院管理系统与农合系统，如果希望将接口表建立在医院系统数据库内，需向农合系统开放医院数据库名称、访问用户和密码。
2、形成医院系统与农合系统药品、医疗、材料项目对照关系
（1）农合系统提供最新的农合医药项目补偿表（Excel格式），合管中心向定
北京北航冠新世纪软件有限公司第3页
新农合定点医疗机构收费软件接口说明书
点医疗机构下发，医院系统按照中心下发通知接收该表，导入项目对照库（医院系统自定义），根据该表提供项目制定医院系统医药项目表对应的对照表。
注意事项：
农合系统提供的只是补偿医药项目，凡是医院系统医药项目不能在农合补偿表里找到对应项目的，即被当作自费项目处理。
（2）农合补偿项目表分为三类：
药品表、医疗（诊疗）项目表、卫生（一次性）材料表。
（3）由于各医院系统定义的医药项目主键规则各不相同，项目对照表的表结
构和提供给医院进行项目对照的功能由各医院系统开发商自行设计，下面的对照表（样例）仅供参考。
（4）农合项目和医院项目的对照关系是一对多的对照关系，即一个农合项目可以对应多个医院项目，但医院项目最多可以对应一个农合项目。
确保医院系统向农
合系统提供费用信息的唯一性与可辨别性。
药品表样例（药品编码为农合药品唯一索引值）
药品编码
规范名称
常用名称
常用拼音码
剂型
药品分类
101001
氨氯西林
氨氯西林
alxl
注射剂
甲类
101002
头孢氨苄颗粒剂
头孢氨苄颗粒剂
tbabklj
颗粒剂
甲类
101003
（复方）穿心莲片
炎虎宁
yhn
其它
甲类
101004
红霉素
红霉素
hmszsj
注射剂
甲类
医疗表样例（药品编码为农合医疗项目唯一索引值）
医疗编码
项目名称
项目拼音
财务分类代码
计价单位
11020000500
住院诊查费
Zyzcf
B
日
11090000103
普通病房床位费（二人间）
Ptbfcwferj
C
日
11090000119
普通病房床位费（四人间以上加床）
ptbfcwfsrjysjc
C
日
11090000120
普通病房床位费（三人间加床）
ptbfcwfsrjjc
C
日
材料表样例（药品编码为材料唯一索引值）
北京北航冠新世纪软件有限公司第4页
新农合定点医疗机构收费软件接口说明书
材料编码
材料名称
项目拼音
规格
包装
计价单位
1201000111g
一次性吸痰管（硅胶）
ycxxtg
个
1201000111i
一次性吸痰管（负压吸痰管）
ycxxtg
个
1203000001a
吸氧过滤器（吸氧面罩）
xyglq
个
1203000001b
吸氧过滤器（双腔吸氧管）
xyglq
条
对照表样例：
（注：
医药分类中
1表示药品，2表示医疗，3表示材料）
序号
农合项目编码
医院项目编码
医药分类
其他对照项目
1
101001
11010001a
1
2
101001
11010001b
1
3
101002
110100002
1
4
101003001
20100011
2
5
101004002b
330100026
2
6
1201000111g
10101
3
7
1201000111i
10212
3
3、农合系统医药补偿表的发布与接口对照表的更新
农合系统定期向医院系统发布最新农合医药补偿项目表（excel格式）。
医院系统根据农合系统的最新发布，将补偿项目正确的接收到项目对照用数据库与接口库中，同时提供前台应用，使医院人员可以调整医院医药项目表与农合补偿项目表的
对照，保障医院系统提供的费用信息可以被农合系统识别。
同时提供对照情况查询、打印功能（功能规格按照合管中心要求制定），用于合管中心定期到医疗机构现场检查工作。
4、两系统的数据交互
（1）农合系统与医院系统完全通过接口库进行数据交互，从操作上看，除农合系统在结算成功后，回写结算状态结算数值（参看中间表结构）；医院系统的门诊退费与住院招回需要得到农合系统退结确认（结算状态的处理），两系统的业务互不干
北京北航冠新世纪软件有限公司第5页
新农合定点医疗机构收费软件接口说明书
扰。
医院系统登记参合人员的基本信息后，可以直接进行门诊划价收费与住院病人
结算，当时无需农合系统的认证，即医院的业务处理不直接受到农合系统干预。
（2）住院登记费用信息按照合管中心管理要求按两种方式写入接口库（参看
二.1.
（2）说明）；门诊登记信息与费用明细结算后一次性写入接口库。
注意：
对于有在院患者审核要求的合管中心所辖医院，其住院信息接口方式按照二.1.
（2）说明要求执行。
住院患者结算后，可重新写接口库，农合系统重新接收，保证医院系统与农合系统的数据一致性。
合管中心无此要求的医院，可在出院结算后一次性写入接口库。
三、功能设计
（一）医院系统功能
声明：
由于门诊接口支持的交互数量大、两系统交互响应要求更高，对于有门诊接口需求的用户，需提前与开发商联系，以便安排接口功能的开放及调试工作。
以下提供门诊接口方案用于用户参考选用。
1、在医院设置接口服务器，建立接口数据库和接口表
协商医院设置一台接口服务器，（建议：
一般可建立在医院系统服务器本机），
按照农合系统提供的规则建立接口数据库和接口表（注：
数据库名建议定为hzyl_his，也可将表建立在医院系统数据库），提供给农合系统访问该服务器的名称、
登录数据库及访问用户名和密码，并保证农合系统具有读写该数据库中间表的权限。
2、农合系统补偿项目表对照维护功能
（1）医院系统提供医院工作人员日常维护农合系统补偿项目表的对照功能。
医院工作人员根据农合系统提供的补偿项目表与本院系统的医药项目表进行对照，建立对照关系表，用于医院系统写入接口库医药明细费用时区分出自费和补偿项目，并可准确、完整的按照中间表项目要求写入数据。
（2）对照关系表由医院系统参照农合系统提供的费用表T_CON2\T_CON4所
需信息自行设计，本方案中不做规定。
（3）对照关系表要保证HIS系统能将费用项目准确地对应于合管中心下发的
北京北航冠新世纪软件有限公司第6页
T_CON1中，标识“在院”状态。
T_con1中的相应信息。
新农合定点医疗机构收费软件接口说明书
对照表项目。
并完整、准确地按照T_CON2\T_CON4要求写入数据，农合系统在接收接口库数据时，将按照中间表说明进行校验，拒绝接收非法数据。
3、参合人员门诊划价收费、住院登记时基本信息的录入
（1）鉴于农合医疗证目前以手工证为主，医院系统在门诊划价、住院登记时先将患者设置农合身份标识。
（可通过患者人员类别定义）
（2）当该患者为农合类别人员时，门诊划价收费、住院登记直接提供个人参合
号的录入入口，在登记医院系统患者基本信息的同时，按照T_CON1/T_CON3要求向接口库写入患者基本信息，用于农合系统的身份认证与结算。
注意：
使用磁卡、IC卡认证患者身份的用户需向农合系统开发商申请项目化处
理。
4、门诊划价收费（选用）
门诊划价收费成功时，将农合患者基本信息写入接口库门诊收费表T_con3，以医院系统中门诊收流水号为主健，标明记录状态为“等待”农合系统结算。
同时将费用信息根据T_con4要求写入其中。
５、门诊退费（选用）
医院系统在门诊退费时，如果接口库门诊结算表T_con3中该患者记录仍为“等
待”状态，医院系统先将该条记录连同其费用明细在中间库全部清空，在进行正常
退费处理。
退费后，将最新的划价收费信息按照上述第4条“门诊划价收费”要求
进行接口库的写入。
农合系统在结算成功时，会将补偿信息写入接口库门诊结算表T_con3中，并标
识该条记录已经在农合系统中结算成功，医院系统在退费处理时，首先判断T_con3中该条记录是否是已结，如果为农合结算有效记录，医院系统将不可执行门诊退费
操作。
农合系统将该条结算信息退结后，回写接口库T_con3表中该条记录的状态标识为“等待”，医院系统方可按照“等待”状态执行正常退费操作。
6、住院登记
按照合管中心数据上传时间要求向接口库写入在对住院登记信息进行修改的同时，更新接口库
北京北航冠新世纪软件有限公司第7页
新农合定点医疗机构收费软件接口说明书
删除在院患者住院登记信息时，医院系统应同时清空接口库中T_con1与
T_con2中相应记录。
7、住院划价
按照合管中心数据上传时间要求，依照对照关系表，将患者费用信息写入接口费用表T_con2中。
8、在院病人退项目
医院系统对于在院病人的费用明细退费记录作退费标识，数量以负值表示。
除
划价时间、退费标识、数量以负数表示（绝对值应小于该项目的正值划价总量）外，其他项目应保持与该项目的正常划价一致。
注意：
对于在院患者已写入中间库的费用记录，如果医院系统修改某条记录，一律先按照退项目进行错误记录处理后，再写入正确的修改后记录。
9、病人结算
医院系统在病人结算时，将最新的住院登记信息，押金信息按照住院号进行T_con1表的数据更新，押金值只要汇总数，不区分押金交款方式。
同时按照住院号，将T_con2表的信息进行重写，退费作废记录保留。
10、病人招回
农合系统在结算成功时，会将补偿信息写入接口库住院登记表T_con1中，并
标识该条记录已经在农合系统中结算成功，医院系统在做招回处理时，首先判断
T_con1中该条记录是否是“已结”，如果为农合结算有效记录，医院系统将不可执
行招回操作。
农合系统将该条结算信息退结后，回写接口库T_con1表中该条记录的状态标
识为“未结”，医院系统方可进行召回操作。
（二）农合系统
1、农合系统药品、医疗、材料字典的发布功能
农合系统向医院系统提供补偿项目字典（以excel格式提供）用于和医院医药
项目字典对照。
北京北航冠新世纪软件有限公司第8页
新农合定点医疗机构收费软件接口说明书
2、农合系统接收数据身份确认
农合系统对接收数据时进行复核，对于不合法的数据（比如录入了错误的参合号，当参合人手持医疗证或身份证时必须根据接口表发票号、住院号查询出的人员基本信息做对照，如有不符按照参合人手持的医疗证号为准）需医院系统进行接口数据库的信息更正。
3、农合系统结算
农合系统根据接口数据库接收数据，执行补偿算法，进行参合人员医疗费用补
偿结算，并向T_con1，T_con3表返回结算信息，同时更新T_con1与T_con3状态。
４、农合系统退结
针对门诊退费与住院招回功能，农合系统通过退结功能回执T_con1与T_con3
状态标识值，农合系统退结成功后，医院系统方可执行门诊退费与住院招回。
（三）注意事项
１、两系统交互数据的确定记录的关键字门诊流水号、住院使用住院号６位。
２、在门诊划价收费、住院登记时录入合法的个人参合号，位长为12位。
注意是
个人参合号而不是家庭参合号，一般医疗证上的号码为家庭参合号，应明确患
者的个人参合号再登记，并保证位长为12位，否则系统不允许录入。
3、方案中医院系统的门诊划价收费时、住院登记、病人结算无需得到农合系统确认。
保证将人员基本信息，费用信息准确写入接口数据库即可。
４、医院系统门诊退费、住院招回处理时必须得到农合系统该条记录的退结处理确认，方可执行。
５、医院系统可不提供具体的门诊退费费用明细，以门诊流水号或发票号为准重新写接口库门诊收费表与门诊费用表即可。
在院退费信息需作退费标识并写入数量为负。
６、农合系统在结算时会相应提供补偿信息到接口库门诊费用结算表T_con3、住院登记表T_con1，医院系统对“已结”记录补偿信息定期收取到自身系统中，用于定点医疗机构产报。
北京北航冠新世纪软件有限公司第9页
新农合定点医疗机构收费软件接口说明书
7、医药项目分类：
1（药品）、2（医疗）、3（卫生材料）
8、药品分类：
1（西药）、2（中成药）、3（中草药）
9、财务分类：
A（挂号费）、B（诊查费）、C（床位费）、D（检查费）、E（治疗费）、F（护理费）、G（手术费）、H（化验费）、I（其它费用）
四、农合系统字典发布表结构
T_dic1（补偿药品字典）
字段名
字段含义
数据类型
长度
主键
备注
Dm
药品代码
Char
20
Y
Mc1
化学名称
Varchar
200
Mc2
常用名称
Varchar
200
Py
常用名称拼音
Varchar
200
Jxmc
剂型名称
Varchar
50
Sx3
药品属性
Tinyint
0甲类1乙类2非甲乙
T_dic2（补偿医疗项目字典）
乙、类
字段名
字段含义
数据类型
长度
主键
备注
Dm
项目代码
Char
20
Y
Mc
项目名称
Varchar
200
Py
项目拼音
Varchar
200
Cwfl
财务分类代码
Char
1
Jjdw
计价单位
Varchar
50
T_dic3（补偿材料字典）
字段名
字段含义
数据类型
长度
主键
备注
Dm
材料代码
Char
20
Y
Mc
材料名称
Varchar
200
北京北航冠新世纪软件有限公司
第10
页
新农合定点医疗机构收费软件接口说明书
Py
项名拼音
Varchar
200
Guige
规格
Varchar
50
Bz
包装
Varchar
50
Jjdw
计价单位
varchar
50
五、接口库表结构
接口表名：
T_CON1
含义：
住院登记表
字段名
字段含义
数据类型
长度
主键/
默认
外健
值
Zyh
标识住院号
Char
6
Y
Not
null
备注
HIS写入（必填）；
六位唯一标识号（流水号形
式）。
存在分院的医院，其
各分院不在同一网络内无
法获取唯一住院号。
HIS厂
商应在住院号前第一位加
字母（a-z）用于区分同一
医院不同分院的住院登记信息，余下五位采用五位流水号。
Zyh1
真实住院号
Varchar
50
Not
HIS写入（必填）
null
参合人员当次住院的医疗
机构住院号。
Fph
结算发票号
Varchar
30
Null
HIS写入（必填）；
向农合系统提交结算时写
入。
出院结算时的财务发票号。
Fpsj
发票时间
Datetime
null
HIS写入（必填）。
北京北航冠新世纪软件有限公司
第11
页
新农合定点医疗机构收费软件接口说明书
Ylzbh
个人参合号
Char
12
Not
null
此次费用医院结算时间，即
医院开具发票时间。
HIS写入（必填）；
农合系统将作严格验证。
农合系统刷卡结算时，允许HIS写入的个人参合号长度为10位，农合系统回写
此项。
Hzxm
患者姓名
Varchar
50
Not
HIS写入（必填）；
null
农合系统将按照合管中心
规定作验证。
Xb
性别
Tinyint
Not
HIS写入（必填）；
null
1男，2女；农合系统将按
照合管中心规定作验证
Sfzh
身份证号
Char
18
Nu
升级会员 