商品清单导入
每个组织有一份默认商品目录,也可以有多份。每次完整导入都会整体替换所选目录:未进入最终有效集合的商品会从该目录删除,其他目录不受影响。因此必须上传该目录的完整主文件,而不是仅上传新增行。
商品识别方式
在同一目录内,商品的确定性 Product ID 由 条码 + SKU + 外部编码 组合生成。读取列值时先去除首尾空白,再执行导入修正规则;计算身份前会对变换后的值再次去除首尾空白。大小写和数字前导零会保留,身份计算不使用扫码匹配归一化。
扫码时的商品匹配
扫码后,系统先归一化编码,再按 C1 → C2 → C3 在该盘点绑定的目录中查找。仅当 C1 层没有商品时才可进入 C2,前两层均为空时才可进入 C3。第一个出现候选的层直接决定结果:一个候选即为命中,多个候选即为有歧义,不再回退到更低层。同一编码可以合法出现在不同层,此时高层优先。
匹配顺序在导入模板页按目录分别设置。
可导入的列
| 列 | 必填 | 说明 |
|---|---|---|
barcode、sku、externalId | 至少一个 | 用于识别商品;可应用修正规则 |
name | 否 | 可选品名 |
description | 描述 | |
category | 品类 | |
unit | 单位 | |
retailPrice | 零售价 | |
remark | 备注 | |
brand、color、size、style、spec | 品牌、颜色等 | |
costPrice | 成本价 | |
custom1 … custom5 | 自由文本,原样保留 |
仅标识列参与匹配,其他列仅作为商品信息。
配置模板(管理员)
在 模板设计 → 导入模板 → 商品目录 中选择目录并配置:
- 文件是否包含表头行
- 列映射:至少映射一个标识列,否则上传会被拒绝

未配置模板即上传会报 PRODUCT_IMPORT_PROFILE_REQUIRED 错误。
现场目录导入(主管)
盘点处于已安排、已批准或盘点中时,获分配的主管可在该盘点的目录面板中导入。管理员必须先配置该目录的导入模板并开启允许现场导入。导入会整体替换该盘点绑定的目录。如果另一份已批准、盘点中或收尾中的盘点共用此目录,主管的写入会被拒绝;盘点员不能使用此入口。
上传后的处理流程
上传在后台执行:
- 按照模板解析文件。
- 有效且无冲突的新增、变更商品会被应用;未进入最终有效集合的商品会从所选目录删除。
- 文件内或与当前商品之间的匹配码归属冲突会进入 Issues 复核队列。这些行不会应用,也不会因为引用旧商品编码而保护旧商品免于删除。完整“条码 + SKU + 外部编码”身份组合重复的行会被报告并忽略,不进入复核队列。
- 重试会沿用原任务的解析快照。Restore 会从某个已完成导入的原始文件和解析设置发起一次新的全量替换,并捕获目录的当前匹配布局;它不是数据库回滚。

套餐限制
| Starter | Business | Enterprise | |
|---|---|---|---|
| 商品数(组织内全部目录合计) | 1,000 | 100,000 | 5,000,000 |
| 商品导入单文件行数 | 10,000 | 500,000 | 6,000,000 |