医保前台软件接口系统说明医院接口.docx
《医保前台软件接口系统说明医院接口.docx》由会员分享，可在线阅读，更多相关《医保前台软件接口系统说明医院接口.docx（33页珍藏版）》请在冰豆网上搜索。
医保前台软件接口系统说明医院接口
南京市医保前台软件接口系统说明
一．网络连接方式：
在医院运行的医保前台软件,是和医保中心的应用服务器（中间件服务器）实时连接的，必须保证每一台使用医保前台软件的计算机都能连接到医保中心的应用服务器网络上，医院操作人员操作的所有数据都保存在医保中心的数据库中和医院本地HIS系统数据库中。
二．医院基础数据准备：
在使用医保前台软件之前，医院必须将基础数据准备好，主要有如下几方面的数据：
1．医院药品数据：
由医保中心提供一套基本的医保药品库（中心药品库），同时医保中心为每家医院建立一个药品对照库（机构药品库），医院必须按医保中心的要求提供医院的药品明细库，由医保中心相关部门将药品对照数据审批维护到机构药品库中。
同时医院可下载对照库到HIS系统中供查询打印等。
2．医院诊疗项目数据：
同医院药品数据类似处理
3．医院就诊科室对照表:
各医院将本字所有的科室基本信息数据上报到医保中心，由医保信息科维护到中心数据库中。
4．医院医生基本信息库：
各医院应将本院的医生基本信息（医生编号，姓名等）上报到医保中心，由医保信息科维护到中心数据库中。
三、医院前台软件运行方案的选择：
针对不同定点医院现有的HIS系统的实施、运行状况、在充分保证医保中心业务管理和数据要求的基础上，尽可能利用定点医院的HIS系统的数据和功能，对前台的业务主要有以下两种方案：
1.完全使用医保提供的前台软件：
该方案主要针对无HIS系统或对现行HIS系统改造比较困难的定点医院，医保业务完全由医保前台软件与医保中心中间件应用服务器实时联网来完成。
该方案医保的数据和医院HIS系统的数据相互较独立。
2.使用医保提供的嵌入式接口系统：
该方案主要针对有较完善的HIS系统并对HIS系统有改造能力的定点医院，嵌入式接口系统采用WINDOWS动态连接库的标准，将医保业务的主要功能封装在接口系统中，可以由医院HIS系统连接调用，并实时返回业务的输出数据，使医保数据和HIS系统的数据达到最大的共享。
四、HIS系统与医保嵌入式接口系统的总结构图
五、主要业务流程接口调用简表
HIS系统业务功能
调用接口服务
数据关联
1
门诊挂号：
参保人员刷卡
调用刷卡函数read_ic
通过返回的个人编号（P_TBR），随后调用接口服务GETCBRYXX取参保人员的基本信息
调用服务后数据通过中间件提交到医保中心数据，返回挂号单据的流水号，HIS系统应保存该单据号作为对照
在HIS系统中输入业务数据，转给接口，调用服务成功后将返回流水号记录到HIS系统中
MZGH
2
门诊收费：
1）参保人员刷卡后，在HIS系统中输入相关人员信息和处方费用明细（药品明细和诊疗项目明细）
2）将HIS系统中已录入的费用明细调用服务接口上传到医保中心，为计算费用做准备
MZSF_SC
药品或诊疗项目由对照编码的方式处理，HIS系统传的是自编码，由对照库对应到医保中心支付类别等
3）调用费用计算接口，按医保政策计算出费用的支付分滩情况
MZSF_JS在MZSF_SC之后调用
本服务只计算费用，返回支付项目，没有实际的数据存贮，调用本服务之前必须已成功调用MZSF_SC服务
4）对计算出的费用支付无异议后，调用最终结算确认服务，生成结算单据，并返回相关信息
MZSF_QR
在MSZF_QR之后调用
最终生成门诊收费单据，提交数据到医保中心，调用本服务之前必须已成功调用MZSF_JS服务
5）HIS将返回的相关信息记录在HIS系统数据库中，并提交HIS系统的后续业务
6）HIS系统中对相关票据进行打印
打印由HIS系统程序完成
3
住院登记：
参保人员刷卡后，HIS系统输入住院病人的基本信息和入院相关信息，确认无误后，调用接口服务，调用成功后，将返回的住院序号记录在HIS系统的数据库中，住院序号（ZYXH）用于标识该医保住院病人的唯一流水号,在后续住院期间输入费用和相关业务操作中都用到ZYXH
ZYDJ
医保中心的数据和HIS系统的数据用ZYXH进行相关联
HIS系统也可以有本系统内部对住院病人的标识号，于医保中心的标识号并无冲突
4
住院期间费用管理:
对医保住院病人每天发生的费用进行上传，预结算等业务
1）费用上传：
在HIS系统的费用管理程序中录入发生的费用后，调用接口服务上传费用到医保中心。
ZYMX_SC
按费用发生时间（天）覆盖式的上传
2）对住院病人已发生的费用进行预结算，对押金不足等HIS可进行提示
CYJS
出院结算特征特征为0
本服务对在院病人的费用进行按医保政策进行预结算，返回各支付项目
5
出院结算：
HIS系统输入住院病人的出院信息（出院时间，出院性质等）
1）出院费用计算，返回支付项目
CYJS
出院结算特征为1
2）最终出院结算确认
CYQR
生成出院结算单据，返回单据的流水号，HIS系统记录相关返回信息，调用本服务之前必须先成功调用CYJS服务
3）HIS系统记录返回数据，并提交HIS系统的其它业务
4）HIS打印相关票据
医疗保险嵌入式数据接口系统说明
业务接口部分:
一.门诊挂号:
医院HIS系统在本系统门诊挂号确认之前，调用门诊挂号接口服务功能实现医保病人的挂号，调用成功后将返回的单据号保在HIS系统中。
接口服务名称:
MZGH
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_TBR
C9
个人编号
参保人员个人编号
P_YYKSM
C20
挂号科室码
挂号的医院科室编码
P_GHF
N
挂号费
P_CZRYH
C10
操作人员编号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_DJH
C20
单据号
挂号单据的流水号
二.门诊退号：
门诊退号功能，将取消医保病人未收费的挂号单据
接口服务名称:
MZTH
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_DJH
C20
原挂号单据号
将要退号单据的单据号
P_CZRYH
C10
操作人员编号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_DJH
C20
单据号
新的冲帐单据的流水号
三.门诊收费：
在医院HIS系统中，将医保病人的就诊信息和药品诊疗项目信息输入完毕后，调用费用明细上传服务将费用上传到医保中心系统,后调用收费计算接口服务计算医保费用的各项支付，确认计算费用无误后，调用费用提交接口服务最终结算并将返回的单据号等信息保存在HIS系统中。
1.费用上传
接口服务名称:
MZSF_SC
本服务将处方明细上传到医保中心,输入参数可多条数据（参见参数的传递方法）
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_LB
C1
类别
0-药品,1-诊疗项目
P_JZLB
C1
就诊类别
暂固定为’0’
P_YBBM
C20
医保编码
暂为空串””
P_ZBM
C20
自编码
药品（或诊疗项目）自编码
P_JG
N
单价
P_SL
N
数量
返回参数（暂无）
2.费用计算
接口服务名称:
MZSF_JS
本服务根据医保政策实时计算各费用支付分滩情况
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员个人编号
P_KXH
C3
医保卡序号
刷IC卡返回的卡号
P_TSMZ
C1
特殊就诊类别
暂固定为’0’
P_YYKSM
C20
医院科室编码
就诊科室
P_YSRYH
C10
医保编码
医生人员号（处方医生）
P_CFH
C20
处方号
暂为空串
P_BZM
C10
病种码
就诊病种（可为空）
P_JZ
C1
是否急诊
0-否1-是
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_ZFY
N
总费用
处方总费用
P_YF
N
药品费
药品费用
P_ZLXMF
N
诊疗费
诊疗项目费用
P_GRZL
N
个人自费
P_GRZF
N
个人自付
P_GRZHZF
N
个人帐户支付
P_TCJJZF
N
统筹基金支付
P_BCYLZF
N
补充医疗支付
P_GWYBZZF
N
公务员补助支付
P_LJZF
N
累计支付
P_LJZL
N
累计自费
P_QCGRZH
N
期初个人帐户
P_QMGRZH
N
期末个人帐户
3.最终结算提交
接口服务名称:
MZSF_QR
本服务根据医保政策实时计算各费用支付分滩情况
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_QCGRZH
N
初始个人帐户
期初个人帐户
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_DJH
C20
单据号
门诊结算单据流水号
P_ZFY
N
总费用
处方总费用
P_YF
N
药品费
药品费用
P_ZLXMF
N
诊疗费
诊疗项目费用
P_GRZL
N
个人自费
P_GRZF
N
个人自付
P_GRZHZF
N
个人帐户支付
P_TCJJZF
N
统筹基金支付
P_BCYLZF
N
补充医疗支付
P_GWYBZZF
N
公务员补助支付
P_LJZF
N
累计支付
P_LJZL
N
累计自费
P_QCGRZH
N
期初个人帐户
P_QMGRZH
N
期末个人帐户
注:
调用本服务前,HIS系统应再次调用刷卡函数,判断医保病人的卡是否读卡器中
四.门诊冲帐:
门诊冲帐将医保病人已收费单据作废，并恢复个人帐户到本单据就诊前的状态（建议从最后一张收费单冲起）,退现金给病人。
接口服务名称:
MZCZ
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_DJH
C20
原单据号
将要冲帐的单据的单据号
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_DJH
C20
单据号
新冲帐单据的流水号
P_QCGRZH
N
期初个人帐户
冲帐前个人帐户
P_GMGRZH
N
期末个人帐户
冲帐后个人帐户
五.住院登记:
医保病人入院登记，在HIS系统入院登记确认之前，调用登记接口服务，成功后将返回的住院序号保存在HIS系统中，为医保病人住院的唯一标记。
接口服务名称:
ZYDJ
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员个人编号
P_KXH
C3
医保卡序号
读IC卡的序号
P_YYKSM
C20
医院科室
入院登记所在的科室
P_BZM
C20
病种编码
暂为空串””
P_RYYMD
C6
入院时间
格式为YYYYMMDD
P_RYBQ
C20
入院病区
P_RYCWH
C20
入院床位号
P_ZYH
C20
住院号
医院对住院病人分配的编号
P_LXDH
C20
联系电话
P_YJHJ
N
入院押金
入院登记时交的押金
P_YSRYH
C20
住院主治医生
HIS系统医生编号
P_KDYSRYH
C20
门诊开单医生
HIS系统医生编号
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_ZYXH
C20
住院序号
医保中心对住院病人中唯一标志流水号
不同于P_ZYH（此项是医院HIS系统给在院病人的唯一标识）
六.住院人员病区床位登记:
给住院人员分配病区和床位
接口服务名称:
ZYBQCW
输入参数：
标识名
类型
名称
说明
P_ZYXH
C20
住院序号
住院登记时返回时的流水号
P_RYBQ
C20
入院病区
P_RYCWH
C20
入院床位
P_YSRYH
C20
住院主治医生
HIS系统医生编号
P_KDYSRYH
C20
门诊开单医生
HIS系统医生编号
P_CZRYH
C10
操作人员号
返回参数（暂无）
七.住院每日费用明细上传:
将医保在院病人每天发生的费用上传（建议在HIS系统录入费用确认时上传），每次上传的费用明细将全覆盖同一费用时间的已上传费用。
接口服务名称:
ZYMX_SC
输入参数：
基本参数:
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_ZYXH
C20
住院序号
住院登记时生成的唯一标志号
P_FYYMD
C8
费用时间
费用的发生时间,格式（YYYYMMDD）
P_RYBQ
C20
所在病区
费用录入的病区
P_RYCWH
C20
所在床位号
P_JZLB
C1
就诊类别
暂为0
P_CZRYH
C10
操作人员号
登录系统的操作人员号
明细参数:
标识名
类型
名称
说明
P_ZBM
C20
自编码
费用明细自编码
P_LB
C1
类别
0-药品1-诊疗项目
P_JG
N
价格
P_SL
N
数量
P_CZYMD
C16
费用发生的精确时间
格式YYYYMMDDHH24MISS
返回参数（暂无）:
八.住院特殊费用审批上报:
对医保在院病人发生的特殊费用（血液蛋白制品等），需要医保中心相关科室审批,该服务实现上报审批数据的功能。
接口服务名称:
ZYSP_SC
输入参数：
基本参数:
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_ZYXH
C20
住院序号
住院登记时生成的唯一标志号
P_BZ
C200
备注说明
审批具体原因
P_CZRYH
C10
操作人员号
审批单录入人员
明细参数:
标识名
类型
名称
说明
P_FYYMD
C8
费用时间
费用的发生时间,格式（YYYYMMDD）
P_ZBM
C20
自编码
费用明细自编码
P_MCH
C50
名称
P_LB
C1
类别
暂定为’1’--诊疗项目
P_JG
N
价格
P_SL
N
申报数量
P_RYBQ
C20
所在病区
费用录入的病区
P_RYCWH
C20
所在床位号
P_CZYMD
C16
费用发生的精确时间
格式YYYYMMDDHH24MISS
返回参数
标识名
类型
名称
说明
P_SPDJH
C25
审批标识号
唯一标识本次待批单据的号码
九.获取住院特殊费用审批结果:
对医保在院病人发生的特殊费用（血液蛋白制品等），需要医保中心相关科室审批,该服务用来获取审批结果。
接口服务名称:
ZYSP_JG
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_SPDJH
C25
审批标识号
唯一标识本次待批单据的号码
返回参数:
基本参数:
单行
标识名
类型
名称
说明
P_BZ
C200
审批意见
返回医保中心审批意见
P_CZYMD
C16
审批时间
格式YYYYMMDD
明细参数:
多行
标识名
类型
名称
说明
P_ZBM
C20
自编码
费用明细自编码
P_MCH
C50
名称
P_LB
C1
类别
0-药品1-诊疗项目
P_JG
N
价格
P_SL
N
申报数量
P_SPSL
N
审批数量
已审批通过的数量
P_SPJE
N
审批金额（暂保留）
暂不使用,以后扩展
P_SPBZ
N
审批标志
0-未审,1-审批通过,2-审批未通过
十.住院登记注销:
注销错误的住院登记
接口服务名称:
ZYDJZX
输入参数：
基本参数:
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员的个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_ZYXH
C20
住院序号
住院登记时生成的唯一标志号
P_BZ
C40
备注
注销说明
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数（暂无）
十一.出院结算
1.费用结算
接口服务名称:
CYJS
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员的个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_ZYXH
C20
住院序号
住院登记时生成的唯一标志号
P_LB
C1
备注
预结算特征（0-预结算,1-出院结算）
P_CYYMD
C8
出院日期
格式（YYYYMMDD）
当为预结算时可传入当天时间
P_CYXZ
C1
出院性质
1治愈;2好转;3未愈;4死亡;5其他
当为预结算时可传入,2好传
P_BZM
C20
出院诊断
出院诊断病种ICD10
P_ZYTZ
C1
转院特征
0-不是转院,1-上转,2-下转
P_ZWYYM
C5
转往医院码
转往医院的医院编码
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_ZFY
N
总费用
处方总费用
P_YF
N
药品费
药品费用
P_ZLXMF
N
诊疗费
诊疗项目费用
P_GRZL
N
个人自费
P_GRZF
N
个人自付
P_GRZHZF
N
个人帐户支付
P_TCJJZF
N
统筹基金支付
P_BCYLZF
N
补充医疗支付
P_GWYBZZF
N
公务员补助支付
P_LJZF
N
累计支付
P_LJZL
N
累计自费
P_QCGRZH
N
期初个人帐户
P_QMGRZH
N
期末个人帐户
2.出院结算确认
接口服务名称:
CYQR
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员的个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_ZYXH
C20
住院序号
住院登记时生成的唯一标志号
P_QCGRZH
N
初始个人帐户
期初个人帐户
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_DJH
C20
单据号
住院结算单据流水号
P_ZFY
N
总费用
住院总费用
P_YF
N
药品费
药品费用
P_ZLXMF
N
诊疗费
诊疗项目费用
P_GRZL
N
个人自费
P_GRZF
N
个人自付
P_GRZHZF
N
个人帐户支付
P_TCJJZF
N
统筹基金支付
P_BCYLZF
N
补充医疗支付
P_GWYBZZF
N
公务员补助支付
P_LJZF
N
累计支付
P_LJZL
N
累计自费
P_QCGRZH
N
期初个人帐户
P_QMGRZH
N
期末个人帐户
十二.出院结算冲帐:
将医保病人的最后一次出院结算作废，将病人的状态恢复到在院，并将结算支付的医保费用恢复。
接口服务名称:
ZYCZ
输入参数：
标识名
类型
名称
说明
P_JGM
C5
医院码
医保中心为医院分配的编码
P_TBR
C9
个人编号
参保人员的个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_DJH
C20
住院单据的流水号
住院结算时生成的唯一号
P_CZRYH
C10
操作人员号
登录系统的操作人员号
返回参数:
标识名
类型
名称
说明
P_DJH
C20
单据号
新冲帐单据的流水号
P_QCGRZH
N
期初个人帐户
冲帐前个人帐户
P_GMGRZH
N
期末个人帐户
冲帐后个人帐户
十三.已出院病人ICD10病种确定:
对于已出院病人，出院结算时没有确定ICD10病种的，对该病人的病种重新确认。
接口服务名称:
ZYBZ_SC
输入参数：
标识名
类型
名称
说明
P_DJH
C20
原病人出院结算单据号
P_TBR
C9
个人编号
参保人员的个人编号
P_KXH
C3
医保卡序号
参保人员IC卡序号
P_BZM
C20
ICD10病种编码
返回参数（暂无）
系统功能维护接口部分:
一:
医保中心应用服务器连接控制函数
医院HIS系统要调用接口功能服务之前，系统必须已经连接登录到医保中间件应用服务器中
连接登录:
Functionintconn_ybzx（stringjgm,stringryh,stringmm,stringres）;
参数：
jgm医院在医保系统中的编号，如H0001
ryh操作人员在医保系统中的编号。
如”H0001Y0001”
mm操作人员的医保操作密码
res保留暂不使用
返回0-连接成功,-1
升级会员 