批量与智能导入
概述
在初次设置——或从其他系统迁移——时，您很少会一条一条地添加记录。Rewardly 为您提供两种一次性加载大量数据的方式：经典的 CSV 导入（下载示例模板、填写、上传），以及 Smart Import——一个由 AI 辅助的流程，您粘贴或上传大致成形的数据，Rewardly 会为您推断出列。
两者都位于管理后台中，在您所导入对象的列表页面上——请在工具栏中查找 Import 与 Smart Import 按钮。
先导出以获取列结构
学习 CSV 布局最快的方式是先导出几条现有记录，打开文件，编辑，然后重新导入。导出的列与导入器所期望的完全一致——包括商品的 modifier_list.* 与 bundled_item_list.* 等嵌套列。
工作原理
经典 CSV 导入
CSV 导入器是一个步骤固定的专用页面：
- 下载示例模板 — 一个链接会给您一个带有正确列和表头行的
.csv。 - 在电子表格中填写，然后用文件选择器上传文件。
- 观察进度条 — 它会经过 Uploading → Processing → Complete。
- 阅读结果日志 — 关于多少行成功、多少行失败的摘要。
- 重新导出失败的行 — 失败的行可以下载回 CSV，以便您修正后只导入那些行。
此方式适用于 Products（商品列表上的 Import 按钮）与 Members（Members 列表上的 Import 链接）。
Smart Import（AI 辅助）
Smart Import 跳过了僵硬的模板。您按数据原本的样子提供给它，它会推断出结构：
- 输入 — 粘贴文本（例如直接从电子表格）或上传 CSV。
- 自动检测 — Rewardly 判断您的数据是否带有表头行。如果无表头，它会启发式地映射每一列——识别门店、单位、类目、供应商、是/否布尔值、数字、商品名称/编码以及变体 SKU。
- 审核 — 一个可编辑的表格，您可在其中更正任何映射错误。每一列都有一个批量应用控件，因此您可以一次性为每一行设置相同的值（一个门店、一个单位、一个类目、一个价格）。您可以就地编辑单元格、删除行，并且——对于原料配方——可以展开某一行查看其子原料。
- 导入中 — 记录会逐条创建，并带有进度条。
- 结果 — 成功与失败的列表，并带有下载失败行 CSV，以便您只修正并重试那些行。
Smart Import 适用于 Products、Members、Ingredients、Ingredient Bundles 与 Product Inventories。
AI 映射只是起点，并非最终结论
审核表格之所以存在，正是因为自动检测可能会猜错。请在导入前务必扫一遍——批量应用控件能让更正变得很快。
您可以导入什么
| 记录 | 经典 CSV | Smart Import | 位置 |
|---|---|---|---|
| Products | 是 | 是 | Products 列表 → Import / Smart Import |
| Members / 客户 | 是 | 是 | Members 列表 → Import / Smart Import |
| Ingredients | — | 是 | Ingredients 列表 → Smart Import |
| Ingredient Bundles | — | 是 | Ingredient Bundles 列表 → Smart Import |
| Product Inventories | — | 是 | Product Inventories 列表 → Smart Import |
商品 CSV 导入器使用与商品 Export 所生成的相同的丰富嵌套结构——包括附加项、组合/打包商品、营业时间以及价格层级——因此对于商品而言，导出、编辑、再重新导入是最安全的往返方式。
匹配规则
导入时，Rewardly 会尝试将每一行匹配到您已有的记录，而不是盲目地创建重复项。
| 查找…… | 匹配依据 |
|---|---|
| Product | 先按其编码，再按其名称（en_US 或 mn_MN）。 |
| Variant | 按其 SKU。 |
| 门店、单位、类目、供应商 | 按名称从您已有的记录中自动映射。 |
Smart Import 会将您的门店、供应商、原料、商品、商品变体以及商品类目拉取为匹配字典——这样，写着 Coffee Beans 的一行会解析到您已创建的那个原料，而未匹配的名称会在审核表格中作为警告显现出来。
校验
行会在创建任何内容之前被检查。审核表格会显示内联警告，导入会跳过（并报告）未通过的行。
| 记录 | 有效行所需 |
|---|---|
| Ingredients / Ingredient Bundles | 名称 — 必填，且必须在该批次内唯一。 |
| Product Inventories | Outlet 与 Product 二者都需。 |
Product Inventories 的每一行都需要门店和商品
如果有任何一行缺少其 Outlet 或 Product，Product Inventories 导入就会阻止——库存始终是按门店、按商品的，因此两者都不能留空。请在导入前修正被标记的行（或使用批量应用为所有行设置门店）。
默认设置
Bean & Brew 示例： 加载一季的新糕点，无需逐个重新输入。
1. 导出一个示例以了解结构
- 在侧边栏打开 Products → Products。
- 点击 Export，确认提示，然后打开下载的 CSV。
- 保留一两行作为范本，然后将您的新糕点作为新行添加。
2. 重新导入编辑后的文件
- 回到商品列表，点击 Import。
- 选择您的
.csv，观察它经过 Uploading → Processing → Complete。 - 阅读结果日志。如果有任何行失败，请下载失败的行，修正它们，然后只导入那个文件。
3. 或用 Smart Import 直接粘贴
- 在同一列表上，点击 Smart Import。
- 粘贴您的电子表格数据或上传 CSV。
- 在审核表格中，使用每列的批量应用一次性为每一行设置类目和门店，修正任何映射错误的单元格，然后导入。
- 在结果步骤，下载任何失败的行以重试。
现在您一次就拥有了所有新商品，并附带一份需要再看一眼的内容的整洁清单。
会员与员工看到什么
这是一项管理后台的任务——收银员或客户无需做任何事。
在 POS 上，导入的商品一经创建并在 POS 渠道可见，就会出现在销售网格上，与您手动添加的商品一样。
在会员应用中，导入的会员可以正常登录，导入的商品会在其渠道可见性允许的任何地方显示。