客户导入 功能用于通过标准化的 Excel 或 CSV 模板，将客户资料进行 批量导入客户 至 Subotiz 系统。商家可一次性创建或更新多条客户记录，减少人工逐条录入操作，提升 客户数据管理 与维护效率。
功能适用场景
客户导入功能适用于以下业务场景：
- 已整理好客户资料表，希望一次性批量创建客户信息
- 系统初次使用时，快速完成客户数据初始化
- 对已有客户资料进行批量补充或修正，例如地址、备注、自定义字段
- 为后续客户管理、订阅配置或营销邮件准备基础客户数据
该功能适用于通过文件方式批量维护客户资料。
进入客户导入页面
- 打开客户导入入口：登录您的 Subotiz 后台，前往 客户 页面，点击右上角的 导入，打开客户导入弹窗。
- 下载导入模板：在导入弹窗中，点击 导入模板，下载系统提供的标准客户导入模板，并按要求填写客户信息。
-
模板填写规则说明: 在填写模板前，请务必确认以下规则：
- 请勿修改表格的表头名称或顺序，否则将无法导入
- 请严格按照模板的字段格式填写，不符合要求的记录将导入失败
- 文件大小不得超过 10MB
- 仅支持 .xlsx 与 .csv 文件格式，其他格式将无法导入
- 字段说明: 下表为客户导入模板中各字段的填写说明：
字段 |
是否必填 |
描述 |
|---|---|---|
姓名 |
否 |
客户的完整姓名 |
邮箱 |
是* |
客户的邮箱地址，必须唯一，不可与其他客户重复 |
外部客户ID |
否 |
对应您系统内的客户唯一标识 |
订阅营销邮件 |
否 |
客户是否同意通过电子邮件接收营销邮件；填写 Y 表示接受，N 表示不接受 |
国家 |
否 |
客户所在国家，仅用于备注 |
国家代码 |
否 |
国家代码，采用 ISO Alpha-2 代码 标准 |
地址行1 |
否 |
第一个地址行，最多 100 个字符 |
地址行2 |
否 |
第二个地址行，最多 100 个字符 |
城市 |
否 |
城市名称，最多 50 个字符 |
省/州 |
否 |
客户所在省或州，仅用于备注 |
省/州代码 |
否 |
省州代码，采用 ISO 3166 2代码 标准；如填写该字段，则国家代码必须填写 |
邮编 |
否 |
邮政编码，最多 20 个字符 |
自定义数据 |
否 |
自定义数据，需使用 JSON 格式，最多支持 20 个字段 |
-
关于客户唯一标识的说明:
- 系统默认以 邮箱 作为客户的唯一标识
- 若客户资料中没有邮箱，可使用 外部客户ID 作为唯一标识
- 在使用 外部客户ID 的情况下，邮箱 字段可不填写
- 邮箱 或 外部客户ID 均不可重复
- 上传导入文件：填写完成后，点击 选择文件，选择对应的 Excel 或 CSV 文件并完成上传。
-
设置覆盖规则（可选）: 如需修改系统中已存在的客户信息，请在上传文件时勾选 覆盖电子邮件或者外部客户ID相同的现有客户。
-
覆盖：当导入记录的邮箱或外部客户ID已存在时，系统将使用导入文件中的字段更新对应客户信息。
- 模板中为空的字段不会覆盖原有数据。
- 不覆盖：当导入记录的 邮箱 或 外部客户ID 已存在时，系统将跳过该条记录，不进行任何修改。
-
- 执行导入任务：确认文件与导入规则无误后，点击 开始导入，系统将自动处理导入任务。
- 等待系统处理: 若导入文件较大，系统可能需要一定时间完成处理。您可以在当前页面等待，或直接关闭导入弹窗。系统将在任务完成后通过消息通知告知结果。
-
查看导入结果: 导入完成后，系统将展示本次导入结果统计，包括：
- 导入成功
- 导入失败
- 跳过记录
如存在导入失败的记录，可点击 失败记录 下载错误明细文件，查看具体失败原因并修正后重新导入。
- 通过消息中心查看结果: 若您在导入过程中关闭了弹窗，系统处理完成后将发送消息通知。您可通过右下角消息提醒或 消息中心 查看导入结果，并下载失败记录文件。
客户导入功能通过模板文件方式，帮助商家高效完成客户资料的批量创建与更新。通过统一的字段规范与覆盖规则，商家可在 Subotiz 中建立清晰、可维护的客户数据基础，为后续客户管理、订阅及运营使用提供支持。