文档版本说明.docx
- 文档编号:30737926
- 上传时间:2023-08-20
- 格式:DOCX
- 页数:103
- 大小:87.55KB
文档版本说明.docx
《文档版本说明.docx》由会员分享,可在线阅读,更多相关《文档版本说明.docx(103页珍藏版)》请在冰豆网上搜索。
文档版本说明
文档版本说明
文档信息:
文档名称:
合肥职工医疗保险市级统筹医院收费接口规范
负责人:
文档版本编号:
文档版本日期:
2011-10-23
版本记录:
日期
内容摘要
编制/修改
审核
2011-10-23
合肥职工医疗保险市级统筹医院收费接口编制
侯鹏
特别说明:
本文档仅包含合肥市职工医保市级统筹内容,其他险种的联网内容请参加合肥市医疗生育工伤保险医院收费接口说明书
2011年11月20日提供对外测试接口
1接口设计概述
1.1接口设计主体思路
采用Soap协议进行信息的交换,每个业务接口主要步骤均为:
首次使用时必须先发送登陆请求,医院根据接口规范将数据通过sieaf.dll传送到中间层服务器,服务器处理完毕后返回结果集,医院程序可以通过反复调用sieaf.dll的相关函数得到结果集并进行处理。
注:
如果医保政策或实施细则有变化,本规范将作相应调整。
1.2SIEAF.DLL接口说明
此动态库函数及其作用列表如下:
函数名称
作用
init
初始化
putPara
以"name=value"的格式装入参数数据
startResultSetName
指定后续装入数据所在的记录集名
endCurResultSet
结束当前的记录集
endcurRow
结束当前的行数据
putColData
在当前记录集的当前行,以"name=value"的格式装入数据
process
调用应用服务器端处理,参数funcID为业务功能标识
如果返回失败,可以用getFailReason获取失败原因
getParaByName
按名字取得返回的参数数据
getErrMsg
返回服务器端的信息,如果是OK,表示操作成功!
toResultSetName
按名字得到记录集,并返回行的数目
如果失败,可以用getFailReason获取失败原因
nextRow
将光标移到下一行
getColData
按名字得到当前光标指定行的数据
如果失败,可用getFailReason获取失败原因
destroyInterface
释放接口
getFailReason
得到具体的错误信息
1.3接口协议详细说明
本接口中部分需要按值返回的字段,可以到编码表中找到,具体编码看附件:
编码表。
系统中所有用到的日期都采用:
YYYY-MM-DD的格式。
用到金额的的字段单位为“元”保留两位,
冲销标志:
Z是正常记录;”-”是被冲销记录;”+”是冲销记录;每条被冲销记录中冲销编号记录冲销记录的流水号;
本接口中所有的出入参数的字母必须小写字母。
2公共模块功能描述
2.1系统登录
2.1.1系统登录(F09.01.01.05)
2.1.1.1输入输出
输入
userid
VARCHAR2(10)
用户名
passwd
VARCHAR2(10)
密码
xtdh00
VARCHAR2(10)
系统代号(固定值:
“YY”)
输出
usernm
VARCHAR2(10)
用户名称
akb020
VARCHAR2(10)
网点编号(医院、药店、门诊编号)
akb021
VARCHAR2(10)
网点名称(门诊、药店)
aka101
VARCHAR2(10)
医院等级
aab034
VARCHAR2(8)
分中心编码(网点所属分中心)
aab300
VARCHAR2(50)
分中心名称(网点所属分中心)
2.1.1.2处理流程
在每次启动程序之前需要先进行登陆操作,入参有:
用户名,密码和系统代号这三个非空参数,系统代号边编号必须为“YY”(大写),如果登陆成功之后服务端返回相应出参。
医保市级统筹新增及返回该网点所属的分中心的编码和分中心名称
2.2公共模块
2.2.1医疗读卡(F04.02.01.01)
2.2.1.1输入输出
输入
akc020
VARCHAR2(18)
IC卡号(接受手工输入6、7、8位医保证号代替IC卡号;如果刷卡,此参数不要赋值,由读卡DLL自动设置)
输出[v_kc01]
aac001
VARCHAR2(10)
医保编号(8位最新医保号)
akc020
VARCHAR2(18)
IC卡号
aac002
VARCHAR2(18)
身份证
F
akc021
VARCHAR2(3)
医疗人员类别
F
vvv001
VARCHAR2(50)
医疗人员类别名称
F
aab001
VARCHAR2(8)
单位编号
aab004
VARCHAR2(50)
单位名称
aac003
VARCHAR2(20)
姓名
F
aac004
VARCHAR2(3)
性别编码
F
vvv002
VARCHAR2(50)
性别名称
akc023
NUMBER(3,0)
年龄
F
aab034
VARCHAR2(8)
经办机构编码(作废)
F
aab300
VARCHAR2(50)
经办机构名称(作废)
aab301
VARCHAR2(6)
行政区划代码(参保人员所属)
aaa146
VARCHAR2(100)
行政区划名称(参保人员所属)
akc087
NUMBER(8,2)
个人帐户余额
akc141
VARCHAR2(3)
IC卡状态
特殊病定点信息
akb020
VARCHAR2(8)
定点医院编号
akb021
VARCHAR2(50)
定点医院名称
skc516
VARCHAR2
(2)
特殊病种编码
skc519
VARCHAR2(50)
特殊病种名称
特殊病定点信息
2.2.1.2处理流程
该业务逻辑由先由读卡器读出卡号,然后客户端调用F04.02.01.01,向服务器发出服务申请。
服务器处理结束后返回个人参加医疗保险的基本信息,包括个人基本信息、个人参保状态、医疗帐户余额等。
v_kc01的所有信息都是从基本信息表中取得。
医疗人员类别的代码是“AKC021”,医疗人员类别名称是具体的代码说明。
性别编码的代码是“AAC004”,性别名称是具体的代码说明。
系统返回参保人员所属行政区划代码和行政区划名称,原有的分中心编号和分中心名称不在使用。
2.3公告查询
2.3.1近期公告查询(F04.12.01.02)
2.3.1.1输入输出
输入
无
输出
v_kbfr
公告信息
skb611
varchar2(200)
公告消息标题
skb612
varchar2(4000)
公告消息内容
skb613
varchar2(20)
公告发布时间
公告信息
2.3.1.2处理流程
原有系统公告显示后,用户一旦点击不在显示按钮后,就无法再次查询到之前的公告信息,为了方便用户查询之前的公告内容,系统提供90天内公告信息查询功能。
3职工医疗保险功能描述
3.1门诊挂号
3.1.1门诊挂号公共输出
[V_kcag]
akc190
VARCHAR2(18)
门诊号
aac001
VARCHAR2(10)
医保编号
akc020
VARCHAR2(18)
IC卡号
akc141
VARCHAR2(3)
IC卡状态
akb020
VARCHAR2(8)
网点编号(医院、药店、门诊编号)
aka101
VARCHAR2(3)
医院等级
akc021
VARCHAR2(3)
医疗人员类别
aab034
VARCHAR2(8)
分中心编码(网点所属分中心)
aab300
VARCHAR2(50)
分中心名称(网点所属分中心)
aab301
VARCHAR2(6)
行政区划代码(参保人员所属)
aaa146
VARCHAR2(100)
行政区划名称(参保人员所属)
aab001
VARCHAR2(8)
单位编号
aac003
VARCHAR2(20)
姓名
aac004
VARCHAR2(3)
性别
akc023
NUMBER(3,0)
年龄
aka150
NUMBER(3,0)
看病次数
skc030
VARCHAR2(18)
转院登记号
skb010
VARCHAR2(3)
挂号科室编码(必填)
skc031
VARCHAR2(10)
挂号科室名称
skc032
NUMBER(8,2)
挂号费用
skc033
VARCHAR2(3)
冲销标志(Z正常;+被冲销;-冲销)
skc034
VARCHAR2(18)
被冲销流水号
aae011
VARCHAR2(20)
经办人(医院办理挂号工作人员姓名)
aae036
DATE
经办日期(挂号日期)
aae040
DATE
结算日期
skc035
VARCHAR2(20)
结算人
akc087
NUMBER(8,2)
个人帐户余额
aae001
NUMBER(4)
结转年度
vvv001
VARCHAR2(50)
医疗人员类别名称
vvv002
VARCHAR2(50)
性别名称
vvv003
VARCHAR2(50)
IC状态名称
vvv004
VARCHAR2(50)
医院等级名称
aab300
VARCHAR2(50)
经办机构名称(医保中心、分中心名称)
aab004
VARCHAR2(50)
单位名称(看病人员所在单位)
akb021
VARCHAR2(50)
网点名称(医院、药店、门诊名称)
收费单据
[V_kcaoDTO]
aae072
VARCHAR2(18)
单据号
akc260
NUMBER(8,2)
医保基金应支付金额
akc261
NUMBER(8,2)
个人现金应支付金额
akc262
NUMBER(8,2)
个人帐户应支付金额
akc264
NUMBER(8,2)
总额
skc099
NUMBER(4,0)
处方项目数
aae040
DATE
结算日期
skc035
VARCHAR2(20)
结算人
收费单据
V_kcag说明:
IC卡状态的代码是“AKC141”。
医院等级的代码是“AKA101”。
3.1.2门诊挂号(F04.05.02.01)
3.1.2.1输入输出
输入(2006年4月1号后,调用此函数,必须保持IC卡在读卡器中)
aac001
VARCHAR2(18)
医保编号(使用F04.02.01.01的返回结果)
skb010
VARCHAR2(3)
科室编码(必填)
skc031
VARCHAR2(50)
挂号科室名称(必填)
skc032
NUMBER(8,2)
挂号费用
输出(参见门诊挂号公共输出)
3.1.2.2处理流程
参保病人要进行门诊收费之前,需要到挂号处进行门诊挂号登记,缴纳规定的挂号费用后方可进行就诊。
系统根据客户端上进行挂号登记过程中碰到下列情况之一时,业务不予进行:
✧IC卡被冻结挂失
2012年1月1日期,新增科室编码(必填)、挂号科室名称调整为必填项。
3.1.3门诊挂号冲销(F04.05.03.01)
3.1.3.1输入输出
输入
aac001
CHAR(10)
医保编号
akc190
VARCHAR2(18)
门诊号
输出(参见门诊挂号公共输出)
3.1.3.2处理流程
根据客户端上进行挂号登记冲销过程中碰到下列情况之一时,业务不予进行:
✧IC卡被冻结挂失
✧当前号已经进行了有效的门诊收费
✧当前号已经被冲销(非正常挂号信息)
✧当前号对应的参保人员和需要冲销的参保人员不一致
✧准备冲销的门诊挂号不是在当前的医院(门诊)登记的
✧门诊号是每次门诊登记的时候医保中心系统自动生成的,是该次门诊的唯一标识。
3.1.4查询有效门诊号列表(F04.05.01.01)
3.1.4.1输入输出
输入
aac001
CHAR(10)
医保编号
输出
vvv001
VARCHAR2(50)
挂号数量
vvv002
VARCHAR2(50)
发票数量
数据集
akc190
VARCHAR2(18)
门诊号
skb010
VARCHAR2(3)
挂号科室编码(必填)
skc031
VARCHAR2(50)
挂号科室名称
skc032
NUMBER(8,2)
挂号费用
aae011
VARCHAR2(20)
经办人(医院办理挂号工作人员姓名)
aae036
DATE
挂号日期
数据集
3.1.4.2处理流程
门诊挂号一般是当天有效,而且允许每天多次挂号,故在进行门诊收费之前,需要知道当前收费所对应的门诊挂号信息。
客户端发送输入入参“个人编号”,发出服务请求,服务号为:
“F04.05.01.01”。
处理成功后将返回当前有效挂号列表已经本系统所设定的发票项目列表。
输出参数说明:
参数共分为2个部分
第一部分:
挂号数量、发票数量
第二部分:
具体的挂号记录信息集合,门诊号是唯一表示该次门诊记录.
3.1.5门诊挂号查询(F04.05.04.01)
3.1.5.1输入输出
输入
akc190
VARCHAR2(18)
门诊号
输出(参见门诊挂号公共输出)
3.1.5.2处理流程
该查询通过主键门诊流水号进行查询,故最多返回一条信息,如果此流水号不存在或者该用户没有浏览此流水号的权限,系统将返回错误信息(下面的门诊收费查询、住院登记查询、住院收费查询、报销收费查询和该业务逻辑处理方法一致)。
3.2门诊收费
3.2.1门诊收费公共输出
[V_kcaoDTO]
aae072
VARCHAR2(18)
单据号
akc190
VARCHAR2(18)
门诊号
akb020
VARCHAR2(8)
网点编号(医院、药店、门诊编号)
aab001
VARCHAR2(8)
单位编号
aac001
VARCHAR2(10)
医保编号
aka101
VARCHAR2(3)
医院等级
akc021
VARCHAR2(3)
医疗人员类别
aab034
VARCHAR2(8)
分中心编码(网点所属分中心)
aab300
VARCHAR2(50)
分中心名称(网点所属分中心)
aab301
VARCHAR2(6)
行政区划代码(参保人员所属)
aaa146
VARCHAR2(100)
行政区划名称(参保人员所属)
akc020
VARCHAR2(18)
IC卡号
akc141
VARCHAR2(3)
IC卡状态
aac003
VARCHAR2(20)
姓名
aac004
VARCHAR2(3)
性别
akc023
NUMBER(3,0)
年龄
aka150
NUMBER(3,0)
看病次数
skc516
VARCHAR2
(2)
特殊病种编码
aka120
VARCHAR2(20)
病情种类
skc057
VARCHAR2(20)
病情种类(次)
skc058
VARCHAR2(20)
病情种类(第三)
本年度个人帐户
akc252
NUMBER(8,2)
个人帐户余额(不含本次收费)
本年度普通门诊累计
skc059
NUMBER(8,2)
本年度个人帐户支付普通门诊累计(不含本次收费)
本年度自付段累计(包括门槛费和门诊进入医保的费用)
skc060
NUMBER(8,2)
本年度个人帐户代付自付段累计(不含本次收费)
skc063
NUMBER(8,2)
本年度个人现金支付自付段累计(不含本次收费)
本年度基本统筹累计
skc061
NUMBER(8,2)
本年度个人帐户代付基本统筹段个人支付部分累计(不含本次收费)
skc064
NUMBER(8,2)
本年度个人现金支付基本统筹段个人支付部分累计(不含本次收费)
skc066
NUMBER(8,2)
本年度基本统筹支付累计(不含本次收费)
本年度大病累计
skc070
NUMBER(8,2)
本年度个人帐户代付大病段支付累计(不含本次收费)
skc071
NUMBER(8,2)
本年度个人现金支付大病段支付累计(不含本次收费)
skc072
NUMBER(8,2)
本年度大病基金支付总额(不含本次收费)
本年度超过医保封顶累计
skc062
NUMBER(8,2)
本年度个人帐户代付医保超支段累计(不含本次收费)
skc065
NUMBER(8,2)
本年度个人现金支付医保超支段累计(不含本次收费)
本次非医保费用
akc253
NUMBER(8,2)
本次个人自费【现金】金额(非医保费用)
akc270
NUMBER(8,2)
本次个人自费【账户】金额(非医保费用)
本次普通门诊金额
skc075
NUMBER(8,2)
本次个人帐户支付普通门诊金额
本次自付段(门槛费和门诊进入医保的费用)
skc076
NUMBER(8,2)
本次个人帐户支付自付段金额
skc079
NUMBER(8,2)
本次个人现金支付自付段金额
本次基本统筹部分
skc077
NUMBER(8,2)
本次个人帐户代付统筹段个人支付部分金额
skc080
NUMBER(8,2)
本次个人现金支付统筹段个人支付部分金额
skc089
NUMBER(8,2)
本次统筹段基金支付部分()
本次大病部分
skc082
NUMBER(8,2)
本次个人帐户代付大病段个人支付部分金额
skc083
NUMBER(8,2)
本次个人现金支付大病段个人支付部分金额
skc084
NUMBER(8,2)
本次大病段基金支付部分
本次超出医保封顶部分
skc078
NUMBER(8,2)
本次个人帐户代付超出医保封顶部分金额
skc081
NUMBER(8,2)
本次个人现金支付超出医保封顶部分金额
本次总计
akc260
NUMBER(8,2)
本次医保基金应支付金额
akc261
NUMBER(8,2)
本次个人现金应支付金额
akc262
NUMBER(8,2)
本次个人帐户应支付金额
akc264
NUMBER(8,2)
本次医疗费总额
skc093
VARCHAR2(18)
被冲销单据号
skc033
VARCHAR2(3)
冲销标志(Z正常;+被冲销;-冲销)
aae011
VARCHAR2(20)
经办人(收费人员)
aae036
DATE
经办日期(收费日期)
skc095
NUMBER(2,0)
单据打印次数
skc099
NUMBER(4,0)
处方项目数
aae040
DATE
结算日期
skc035
VARCHAR2(20)
结算人
akc087
NUMBER(8,2)
个人帐户余额
aae001
NUMBER(4)
结转年度
vvv001
VARCHAR2(50)
医疗人员类别
vvv002
VARCHAR2(50)
性别名称
vvv003
VARCHAR2(50)
IC状态名称
vvv004
VARCHAR2(50)
医院等级名称
aab300
VARCHAR2(50)
经办机构名称(分中心)
aab004
VARCHAR2(50)
单位名称
akb021
VARCHAR2(50)
网点名称
vvv005
VARCHAR2(50)
主病情名称
vvv006
VARCHAR2(50)
次病情名称
vvv007
VARCHAR2(50)
三病情名称
收费项目
Kc22DTO
aka060
VARCHAR2(20)
收费项目编码
aka061
VARCHAR2(50)
收费项目名称
aka063
VARCHAR2(3)
收费类别
ska003
VARCHAR2(3)
是否医保项目(000否,001是)
skc049
VARCHAR2(20)
医生姓名
aka070
VARCHAR2(20)
剂型(单位)
aka074
VARCHAR2(50)
规格
aka068
NUMBER(8,2)
单价
akc226
NUMBER(6,0)
数量
akc227
NUMBER(8,2)
金额
aka071
NUMBER(5,2)
每次用量
aka072
VARCHAR2(20)
使用频次
aka073
VARCHAR2(50)
用法
akc229
NUMBER(4,1)
执行天数
aka069
NUMBER(3,2)
自付比例
skc614
VARCHAR2(3)
是否特殊门诊用药(000否,001是)
收费项目
收费项目
Kc23DTO
akb020
VARCHAR2(8)
网点编号(医院、药店、门诊编号)
akc190
VARCHAR2(18)
住院号(门诊、报销号)
aae072
VARCHAR2(18)
单据号
aka063
VARCHAR2(3)
收费类别
akc240
NUMBER(8,2)
费用总额
skc050
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 文档 版本 说明