药品信息能力与数据说明

本页用于说明药品信息目录下各类接口的能力结构、数据层级、覆盖口径和推荐使用方式。

药品信息类接口更适合承担药品检索、标准化标识管理、包装与批准文号详情查询、说明书补齐和本地数据同步等任务。

适用场景

• 药品搜索和下拉联想
• 药品主数据建档与标准化治理
• 基于包装、批准文号或通用名的详情查询
• 说明书、医保属性、批准状态等字段补齐
• 本地药品库的批量同步和增量更新

能力范围

药品信息目录当前主要包含三层能力：

1. 搜索与定位

• 基础·药品批准文号查询

适合用于：

• 根据药品名称、通用名、生产企业或批准文号做模糊搜索
• 在产品中提供候选列表、下拉框或检索入口
• 为后续详情接口定位 drug_approval_number_id 和 drug_generic_id

2. 详情与字段补齐

• 基础·药品包装信息详情
• 基础·药品批准文号详情
• 基础·通用名药品详情
• 基础·药品批准文号说明书

这组接口覆盖不同粒度的药品实体，适合用于：

• 查询包装维度的规格、品牌、剂型和包装表达
• 查询批准文号维度的状态、医保属性和原研相关信息
• 查询通用名维度的共性信息和医保、说明书等公共字段
• 获取结构化说明书内容

3. 更新与同步

• 基础·获取数据批量 ID
• 基础·查询数据更新

适合用于：

• 批量拉取本地需要同步的实体 ID
• 查询药品包装、通用名等数据的更新记录
• 将平台数据接入本地主数据仓库或搜索索引

药品数据层级说明

药品信息目录下的常用标识主要分为三层：

包装层

• 标识：drug_package_id
• 适合关注：包装规格、流通包装表达、包装维度的实际商品信息
• 典型接口：药品包装信息详情

批准文号层

• 标识：drug_approval_number_id
• 适合关注：批准状态、批准文号详情、药监局口径字段
• 典型接口：药品批准文号查询、药品批准文号详情、药品批准文号说明书

通用名层

• 标识：drug_generic_id
• 适合关注：同一通用名下共性的医保、说明书和基础属性
• 典型接口：通用名药品详情

不同层级的统计口径并不相同，数值不建议直接横向比较。

在系统设计上，建议明确本地业务究竟以包装、批准文号还是通用名作为主索引，再决定接口组合方式。

当前文档已披露的数据口径

根据现有接口说明，当前公开文档已披露以下数据口径：

• 药品批准文号查询：已收录 3.7 万个通用名下合计 22 万条数据
• 药品包装信息详情：已覆盖 1.5 万个通用名，共收录 26 万个包装数据，并以天为单位更新
• 通用名药品详情：当前通用名数量约 1.7 万，返回字段 28 个
• 药品批准文号说明书：已收录近 18 万个批准文号级别的说明书数据，覆盖约 20 个字段，并以周为单位更新

从公开描述看，数据主要参考国家药监局等权威公开信息，并结合流通包装和结构化处理能力进行持续更新。

推荐调用方式

药品信息类场景通常建议按下面的路径组合：

1. 先通过 药品批准文号查询 搜索并定位候选药品
2. 根据业务关注粒度，继续查询：
   • 包装维度：使用 药品包装信息详情
   • 批准文号维度：使用 药品批准文号详情
   • 通用名维度：使用 通用名药品详情
3. 需要结构化说明书时，再调用 药品批准文号说明书
4. 需要做本地同步时，配合 获取数据批量 ID 和 查询数据更新

使用建议

• 检索入口建议先走查询接口，不建议一开始就直接依赖详情接口猜测 ID
• 若业务最终展示的是具体流通商品，优先以包装层数据为主
• 若业务关注药监口径、批准状态、医保等属性，优先查看批准文号层
• 若业务关注共性信息归并，可在通用名层聚合展示
• 本地落库时，建议同时保留平台标准 ID 和业务侧原始 ID，便于回溯与重建映射

能力边界

药品信息目录提供的是结构化药品数据能力，不等同于完整业务系统。

使用时应注意：

• 各接口字段口径不同，不能简单把包装层字段直接等同于通用名层字段
• 并非所有业务所需字段都由单一接口一次性返回，通常需要组合调用
• 本地系统如有额外分类、标签、运营字段，仍需自行维护映射和扩展逻辑
• 若需要先完成原始药品库标准化，再查询详情，建议先结合 药品对码标准化方案 使用