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

# 客户

<AccordionGroup>
  <Accordion title="Subotiz 中「会员」和「游客」有什么区别？">
    Subotiz 会根据结账时购物车内容自动分配客户类型：

    * **会员** —— 购物车中包含至少一个订阅商品时创建。
    * **游客** —— 购物车仅包含一次性商品时创建。

    这一区别非常重要，因为订阅相关的账单、合同 ID 和续费记录会关联至会员类型的资料。如果游客后续使用相同标识（通常为邮箱）购买订阅商品，系统会自动将其资料升级为会员类型，并保留原有客户 ID。
  </Accordion>

  <Accordion title="Subotiz 如何判断是创建新客户资料还是复用已有资料？">
    Subotiz 使用基于优先级的匹配逻辑来判断是复用已有资料还是创建新资料。系统按以下顺序检查标识：

    1. **客户 ID** —— 若找到有效匹配，直接使用该资料，结账时联系字段变为只读。
    2. **外部客户 ID** —— 若客户 ID 未匹配，检查外部客户 ID。
    3. **邮箱** —— 若前两者均未匹配，检查邮箱地址。

    只有在提供外部客户 ID 或邮箱且未匹配到现有资料时，系统才会新建客户资料。若仅提供客户 ID 但未找到匹配记录，系统不会创建新资料。
  </Accordion>

  <Accordion title="外部客户 ID 是什么？什么时候应该使用？">
    外部客户 ID 是商家可选填的标识字段，用于从外部系统（如 CRM 或 ERP）同步客户资料时保持数据一致性。它是第二优先级的匹配标识——在未提供客户 ID 时，系统会先检查外部客户 ID，再检查邮箱。它也是唯一可以在客户没有邮箱时替代邮箱作为唯一标识的字段。外部客户 ID 在同一 Subotiz 账户内必须唯一。
  </Accordion>

  <Accordion title="之前以游客身份一次性购买的客户，后来购买订阅时会创建新的资料吗？">
    不会，只要使用相同的标识（如邮箱）。当游客后续使用相同标识购买订阅商品时，Subotiz 会自动将现有游客资料升级为会员资料，而不会创建新资料。升级过程中：

    * 原客户 ID 保持不变。
    * 客户类型更新为会员。
    * 如有新的有效数据（如姓名、地址），系统会自动补充缺失字段。

    这避免了重复资料的产生，并将所有购买历史集中保存在同一资料下。
  </Accordion>

  <Accordion title="客户导入支持哪些文件格式？有文件大小限制吗？">
    客户导入支持两种文件格式：.xlsx 和 .csv。其他格式无法导入。文件大小不得超过 10MB。此外，模板中的表头名称和顺序不可修改——表头被修改的文件无法被系统正确处理。所有字段需按规定格式填写。若有记录验证失败，系统会跳过或标记，并可下载错误明细文件查看具体失败原因，修正后重新导入。
  </Accordion>

  <Accordion title="客户导入时，如果邮箱已经存在，会覆盖还是跳过现有记录？">
    取决于导入时是否启用覆盖选项：

    * **启用覆盖** —— 当导入记录的邮箱或外部客户 ID 与已有客户匹配时，系统会用导入数据更新现有资料。模板中为空的字段不会覆盖原有数据，只有非空字段才会更新。
    * **不启用覆盖** —— 任何与现有客户匹配的导入记录会被跳过，不做任何修改。

    无论覆盖选项如何设置，没有匹配记录的新客户始终会被创建。
  </Accordion>

  <Accordion title="我在导入过程中关闭了导入弹窗，导入会被取消吗？">
    不会。关闭导入弹窗不会中断或取消导入任务，系统会在后台继续处理文件。导入完成后，系统会通过消息中心发送通知，包含导入成功、失败和跳过的记录数量，并支持下载错误明细文件。如需稍后查看结果，可前往消息中心或通知区域查看导入汇总。
  </Accordion>

  <Accordion title="可以删除还有有效订阅的客户吗？">
    不可以。若客户仍有未结束的有效订阅，系统不允许删除，并会提示先取消相关订阅。取消所有有效订阅后才可以确认删除。删除后客户资料将永久移除，无法恢复，所有关联数据将不可再访问。
  </Accordion>

  <Accordion title="客户资料中的自定义数据是什么？和联系信息有什么区别？">
    自定义数据是客户资料中一个独立模块，用于保存商家自定义的扩展字段，供内部参考或外部系统映射使用，例如内部标识、业务标签或集成密钥。每个客户资料最多支持添加 40 个自定义字段（键值对）。自定义数据仅用于信息记录，不参与客户识别或资料匹配，不显示在发票上，也不影响任何计费逻辑。联系信息（如姓名、邮箱、地址）则用于账单生成、发票开具和结账页面预填充。自定义数据纯属内部业务使用。
  </Accordion>

  <Accordion title="我只有客户的发票 ID 或交易单 ID，怎么快速找到这个客户？">
    客户列表的搜索仅支持邮箱、客户 ID 和外部客户 ID。但如果只有发票 ID 或交易单 ID，最有效的方式是先在发票或交易单模块中搜索对应记录，然后从发票或订单详情页点击跳转至关联客户资料。如果知道客户邮箱，也可以直接在客户列表中搜索。
  </Accordion>

  <Accordion title="一个客户资料下可以有多个订阅吗？">
    可以。同一客户资料可以关联多个订阅合同 ID，支持客户同时订阅多个商品或定价方案的场景。每个订阅合同 ID 代表一份独立的订阅关系。所有订阅记录可在客户详情页的订阅模块中查看，包括各合同的商品名称、计费周期、创建时间和订阅合同 ID。点击任意订阅合同 ID 可进入完整的订阅详情页。
  </Accordion>

  <Accordion title="客户资料创建后，可以修改客户的邮箱地址吗？">
    客户 ID 由系统自动生成，不可修改。其他字段（如姓名、地址、邮箱订阅状态）可以在客户详情页的基础信息模块中点击编辑进行更新。邮箱在 Subotiz 中为可选字段，若填写，必须在账户内保持唯一。在结账过程中使用已有客户 ID 时，联系信息字段（包括姓名和邮箱）会变为只读，系统会自动从现有资料预填数据。如需在结账之外更新客户信息，请直接在客户详情页使用编辑功能。
  </Accordion>

  <Accordion title="客户资料中的邮箱订阅字段是什么？如何获取？">
    客户资料中的邮箱订阅字段表示客户是否同意接收营销或服务相关邮件。该字段在结账流程中通过客户与营销邮件订阅复选框的互动获取，或通过 API 同步从外部系统导入客户数据时捕获。商家可以在后台使用该字段按通信偏好筛选客户——例如在发送营销活动前筛选已授权的客户。该字段也可以在客户详情页中查看和更新。
  </Accordion>

  <Accordion title="Subotiz 在结账时会自动收集哪些客户信息？">
    在结账创建客户资料时，Subotiz 会自动从结账表单、支付方式或 API 请求中收集以下信息：

    * **邮箱** —— 从结账表单收集或通过 API 传入。
    * **姓名** —— 从支付方式获取，例如信用卡持卡人姓名或 PayPal 账户姓名。
    * **电话** —— 可选，从结账表单或 API 获取。
    * **地址** —— 可选，从支付方式或 API 获取。
    * **自定义数据（Metadata）** —— 可选，通过 API 传入。

    系统只要收到至少一个有效标识就会自动收集可获取的信息，无需商家手动填写。
  </Accordion>

  <Accordion title="客户导入模板中，用邮箱还是外部客户 ID 作为唯一标识？">
    默认情况下，导入模板使用邮箱作为客户的唯一标识。如果客户没有邮箱，可以使用外部客户 ID 作为替代标识。使用外部客户 ID 作为标识时，邮箱字段可以留空。邮箱和外部客户 ID 在所有客户中都必须唯一——不同记录之间的重复值会导致导入失败。两者不能同时用于同一条记录的标识，系统会根据可用性优先使用其中一个。
  </Accordion>

  <Accordion title="客户导入完成后，如何查看哪些记录失败了以及失败原因？">
    导入完成后，Subotiz 会显示导入结果汇总，包含成功导入、导入失败和跳过记录的数量。如有失败记录，点击失败记录按钮下载错误明细文件。该文件会指明无法导入的具体记录及每条记录的失败原因。查看并修正文件中的问题后，仅重新导入已修正的记录即可。如果在任务完成前关闭了导入弹窗，任务完成后可在消息通知或消息中心查看结果并下载失败记录文件。
  </Accordion>

  <Accordion title="如何筛选有订阅的客户和只有一次性购买的客户？">
    在 Subotiz 后台的客户模块中，使用类型筛选器按客户类型分类查看：

    * **会员** —— 查看至少有一个订阅商品的客户资料。
    * **游客** —— 查看只有一次性购买的客户资料。

    还可以将类型筛选与邮箱订阅筛选组合使用，进一步缩小范围——例如，查找已授权营销邮件的订阅客户。这些筛选条件有助于快速识别不同客户群体，用于运营或沟通目的。
  </Accordion>

  <Accordion title="可以在客户资料创建后添加自定义数据吗？有数量限制吗？">
    可以。自定义数据可以随时在客户详情页添加或更新。点击自定义数据模块中的编辑，然后选择添加自定义数据即可添加键值对。每个客户资料最多支持40个自定义数据字段。已有的自定义数据也可以随时更新。自定义数据仅供参考，不用于客户识别、资料匹配或任何计费逻辑，纯属内部业务使用，如存储业务标签、内部 ID 或外部系统映射信息。
  </Accordion>
</AccordionGroup>