普通商品档案与批量维护

入口：“商品管理” /product/product_manage。新增、编辑和详情均从商品列表进入。组套商品另见组套档案。

商品资料会用于采购、销售、库存、验收、养护及追溯。建档前准备名称、规格、基本单位、生产企业、供应商、证照、贮存要求和产品标识。先查询是否已有同一商品，避免只因简称或包装描述不同重复建档。

新建商品

1. 在商品列表点击新增，进入 /product/product_manage/add。
2. 填写“基本信息”，核对名称、规格型号、基本单位、生产企业和运输及贮存条件。
3. 设置生产信息中的批号、序列号、生产日期、效期、灭菌信息及证照要求。
4. 在“供应商信息”中选择供货企业，检查是否存在重复关联。
5. 在“证照信息”关联商品证照，核对生产企业及受托生产企业证照。
6. 维护编码、价格与税率、辅助单位、UDI 解析规则和商品图案。
7. 提交，处理必填或校验提示；返回列表打开详情，逐项核对保存结果。

企业可以配置商品必填字段。表单实际标记和提交校验是当前企业的要求；不要照搬另一家企业的空字段填写方式。集团授权资料的维护入口受来源和权限限制。

图：正式版前端连接测试环境的商品空表单；灰色区域遮盖了环境默认值，不代表必填项或不可编辑字段。

基本信息与生产信息

信息	主要内容	核对重点
识别信息	名称、规格型号、通用名、基本单位、助记码、品牌、产地、自定义分类	名称与规格共同区分商品，基本单位作为数量换算基准
生产相关	生产企业、注册人或备案人、受托生产企业、代理人及地址	不同主体分别核对，不根据简称推断
管理属性	商品类别、剂型、旧版/新版经营范围、集采类型	按实际资质和业务要求维护
贮存养护	运输及贮存条件、养护类型、推荐货位	影响冷链、养护和仓储选择；先建立有效基础资料
效期	保质期或使用年限、单位、推算方式、近效期天数	保质期与单批商品实际效期不同，仍需核对批次记录
追溯要求	首营管理、批号、序列号、生产日期、效期、灭菌批号/日期/效期	决定业务录入需要补充哪些追溯字段
证照要求	注册证、生产许可证、质检报告是否必填	与实际业务附件及证照核对要求配合使用

启用首营管理后，继续完成商品首营。保存商品资料不表示已经获得首营通过状态，也不表示已经增加库存。

供应商和证照关系

“供应商信息”支持关联多家供应商，同一供应商不能重复添加。选择前先确认供应商档案、启用状态和首营资料。企业将供应商设为必填时，未关联供应商无法完成保存。

“证照信息”中关联商品适用的证照，核对证照类型、编号、适用产品及有效期。生产企业与受托生产企业的企业证照也应检查，不要把企业资质附件当作商品注册或备案证照。

证照换新时，先维护商品证照，再核对商品关系和业务单据中选用的证照。批量导入商品与导入商品证照关系是不同入口，完成商品导入不代表已建立全部证照关系。

编码、价格和尺寸

编码区域可维护不同体系 UDI、厂家物料编码、原编码、医保编码、阳光平台编码、自定义编码和省级平台编码。编码应保持原始字符和前导零；不同编码有不同用途，不能随意互填。

价格及尺寸区域按实际维护采购或销售参考价格、税率和规格尺寸。商品参考价格不等于所有后续单据成交价格，业务单据还会受到价格来源配置、客户或供应商规则及人工调整影响。保存后以具体单据展示的单价、税率与金额为准。

辅助单位与换算

1. 先确认基本单位，例如“支”。
2. 按实际包装维护第二、第三辅助单位及其相对于基本单位的数量。
3. 第二单位换算数量应小于第三单位换算数量。
4. 使用表单中的换算检查，核对不同单位对应的数量。
5. 保存后在业务单据选择相应单位，检查数量和金额变化。

例如基本单位为“支”，一盒含 10 支、一箱含 100 支，则换算均以“支”为基准，不能把“一箱 10 盒”误填成第三单位 10。商品已有业务后调整单位关系应先核对现有库存与历史业务的影响。

UDI 解析规则

表单可维护 DI、批号、序列号、生产日期和效期等解析规则，并提供解析或测试结果。使用真实包装上的完整标识测试，逐项比对结果；不能仅看到商品名称匹配就确认批号、序列号和日期均正确。

UDI 数据库查询和识别可以辅助填充商品资料，仍需核对包装层级、规格型号、生产企业和证照。详情见UDI 数据库与基础字典。

修改、复制、停用与归档

操作	使用方式与结果核对
编辑或申请修改	打开详情核对当前值；按企业的直接编辑或申请修改模式提交；审核中记录不可按普通编辑处理
复制新增	复用现有字段建立另一条商品，提交前重新核对名称、规格、编码、单位、供应商和证照
停用/启用	按实际使用状态切换，提交后刷新列表；后续业务选择时核对可用状态
归档/取消归档	归档商品不用于新单据，历史已有关联仍保留；在归档列表核对，再按需要取消归档
删除	阅读确认提示，核对历史业务及组套引用；遇到引用限制按提示处理

普通商品与归档商品分开查询。没有找到商品时，先检查当前列表、启用状态和搜索条件。被有效组套配方引用的普通商品可能不能直接删除，应先核对组套配方和授权关系。

批量关联与批量替换

批量操作前明确选择记录并核对条数。批量关联供应商用于维护供应关系；批量归档、停用或删除会同时影响多条记录，不应把导入或查询成功当作已处理完成。

“批量替换”可选择选中记录或全部商品，并设置“替换对象”“原始值”“替换为”。支持税率、注册人/备案人、代理人、贮存条件、养护类型、规格、效期规则、追溯必填开关、推荐货位等字段。

1. 优先选择少量明确商品，打开“替换选中记录”。
2. 选择替换对象，核对原始值与新值。
3. 提交后打开样本详情检查结果，并核对关联的业务规则。
4. 需要扩大范围时，重新确认全部商品的业务影响。

批量范围和空值

“替换全部商品”不以当前列表搜索或分页作为限定。原始值为空时匹配原值为空的记录，不表示忽略原值并替换所有记录。修改近效期还会影响对应库存的近效期设置，提交后应再核对库存查询结果。

常见问题

现象	处理
保存提示缺少供应商或经营范围	核对企业商品必填配置，补齐实际需要的信息
扫码识别出错误规格或日期	核对完整 UDI、包装层级及解析规则，测试后逐项比对
替换后部分商品未变	核对选中范围和原始值是否匹配，特别是空值与数字 0 的区别
新单据选不到商品	检查归档、停用、首营、业务类型及资料来源
不能修改授权商品	交集团维护源资料，参见集团资料维护

相关阅读：商品组套、仓库库区库位、系统参数。