完整word版医保HIS接口规范1.docx
- 文档编号:11237081
- 上传时间:2023-02-26
- 格式:DOCX
- 页数:64
- 大小:102.44KB
完整word版医保HIS接口规范1.docx
《完整word版医保HIS接口规范1.docx》由会员分享,可在线阅读,更多相关《完整word版医保HIS接口规范1.docx(64页珍藏版)》请在冰豆网上搜索。
完整word版医保HIS接口规范1
武汉市铁路医保系统
HIS接口应用编程接口规范
华中兴业软件
2007年05月
1、概述
《武汉市铁路医保系统支付接口应用编程接口规范》(以下简称规范)的使用对象为将使用武汉兴业公司的医保支付组件库(以下简称组件库)来完成医保支付的为定点医疗机构提供应用软件的HIS供应商、药店MIS供应商或其它第三方应用软件供应商。
规范公布了组件库所提供的交易,规定了调用每一交易的前提条件,详细描述了每一交易的调用方法。
规范从编程的角度来介绍以上内容,对医保政策和医保支付流程的介绍不属于本规范的范围。
§1.1.术语及参考资料
COM:
CommonObjectModel
HIS:
HospitalInformationSystem
MIS:
ManagementInformationSystem
§1.2.应用模式
兴业医保支付组件库是一组运行在WINDOWS32位环境下的COM组件,第三方应用软件使用相应的COM组件调用方式来调用它。
§1.3.环境要求
§1.3.1.硬件环境
指标
指标值
CPU
≧1.6MHz
Memory
≧256MB
HardDisk
≧100M(free)
NetCard
≧10MB
§1.3.2.网络环境
指标
指标值
协议
TCP/IP、HTTP/HTTPS
广域网带宽
≧56k
网络连接
客户端直接访问医保中心网络
§1.3.3.系统软件
指标
指标值
操作系统
WIN98SE或WIN2000及以上WIN系列操作系统
辅助软件
IE6.0
§2.接口描述
§2.1.总体描述
组件库注册在每一台需要进行医保支付业务的客户机上(该客户端也必须能连接到医保网络),通过被动调用的方式将医保支付业务功能嵌入到定点医疗机构的系统中(以下简称HIS);
接口交易组件库提供了三个公共方法(Init初始化,Destroy资源释放,Trade业务方法调用),交易参数组织采用String(字符串)(所有社保经办机构交易调用及交易参数统一),差别处理对于HIS透明。
接口交易内部也存在用户交互窗口,因此建议HIS事务管理与接口交易调用相互独立。
字段分隔符:
@@;
行分隔符:
\/;
§2.2.接口COM说明
组件库提供交易的COM组件属性如下:
属性
值
AppID
TypeLibraryID
ProgramID
Railway_insure.InsureInterface
COMClassName
InsureInterface
COMClassID
InterfaceType
DualInterface
InterfaceName
InterfaceID
§2.3.交易接口函数描述
Init
✓原型定义:
Init(ByRefintAppCodeAsLong,
ByRefstrAppMsgAsString)
参数名称
参数含义
参数类型
参数类别
参数说明
intAppCode
交易标志
long
出口参数
小于0均为失败。
此值数据类型是整数
strAppMsg
交易信息
String
出口参数
错误信息描述。
intAppCode小于0时存放错误描述,其他intAppCode不用关心该参数内容。
✓函数说明:
初始化函数,HIS应用启动时调用,进行医保交易处理初始化,本交易调用成功后才能进行其他交易处理。
Destroy
✓原型定义:
Destroy()
✓函数说明:
资源释放函数,在HIS应用退出时调用。
Trade
✓原型定义:
Trade(
ByvalstrTradeIdAsString,‘交易编号
ByvalstrControlAsString,‘交易控制
ByvalstrInAsString,‘交易输入
ByrefstrSerialIdAsstring,‘交易流水号
ByrefstrOutAsstring,‘交易输出
ByrefintAppCodeAslong,‘交易标志
ByrefstrAppMsgAsstring)‘交易信息
参数名称
参数含义
参数类型
参数类别
参数说明
strTradeId
交易编号
String
入口参数
具体的交易代码见〖交易列表〗
strControl
交易控制
String
入口参数
字符串方式,组织方式见业务说明
strIn
交易输入
String
入口参数
字符串方式,组织方式见业务说明
strSerialId
交易流水号
String
出口参数
唯一标识一次交易,VARCHAR(20)
strOut
交易输出
String
出口参数
字符串方式,组织方式见业务说明
intAppCode
交易标志
long
出口参数
小于0均为失败。
此值数据类型是整数,范围为-2147483648to+2147483647
strAppMsg
交易信息
String
出口参数
错误信息描述。
intAppCode小于0时存放错误描述,其他intAppCode不用关心该参数内容。
✓函数说明:
交易主函数,完成所有医疗业务的实际处理。
由于交易调用远程方法,并且可能存在用户交互界面,因此建议所有交易不要纳入HIS系统事务管理。
在交易接口函数定义中,传递的参数都是字符串。
但是在交易详细说明中,数据类型都是逻辑类型,常用类型有三种:
string,number,datetime,下面的表格描述了交易接口进行类型转换的限制和说明。
数据类型
空字符串
格式不合法
其它说明
string
视同空串
无
无特别说明标注的长度为最大长度
number
视同0
返回错误
无特别说明标注的长度为最大长度(小数尾数同)
datetime
视同空值
返回错误
足19位长,格式如下:
YYYY-MM-DDhh24:
mm:
ss
date
视同空值
返回错误
足19位长,格式如下:
YYYY-MM-DD00:
00:
00
接口调用示例:
VB调用
DimXYobjectAsObject'定义存放引用对象的变量。
SetXYobject=CreateObject("Railway_insure.InsureInterface")
'检查连接是否建立
IfXYobjectIsNothingThen
MsgBox"对象为空!
"
EndIf
dimstrTradeIdAsString,‘交易编号
dimstrControlAsString,‘交易控制
dimstrInAsString,‘交易输入
dimstrSerialIdAsstring,‘交易流水号
dimstrOutAsstring,‘交易输出
dimintAppCodeAslong,‘交易标志
dimstrAppMsgAsstring)‘交易信息
strTradeId="01"
'HIS业务处理
CallXYobject.Trade(strTradeId,strControl,strIn,strSerialId,strOut,intAppCode,strAppMsg)
'判断返回信息
IfAppcode<0Then
MsgBoxAppmsg
EndIf
delphi调用
注意:
delphi调用时先要usesComObj;否则不能引用oleobject。
Var
XYobject:
Variant;//定义存放引用对象的变量。
BusinessID:
String
Ctrl:
String
Data:
String
Businesssequence:
String
Businessvalidate:
String
Output:
String
Appcode:
integer
Appmsg:
String;
Begin
try
XYobject:
=CreateOleObject(‘Railway_insure.InsureInterface');
BusinessID:
='01';
XYobject.Trade(strTradeId,strControl,strIn,strSerialId,strOut,intAppCode,strAppMsg)
//返回结果判断,HIS内部处理
finally
end;
End;
pb调用
oleobjectXYobject
stringstrTradeId‘交易编号
stringstrControl‘交易控制
stringstrIn‘交易输入
stringstrSerialId‘交易流水号
stringstrOut‘交易输出
longintAppCode,‘交易标志
stringstrAppMsg‘交易信息
XYobject=createoleobject
result=XYobject.ConnectToNewObject("Railway_insure.InsureInterface")
ifresult<>0then
messagebox("error","failtoconnect")
return
endif
BusinessID=”01”
XYobject.Trade(strTradeId,strControl,strIn,refstrSerialId,refstrOut,refintAppCode,refstrAppMsg)
//返回结果判断,HIS内部处理
§2.4.交易类型和调用流程
1、查询类交易:
包括一般查询交易,例如:
身份确认;
2、处理类交易:
包括门诊结算(退单/作废)、入院办理(回退)、出院结算(退单/取消结算)六个交易,一次完整的处理类交易可以有两种方式:
1)只有处理流程,符合情况是处理流程执行失败(接口返回错误代码及信息);
2)处理流程+取消流程,符合情况是处理流程执行成功,HIS处理失败,调用取消流程。
图1-1处理类交易调用流程
§2.5.处理交易的不同宕机点和相应的处理
1、处理流程处理完毕
2、调用成功
3、HIS处理完毕
4、处理失败
5、处理成功
在上面5个点系统宕机,系统重新启动后,都没有办法直接决定调用【取消流程】还是【确认流程】;对于这种情况,应及时通知相关部门(例如:
医保中心),再根据这些交易出的相关信息,查询HIS系统的情况,决定是否调用【取消流程】。
不同的业务交易,判断不同。
门诊结算:
如果HIS系统没有相应的结算信息,则应该调用取消流程。
门诊结算回退:
如果HIS系统没有相应的结算信息,或者有相应的退单信息,则通知医保中心取消相关记录。
§2.6.交易列表
序号
交易代码
交易名称
交易类型
广域网支持
备注
1.
01
身份识别
查询类交易
√
患者登记确认
2.
10
门诊费用分解
处理类交易
√
3.
11
门诊结算
处理类交易
√
4.
12
门诊结算回退(取消结算)
处理类交易
√
5.
21
入院办理
处理类交易
√
6.
22
入院办理回退
处理类交易
√
7.
23
入院办理信息修改
处理类交易
√
8.
25
出院办理
查询类交易
√
9.
26
出院办理回退
查询类交易
√
10.
31
住院费用明细写入(住院)
处理类交易
√
11.
42
住院费用明细写入(结算)
处理类交易
√
12.
51
住院费用分解
处理类交易
√
13.
52
住院结算
处理类交易
√
14.
53
住院结算退单
处理类交易
√
15.
91
服务项目目录获取(三大目录)
查询类交易
√
16.
94
医院需审核项目上传
处理类交易
√
HIS基本业务调用说明:
(1)门诊挂号:
01身份识别;
(2)门诊结算:
01身份识别>>10门诊费用分解>>11门诊结算;
(3)门诊结算取消:
01身份识别>>12门诊结算回退(取消结算;
(4)入院办理:
01身份识别>>21入院办理;
(5)入院办理回退:
01身份识别>>22入院办理回退;
(6)入院办理信息修改:
01身份识别>>23入院办理信息修改;
(7)出院办理:
01身份识别>>25出院办理;
(8)出院办理回退:
01身份识别>>26出院办理回退;
(9)住院结算:
01身份识别>>51住院费用分解>>52住院结算;
§2.7.交易详细说明部分
01身份识别
交易名称
身份识别
交易类型
查询类交易
处理描述
读卡,验证成功后返回个人医疗信息相关参数。
调用说明
本交易返回HIS参保人员个人信息、参保信息、帐户信息,由HIS完成错误信息控制和相关信息显示。
输入参数
交易编号
01
交易控制
交易输入
输出参数
交易流水号
无
交易输出
医疗保险号@@卡号@@身份证号码@@姓名@@性别@@出生日期@@年龄@@民族@@人员参保类别编码@@人员参保类别@@个人帐户余额@@本年帐户支出累计@@单位编码@@单位名称@@地址@@联系电话@@邮政编码@@户口所在地@@卡状态@@是否在院
交易标志
小于0表示失败
交易信息
参数详细说明:
交易控制:
代码
名称
约束
类型
说明
交易输入:
代码
名称
约束
类型
说明
交易输出:
代码
名称
约束
类型
说明
1
医疗保险号
NOTNULL
VARCHAR(10)
2
卡号
NOTNULL
VARCHAR(12)
IC卡号
3
身份证号码
VARCHAR(18)
4
姓名
NOTNULL
VARCHAR(20)
5
性别
NOTNULL
VARCHAR
(2)
1男2女
6
出生日期
NOTNULL
DATE
yyyy-MM-dd
7
年龄
NOTNULL
VARCHAR(10)
例如:
50岁
8
民族
VARCHAR(20)
9
人员参保类别编码
NOTNULL
VARCHAR(3)
10
人员参保类别
NOTNULL
VARCHAR(20)
11
个人帐户余额
NOTNULL
NUMERIC(10,2)
12
本年帐户支出累计
NOTNULL
NUMERIC(10,2)
13
单位编码
NOTNULL
CHAR(8)
14
单位名称
NOTNULL
VARCHAR(50)
15
地址
VARCHAR(40)
16
联系电话
VARCHAR(20)
17
邮政编码
CHAR(6)
18
户口所在地
VARCHAR(50)
19
卡状态
NOTNULL
CHAR
(1)
0正常、1挂失、2消号、3未办理参保手续、4冻结、5卡不可用
20
是否在院
NOTNULL
CHAR
(1)
0否
1是
注意:
患者如果在院(在院未结算),门诊结算系统自动以自费患者处理
10门诊费用分解
交易名称
门诊费用分解
交易类型
处理类交易
处理描述
读卡,身份确认,接口根据传入的明细信息进行明细分割和门诊预结算,明细分割和预结算成功后显示结算结果窗口,由操作员选择[分解]或[取消],如果选择[分解]则完成前置机结算处理,如果[取消],则返回HIS取消结算错误代码;
本交易完成后,完成费用分解。
调用说明
收费员录入门诊费用明细信息,HIS系统组织明细相关参数调用门诊结算交易,等待费用分解返回结果信息;如果返回成功则写入HIS数据库门诊结算详细信息,写入成功后调用确认流程,写入失败后调用取消流程;
详细处理流程见:
图1-1处理类交易调用流程;
由于本交易存在用户交互,建议HIS内部事务处理不要包含本交易调用。
输入参数
交易编号
10
交易控制
医疗保险号@@明细条数@@费用总额@@发票号
交易输入
记账流水号@@医保项目编码@@医院项目名称(诊疗项目)@@规格@@数量@@单价@@费用总额@@实收费用总额@@开单科室@@开单医生@@开单时间@@结算时间@@HIS项目编码\/。
。
。
\/
输出参数
交易流水号
交易输出
医疗机构代码@@门诊收费流水号@@结算日期@@医保号@@总金额@@起付线@@药品甲类金额@@药品乙类医保内金额@@药品乙类按比例自付金额@@自费药品金额@@普通治疗金额@@普通治疗自费金额@@特检特治医保内金额@@特检特治按比例自付金额@@服务医保内金额@@自费服务金额@@统筹基金支付金额@@大额保险支付@@慢性病自付补助支付金额@@普通门诊自付补助支付金额@@个人帐户支付@@普通门诊个人自付@@本次帐户余额@@慢性病标志@@慢性病病种编码@@医保内金额@@医保外金额@@医保内个人自付
交易标志
小于0表示失败
交易信息
参数详细说明:
交易控制:
代码
名称
约束
类型
说明
1
医疗保险号
NOTNULL
CHAR(10)
医疗保险号码
2
明细条数
NOTNULL
NUMBER(3)
3
费用总额
NOTNULL
NUMBER(14,2)
4
发票号
VARCHAR(20)
交易输入:
代码
名称
约束
类型
说明
1
记账流水号
NOTNULL
VARCHAR(20)
2
项目记帐流水号
NOTNULL
VARCHAR(12)
项目记帐流水号
3
医保项目编码
NOTNULL
VARCHAR(20)
见医保目录信息
4
医院项目名称
NOTNULL
VARCHAR2(100)
5
规格
VARCHAR2(50)
6
数量
NOTNULL
NUMBER(10,2)
本条明细数量
7
单价
NOTNULL
NUMBER(14,4)
单价保留四位小数
8
费用总额
NOTNULL
NUMBER(14,4)
单条明细费用总额保留4位小数,结算时汇总费用总额保留2位小数
9
实收费用总额
NOTNULL
NUMBER(14,4)
实际收费额
10
开单科室
VARCHAR2(20)
11
开单医生
VARCHAR2(20)
12
开单时间
NOTNULL
DATE
医院收费员录入明细时间
13
结算时间
NOTNULL
DATE
明细结算时间
14
HIS项目编码
NOTNULL
VARCHAR(20)
交易输出:
代码
名称
约束
类型
说明
1
医疗机构代码
NOTNULL
VARCHAR2(8)
2
门诊收费流水号
NOTNULL
VARCHAR2(16)
3
结算日期
NOTNULL
DATE
4
医保号
NOTNULL
CHAR(10)
5
总金额
NOTNULL
NUMERIC(10,2)
6
起付线
NOTNULL
NUMERIC(10,2)
7
药品甲类金额
NOTNULL
NUMERIC(10,2)
8
乙类医保内金额
NOTNULL
NUMERIC(10,2)
9
乙类按比例自付金额
NOTNULL
NUMERIC(10,2)
10
自费药品金额
NOTNULL
NUMERIC(10,2)
11
普通治疗金额
NOTNULL
NUMERIC(10,2)
12
普通治疗自费金额
NOTNULL
NUMERIC(10,2)
13
特检特治医保内金额
NOTNULL
NUMERIC(10,2)
14
特检特治按比例自付金额
NOTNULL
NUMERIC(10,2)
15
服务医保内金额
NOTNULL
NUMERIC(10,2)
16
自费服务金额
NOTNULL
NUMERIC(10,2)
17
统筹基金支付金额
NOTNULL
NUMERIC(10,2)
18
大额保险支付
NOTNULL
NUMERIC(10,2)
19
慢性病自付补助支付金额
NOTNULL
NUMERIC(10,2)
20
普通门诊自付补助支付金额
NOTNULL
NUMERIC(10,2)
21
个人帐户支付
NOTNULL
NUMERIC(10,2)
22
普通门诊个人自付
NOTNULL
NUMERIC(10,2)
23
本次帐户余额
NOTNULL
NUMERIC(10,2)
24
慢性病标志
CHR
(1)
0否
1是
25
慢性病病种编码
VARCHAR(20)
26
医保内金额
NOTNULL
NUMERIC(10,2)
27
医保外金额
NOTNULL
NUMERIC(10,2)
28
医保内个人自付
NOTNULL
NUMERIC(10,2)
相关界面:
针对门诊慢性病患者就诊,需要选择的慢性病种类。
界面集中显示患者的参保信息、账户信息以及本次费用的分解计算结果信息,和相关的明细分解结果信息。
11门诊费用结算
交易名称
门诊结算
交易类型
处理类交易
处理描述
读卡,身份确认,接口根据传入的明细信息进行明细分割和门诊预结算,明细分割和预结算成功后显示结算结果窗口,由操作员选择[确认]或[取消结算],如果选择[确认]则完成前置机结算处理,如果[取消结算],则返回HIS取消结算错误代码;
本交易完成后,结算数据处于未上传中心状态,当HIS存盘成功,调用确认门诊结算业务,成功后完成前置机结算业务的门诊结算数据上传中心业务,明细数据处于等待上传状态。
调用说明
收费员录入门诊费用明细信息,HIS系统组织明细相关参数调用门
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 完整 word 医保 HIS 接口 规范