使用 CSV 文件批量导入用户

您可以从 Shopify 后台导入 CSV 文件，为 Shopify POS 创建新的后台用户或 POS 用户，并批量管理其商店访问权限。

您可以通过 CSV 导入对用户账户进行以下更改：

• 创建新的后台用户
• 为 Shopify POS 创建分配了 PIN 的新 POS 用户
• 暂停和重新激活现有的后台用户和 POS 用户账户

用户管理 CSV 文件的注意事项

CSV 导入不支持对用户账户进行某些更改。对于 CSV 导入无法完成的更新，请在 Shopify 后台或 Shopify POS 应用中手动管理您的用户账户。使用 CSV 文件导入用户时，请查看以下注意事项：

• CSV 文件导入不支持批量删除用户。
• 您无法设置或更新用户的双重验证要求。
• 您无法更改现有用户的 Shopify POS PIN。
• 您无法通过 CSV 导入创建新角色、群组或地点。文件中的角色名称、群组名称和地点名称必须与 Shopify 后台中已有的名称匹配。
• 您只能使用 CSV 导入暂停或重新激活现有用户。您无法更改现有用户的角色、分配的群组、地点或商店访问权限。
• 您无法更改用户类型，例如将仅限 POS 的用户更改为后台用户。

下载示例用户管理 CSV 文件

示例文件包含必填列标题和每一列的示例值。您可以将其作为添加您自己的用户之前的起点。

您可以从此页面下载并查看示例用户管理 CSV 文件，或从 Shopify 后台的导入页面下载示例。

要了解如何在电子表格应用中保存和编辑 CSV 文件，请参阅打开和编辑 CSV 文件。

用户管理 CSV 文件的列定义

下表列出了示例用户管理 CSV 文件中的每一列。每个定义说明了在创建用户或暂停或重新激活现有用户时如何使用该列，包括后台用户和仅限 POS 用户之间的区别。

在 CSV 文件中创建新用户

要创建新用户，请将该行上的 id 留空。创建用户后，导入操作会自动为 id 分配一个值。

如需向用户授予对多个地点、角色或商店的访问权限，请参阅向用户分配多个角色、地点和商店。

创建 POS 用户

要创建 POS 用户，请为以下字段输入值：

• 在 user_type 中输入 Point of sale。
• 输入 given_name 和 family_name。
• 要设置用户权限，请为以下字段之一输入值：
  • role_name 和 store_name：如果您的组织包含多个商店，则这两个字段都是必填项。
  • group_name：仅支持 Shopify Plus 套餐。若要了解如何分配群组，请参阅在 CSV 文件中为用户分配群组。
• 要设置地点访问权限，请为以下字段输入值：
  • 要授予特定地点的访问权限，请输入 pos_location_name，并将 all_current_and_future_locations 设置为 FALSE。
  • 要授予所有地点的访问权限，请将 all_current_and_future_locations 设置为 TRUE，并将 pos_location_name 留空。
• 可选：输入 email、phone 或 pin。PIN 必须是在商店中唯一的 4-6 位数字。

创建后台用户

要创建后台用户，请为以下字段输入值：

• 在 user_type 中输入 Admin。
• 输入 email。
• 要设置用户权限，请为以下字段输入值：
  • role_name 和 store_name：如果您的组织只有一个商店，则不需要输入 store_name。如果此角色是组织级角色，请将 store_name 留空。
  • group_name：仅支持 Shopify Plus 套餐。若要了解如何分配群组，请参阅在 CSV 文件中为用户分配群组。
• 可选：如果 role_name 是 POS 类别角色，您可以在该行中为 pin 输入一个值。如果您未指定 PIN，导入操作将为该用户生成一个 PIN。
• 如果 role_name 是 POS 类别角色，则您必须为该用户设置地点访问权限。请为以下字段输入值：
  • 要授予特定地点的访问权限，请输入 pos_location_name，并将 all_current_and_future_locations 设置为 FALSE。
  • 要授予所有地点的访问权限，请将 all_current_and_future_locations 设置为 TRUE，并将 pos_location_name 留空。

在 CSV 文件中暂停或重新激活现有用户

您可以通过在用户管理 CSV 文件中为每位用户添加一行来暂停或重新激活现有用户。通过 id 标识用户。

要暂停或重新激活现有用户，请为以下字段输入值：

• 输入用户的 id。
• 输入用户的 user_type。
• 如果该用户是后台用户，请为以下字段输入值：
  • email：必填。
  • given_name：可选。如果输入值，则该值必须与 Shopify 后台中的用户名字匹配。
  • family_name：可选。如果输入值，则该值必须与 Shopify 后台中的用户姓氏匹配。
  • phone：可选。如果输入值，则该值必须与 Shopify 后台中的用户电话号码匹配。
• 如果该用户是 POS 用户，请为以下字段输入值：
  • given_name：必填。
  • family_name：必填。
  • email：如果用户的账号关联了电子邮件地址，则此字段为必填项。
  • phone：如果用户的账号关联了电话号码，则此字段为必填项。
• status：输入 Suspended 可暂停用户，输入 Active 可重新激活用户。只有在 Shopify 后台中用户的当前状态为 Active 或 Inactive 时，您才能暂停该用户。只有在用户当前状态为 Suspended 时，您才能重新激活该用户。

向一位用户分配多个角色、地点和商店

当您创建新用户时，可以在一次 CSV 文件导入中为该用户分配多个角色、POS 地点和商店。每个角色、地点或商店的组合需要在文件中占用单独的一行。

为您希望分配给同一用户的每个值添加一行。在该用户的每一行中，输入相同的标识值，以便导入操作将每一行应用至该用户账户。将每一行的 id 留空。导入操作会在创建用户后分配 id。

每行所需的标识值

为确保导入操作能识别同一用户，请在您的 CSV 文件中该用户的每一行输入以下值：

• 对于后台用户，该用户的每一行都必须输入相同的 email 和 user_type。
• 对于 POS 用户，必须在每一行中为该用户输入相同的 user_type、given_name、family_name、email 和 phone。

在同一商店中向用户分配多个角色

如果在 CSV 文件中通过各自独立的行来表示每个角色，那么同一用户可以在同一商店中拥有多个角色。

若要在同一商店中为用户分配多个角色，您必须在 CSV 文件中为每个角色添加一行。在每一行中，输入该用户相同的标识值，然后包含与您 Shopify 后台中列出的名称完全一致的 store_name 和 role_name。

在同一商店中分配多个 POS 地点

当某位用户只能访问商店中的特定 POS 地点时，请在单独行上列出每个地点。

要为用户分配访问多个特定 POS 地点的权限，您必须在 CSV 文件中为每个地点添加一行。在每一行中，输入该用户相同的标识值，输入 Shopify 后台中列出的 pos_location_name，并将每一行的 all_current_and_future_locations 设置为 FALSE。

例如，若要向用户分配同一商店中两个特定地点的相同角色，请为每个地点添加一行。

或者，要授予所有当前和未来地点的访问权限，请使用单行，将 all_current_and_future_locations 设置为 TRUE，并将 pos_location_name 留空。对于该商店中的该用户，请在每一行中使用相同的 TRUE 或 FALSE 值。您不能在各行之间混用这两种值。

跨多个商店分配用户访问权限

拥有多个商店的组织可根据需要在每个商店中向同一人授予访问权限。

如果同一用户需要具有多个商店的访问权限，请为每种“角色-商店-地点”组合使用一行。在每一行中，您必须输入该用户的相同识别值，以及与 Shopify 后台中列出的名称完全匹配的 store_name。

您可以在每个商店中向同一用户分配多个角色和多个 POS 地点。

对于创建行中的 all_current_and_future_locations 和 pos_location_name，请使用与在同一商店中分配多个 POS 地点相同的行模式。当该行中的 pos_location_name 包含值时，您无法将 all_current_and_future_locations 设置为 TRUE。

以下示例为在两家不同商店中拥有不同地点访问权限的同一 POS 用户分配角色。

如果某个用户的某一行失败，系统会拒绝该用户的所有行。修复错误后，请在下一次导入中包含该用户的所有行。

在 CSV 文件中为用户分配群组

群组仅适用于使用 Shopify Plus 套餐的组织。一个群组中包含一个或多个角色，因此分配群组可以同时为用户授予多个角色。

分配群组或单个角色

CSV 文件中的每一行可以分配群组或单个角色，但不能同时分配两者：

• 若要分配群组，请在 group_name 中输入群组，并将 role_name 留空。
• 若要分配单个角色，请在 role_name 中输入角色，并将 group_name 留空。

为符合条件的用户分配群组

当群组中至少有一个角色适用于用户的类型时，您可以将该群组分配给该用户。群组中不适用于用户类型的角色不会被授予给用户，但也不会导致错误。该群组仍会根据适用的角色成功分配。

您无法分配没有角色的群组。

跨商店和地点分配群组

对于通过群组授予 POS 角色的每家商店，您必须在 CSV 文件中包含一行。在这些行中，您还必须设置地点访问权限：

• 对于特定地点的访问权限，请输入 pos_location_name，并将 all_current_and_future_locations 设置为 FALSE。若要授予一家商店中几个特定地点的访问权限，请为每个地点添加一行，并在每一行中指定相同的群组和商店。
• 要授予所有地点的访问权限，请将 all_current_and_future_locations 设置为 TRUE，并将 pos_location_name 留空。

验证群组的地点访问权限的方式与验证未通过群组分配的 POS 角色的方式相同，包括该权限不能与同一用户在另一行中被授予的地点访问权限相冲突。

在分配群组时设置 PIN

PIN 遵循适用于具有多个角色的用户的相同规则：

• 仅在 CSV 文件中通过群组授予 POS 角色的商店所在的行输入 pin。
• PIN 必须在商店内保持唯一，但可以在不同商店之间有所不同。
• 请勿在仅通过群组授予非 POS 角色的商店所在的行输入 pin。

分配包含组织角色的群组

如果某个群组包含具有 POS 权限的组织角色，则该组织角色会自动授予所有地点的访问权限，因此针对单家商店的地点要求对其不适用。您可以通过以下任一方式分配此类群组：

• 仅包含群组信息的单行：在 group_name 中输入群组，并将 store_name、pos_location_name、all_current_and_future_locations 以及 pin 留空。该组织角色会自动授予所有地点的访问权限。
• 显式指定商店的行：为通过群组授予 POS 角色的每家商店分别添加一行。在所有这些行上，将 all_current_and_future_locations 设置为 TRUE。您不能将拥有组织角色的用户限制在单个地点。

分配群组的示例

以下示例演示了如何跨不同商店和地点分配一个群组。每一行均列出了 group_name、store_name、pos_location_name 和 all_current_and_future_locations 的值。

在以下示例中，该群组在商店 1 中授予商店角色和 POS 角色，在商店 2 中授予 POS 角色：

• 示例 1 分配具有两家商店中所有地点访问权限的群组。由于该群组在每家商店中都会授予 POS 角色，因此您必须在 CSV 文件中为每家商店各添加一行。

• 示例 2 在两家商店中分配群组，但该群组仅在商店 1 中授予 POS 角色，而在商店 2 中授予仅限商店角色。您只需在 CSV 文件中为具有 POS 角色的商店添加一行。无需添加行即可授予商店 2 中的仅限商店角色。

• 示例 3 分配的群组具有访问两家商店中特定地点的权限。您必须在 CSV 文件中为每个地点添加一行。

• 示例 4 分配的群组除了包含商店角色和 POS 角色之外，还包含具有 POS 权限的组织角色。您可以通过以下方式之一分配此群组：

  • 第一种选项是使用仅限群组的单行，其中的组织角色授予所有地点的访问权限。
  • 第二种选项是为群组授予 POS 角色的每家商店使用明确对应的行。在每一行中，all_current_and_future_locations 都必须为 TRUE，因为组织角色不能仅限于单个地点。

从您的 Shopify 后台导入用户管理 CSV 文件

构建好 CSV 文件并以正确的格式保存后，您可以从组织的用户页面上传该文件。导入在 Shopify 后台中运行，并会报告无法处理的任何行。

步骤：

1. 在 Shopify 后台中，转至设置 > 用户。

2. 点击导入。

3. 可选：点击链接下载示例 CSV 文件，然后将其用作您自己文件的模板。

4. 点击上传文件，然后选择您的 .csv 文件。

导入完成后，请查看 Shopify 后台中的确认消息。如果任何行存在错误，您将收到一封包含详细信息的电子邮件，以便您纠正文件并重新导入。

用户管理导入常见问题的解决方案

如果您在上传用户管理 CSV 文件时遇到问题，请检查下方的解决方案中是否列出了该问题。

如需特定错误消息相关故障排除的帮助，请参阅导入错误消息故障排除。

修复错误后重新导入

导入失败时，您会收到一封列出失败行的电子邮件。请仔细重新导入文件，以免创建重复用户。

仅重新导入存在错误的用户，切勿重新导入整个文件。遵循以下做法：

• 修复失败的行，并在新文件中包含每个受影响用户的所有行。如果某位用户共有 3 行，其中 1 行导致了错误，则系统将拒绝该用户的所有 3 行。因此在重新导入时，请包括全部 3 个已更正的行。
• 切勿包含已成功导入的用户。这些账户已存在。如果再次导入这些账户，可能会返回 user already exists（用户已存在）错误、创建重复的用户或同时出现这两种情况。

如果您重新导入完整的原始文件（包含已经成功创建了用户的行），那么您可能会遇到以下结果：

• 后台用户：如果电子邮件地址已在使用中，您可能会收到 user already exists（用户已存在）或电子邮件重复的错误消息。
• POS 用户：系统可能会创建重复的 POS 用户记录。由于系统是通过姓名及相关字段，而不是唯一的电子邮件地址来匹配 POS 用户，因此可以创建具有相同姓名和角色的第二个用户。
• 席位限制：如果该导入将已创建的用户计算在内，那么您可能会收到席位限制错误消息。参阅各定价套餐支持的最多用户数，详细了解。

创建多个同名的 POS 用户

如果在一次导入中，某位 POS 用户的标识值在多行（包括不相邻的行）中相匹配，则导入操作会将这些行视为同一个用户。

若要在一次导入中创建具有相同 given_name 和 family_name 的不同 POS 用户，您必须为每个用户的以下至少一个字段输入不同的值：

• email
• phone

如果您无法通过 email 或 phone 的不同值来区分具有相同 given_name 和 family_name 的多个用户，则必须使用单独的 CSV 文件导入每个用户。

文件格式和上传大小

下列问题与 CSV 文件格式或大小有关，与您用户行中的值无关：

• 文件格式错误：您的文件必须为保存时采用打开和编辑 CSV 文件中所述编码格式的 .csv 文件。
• 文件过大：如果您的文件包含许多行，请将其拆分为较小的文件并逐个导入。

POS 用户显示为多个用户，而不是单个具备多个角色的用户

当某个人员在每一行中的 user_type、given_name、family_name、email 和 phone 都匹配时，导入操作会将这些行与同一个 POS 用户进行匹配。如果各行之间的这些值有任何差异，导入操作将创建单独的用户。

在您预期获得单个具备多个角色的用户时，以下情况通常会导致创建出重复的 POS 用户：

• 某一行中有电子邮件，但另一行中没有：如果您在 POS 用户的第一行包含了 email，而在另一行将其留空，那么导入将创建独立的用户。请在该用户的每一行中都包含 email，或者在每一行中均留空。
• 姓名中存在拼写错误：姓名行中的拼写错误可能会导致创建独立的用户。例如，如果匹配区分大小写，那么系统可能会将一行中的 Jane 和另一行中的 jane 视为不同的用户。请在每行中采用相同的方式写入该用户的姓名。
• 一行中有 phone 但另一行中没有：如果您为 POS 用户在第一行中包含了 phone，但在另一行中将其留空，导入操作将创建单独的用户。请在该用户的每一行都包含 phone，或者在每一行都将其留空。

为了避免重复创建用户，请确保在 CSV 文件中，同一 POS 用户的每一行 user_type、given_name、family_name、email 和 phone 均完全相同。

席位限制错误

席位限制适用于您组织定价套餐中的后台用户。如果在导入期间遇到席位限制错误，则表明导入操作计算了文件将创建的新后台用户数量，并对照套餐的席位限制检查了该数字。如果已达到或接近席位限制，请减少 CSV 文件中的新后台用户数量，或者在再次导入前查看定价套餐的用户限制。

导出用户列表，查找重复的 POS 用户

如果怀疑有重复的 POS 用户，您可以将用户列表导出为 CSV 文件，并在电子表格中对各个行进行比较。导出文件中包含的时间戳可指示哪个账户是先创建的。

如需了解导出的文件如何发送以及谁可以下载，请参阅将用户管理信息导出为 CSV 文件。

步骤：

1. 在 Shopify 后台中，转至设置 > 用户。

2. 点击导出。

3. 在导出用户对话框中，点击导出。

4. 收到电子邮件后，点击下载文件将 CSV 保存到设备。

5. 在电子表格应用中打开该文件，然后按 GIVEN_NAME 列进行排序。

6. 在导出文件中，查看 given name、family name、email 和 phone 值匹配且 CREATED_AT 时间相同或非常接近的 POS 用户。这些账户可能是重复项。

手动删除重复的 POS 用户

您可以直接在 Shopify 后台手动移除重复的 POS 用户账户，无需使用 CSV 文件。

步骤：

1. 在 Shopify 后台中，转至设置 > 用户。

2. 选择重复的用户账户。

3. 点击移除。

使用 CSV 文件批量删除重复的 POS 用户

您可以通过 CSV 导入功能停用重复的账户，然后从 Shopify 后台的用户页面批量删除这些已停用的账户。先停用账户有助于在删除前确认要移除哪些账户。

步骤：

1. 导出当前用户列表。
2. 使用导出用户列表，查找重复的 POS 用户中所述的比较方法确定重复的账户。
3. 对于每个重复账户，请将 id、user_type、email、phone、given_name 和 family_name 的值复制到新的 CSV 文件中。使用与示例用户管理 CSV 文件相同的列结构。
4. 将每个重复行的 status 设置为 Suspended。将 role_name、group_name、store_name、pos_location_name、all_current_and_future_locations 和 pin 留空。
5. 导入 CSV 文件，停用这些用户。
6. 转到设置 > 用户。
7. 如果可用，请将用户列表筛选为已停用账户。选择您停用的重复账户，然后批量将其删除。

导入错误消息故障排除

如果用户管理 CSV 导入失败，您将收到一封包含错误消息和受影响行的电子邮件。以下部分说明了每种消息的含义，以及您在重新导入之前可以在 CSV 文件中修改哪些内容。

如果您在导入 CSV 时仍然遇到问题，请联系 Shopify 支持团队。

CSV 文件错误

用户标识错误

后台或 POS 用户创建错误

以下故障排除适用于为了创建新用户而将用户的 id 字段留空的情况。

后台用户创建错误

以下故障排除适用于 id 留空且 user_type 设置为 Admin 的情况。

POS 用户创建错误

当 id 为空且 user_type 设置为 Point of sale 时，适用以下故障排除方法。

用户暂停错误

当 id 包含值且您正在更改现有用户的 status 时，适用以下故障排除操作。