> ## Documentation Index
> Fetch the complete documentation index at: https://guide.uku.to/llms.txt
> Use this file to discover all available pages before exploring further.

# 批量导入客户到UKU店铺

> 通过批量导入功能，一次性将多名客户添加到UKU店铺。支持姓名+电话或姓名+姓氏+电话格式，系统自动跳过重复号码并列出错误。

当您需要将大量客户一次性录入 UKU 时，手动逐个添加效率太低。UKU 提供批量导入功能，只需准备一个表格文件，即可快速完成客户名单的迁移。

## 准备导入文件

UKU 支持导入包含以下字段的表格文件：

| 字段     | 是否必填 | 说明                |
| ------ | ---- | ----------------- |
| 姓名     | 必填   | 客户的完整姓名           |
| 电话号码   | 必填   | 完整的电话号码，同一店铺内不可重复 |
| 姓氏（可选） | 选填   | 如需分开姓和名，可单独填写姓氏字段 |

<Tip>
  推荐格式：CSV 或 Excel 文件。确保电话号码列格式统一，不要包含空格或特殊符号（如 `-` 或 `()`），以免系统无法识别。
</Tip>

## 导入步骤

<Steps>
  <Step title="进入导入页面">
    打开 UKU 应用，进入**客户**页面，点击右上角的菜单按钮，选择**批量导入**。
  </Step>

  <Step title="上传文件">
    点击**选择文件**，从手机或电脑中选取准备好的客户表格文件。
  </Step>

  <Step title="匹配字段">
    系统会显示表格中的列名，请确认每一列对应正确的字段（姓名、电话号码等）。如果表格包含姓氏列，也请一并匹配。
  </Step>

  <Step title="开始导入">
    点击**开始导入**。系统会自动处理文件内容。
  </Step>

  <Step title="查看结果">
    导入完成后，系统会显示成功导入的客户数量，以及被跳过的重复项和错误记录。
  </Step>
</Steps>

## 导入结果说明

导入完成后，您会看到以下信息：

* **成功导入**：新客户的数量，这些客户已添加到您的店铺。
* **已跳过**：电话号码已存在的客户，系统自动跳过，避免重复。
* **错误记录**：格式不正确或信息缺失的行，系统会列出具体错误，方便您修正后重新导入。

<Note>
  导入过程不会覆盖已有客户信息。如果表格中某位客户的电话号码已存在于店铺中，该条目会被自动跳过，现有客户数据保持不变。
</Note>

## 常见问题

<AccordionGroup>
  <Accordion title="导入失败，提示格式错误">
    请检查表格文件是否为 CSV 或 Excel 格式，并确保电话号码列不包含文字或特殊符号。
  </Accordion>

  <Accordion title="部分客户未导入">
    查看错误报告，通常是电话号码格式不正确或必填字段为空。修正后可单独重新导入这些客户。
  </Accordion>
</AccordionGroup>

## 相关功能

* [手动添加单个客户](/zh/customers/add)
* [让客户通过二维码自助注册](/zh/customers/self-signup)