五险合一政策机接口规范医疗保险810版1026.docx
《五险合一政策机接口规范医疗保险810版1026.docx》由会员分享,可在线阅读,更多相关《五险合一政策机接口规范医疗保险810版1026.docx(47页珍藏版)》请在冰豆网上搜索。
五险合一政策机接口规范医疗保险810版1026
150********99400000
赤峰市“五保合一”信息系统
医疗保险系统
接口文档
安宁英硕Version8.1.0
2009-12-23
WrittenByAnyInsure
北京安宁英硕软件系统有限公司2009
BeiJingAnyInsureSystemLTD.
AllRightsReserved®
目录
1、系统说明4
1.1系统体系结构4
1.2软件体系结构5
1.3应用服务器系统组成6
1.4设计原则6
1.5接口特点7
1.6应用程序说明7
1.7数据上传要求7
1.8更新日志8
2、接口流程9
2.1函数调用流程9
2.2门诊收退费流程9
2.3门诊接口开发流程12
2.4住院收退费流程13
2.3住院接口开发流程15
3接口函数说明16
3.1接口函数调用格式说明16
3.2公用函数18
3.2.1登录函数18
3.2.2退出登录函数18
3.2.3得到该医疗机构信息19
3.2.4个人通用信息查询函数19
3.2.5错误提示函数21
3.2.6服务器时间21
3.2.7修改IC卡密码22
3.3业务处理类函数23
3.3.1门诊挂号函数23
3.3.2门诊退号函数23
3.3.3医疗项目费用分解函数24
3.3.4医疗收费函数26
3.3.5医疗费用分解函数27
3.3.6门诊费用支付确认函数29
3.3.7门诊退结算函数30
3.3.8住院费用清除30
3.3.9门诊费用清除31
3.3.10入院登记函数31
3.3.11入院退登记函数32
3.3.12入院结算函数32
3.3.13入院退结算函数33
3.4维护类函数34
3.4.1中心目录查询函数34
3.4.2对照目录查询函数35
3.4.3目录上传函数36
3.4.4目录维护函数38
3.5对帐函数39
3.5.1门诊收费检验函数39
3.5.1住院结算检验函数40
3.5.3明细查询函数40
1、系统说明
1.1系统体系结构
中心服务器
中心客户机
中心客户机
中心端医保前置机
IC卡读写器
IC卡读写器
医院客户机
医院客户机
医院服务器
应用服务器系统体系结构
如图所示,医院端和医保中心端分别设置医保前置机。
医院端医保前置机调用北京安宁英硕软件有限公司接口程序(AnyInterface82.dll)。
医保政策机系统向HIS系统提供访问接口(API)。
北京安宁英硕医保政策机系统是医保信息系统与HIS系统之间的数据通道和解释器,充当医保系统与HIS系统之间的桥梁,同时限制流通数据,隔离医保系统与HIS系统,保证医保系统和HIS系统的安全性。
1.2软件体系结构
中心端应用服务器
数据加密
医院端接口
AnyBrowser.exe
IC卡机具驱动程序
HIS系统
接口应用软件体系结构
1.3应用服务器系统组成
医保前置接口
医保政策机/CLIENT
医保政策机/CLIENT为一个动态连接库,安装在HIS系统的客户端,为HIS系统提供一组API函数供HIS调用。
当HIS调用API函数时,医保政策机/CLIENT向医保政策机/SERVER申请服务,医保政策机/SERVER响应服务,将服务结果返回给医保政策机/CLIENT,医保政策机/CLIENT再将调用结果给HIS。
同时,医保政策机/CLIENT内嵌了一个医疗保险IC卡通用接口层,负责屏闭掉不同类型的IC卡的差异。
1.4设计原则
●不进入、不干预对方系统的业务处理;
●保证医疗保险政策在医院端有效地执行;
●保证医保中心与医院实时地交换信息;
●应用系统间采用数据耦合,无数据控制关系。
●统一接口模式。
●提供磁盘/磁带应急传递手段。
●遵循可扩展性原则,实现方式灵活,能较快地适应政策调整和运行环境改进等变化;
1.5接口特点
●API接口界限明晰,保证整个医保应用服务器系统的完整性、易移植、易扩充性;
●交换的数据应满足双方HIS系统、医保系统的需要和业务流程,并适当考虑日后的变更需要;
●恰当的考虑安全性和效率问题;
●耦合方式为函数耦合。
1.6应用程序说明
●AnyInterface82.dll为接口主调用程序;
●AnyBrowser.exe为客户端应用程序;
●AnyInterface8.log客户端日志文件,增量插入;
●Client_Test.EXE接口测试程序;
●在调用函数前(f_comm_logout,f_comm_compinfo,f_comm_datetime,f_comm_geterrormsg除外)必需调用f_comm_login函数
●调用f_comm_logout后,系统会清除当前登陆信息,如再次使用,需重新调用f_comm_login
1.7数据上传要求
●要求及时上传院方产生数据(具体要求请向医保局了解)
●要求准确反映院方数据所产生的时间,操作人等实际情况,如登记,明细,出院等业务
●及时核对数据是否一致,如有误差需及时调整
●及时更新中心目录,检查报销目录是否有变动
1.8更新日志
更新日期
更新目标
更新函数名
版本
说明
2009-12-21
文档
f_comm_divide
医疗垫付金额=21+22+23+27
2009-12-27
文档
f_maint_contrast
项目名称与检索码长度最大为254
2010-1-3
文档/动态库
f_comm_alterpasswd
10.1.3.1
增加修改IC卡密码函数
2010-1-3
文档/动态库
f_maint_edit
10.1.3.1
增加目录修改函数
2010-1-3
文档
f_inp_clear
修改函数名f_inp_clean
2010-1-3
文档
f_outp_clear
修改函数名f_inp_clean
2010-1-5
文档
f_maint_list,f_contrast_list
增加收费类别
2010-1-7
文档
f_outp_withdrawal
10.1.7.1
去掉返回参数
2010-1-12
文档/动态库
f_comm_append
10.1.12.1
项目名称扩大到200个字符
2010-1-13
文档/动态库
f_inp_register
f_inp_unregister
f_inp_balance
f_inp_unbalance
f_inp_check
AnyService.dll
10.1.14.1
AnyInterface82.dll0.10.14.1
Client_test.exe
10,10,13,1
增加函数
2、接口流程
2.1函数调用流程
2.2门诊收退费流程
●每一次门诊一定要有登记流水号,结算流水号;每次挂号可包含多个处方费用。
登记流水号与结算流水号一一对应,而这些号码都是要由HIS端产生的。
●然后要调用门诊登记函数f_outp_register(constchar*szIn),此时只涉及到挂号流水号。
●费用录入时可以调用f_item_divide对单笔费用进行分解。
这项操作不涉及到收费流水号和挂号流水号。
对于门诊收费流程也不是必须的。
●调用门诊分解函数f_comm_append(constchar*szIn,char*szOut),把本次要收费的所有费用以文件方式传到政策机进行收费。
●调用门诊分解函数f_item_query(constchar*szIn,char*szOut),查询该人员门诊费用
●调用门诊分解函数f_comm_divide(constchar*szIn,char*szOut),查询该人员门诊费用分解情况
●调用支付确认函数f_outp_affirm(charchar*szIn),要指明需要确认支付的挂号流水号和收费流水号。
调用此函数成功后则此笔收费完全结束。
无论成功或失败都调用f_outp_check,看此笔费用是否成功。
●对于已经确认结算的费用,通过调用f_outp_withdrawal函数来退结算。
●在未结算前退费时只需在导入明细时传入负记录即可。
●f_comm_append中第14项费用编号为该次住院唯一序号,如果在传递费用时有重复费用将不再入库
●门诊分解结果以f_outp_affirm返回结果为准
●门诊收费流程图如下:
注:
1、带*为需读卡操作
2、红色为必需流程
2.3门诊接口开发流程
f_comm_login
注:
1、带*为需读卡操作
2、红色为必需流程
2.4住院收退费流程
●每一次一定要有登记流水号,结算流水号;每次登记可包含多个处方费用。
登记流水号与结算流水号一一对应,都要由HIS端产生的。
●数据为增量插入。
●办理出院前应调f_item_query查核对该人员中心费用与定点费用明细是否一至。
●在未结算前退费时只需在导入明细时传入负记录即可。
●f_comm_append中第14项费用编号为该次住院唯一序号,如果在传递费用时有重复费用将不再入库
●退结算后该人员返回到在院状态,费用全部保留。
●已经有发生的费用,不允许退院
●用结算函数f_inp_balance(charchar*szIn),要指明需要确认支付的登记流水号与结算流水号。
调用此函数成功后则此笔收费完全结束。
无论成功或失败都调用f_inp_check,看此笔费用是否成功。
●住院收费流程图如下:
●
2.3住院接口开发流程
f_comm_login
注:
1、带*为需读卡操作
2、红色为必需流程
3接口函数说明
3.1接口函数调用格式说明
●函数的入口、出口参数标明为“字符串”的,表示该函数入口或出口参数以字符串的形式提供,字段以“序号”所示顺序排列,各字段间以“|”相隔。
●函数的入口、出口参数需分配好空间,再进行操作,建议2000以上;并要注意管理内存
●函数的入口、出口参数标明为“文件”的,表示该函数入口或出口参数为所设定接口文件的绝对路径,文件名称应该为函数名,入口文件后辍为.in;出口参数后辍为.out。
参数文件中各字段以“|”相隔,文件中的每行表示数据表中的一条记录,其中,第一行表示该文件的总计信息,以下各行表示详细信息。
第一行中各字段具体含义以及其余各行各字段具体含义见函数说明。
●当HIS收到接口系统返回信息后,按照业务的要求加以使用或保存,不应做任何修改。
●在以下说明中,数据的“类型”指业务需要的数据类型,传送参数是应转换成字符串。
其中,C:
字符串;N:
数值;D:
日期;DT:
日期时间,I:
整型。
●参数中数据项的长度不得大于指定的长度,若小于指定的长度,按实际长度传送参数即可,不必补足指定的长度。
●入口参数中尽量不要使用全角符号
●字符式参数或文件式参数的内容中不得出现以下符号:
%&*|?
\/
●当参数为文件时,入口文件后辍名为.in
出口文件后辍名为.out
●AnyInterface8.log为错误日志文件,最后一行为最新信息
●当返回值为0时为成功,当返回值为非0时为失败,失败提示可调用函数f_comm_geterrormsg查看,也可查看AnyInterface8.log
●系统配置文件为connect.ini
●字符数据超长时需由HIS方将数据进行截取,截取时需避免出现非法字符
建议:
截取长度小于规定长度一位,截取完后补空格。
●日期格式必需严格按照说明格式设定,格式为YYYYMMDDHHmmSS的要求精确到秒;格式为YYYYMMDD精确到天
●接口文档中szIn,szOut分别代表入口参数和出口参数
●函数中出现的组合项值(特病信息);项目详细信息用点分隔[.],如果有多项时用逗号[,]分隔。
●精度:
数量:
(10,4)单价:
(12,6)明细金额(12,6),结算金额(12,2)
3.2公用函数
3.2.1登录函数
函数名:
f_comm_login
功能:
登录函数。
入口参数:
字符串。
出口参数:
字符串。
格式:
f_comm_login(szIn,szOut)
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
序号
数据项
类型
长度
说明
1
操作员编号
C
20
医疗机构操作员编号Notnull
2
操作员姓名
C
20
医疗机构操作员姓名
●出口参数说明:
序号
数据项
类型
长度
说明
1
操作员编号
C
20
2
操作员姓名
C
20
3
险种编号
C
16
当前操作险种编号
4
险种名称
C
16
当前操作险种名称
3.2.2退出登录函数
函数名:
f_comm_logout
功能:
退出登录函数。
入口参数:
无。
出口参数:
无。
格式:
f_comm_logout()
函数返回值:
0,正确;非0整数,错误码。
3.2.3得到该医疗机构信息
函数名:
f_comm_compinfo
功能:
查询药品信息。
入口参数:
无。
出口参数:
字符串。
格式:
f_comm_compinfo(szOut)
函数返回值:
0,正确;非0整数,错误码。
●出口参数说明:
序号
数据项
类型
长度
说明
1
定点编号
C
20
2
定点名称
C
200
3
定点级别
C
10
3.2.4个人通用信息查询函数
函数名:
f_comm_getpersoninfo
入口参数:
字符串。
出口参数:
字符串。
格式:
f_comm_getpersoninfo(szIn,szOut)
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
该参数用于读卡方式使用
序号
数据项
类型
长度
说明
1
密码
C
6
Notnull
●医疗保险出口参数说明:
序号
数据项
类型
长度
说明
1
IC卡号
C
10
2
社会保障号
C
19
3
姓名
C
20
4
性别
C
1
5
出生日期
D
8
YYYYMMDD
6
人员类别
C
10
7
身份证号码
C
19
8
参保日期
D
8
YYYYMMDD
9
民族
C
2
10
人员姓名检索码(大写)
C
10
11
单位名称
C
50
12
在院标志
I
0:
不在院,1:
在院
13
人员性质
C
50
14
当前月是否有待遇
I
0:
没有,1:
有
15
区域编码号
16
对应区域编码的地区名称
17
备用
备用
18
备用
备用
19
备用
备用
20
备用
备用
21
本年住院次数
I
2
22
个人账户余额
N
10,2
23
本年统筹医纳入保内累计
N
10,2
24
本年统筹支付累计
N
10,2
25
公务员支付累计
N
10,2
26
大额支付累计
N
10,2
27
最后出院日期
D
8
YYYYMMDD
28
特殊病信息
C
400
组合项
以下特病详细信息用点分隔[.]
1
疾病编号
C
20
使用医疗保险接口时,在门诊登记(f_outp_register)第四项用该编号
2
疾病名称
C
50
3.2.5错误提示函数
函数名:
f_comm_geterrormsg
功能:
返回错误信息。
入口参数:
字符串。
出口参数:
字符串
格式:
f_comm_geterrormsg(szIn,szOut)
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
序号
数据项
类型
长度
说明
1
错误编码
C
10
NOTULL
●出口参数说明:
序号
数据项
类型
长度
说明
1
错误提示
C
100
3.2.6服务器时间
函数名:
f_comm_datetime
功能:
返回中心服务器时间。
入口参数:
无。
出口参数:
字符串
格式:
f_comm_datetime(szOut)
函数返回值:
0,正确;非0整数,错误码。
●出口参数说明:
序号
数据项
类型
长度
说明
1
系统日期
C
100
YYYY-MM-DD|HH:
mm:
SS
3.2.7修改IC卡密码
函数名:
f_comm_alterpasswd
功能:
返回中心服务器时间。
入口参数:
字符串。
出口参数:
无
格式:
f_comm_alterpasswd(szIn)
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
序号
数据项
类型
长度
说明
1
旧密码
C
6
NOTNULL
2
新密码
C
6
NOTNULL
3.3业务处理类函数
3.3.1门诊挂号函数
函数名:
f_outp_register
功能:
将门诊挂号信息写入政策机。
入口参数:
字符串。
出口参数:
无。
格式:
f_outp_register(szIn)
说明:
门诊挂号流水号不得重复
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
序号
数据项
类型
长度
说明
1
门诊挂号流水号
C
20
Notnull
2
挂号时间
DT
14
YYYYMMDDHHmmSS
Notnull
3
就诊科室名称
C
20
Notnull
4
特病编号
C
20
5
诊断
C
200
6
主治大夫
C
20
7
备用
C
20
3.3.2门诊退号函数
函数名:
f_outp_unregister
功能:
门诊退号。
入口参数:
字符串。
出口参数:
无。
格式:
f_outp_unregister(szIn)
函数返回值:
0,正确;非0整数,错误码。
说明:
如果人员已经有收费信息,必需先退费或清除该人员费用
●入口参数说明:
序号
数据项
类型
长度
说明
1
门诊挂号流水号
C
20
Notnull
3.3.3医疗项目费用分解函数
函数名:
f_item_divide
功能:
从政策机获得明细项目的分解信息。
入口参数:
字符串。
出口参数:
字符串。
10。
1。
1。
99
anning123
格式:
f_item_divide(szIn,szOut)
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
序号
数据项
类型
长度
说明
1
项目代码
C
20
医院的药品、诊疗项目或服务设施编码Notnull
2
项目名称
C
40
本医院项目名称
3
目录类别
C
1
0:
药品
1:
诊疗项目
2:
服务设施
Notnull
4
单价
N
12,6
Notnull
5
计价单位
C
20
6
数量
N
10,4
Notnull
7
金额
N
12,6
Notnull
8
剂型
C
Notnull
9
规格
C
Notnull
10
特殊病编码
C
10
●出口参数说明:
序号
数据项
类型
长度
说明
1
项目代码
C
20
医院的药品、诊疗项目或服务设施编码
2
项目名称
C
40
本医院项目名称
3
目录类别
C
1
0:
药品
1:
诊疗项目
2:
服务设施
4
单价
N
12,6
5
计价单位
C
20
6
数量
N
10,4
7
金额
N
12,6
8
中心编码
C
20
9
项目类别
C
2
10
支付级别
C
1
0:
全额支付
1:
部分支付
2:
全额自付
11
对照表中医院药品单价
N
12,6
12
自付比例
N
6,4
13
医保范围内金额
N
10,4
14
医保范围外金额
N
10,4
15
剂型
C
20
16
规格
C
20
3.3.4医疗收费函数
函数名:
f_comm_append(费用明细上传)
功能:
将患者门诊处方信息传入政策机,并从政策机获得费用分解信息。
入口参数:
文件(*.in)
出口参数:
字符串
格式:
f_comm_append(szIn,szOut)
函数返回值:
0,正确;非0整数,错误码。
●入口参数说明:
文件总计信息(首行)格式说明:
序号
数据项
类型
长度
说明
1
类别
I
1
1:
门诊
2:
住院
Notnull
2
挂号流水号
C
20
Notnull
3
文件记录条数
C
4
本文件包含的记录的数量
Notnull
4
本次收费费用总金额
N
12,6
Notnull
文件详细信息(第二行至最后一行)格式说明:
序号
数据项
类型
长度
说明
1
费用发生时间
DT
14
YYYYMMDDHHmmSS
Notnull
2
项目代码
C
20
Notnull
3
项目名称
C
200
本医院项目名称
4
目录类别
C
1
0:
药品
1:
诊疗项目
2:
服务设施
Notnull
5
单价
N
12,6
Notnull
6
计价单位
C
20
7
数量
N
10,4
Notnull
8
金额
N
12,6
Notnull
9
处方编号
C
20
10
处方大夫
C
20
开本处方大夫
11
费用序号
C
20
在处方中的序号
12