商品清单导入

商品清单就是你当前的主数据文件。每次完整导入都会整个替换——文件里没有的商品会被删掉。所以永远传完整文件，别只传新增的几行。

商品怎么认

一个商品由 条码 + SKU + 外部编码 这个组合确定，完全按原样比对（大小写和前导零都算数）。导入就靠这个组合认出已有商品。

扫码怎么找到商品

有人扫码时，系统按你定的匹配顺序找商品：最多三个字段依次尝试，比如先条码、再 SKU、再外部编码。同一步里撞上多个商品就标成"有歧义"，绝不瞎猜。

匹配顺序就在导入模板那一页设置。

能导入哪些列

列	必填	说明
barcode、sku、externalId	至少一个	用来认商品；可以挂修正规则
name	是	品名
description		描述
category		品类
unit		单位
retailPrice		零售价
remark		备注
brand、color、size、style、spec		品牌、颜色等
costPrice		成本价
custom1 … custom5		自由文本，原样保留

只有标识列参与匹配，其他都只是信息。

配模板（管理员）

在 Settings → Import Templates → Product catalog：

• 文件有没有表头行
• 列映射——至少映射一个标识列，否则上传会被拒
• 编码和定宽排版（如果文件需要）——见文件格式与编码
• 标识列上可选的修正规则，比如"编码满 14 位就去掉最后一位"——见编码清理与修正

没配模板就上传，会报 PRODUCT_IMPORT_PROFILE_REQUIRED 错误。

上传之后发生什么

上传在后台跑：

1. 按你的模板解析文件。
2. 新增和有变化的商品保存；文件里没有的商品删除。
3. 互相冲突的行进复核队列，不会阻塞其余部分。
4. 重试或回滚用的都是上传时那版模板。

套餐限制

	Starter	Business	Enterprise
商品数	1,000	100,000	5,000,000
单文件行数	10,000	500,000	6,000,000