沈阳医保接口用户手册 QMS2005 P-11/113 联机模式进行消费,当定点医疗机构与中心网络不通时,连接前置机进行脱机消费。 HIS系统 包括定点医疗机构的医院管理信息系统和收费本文档中提到的开发商也端两种系统,这两种情况都需要调用医保接口是指HIS系统的软件开发动态库完成定点医疗机构的医保收费。
商 1.4 参考资料
编号 1 2 3 4
参考资料 《社保卡整合过渡方案》 《医保接口对账方案》 《医保接口用户数控制方案》 《核心平台医保接口设计报告》 备注 东软集团股份有限公司
沈阳医保接口用户手册 QMS2005 P-12/113
2 接口流程设计
2.1 医院就医流程设计
开始读卡<<可选>>人员封锁信息查询<<可选>>医疗待遇审批信息查询门诊挂号Y费用明细上报是否发生费用N上报明细是否正确YN<<可选>>费用明细对帐<<可选>>费用明细查询N<<可选>>费用明细撤销无费退号Y中心端与医院端数据一致费用结算Yes费用预结算费用结算撤销No结束结算正确
说明:上图以门诊为例说明医院就医的业务流程,住院业务与门诊业务的区别是,在就诊登记后,费用结算前,任何一个环节,都可以选择进行住院登记信息修改。
东软集团股份有限公司
沈阳医保接口用户手册 QMS2005 P-13/113
2.2 药店购药流程
开始读卡(from State/Activity Mod...)<<可选>>人员封锁信息查询(from State/Activity Mod...)<<可选>>医疗待遇审批信息查询(from State/Activity Mod...)药店预结算是否退药药店结算NY费用结算撤销(from State/Activity Mod...)是否购药结束N
3 系统接口设计
3.1 用户接口函数
本系统提供给医院的是一个动态库接口,无用户界面,输入输出均通过DLL完成。 程序文件名:SiInterface.dll 对外提供的接口函数:
? 初始化函数:
int INIT(char * pErrMsg)
参数说明:
pErrMsg:动态库初始化错误信息。 功能描述:
检查整个运行环境:包括网络环境、运行所需文件、参数等的检查 本地临时文件的清除,比如获取照片信息交易所生成的本地jpg文件。 返回值: 成功:返回0 ; 失败:返回 -1
? 交易函数:
东软集团股份有限公司
沈阳医保接口用户手册 QMS2005 P-14/113
int BUSINESS_HANDLE( char* inputData,
char* outputData)
功能描述:HIS系统开发商需要向医保中心发送业务请求的通用函数
输入参数:inputData 输出参数:outputData char*
返回值:成功:返回0 ; 失败:返回 <0 输入输出参数是以“^、$、|”分割的字符串 参数说明: 入参格式: inputData
业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^联机标志^
业务编号(4位) 定点医疗机构编号 操作员编号(8位) 宏定义, 分别对应后台的一项业务操作 医院分配给操作员的唯一标识 业务周期号(最大36操作员签到时,中心返回给his的业务周期号。 位) 每次向中心发送交易,必须带上这个业务周期号,该业务周期号必须使用中心返还的数据,开发商自己不能随意生成,否则对账会受影响,造成月结算数据不准。 医院交易流水号(发建议规则:时间(14)+医院编号(8)+流水号(4) 例:20120101083030-10011001-0001 送方交易流水号)(最大30位) 中心编码 0000 入参 以“|”分隔,详见每个交易的参数表, 分项之间使用管道分割符‘|’分割,最后必须要以管道分割符号‘|’结尾,不以‘|’开始。如果入参为多条记录,记录之间以‘$’分割,不同数据项之间以‘|’分割 说明:中心修改参数的原则:只增不减,增加的参数加在参数列表的最后,不在中间插入参数。 0:脱机 1:联机。沈阳传‘1’,因为本系统全是联机模式。 联机标志
出参格式: outputData char*
中心交易流水号^联脱机标志^输出参数^
东软集团股份有限公司
沈阳医保接口用户手册 QMS2005 P-15/113 中心交易流水号 联脱机标志 输出参数 中心交易流水号(最大30位)中心返回 本项目是联机项目,所以该字段不用。 该参数为输出参数,客户程序必须在调用本函数之前分配足够长 的空间,其最小值为1024字节,如果未给本参数分配空间或分配的空间长度小于实际返回的长度,客户程序将会出现内存保护错误 输出参数的规则同入参格式中的输入参数说明 返回值说明 :
0 – 成功,表示此次交易请求成功,业务处理也正常
< 0 - 错误,包括系统级别错误(网络、主机、数据库)和业务级别错误,错误信息通过输出参数提示出来。其中:
-1-系统级别错误,HIS系统提示错误信息后,需要进行冲正等后续业务操作处理; -2-业务处理错误,HIS系统直接将输出参数的错误信息提示给操作员即可。
交易流水号说明:
说明:交易流水号必须是每一次交易的唯一标识,在整个系统中是唯一的,因此开发商应严格按照建议规则生成交易流水号
规则:时间(14)+医院编号(8)+流水号(4),之间用-分隔 例:20120101083030-10011001-0001 业务周期号说明:
说明:医院编号(8)+操作员编号(最大8位)+时间(14)+流水号(3),之间用-分隔 例:10011001-99999999-20060101083030-001
注:业务周期号在签到交易由中心生成传给his系统。
3.2 交易编码说明
交易码为四位编码,开发商调用不同的交易通过交易编码区分 序号 交易码 交易名称 交易类型 查询 1 1100 医疗费用信息查询 查询 2 1101 医疗费结算信息对账查询 查询 3 1120 医疗费信息对账 查询 4 1200 费用明细信息查询 查询 5 1210 明细对帐请求 查询 6 1300 信息批量下载 查询 7 1310 对照信息批量下载 查询 8 1330 月结算汇总信息查询 查询 9 1331 药店年结算汇总查询 查询 10 1340 月结算详细信息查询 交易说明 对账使用 对账使用 对账使用 对账使用 对账使用 月结算使用 年结算使用 月结算使用 东软集团股份有限公司