适合谁
为拿到供应商商品表、需要整理成 Shopify 导入格式的卖家而设计。
当供应商给你的是自己的字段体系——商品名、价格、SKU、款号、颜色、尺码、库存、图片链接等，而你需要可控地整理成 Shopify 商品 CSV 时，就可以使用这个工具。
它解决什么问题？
供应商文件通常不会直接符合 Shopify 商品结构。这个工具帮助你映射供应商字段、明确商品与变体关系、区分成本与售价、整理图片，并在下载前用同一套 Merchant CSV Doctor 规则再次检查生成文件。
开始前准备
- 准备 UTF-8、逗号分隔的 CSV，表头不能为空且不能重复。
- 当前单个文件上限为 15 MiB。
- 供应商原始字段名不需要先改成 Shopify 字段，映射步骤就是用来处理这些差异的。
- 提前判断每一行是独立商品，还是多行属于同一个商品的不同变体。
操作步骤
如何使用 Supplier CSV → Shopify
上传供应商 CSV
把文件拖入上传区域，或从设备选择文件。文件始终留在浏览器中。
检查每一个字段映射
HIGH（高置信度）建议可以自动预选；MEDIUM 和 LOW 需要你确认或手动选择。页面会保留供应商原字段名，方便与 Shopify 目标字段逐项对照。
正确区分成本和售价
Wholesale Price、Supplier Price、Purchase Price、Unit Cost、Cost 会优先映射到 Cost per item；Retail Price、Selling Price、Sale Price、Shop Price 会优先映射到 Price。只有“Price”这种通用字段不会被静默当成售价，必须人工确认。
明确选择商品结构
只有每一行确实都是独立商品时，才选择“每行是独立商品”。如果多行是同一个商品的 Color、Size 等不同变体，应选择“将行分组为商品变体”。工具不会因为标题相同就自动猜测商品关系。
需要变体时设置分组和选项
选择稳定的分组列，例如 Style ID、Parent SKU、Model 或 Product Code，再选择最多三个选项列。例如：Grouping = Style ID，Option 1 = Color，Option 2 = Size。
明确处理图片字段
最多可把 10 个来源图片列映射到 Product image URL。多个图片列可以共同映射到这个目标。同一商品内完全相同的图片 URL 会按首次出现顺序去重，并生成连续的图片顺序。
决定是否输出库存数量
如果不能确定店铺只有一个库存地点，保持“否 / 不确定”，不要输出 Inventory quantity。多地点库存应在商品导入后使用 Shopify Inventory CSV 处理。
生成前检查默认值
默认值包括 Status = draft、Published = FALSE、Requires shipping = TRUE、Charge tax = TRUE、Fulfillment service = manual。只有明确知道影响时再修改。
生成、检查并解决阻断问题
检查页会显示 Products、Variants、Output rows、Critical、Warnings、Info 和 Readiness。重复变体组合、选项值为空、不安全的分组等结构性问题必须解决后才能下载。
下载两个输出文件
下载 shopify-products-from-supplier.csv 用于 Shopify；同时保留 supplier-to-shopify-mapping-report.csv，作为供应商字段如何被解释和映射的记录。
映射置信度是什么意思
| 等级 | 含义 | 你的操作 |
|---|---|---|
| HIGH | 明确且稳定的匹配。 | 通常会自动预选，但仍建议核对。 |
| MEDIUM | 可能正确，但不能替你做业务判断。 | 需要手动确认目标字段。 |
| LOW | 没有足够安全的自动判断。 | 只有明确理解来源字段含义时才手动映射。 |
五个实际例子
普通商品
每行一个商品。映射标题、SKU、成本、售价、品牌/供应商、描述和图片。
Color + Size 变体
使用 Style ID 分组，再把 Color、Size 设置为变体选项。
价格安全
Wholesale Price 保持为成本；Retail Price 作为售价；通用 Price 必须等待人工确认。
图片去重
多个变体重复出现的图片 URL 在同一商品内只输出一次，并生成连续图片顺序。
重复变体阻断
如果同一商品中出现两个相同选项组合，例如 Black / M，系统会阻止生成，直到修改源文件或映射。
工具不会替你猜什么
- 不会因为标题重复就判断它们属于同一商品。
- 不会把通用 Price 字段静默当成 Shopify 售价。
- 不会进行货币或重量单位换算。
- 不会抓取、上传或重写图片 URL。
- 不会通过商品 CSV 处理多地点库存。
隐私与数据处理
供应商 CSV 在浏览器本地处理。只有在你明确允许时，SellerFrog 才会记录工具操作和聚合结果；CSV 内容和文件名不会发送到分析系统。
下载后怎么做
正式导入大批量商品前，再检查一次生成的 Shopify CSV 和 Shopify 自己的导入预览。如果商品结构是新的或目录很重要，先用少量样本验证。