使用 CSV 檔案大量匯入使用者

您可以從 Shopify 管理介面匯入 CSV 檔案，為 Shopify POS 建立新的管理員使用者或銷售點 (POS) 使用者，並大量管理其商店存取權限。

您可以使用 CSV 匯入功能對用戶帳號進行以下變更：

• 建立新的管理員使用者
• 為 Shopify POS 建立具備指派 PIN 的新銷售點 (POS) 使用者
• 暫停和重新啟用現有的管理員和 POS 用戶帳號

使用者管理 CSV 檔案的注意事項

部分對用戶帳號的變更不支援透過 CSV 匯入。針對無法透過 CSV 匯入完成的更新，請在 Shopify 管理介面或 Shopify POS app 中手動管理您的用戶帳號。使用 CSV 檔案匯入使用者時，請檢閱下列注意事項：

• CSV 檔案匯入不支援大量刪除使用者。
• 您無法為使用者設定或更新雙因素驗證要求。
• 您無法變更現有 Shopify POS 使用者的 PIN 碼。
• 您無法透過 CSV 匯入建立新角色、群組或地點。檔案中的角色名稱、群組名稱和地點名稱必須與 Shopify 管理介面中現有的名稱相符。
• 您只能透過 CSV 匯入暫停或重新啟用現有的使用者。您無法變更現有使用者的角色、指派群組、地點或商店存取權限。
• 您無法變更使用者類型，例如將純 POS 使用者變更為管理員使用者。

下載使用者管理 CSV 檔案範例

範例檔案包含必要的欄標題和各欄的範例值。在新增您自己的使用者之前，可將其作為起點。

您可從此頁面下載並檢視使用者管理 CSV 範例檔案，或是從 Shopify 管理介面中的「匯入」頁面下載範例。

若要瞭解如何在試算表 app 中儲存及編輯 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 發放僅限商店角色。您只需為具有 POS 角色的商店在 CSV 檔案中新增一列。系統無須新增列，即可發放商店 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. 在匯出檔案中，檢閱名字、姓氏、電子郵件和電話號碼值相符，且 CREATED_AT 時間相同或非常接近的 POS 系統使用者。這些帳號很可能是重複項目。

手動刪除重複的 POS 系統使用者

您可以不使用 CSV 檔案，直接在 Shopify 管理介面中手動移除重複的 POS 系統使用者帳號。

步驟：

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 的情況。