成都市基本医疗保险基础数据采集接口规范.doc

成都市基本医疗保险基础数据采集接口规范久远银海年月1、 变更说明编号修订日期版本号修订人说明 进销存数据采集接口规范文档发布 针对进销存盘盈、盘损、科室备用药品进行接口规范调整2、 概述成都市基本医疗保险基础数据采集应用编程规范（以下简称数据采集接口规范）的使用对象为定点医疗机构（）供应商或其它应用软件供应商。数据采集接口规范适用于包括医师、科室、设备、药品、进销存等在内的定点医疗机构监管型及公众服务型相关数据资源的采集及管理。（本规范 ，不含对我市医保政策和业务经办流程的介绍） 应用模式数据采集接口交易使用通信协议，传输数据格式遵循协议，通过发布服务。 技术，能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件，就可相互交互数据环境要求硬件环境无。网络环境指标指标值广域网带宽网络连接客户端直接访问医保中心网络数据交互规范1 服务器地址：内网【测试】服务器地址： 内网【生产】服务器地址： 调用方法名：测试交易访问用户交易访问验证码正式交易访问用户正式访问验证码测试通过后再分配授权2 交互数据格式交互数据格式使用数据流。字符集传入参数作为提供服务方法的参数传入，返回数据使用数据流。3 请求调用的数据流格式 交易服务编码 交易访问用户 交易访问验证码 定点机构编码 医保项目编码 医院项目名称 医院对码流水号 流水号 是否拆零标志 采购价格 采购数量 4 服务返回的数据流格式 服务返回的数据流格式为： 返回错误信息： 返回错误代码： 描述表示执行成功表示执行失败表示本次成功但是部分数据失败根据交易内容不同，返回值中会增加相应的节点，详情请看【交易服务明细说明】。数据交易接口1. 交易服务列表序号交易服务名称交易服务编号数据上传周期说明（变更）药品采购信息初始化首次上传使用，只能初始化使用药品入库信息上传当日数据，次日上传，能够做到当日数据当日上传更佳药品出库信息上传药品实际库存信息上传2. 交易服务明细说明. 药品采购信息初始化上传交易名称药品采购信息初始化上传交易分类交易代码交易说明1、 在两定机构首次上传药品采购信息之前，通过本交易将医疗机构现有的药品库存信息盘点之后作为采购信息一次性上传医保。2、 通过本交易上传之后该交易不再继续使用，后续的药品常规采购入库信息通过【药品入库信息上传交易（）】上传信息即可。3、 流水号作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。4、 药品采购信息初始化上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。5、 一次调用最多只允许上传明细条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。 变更、 药品初始化的时候：上传药品总量不包含医院科室的备用药品数量(科室备用药品或称之为科室暂存药品)、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入 交易服务编码 交易访问用户 交易访问验证码 定点机构编码 医保项目编码 医院项目名称 医院对码流水号 流水号 是否拆零标志 采购价格 采购数量 交易输出 错误信息 返回代码 医保项目编码 医疗机构目录编码流水号 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明交易服务编码 ()交易访问用户 ()交易访问授权用户交易访问验证码 ()交易访问验证码定点医疗机构编码 ()两定医疗机构编码医保项目编码 ()药品编码医院项目名称 ()医院内部该项目名称医院对码流水号 ()机构内部使用药品自编码医院自编码流水号 ()机构内部唯一标识码是否拆零标志 () 否； 是采购价格 ()跟是否拆零标志挂钩采购数量 ()允许负值（负值则默认为退货）交易输出：代码名称约束类型说明定点医疗机构编码 ()两定医疗机构编码医保项目编码()药品编码医疗机构目录编码()机构内部使用码流水号()机构内部唯一标识码上传失败原因. 药品入库信息上传交易名称药品入库信息上传交易分类交易代码交易说明1、 本交易为上传两定机构药品采购入库信息。2、 流水号作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。3、 药品入库信息上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。4、 一次调用最多只允许上传明细条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。变更、 药品采购渠道除了正常采购药品之外还包括医院自制制剂、捐赠药品，非正常采购数据上传时随货单号、供应商名称、供应商许可证填写方式有所调整，变化内容详细参考本交易的参数详细说明内容、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入 交易服务编码 交易访问用户 交易访问验证码 定点机构编码 医保项目编码 医院项目名称 医院对码流水号 流水号 随货单号 生产日期 是否拆零标志 供应商名称 供应商许可证号 药品生产批号 采购价格 采购发票号 采购数量 采购入库时间 采购人姓名 药品有效期 交易输出 错误信息 返回代码 医保项目编码 医疗机构目录编码流水号 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明交易服务编码 ()交易访问用户 ()交易访问授权用户交易访问验证码 ()交易访问验证码定点医疗机构编码 ()两定医疗机构编码医保项目编码 ()药品编码医院项目名称 ()医院内部该项目名称医院对码流水号 ()机构内部使用药品自编码医院自编码流水号 ()机构内部唯一标识码随货单号 ()必填变更：.上传医院制剂信息时，随货单号请填写“医院制剂”.上传捐赠药品信息时，随货单号填写“捐赠药品”药品生产日期 是否拆零标志 () 否； 是供应商名称 ()变更：.上传医院制剂信息时，供应商名称请填写“医疗机构名称”.上传捐赠药品信息时，填写“药品捐赠方名称”供应商许可证号 ()变更：.上传医院制剂信息时，供应商许可证号请填写“医院药品经营许可证”.上传捐赠药品信息时，填写“捐赠药品”药品生产批号 ()采购价格 ()采购发票号()采购数量 ()允许负值（负值则默认为退货）采购入库时间 采购人姓名 ()药品有效期 交易输出：代码名称约束类型说明定点医疗机构编码 ()两定医疗机构编码医保项目编码()药品编码医疗机构目录编码()机构内部使用药品自编码医院自编码流水号()机构内部唯一标识码上传失败原因. 药品出库信息上传交易名称药品出库信息上传交易分类交易代码交易说明1、 本交易为上传两定机构药品出库信息。2、 流水号作为定点机构内部使用主键，如果已经存在于医保系统中，本次上传对该条数据做失败处理，系统返回错误信息【数据重复上传】。3、 药品出库信息的上传，前提是两定机构必须在【医保两定管理协同平台】系统中已完成机构药品与医保药品目录的对码工作，否则上传失败。4、 一次调用最多只允许上传明细条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。变更、 针对医院科室备用药品、盘盈盘损药品等处理方式说明：通过本交易来进行处理，对药品消耗原因进行了扩展：损坏撤销（填负数） 变质撤销（填负数） 过有效期撤销（填负数） 盘盈（填负数） 盘损（填正数） 科室暂存药领用（填正数）：针对科室领用备用药品填写 科室暂存药领用撤销（填负数）其他撤销（填负数） （在上传撤销或者销售退货时，填报的各项指标应与正向数据指标保持一致：例如：结算标志、开单科室编码、医执人员编码、姓名、人员编号、身份证号码等）、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入 交易服务编码 交易访问用户 交易访问验证码 定点机构编码 医保项目编码 医院项目名称 医院对码流水号 流水号 是否拆零标志 结算标志 开单科室编码 医执人员编码 姓名 人员编号 身份证号码 单价 数量 出库时间 出库经办人 药品消耗原因 交易输出 错误信息 返回代码 医保项目编码 医疗机构目录编码流水号 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明交易服务编码 ()交易访问用户 ()交易访问授权用户交易访问验证码 ()交易访问验证码定点机构编码 ()两定医疗机构编码医保项目编码 ()药品编码医院项目名称 ()医院内部该项目名称医院对码流水号 ()机构内部使用药品自编码医院自编码流水号 ()机构内部唯一标识码是否拆零标志 () 否； 是结算标志 () 非成都市医疗保险参保病人 成都市医疗保险参保病人药品消耗原因【不为销售时】填开单科室编码 ()两定管理协同平台填报的医院科室编码药品消耗原因为销售时必填，否则选填医执人员编码 ()两定管理协同平台填报的医院医生编码药品消耗原因为销售时必填，否则选填姓名 ()患者姓名，必填【药品消耗原因为销售时必填，否则选填】人员编号 ()参保人员必填身份证号码 ()参保人员必填单价 ()数量 ()药品消耗原因为：出库时间 出库经办人 ()药品消耗原因 ()销售 损坏 变质 过有效期销售退货（此退货表示销售的退货，不是药品采购退货） 损坏撤销（填负数） 变质撤销（填负数） 过有效期撤销（填负数） 盘盈（填负数） 盘损（填正数） 科室暂存药领用（填正数） 科室暂存药领用撤销（填负数）其他 其他撤销（填负数） 交易输出：代码名称约束类型说明定点医疗机构编码 ()两定医疗机构编码医保项目编码()药品编码医疗机构目录编码()机构内部使用药品自编码医院自编码流水号()机构内部唯一标识码上传失败原因. 药品实际库存信息上传交易名称药品实际库存信息上传交易分类交易代码交易说明1、 本交易为上传两定机构药品在本机构内当前的实际库存信息。2、 数据上传时如果出现相同记录（相同记录指：三指标值都相同），则后面上传的结果会覆盖之前上传的结果本次上传成功。3、 一次调用最多只允许上传明细条，超过限制数量提交不成功【注:数据提交成功后，该批次上传数据中校验成功的数据提交保存，校验失败数据返回失败原因】。变更：、 药品实际库存上传的时候：上传药品总量不包含医院科室的备用药品数量(科室备用药品又称之为科室暂存药品)、 针对院外配送药品的管理，该药品可在医保两定管理协同平台对码的时候维护该类药品标志。本规范定义的药品采购信息初始化、药品入库信息医疗机构可自由选择是否上传数据；药品出库信息据实上传。输入参数交易输入 交易服务编码 交易访问用户 交易访问验证码 定点机构编码 流水号 医保项目编码 医院项目名称 医院对码流水号 是否拆零标志 库存日期 数量 交易输出 错误信息 返回代码 流水号 医保项目编码 医疗机构目录编码 上传失败原因 参数详细说明:交易输入：代码名称约束类型说明交易服务编码 ()交易访问用户 ()交易访问授权用户交易访问验证码 ()交易访问验证码定点机构编码 ()两定医疗机构编码流水号 ()机构内部唯一标识码医保项目编码 ()药品编码医院项目名称 ()医院内部该项目名称医院对码流水号 ()机构内部使用药品自编码医院自编码是否拆零标志 () 否； 是库存日