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

1、成都 市 基本医疗保险 基础 数据采集接口 规范 Version1.0 久远 银海 2019 年 01月 1、 变更说明 2、 概述 成都市基本医疗保险 基础数据 采集 应用 编程规范 （以下简称 数据采集 接口规范）的使用对象为定点医疗机构 （ HIS） 供应商或其它应用软件供应商。 数据采集 接口规范 适用于包括医师、科室、设备、药品、进销存等在内的定点医疗机构监管型及公众服务型相关数据资源的 采集 及管理 。 （本 规范 ， 不含 对 我市 医保政策和 业务经办 流程的介绍 ） 应用 模式 数据采集 接口 交易使用 HTTP 通信协议 ， 传输数据格式遵循 SOAP 协议 ， 通过 we

2、bservice发布服务 。 Web Service 技术 ， 能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件 ， 就可相互 交互 数据 环境要求 硬件环境 无 。 网络环境 指标 指标值 广域网带宽 56k 网络连接 客户端直接访问医保中心网络 数据交互规范 1 服务器地址： 内网【测试】服务器地址： http:/10.163.27.162/yhjypt/services/drugsManageService?wsdl 内网【生产】服务器地址： 测试 交易访问 用户 交易 访问验证码 cs0001 yhcs0001 正式 交易访问 用户 正式 访问验证码 测试 通过后

3、 再分配 授权 2 交互数据格式 交互数据格式使用 XML数据流。 字符集 utf-8 传入参数作为提供 WebService服务方法的参数传入，返回数据使用 XML数据流。 3 请求调用的 XML 数据流格式 交易服务编码 交易 访问用户 交易访问 验证码 定点 机构 编码 医保项目编码 医院项目名称 医院 对码流水号 流水号 是否拆零标志 采 购 价 格 采购数量 4 服务返回的 XML 数据流格式 服务返回的数据流格式为： 1 返回错误信息： result.message 返回错误代码： result.code code 描述 1 表示 执行成功 -1 表示执行 失败 99 表示本次 成

4、功但是部分数据失败 根据 交易内容不同，返回值中会增加相应的节点， 详情 请看 【交易 服务明细说明 】。 数据 交易 接口 1. 交易服务列表 序号 交易服务名称 交易服务编号 备注 1 药品 采购信息初始化 cdyp00000 2 药品入库 信息上传 cdyp00001 3 药品出库 信息上传 cdyp00002 4 药品实际库存 信息上传 cdyp00003 2. 交易服务明细说明 1. 药品 采购信息初始化 上传 交易名称 药品 采购 信息 初始化 上传 交易 分类 交易代码 cdyp00000 交易说明 1、 在 两定机构 首次 上传 药品 采购 信息 之前 ， 通过 本交易 将医疗

5、机构现有的 药品 库存 信息 盘点 之后 作为采购信息一次性 上传 医保 。 2、 通过 本交易 上传之后 该 交易 不再继续使用，后续的药品常规 采购 入库信息通过 【 药 品入库信息上传交易（ cdyp00001） 】上传 信息即可。 3、 流水号 作为 定点 机构 内部 使用主键，如果 已 经存 在于 医保 系统 中， 本次上传 对 该条数据做 失败 处理 ， 系统 返回 错误信息 【 数据重复 上传 】 。 4、 药品采购 信息初始化上传 ，前提 是两定 机构 必须 在 【医 保 两定管理 协同 平台 】 系统中 已完成机构药品 与 医保药品目录的对码 工作 ，否则上传失败。 5、 一

6、 次 调用 最多 只 允许 上传 明细 50 条 ， 超过 限制 数 量 提交不成功 【注 :数据提交成功后，该批次 上传 数据中 校验 成功的数据 提交 保存，校验失败数据返回 失败 原因 】 。 输入参数 交易输入xml 交易 服务 编码 交易访问 用户 交易访问验证码 定点 机构 编码 医保项目编码 医院 项目 名称 医院 对码流水号 流水号 是否拆零标志 采购价格 采购数量 交易 输出 错误 信息 返回 代码 医保项目编码 医疗机构目录编码 流水号 上传 失败原因 参数详细说明 : 交易输入： 代码 名称 约束 类型 说明 JYBM 交易服务 编码 Not Null VARCHAR2(

7、20) JYFWYH 交易访问 用户 Not Null VARCHAR2(20) 交易 访问授权用户 JYYHYZM 交易 访问 验证码 Not Null VARCHAR2(20) 交易 访问 验证码 AKB020 定点医疗机构编码 Not Null VARCHAR2(20) 两定医疗机构编码 YKA094 医保项目编码 Not Null VARCHAR2(20) 869药品 编码 YKA095 医院项目名称 Not Null VARCHAR2(200) 医院内部 该项目名称 AKE005 医院 对码流水号 Not Null VARCHAR2(20) 机构内部 使用 药品 自编码 /医院自编码

8、 YKE940 流水号 Not Null VARCHAR2(50) 机构 内部唯一标识码 YKE936 是否拆零标志 Not Null VARCHAR2(6) 0 否； 1 是 YKF276 采购价格 Not Null NUMBER(14,4) 跟 是否拆零标志挂钩 YKF278 采购数量 Not Null NUMBER(14,4) 允许 负值 （负值 则默认为退货 ） 交易输出 ： 代码 名称 约束 类型 说明 AKB020 定点医疗机构编码 VARCHAR2(20) 两定医疗机构编码 YKA094 医保项目编码 VARCHAR2(20) 869药品 编码 AKE005 医疗机构目录编码 V

9、ARCHAR2(20) 机构 内部使用码 YKE940 流水号 VARCHAR2(50) 机构 内部唯一标识码 AAE013 上传 失败原因 VARCHAR2 2. 药品入库 信息 上传 交易名称 药品入库 信息上传 交易 分类 交易代码 cdyp00001 交易说明 1、 本 交易 为上传两定机构 药品 采购 入库 信息 。 2、 流水号 作为定点 机构 内部 使用主键，如果 已 经存 在于 医保 系统 中，本次上传 对 该条数据做 失败 处理 ，系统返回 错误信息 【 数据重复 上传】。 3、 药品 入库信息 上传 ，前提是两定 机构 必须在【医保 两定管理 协同 平台 】系统中 已完成机

10、构药品 与 医保药品目录的对码 工作，否则上传失败。 4、 一 次 调用 最多只 允许上传 明细 50 条， 超过 限制 数 量 提交不成功 【注 :数据提交 成功后，该批次 上传 数据中 校验 成功的数据 提交 保存，校验失败数据返回 失败 原因 】 。 输入参数 交易输入xml 交易服务编码 交易访问 用户 交易访问验证码 定点 机构 编码 医保项目编码 医院 项目 名称 医院 对码流水号 流水号 随货单号 生产日期 是否拆零标志 供应商名称 供应商许可证号 药品生产批号 采购价格 采购发票号 采购数量 采购 入库 时间 采购人姓名 药品有效期 交易 输出 错误 信息 返回 代码 医保项目

11、编码 医疗机构目录编码 流水号 上传 失败原因 参数详细说明 : 交易输入： 代码 名称 约束 类型 说明 JYBM 交易服务 编码 Not Null VARCHAR2(20) JYFWYH 交易访问 用户 Not Null VA RCHAR2(20) 交易 访问授权用户 JYYHYZM 交易 访问 验证码 Not Null VARCHAR2(20) 交易 访问 验证码 AKB020 定点医疗机构编码 Not Null VARCHAR2(20) 两定医疗机构编码 YKA094 医保项目编码 Not Null VARCHAR2(20) 869药品 编码 YKA095 医院项目名称 Not Nul

12、l VARCHAR2(200) 医院内部 该项目名称 AKE005 医院 对码流水号 Not Null VARCHAR2(20) 机构内部 使用 药品 自编码 /医院自编码 YKE940 流水号 Not Null VARCHAR2(50) 机构 内部唯一标识码 YKE938 随货单号 Not Null VARCHAR2(70) 必填 YKE939 药品 生产日期 Not Null DATE YYYY-MM-DD YKE936 是否拆零标志 Not Null VARCHAR2(6) 0 否； 1 是 YKF273 供应商名称 Not Null VARCHAR2(200) YKF274 供应商许可

13、证号 Not Null VARCHAR2(50) YKF275 药品生产批号 Not Null VARCHAR2(50) YKF276 采购价格 Not Null NUMBER(14,4) YKF277 采购发票号 Null VARCHAR2(50) YKF278 采购数量 Not Null NUMBER(14,4) 允许 负值 （负值 则默认为退货 ） YKF279 采购入库时间 Not Null DATE YYYY-MM-DD YKF280 采购人姓名 Not Null VARCHAR2(20) YKF281 药品有效期 Null DATE YYYY-MM-DD 交易输出 ： 代码 名称

14、约束 类型 说明 AKB020 定点医疗机构编码 VARCHAR2(20) 两定医疗机构编码 YKA094 医保项目编码 VARCHAR2(20) 869药品 编码 AKE005 医疗机构目录编码 VARCHAR2(20) 机构内部 使用 药品 自编码 /医院自编码 YKE940 流水号 VARCHAR2(50) 机构 内部唯一标识码 AAE013 上传 失败原因 VARCHAR2 3. 药品出库 信息 上传 交易名称 药品出 库 信息上传 交易 分类 交易代码 cdyp00002 交易说明 1、 本 交易 为上传两定机构 药品 出库 信息 。 2、 流水号 作为定点 机构 内部 使用主键，如

15、果 已 经存 在于 医保 系统 中，本次上传 对 该条数据做 失败 处理 ，系统返回 错误信息 【 数据重复 上传】。 3、 药品 出 库信息 的 上传 ，前提是两定 机构 必须在【医保 两定管理 协同 平台 】系统中 已完成机构药品 与 医保药品目录的对码 工作，否则上传失败。 4、 一 次 调用 最多只 允许上传 明细 50 条， 超过 限制 数 量 提交不成功 【注 :数据提交成功后，该批次 上传 数据中 校验 成功的数据 提交 保存，校验失败数据返回 失败 原因 】 。 输入参数 交易输入xml 交易 服务 编码 交易访问 用户 交易访问验证码 定点 机构 编码 医保项目编码 医院 项目 名称 医院 对码流水号 流水号 是否拆零标志 结算 标志 开单 科室编码 医执人员 编码 姓名 人员编号 身份证号码 单价 数量 出库 时间 出库经办 人 药品消耗原因