医疗保险定点医院接口设计方案

发布时间 : 星期四 文章医疗保险定点医院接口设计方案更新完毕开始阅读

输入参数:inputData 输出参数:outputData char* 返回值: 成功 =0 失败 <0 输入参数是以“^、$、|”分割的字符串 输出也是以“^、$、|”分割的字符串 参数说明: 入参格式: inputData

业务编号^医疗机构编号^操作员编号^业务周期号^医院交易流水号^中心编码^入参^联机标志^动态库参数^

业务编号(4位) 宏定义, 分别对应后台的一项业务操作 医院编号(8位) 操作员编号(8医院分配给操作员的唯一标识 位) 业务周期号(最签到时的返回的业务周期号 大34位) 医院交易流水号建议规则:时间(14)+医院编号(8)+流水号(4) 例:01-0001 (发送方交易流水号)(最大30位) 中心编码 固定为0000 入参 以“|”分隔,详见每个交易的参数表, 分项之间使用管道分割符‘|’分割,最后必须要以管道分割符号‘|’结尾,不以‘|’开始。如果入参为多条记录,记录之间以‘$’分割,不同数据项之间以‘|’分割 0:脱机 1:联机。 注意:在做读卡和门诊挂号这两个交易时,联机标识必须传1。 联机标志 动态库入参

签到交易为:客户端MAC地址|用户数目| 其他交易为:客户端MAC地址| 出参格式: outputData char*

中心交易流水号^业务周期号^输出参数^联机标志^

中心交易流水号 中心交易流水号(最大30位)中心返回 业务周期号 输出参数 中心根据操作员和中心时间,生成业务周期号 (该参数为输出参数,客户程序必须在调用本函数之前分配足够长 的空间,其最小值为1024字节,如果未给本参数分配空间或分配的空间长度小于实际返回的长度,客户程序将会出现内存保护错误),最后以管道分割符号’|’结尾。 联机标志 在读卡和门诊挂号时,从动态库的返回参数中取该笔业务是联机还是脱机交易,HIS需要保存,后续的明细录入和结算交易时,需要传入该标识。 返回值说明 :

0 – 成功,表示此次交易请求成功,业务处理也正常

< 0 - 错误,包括系统级别错误(网络、主机、数据库)和业务级别错误,系统级别错误由动态库将错误信息写入输出参数,业务级别错误由后台通过输出参数提示错误信息。 错误输出机制说明 :

Web应用返回给动态库的返回参数格式为:中心交易流水号^业务周期号^输出参数^交易相应码^,动态库接收到返回参数后,根据交易相应码判断交易处理成功与否,交易处理成功,则动态库返回值为0,否则,将交易相应码转换为小于0的返回值。动态库返回给开发商的出参,去掉交易相应码 交易流水号说明:

规则:时间(14)+医院编号(8)+流水号(4),之间用-分隔 例:01-0001

业务周期号说明:

说明:医院编号(8)+操作员编号(最大8位)+时间(14)+流水号(4),之间用-分隔

例:9999-200601

注:4位流水号可以循环使用

交易编码说明:

交易编码为四位编码,第一位标志交易性质,后面三位表示流水号 序号 交易码 功能简介 交易性质 1 1 1 1 0 医疗费用信息汇总 查询 2 1 2 1 0 明细对帐请求 查询 3 1 1 0 0 医疗费用信息查询 查询 4 1 2 0 0 费用明细信息查询 查询 5 1 3 0 0 信息批量下载 查询 6 参保人员基本信息及其医保个人1 4 0 0 查询 帐户查询 7 1 5 0 0 医疗待遇封锁信息查询 查询 8 1 6 0 0 个人审批信息 查询 9 9 1 0 0 签到 认证交易 10 9 1 1 0 签退 认证交易 11 2 1 0 0 读卡 主体交易 12 2 1 1 0 修改卡密码 主体交易 13 2 1 2 0 校验卡密码 动态库交易 14 2 2 1 0 门诊/住院登记 主体交易 15 2 2 3 0 登记(挂号)信息修改 主体交易 16 2 2 4 0 登记(挂号)撤销 主体交易 17 2 3 1 0 费用明细上报 主体交易 18 2 3 2 0 费用明细撤销 主体交易 19 2 4 1 0 结算 主体交易 20 2 4 2 0 预结算 主体交易 21 2 4 3 0 结算撤销/取消报销 主体交易 22 2 6 1 0 药店收费预结算 主体交易 23 2 6 2 0 药店收费结算 主体交易 24 2 5 1 0 中心报销保存处方 主体交易 25 3 1 1 0 医院审批信息上报 申报业务 26 3 1 2 0 医院审批信息上报撤销 申报业务 27 3 1 3 0 个人参加险种信息 查询 28 4 3 0 0 结算信息冲正 主体交易 29 4 5 0 0 查询系统时间 查询 30 5 1 0 0 将卡中密码存入数据库 主体交易 31 5 1 1 0 从数据库获取卡密码 查询 32 6 1 0 0 医疗类别变更 主体交易 33 5 2 0 0 医院端卡封锁 主体交易 三、接口交易设计 1、查询类 A、交易功能

该交易主要完成诸如中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询及下载,同时还包括个人基本信息及帐户信息、封锁信息等的查询业务。对于中心药品目录、诊疗项目目录、服务设施目录、病种目录等的查询交易,下载时提供以TAB分隔的TXT文件。

B、交易设计

1)、批量数据查询下载

交易说明:批量下载中心目录等基础数据,然后对中心的药品目录和诊疗项目目录在his系统进行对照,上传处方时,根据对照结果,同时上传医院编码名称和中心编码。 项目编码 项目名称 01 药品目录 02 03 04 05 诊疗项目信息 费用类别信息 病种信息 项目和一次性材料对应关系 说明 此交易为了HIS对项目与一次性材料的控制。 输入参数: 编号 1 名称 项目编码 长度 VARCHAR2(3) 约束 NOT NULL 2 开始日期 VARCHAR2(14) NOT NULL YYYYMMDDHH24MISS 开始时间之后维护和发生变化的时间. 输出参数: 编号 1 名称 长度 约束 说明 参见配置信息 说明 确定需要下载信息的种类 文件路径及文件名称 VARCHAR2(200) 说明:下载文件的路径为:当前文件绝对路径\\YBDLOAD\\文件名.txt;文件名的命名规则为:

联系合同范文客服:xxxxx#qq.com(#替换为@)