定点医疗机构API开发手册最新.docx
《定点医疗机构API开发手册最新.docx》由会员分享，可在线阅读，更多相关《定点医疗机构API开发手册最新.docx（52页珍藏版）》请在冰豆网上搜索。
定点医疗机构API开发手册最新
文档编号：
分册名称：
定点医疗机构API开发手册第1.1版
定点医疗机构API
开发手册
河北东软软件有限公司
2009年4月8日
版权声明
《定点医疗机构API开发手册》的版权归河北东软软件有限公司所有。
未经河北东软软件有限公司的书面准许，不得将本规范的任何部分以任何形式、采用任何手段（电子的或机械的，包括照相复制或录制）、或为任何目的，进行复制或扩散。
Copyright©2009河北东软软件有限公司。
版权所有，翻制必究。
阅读指南
〖手册目标〗
本手册详细介绍了本系统的各种功能，帮助用户迅速了解并掌握系统的管理模式和使用方法。
〖阅读对象〗
本手册是针对使用职工医疗保险定点医疗机构API的社区门诊、医院编写的，用户在使用本系统之前，应先阅读本手册，可了解并掌握该系统的使用。
〖手册构成〗
本手册分成五章节：
第一章概述。
介绍系统建设背景和目标。
第二章系统介绍。
从设计原理角度进行介绍。
第三章使用说明。
对每个功能函数进行描述和说明。
第四章常见问题。
在系统使用过程中，各个问题进行汇总。
第五章附录。
系统软硬件环境要求，与重要配置信息。
〖手册约定〗
略
变更履历
修改编号
版本
修改内容
修改人
修改日期
1
0.9
文档建立
陈晓明
2009-04-08
2
1.0
根据邢台医疗市级统筹修改个别业务
陈晓明
2013-04-05
3
1.1
1、根据邢台威县农合一体化增加报销类别，KC21中ZKC282改为报销类别，代码值为00—普通住院,01—转入住院,02—意外伤害住院,03—单病种定额住院,04—单病种限额住院,除威县城乡居民参保人外，职工和居民该字段可传空或00。
单病种住院需要从前台做HIS疾病对照。
除00普通住院外，其他报销类别都需要有审批才允许入院。
2、增加19大额门诊医疗类别，目前只有威县城乡居民使用，大额门诊有20中疾病，需要用前台做HIS疾病对照。
陈晓明
2014-12-01
前言
各个地市核心平台本地化推进过程中，一直困扰我们多年问题就是定点结算软件实施给医院内部管理增加了前所未有的挑战。
充分利用现代信息处理技术和科学手段，建立一个功能齐全、既适用于当前各地业务需求，又具有前瞻性的定点医疗机构API，已经十分必要。
本系统是以劳动部与沈阳东软软件股份有限公司等公司合作、共同开发的核心平台管理信息系统为蓝本，并结合各地市业务需求进行开发。
其目标是定点医疗机构结算与医院管理信息系统实现无缝连接。
如果您对本手册的内容或未来修改的内容有任何疑问，请您与河北东软软件有限公司（简称东软）客服联系电话（400-6120816）。
目录
版权声明2
阅读指南3
前言4
第一章概述9
§1.1背景9
§1.2目标9
第二章系统介绍10
§2.1方案10
第三章使用说明11
§3.1使用流程11
§3.2医保接口表12
§3.2.1病人就诊信息KC2112
§3.2.2费用明细信息KC2214
§3.2.3医保接口表说明15
§3.3接口函数15
§3.3.1comminterface函数15
§3.3.2业务代码表16
§3.3.3指标代码表24
第四章常见问题28
§4.1关于索引使用28
§4.2读取ntdll.dll错误28
§4.3其它提示28
第五章附录29
§5.1环境要求29
§5.2文件清单与配置30
§5.3ODBC配置说明31
§5.4HIS完善建议32
§5.4.1费用录入32
§5.4.2退费33
§5.4.3门诊结算33
§5.4.4入院登记35
§5.4.5入院登记回退35
§5.4.6出院登记36
§5.4.7住院结算36
§5.4.8结算回退37
§5.4.9医保与非医保业务转换38
§5.4.10其它建议38
§5.5定点医疗机构注意事项39
§5.5.1HIS开发商的选择39
§5.5.2其他要求：
39
§5.6定点医疗机构工作说明39
§5.7邯郸结算单据40
§5.7.1门诊40
§5.7.2住院41
§5.7.3生育住院结算单42
第一章概述
§一.1背景
定点医疗机构结算业务是核心平台本地化实施重要组成部分。
我们先后采用定点医疗机构结算软件、定点医疗机构动态库接口方式逐步实现与医院HIS的对接。
通过东软公司近10年的技术和业务积累，我们在定点医疗机构动态库接口基础上推出新版接口，即定点医疗机构API.。
定点医疗机构API在完善原来接口基础上，提高灵活性、方便二次开发，兼容原来接口等特性。
§一.2目标
本文档是定点医疗机构医院管理信息系统（简称HIS）的开发商完善HIS的开发手册。
HIS开发商通过阅读本文档来指导HIS系统开发者调用医保API，实现定点医疗机构的HIS与定点医疗机构结算
第二章系统介绍
定点医疗机构API提供实现医疗保险（简称医保）政策需求的API接口函数。
定点医疗机构的HIS系统通过调用API接口函数，实现医疗保险定点结算业务，同时，HIS系统管理API接口函数返回值。
§二.1方案
图一
说明：
1.HIS开发商按照医疗保险政策的改造HIS。
2.HIS按照医保接口表要求建立接口表或视图（简称医保接口表）。
接口表以只读权限赋予医保前置机数据库的用户。
接口表的数据必须是真实、实时反映就诊信息和费用信息。
3.HIS系统涉及参加医疗保险人员时，HIS开发商需要按照手册完善HIS系统。
第三章使用说明
§三.1使用流程
浅绿色为定点医疗机构API接口处理。
图二
首先，HIS调用医保API接口函数得到医保患者的信息，办理HIS系统的门诊登记、入院登记、费用录入等。
同时，实时产生医保接口数据（开发过程中，凡是在HIS系统内产生医保数据，就要同时反映在医保接口表内。
）。
其次，HIS向医保API接口函数发送结算请求，医保API接口函数从HIS系统数据库中医保接口表读取医保所需数据，根据医保政策通过计算产生医保待遇结算信息，保存到医保前置机数据库。
最后，医保API接口函数将计算结果返回给HIS系统调用，便于其进一步处理、生成HIS的结算信息保存在HIS数据库。
§三.2医保接口表
黄色背景为医保接口表的主键。
§三.2.1病人就诊信息KC21
序号
字段名
类型长度
是否可空
主键
备注
01
AKC190
VARCHAR2（15）
否
是
1.住院号（门诊号）即病人挂号或住院登记时的号码,由于此号是本表的主键,如果HIS系统的门诊号（住院号）对于一个病人是终生的，可以把住院号和流水号（或序号）组合起来形成唯一的号码。
2.住院号（门诊号）要求：
使用15位标识XXXXXXXXXXXXXXX。
02
CKC502
VARCHAR2（18）
否
ic卡号（通过API接口得到）
03
AAC003
VARCHAR2（8）
否
病人姓名（通过API接口得到）
04
AAC001
VARCHAR2（20）
否
个人编号（通过API接口得到）
05
AAB001
VARCHAR2（14）
否
单位编号（通过API接口得到）
06
AAE073
NUMBER（15,0）
审批编号（通过API接口得到）
如果医保病人从其它医院转入,按转入登记时,要录入审批编号,如果没有审批编号,提示病人到医疗保险中心去申请,结算时没有审批编号,将不能按转院类别结算,只能按普通住院结算,
如果是生育入院，需要录入审批编号
07
AKA130
VARCHAR2（3）
否
医疗类别详见指标代码标AKA130
08
AKC192
DATE
否
入院日期（如果是门诊，则为门诊日期）
09
AKC193
VARCHAR2（20）
入院诊断疾病编码
10
AKC194
DATE
出院日期（出院结算时必须填写）
11
AKC195
VARCHAR2（3）
出院原因详见指标代码标AKC195
12
AKC196
VARCHAR2（20）
出院疾病诊断编码
13
AAE011
VARCHAR2（20）
否
经办人
14
AAE036
DATE
否
经办日期
15
AKA121
VARCHAR2（50）
疾病名称
16
CKC126
NUMBER（1,0）
传输标志详见指标代码标CKC126
17
zkc271
VARCHAR2（20）
否
医生姓名
18
zkc272
VARCHAR2（20）
否
科室名称
19
zkc274
VARCHAR2（50）
入院诊断疾病名称,对于住院审批的入院诊断
20
zkc275
VARCHAR2（50）
出院疾病诊断名称
21
zkc276
VARCHAR2（20）
病种编码1
22
zkc277
VARCHAR2（50）
病种名称1
23
zkc278
VARCHAR2（20）
病种编码2
24
zkc279
VARCHAR2（50）
病种名称2
25
zkc280
VARCHAR2（20）
病种编码3
26
zkc281
VARCHAR2（50）
病种名称3
27
zkc282
VARCHAR2（50）
否
报销类别详见指标代码标ZKC082
医疗类别为住院时，必须填写，如果为空，则按普通住院结算
28
Cka040
Varchar2（10）
病房号（住院必须填写）
29
Cka041
Varchar2（10）
病床号（住院必须填写）
30
Zhuzhi
Varchar2（40）
住址
31
Zhiye
Varchar2（40）
职业
32
Amc026
Varchar2（3）
生育类别详见指标代码表AMC026，
出院结算时必录
33
Amc090
Varchar2（20）
相关手术编号详见指标代码表CKC090，
对于相应的生育类别，必须录入，详见代码表中备注
34
Amc001
Varchar2（20）
准生证号
35
Amc008
Varchar2（20）
出生证编号
36
Amc013
NUMBER（1,0）
胎儿数
§三.2.2费用明细信息KC22
序号
字段名
类型长度
是否可空
主键
备注
01
AKC190
VARCHAR2（15）
否
是
住院号（门诊号）
门诊号（住院号）即病人挂号或住院登记时的唯一标示号码,由于此号是本表的主键,所以此号码是能够标志区分病人的信息的。
要与kc21表对应记录住院号一致。
02
AKC220
VARCHAR2（20）
否
是
处方号
03
AAE072
VARCHAR2（18）
否
单据号
单据号即对于一次结算生成的收据号---不同于住院（门诊号）的唯一表示号码。
住院预结算时因没有正式结算此处使用住院号，正式结算时再重新修改为正式的单据号。
04
AKC221
DATE
否
是
处方日期
05
AKC515
VARCHAR2（20）
否
是
医院收费项目编码（HIS系统）
06
AKC223
VARCHAR2（100）
收费项目名称
07
AKC224
VARCHAR2（3）
否
药品/诊疗/床位费详见指标代码标AKC224
08
AKC225
NUMBER（12,4）
否
单价
09
AKC226
NUMBER（9,3）
否
数量
10
AKC227
NUMBER（12,2）
否
金额
11
AKA070
VARCHAR2（100）
剂型
12
AKA071
NUMBER（5,2）
每次用量
13
AKA072
VARCHAR2（20）
使用频次
14
AKA073
VARCHAR2（50）
用法
15
AKC229
NUMBER（4.1）
执行天数
16
AAE040
DATE
否
是
结算日期
17
ZKA100
VARCHAR2（50）
规格名称
18
ZKA101
VARCHAR2（15）
度量单位
19
AAE073
NUMBER（15,0）
审批编号
20
CKC048
VARCHAR2（3）
审核标志
21
CKC126
NUMBER（1,0）
传输标志详见指标代码标CKC126
22
CKC125
NUMBER（1,0）
作废标志详见指标代码标CKC125
处方明细信息（主键:
AKC190、AKC220、AKC221、AKC515、AAE040）
§三.2.3医保接口表说明
1.如果HIS开发商所使用的数据库不是ORACLE,那么，创建医保接口表时，把医保接口表的表名,表名和字段名设置为大写。
2.医保接口表可以建成实体表，也可以建成视图。
3.医保接口表建在HIS系统数据库。
4.上述接口表中的字段类型是按照ORACLE类型名称给出的，如HIS系统使用的不是ORACLE数据，可参考建立对应的数据类型。
具体各数据库系统之间的数据类型对应关系，请参考相应的文献。
§三.3接口函数
§三.3.1comminterface函数
语法：
intcomminterface（in业务类型,in业务入参,out执行结果，in居民医疗证号）
参数描述：
业务类型in具体操作的业务类型代码，请参考业务类型代码表
业务入参in指定业务类型所需要的入参，注意遵守格式，请参考业务类型代码表。
执行结果out请参考业务类型代码表中的出参格式和出参描述。
居民医疗证号in填写当前办理业务人员的个人编号（居民医疗证号）。
注：
红色字体为新增内容，无卡办理业务时使用。
参保人员不持卡消费，可根据医疗证号或身份证号确认身份，办理业务。
居民也使用此参数，根据医疗证号确认身份，办理业务。
读卡办理业务时设置为默认值：
“0”；
返回值：
0表示成功其它表示失败
当返回值不等于“0”它时，执行结果内是错误提示信息。
所有参数都是字符型，同一参数内的不同字段间使用“|”（纵向分隔符）分隔，最后以|XX结束。
日期型格式：
“yyyymmddhhmiss”。
其中，hh为24小时制。
举例:
读取人员基本信息
A、入参列举：
业务类型“AA311010”，业务参数是“”，“0”。
B、调用实现：
comminterface（’AA311010’,‘’,V_执行结果，“0”）。
C、执行结果：
“IC卡号|身份证号|姓名|性别|出生日期|个人编号|单位编号|单位类型|人员类别|人员状态|公务员标识|住院状态|所在区号|老系统编号|缴费月数|XX”。
§三.3.2业务代码表
序号
业务功能
业务类
型代码
入参格式
出参格式
出参描述
1
读人员基本信息
AA311010
无
个人编号|身份证号|单位编号|IC卡号|姓名|性别|出生日期|人员类别|参保日期|人员状态
|变更日期|定点医院1|定点医院2|定点医院3|定点医院4|定点医院5|出院日期|住院状态|预留字段|预留字段|预留字段|区号|单位类型|预留字段|公务员|缴费月数|职务级别|定点医院名1|定点医院名2|定点医院名3|慢性病医院1|慢性病医院2|慢性病医院3|慢性病医院4|慢性病医院5|定点医院名4|定点医院名5|老医保编号|单位名称|行政级别|预留字段|预留字段|灵活就业标志|逻辑卡号|预留字段|职工居民区分标志（职工，居民）|个人ID|单位ID|参加工作日期|XX
第46个字段为区分职工还是居民标志，
如果区号为130533的，为威县参保人。
2
读人员账户信息
AA311011
无
年度|历年结转|本年注入|刷新时间|费用合计|住院次数|帐户支出|统筹支出|个人支付|自费（用做符合基本医疗累计）|结转金累计|住院统筹|门诊大病统筹|门诊特殊统筹累计|门诊特殊疾病起付标准累计|家庭病床累计|符合基本医疗累计|进入统筹累计|预留字段|公务员统筹累计|预留字段|居民普通门诊统筹支付累计|预留字段|住院符合基本医疗|慢性病起付标准|居民普通门诊统筹符合基本医疗|大型检查统筹累计|大型检查符合基本医疗|门诊特殊病符合基本医疗|转外门诊统筹累计|转外门诊符合基本医疗|XX
注意：
1）呼盟读人员账户信息自费字段返回的是“住院符合基本医疗”；住院符合基本医疗字段返回的是“符合基本医疗累计”；符合基本医疗累计字段设为预留字段；第21个字段不设预留字段，改成大病统筹支付累计；
2）邢台账户余额=2+3-7。
3）邯郸呼盟账户余额=19-7
3
读人员基本信息和账户
AA311012
无
读人员基本信息的出参-‘|XX’+'|'+读人员账户信息的出参
4
读取人员封锁信息（中心）
AB31KC08
个人编号
封锁标志|封锁开始时间|封锁结束时间|封锁原因|封锁级别|XX
封锁级别：
0不封,1统筹不可用,2全封锁
5
删除错误数据
BB310000
个人编号|门诊住院号|单据号
无
6
医保数据传输
BB310001
个人编号|门诊住院号
无
7
读取药品信息
BB31KA02
药品编码（His内码）
费用等级（甲类或乙类或丙类）|门诊自付比例|住院自付比例|药品最高限价（如果为0或空，则表示没有限价）|费用类别（西药、中草药等）|限制性用药标志|限制性用药说明|是否儿童用药标志|XX
1.收费项目等级AKA065
2.限制性用药标志：
0不限制，1限制
3.是否儿童用药标志：
0不是，1是
8
读取诊疗信息
BB31KA03
诊疗编码（His内码）
费用等级（甲类或乙类或丙类）|门诊自付比例|住院自付比例|最高限价|限价标志|特殊诊疗标志|特殊诊疗限价|门诊费用类别（检查费、床位费等）|住院费用类别（检查费、床位费等）|体内置换材料标志|XX
1.收费项目等级AKA065
2.体内置换材料标志：
0不是体内置换材料，1是体内置换材料
9
读人员审批信息
BB31KC20
个人编号|审批类别|疾病编码（4、6类别的审批，需要录入疾病编码，其他类别的审批疾病编码为空即可）
审批标志|XX
0,未通过审批；1，已通过审批
10
读人员已审批过的慢性病信息
BB31SPXX
个人编号
审批病种his内码1|审批病种名称1|审批病种his内码2|审批病种名称2
此函数只适用于邯郸
11
读人员已审批过的特殊病信息
BB31TSXX
个人编号
审批病种his内码1|审批病种名称1|审批病种his内码2|审批病种名称2
此函数只适用于邢台
12
读疾病药品对照信息
BB31ZK06
疾病编码|药品编码（诊疗编码）
对照标志|XX
对照标志：
0没有对照信息，1有对照信息
13
门诊结算（预结算）
BC311002
同门诊结算
同门诊结算
14
住院结算（预结算）
BC311003
同住院结算
同住院结算
15
入院登记
CC311001
个人编号|门诊住院号
无
16
门诊结算
CC311002
个人编号|门诊住院号|医疗类别|单据号|经办人
医疗费用总额|本次符合基本医疗保险费用金额|本次符合基本医疗保险外自费金额|本次特检自付金额|本次特检统筹支付金额|本次特治自付金额|本次特治统筹支付金额|本次个人帐户支付金额|本次统筹支付金额|本次现金支付金额|本次公务员补助支出金额|结算后IC卡余额|本次帐户应支付|本次进入大病部分|本次大病支付金额|本次超过大病封顶线|本年历次大病支付累计|XX
支付方式：
1现金支付，0账户支付
17
门诊结算单打印
BB310002
个人编号|门诊住院号|单据号|经办人
医保中心名称|收据号|定点医疗机构名称|科室|姓名|人员类别|个人编号|处方号|IC卡号|西药|中成药|草药|化验|检查|放射|治疗|手术|床费|其他|应收金额|实收金额|自付金额|个人账户支付|本次支付后账户余额|公务员支出|本年支付累计|收费员|打印日期
注意：
1、此函数只适用于邯郸
2、此函数返回值用法请参考5.7邯郸结算单据
18
住院结算
CC311003
个人编号|门诊住院号|医疗类别|单据号|经办人|支付方式（账户支付或是现金支付）|账户支付金额
医疗费总额|本次医保外自费金额（自费类费用）|本次乙类自费金额|本次特检自付金额|本次特检统筹支付金额|本次特治自付金额|本次特治统筹支付金额|本次起付标准自付金额（本次起付线以内支付）|本次分段自付金额|本次超过统筹封顶线个人自付金额|历次符合基本医疗保险累计金额|本次符合基本医疗保险费用金额|预留字段|本次进入统筹费用金额|本次帐户支付金额|本次统筹支付金额|本次现金支付金额|本次公务员补助支出金额|结算后IC卡余额|本次起付线标准|本次帐户应支付|本年住院次数|本次进入大病部分|本次大病支付金额|本次超过大病封顶线|本年历次大病支付累计|XX
支付方式：
1现金支付，0账户支付
注意：
1.传入参数中的“支付方式”目前只适用于呼盟，其他地市传入此参数时可以为空字符。
1.传入参数中的“账户支付金额”只适用于邯郸，其他地市传入此参数时可以为空字符。
19
住院结算单打印
BB310003
个人编号|门诊住院号|单据号|经办人
医保中心名称|医院住院号|单据号|定点医院名称|科室|出院次数|患者姓名|住院号|入院日期|出院日期|住院天数|个人编号|IC卡号|人员类别|是否公务员|床位费|西药|中成药|中草药|化验|检查|治疗|放射|手术|血费|输氧|冷暖|其他|合计|实收金额|甲类药费|甲类诊疗|标准床费|乙类药费|乙类诊疗|自费药费|自费诊疗|超标床费|起付标准|其他自费|进入统筹基金金额|统筹基金支付|本年度统筹基金支付|进入大病基金金额|大病基金支付
升级会员 