Mengimpor pengguna secara massal menggunakan file CSV

Anda dapat mengimpor file CSV dari admin Shopify Anda untuk membuat pengguna admin atau pengguna Point of Sale (POS) baru untuk Shopify POS, dan mengelola akses toko mereka secara massal.

Anda dapat menggunakan impor CSV untuk melakukan perubahan berikut pada akun pengguna Anda:

  • Membuat pengguna admin baru
  • Membuat pengguna titik penjualan (POS) baru untuk Shopify POS dengan PIN yang ditetapkan
  • Menangguhkan dan mengaktifkan kembali akun pengguna admin dan POS yang sudah ada

Pertimbangan untuk file CSV manajemen pengguna

Beberapa perubahan pada akun pengguna tidak didukung oleh impor CSV. Untuk pembaruan yang tidak dapat diselesaikan oleh impor CSV, kelola akun pengguna Anda secara manual di admin Shopify atau di aplikasi Shopify POS. Tinjau pertimbangan berikut saat Anda mengimpor pengguna menggunakan file CSV:

  • Impor file CSV tidak mendukung penghapusan pengguna secara massal.
  • Anda tidak dapat mengatur atau memperbarui persyaratan autentikasi dua faktor untuk pengguna.
  • Anda tidak dapat mengubah PIN pengguna yang sudah ada untuk Shopify POS.
  • Anda tidak dapat membuat peran, grup, atau lokasi baru dari impor CSV. Nama peran, nama grup, dan nama lokasi di file Anda harus cocok dengan yang sudah ada di admin Shopify Anda.
  • Anda hanya dapat menangguhkan atau mengaktifkan kembali pengguna yang sudah ada dengan impor CSV. Anda tidak dapat mengubah peran, grup yang ditetapkan, lokasi, atau akses toko dari pengguna yang sudah ada.
  • Anda tidak dapat mengubah tipe pengguna, seperti mengubah pengguna khusus POS menjadi pengguna admin.

Mengunduh contoh file CSV manajemen pengguna

Contoh file mencakup header kolom yang diperlukan dan nilai contoh untuk setiap kolom. Anda dapat menggunakannya sebagai titik awal sebelum menambahkan pengguna Anda sendiri.

Anda dapat mengunduh dan melihat sampel file CSV manajemen pengguna dari halaman ini, atau mengunduh sampel dari halaman Impor di admin Shopify Anda.

Untuk mempelajari cara menyimpan dan mengedit file CSV di aplikasi spreadsheet Anda, lihat Membuka dan mengedit file CSV.

Definisi kolom untuk file CSV manajemen pengguna

Tabel berikut mencantumkan setiap kolom pada contoh file CSV manajemen pengguna. Setiap definisi menjelaskan cara penggunaan kolom ketika Anda membuat pengguna, atau ketika Anda menangguhkan atau mengaktifkan kembali pengguna yang ada, termasuk perbedaan antara pengguna admin dan pengguna khusus POS.

Kolom-kolom dalam contoh file CSV manajemen pengguna untuk mengimpor akun pengguna.
Kolom CSVDefinisi
id

ID pengguna yang unik untuk setiap akun. Saat Anda mengekspor informasi manajemen pengguna sebagai file CSV, ID setiap pengguna tercantum di kolom id. Anda juga dapat menemukan ID pengguna di URL browser saat membuka profil mereka di admin Shopify Anda.

Untuk membuat:

  • Pengguna admin atau POS: Biarkan kosong. Sistem menetapkan id secara otomatis.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Wajib. Harus cocok dengan ID pengguna dalam ekspor Anda atau di admin Shopify Anda.
user_type

Tipe pengguna, seperti Admin atau Point of sale. Anda tidak dapat mengubah tipe pengguna yang sudah ada dengan impor CSV. Jika menggunakan lebih dari satu baris untuk satu akun pengguna, gunakan nilai yang sama di kolom ini pada setiap baris untuk pengguna tersebut.

Untuk membuat:

  • Pengguna admin: Wajib. Masukkan Admin.
  • Pengguna POS: Wajib. Masukkan Point of sale.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Wajib. Harus cocok dengan tipe pengguna saat ini.
email

Alamat email yang valid.

Untuk membuat:

  • Pengguna admin: Wajib pada setiap baris. Harus unik dan tidak boleh sama dengan email pengguna admin yang sudah ada.
  • Pengguna POS: Opsional. Anda dapat menetapkan email ke pengguna POS, atau membiarkan bidang kosong. Jika Anda memasukkan email di baris mana pun untuk pengguna tersebut, maka masukkan email yang sama di setiap baris untuk pengguna tersebut.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin: Wajib.
  • Pengguna POS: Jika pengguna memiliki email di akun mereka, maka nilai ini diwajibkan pada setiap baris penangguhan atau pengaktifan kembali untuk pengguna tersebut, dan harus cocok dengan alamat email untuk pengguna tersebut di admin Shopify Anda.
phone

Nomor telepon pengguna.

Untuk membuat:

  • Pengguna admin: Biarkan kosong pada baris pembuatan agar pengguna admin dapat menambahkan telepon mereka saat menerima undangan ke toko Anda. Jika Anda memasukkan nilai pada baris pembuatan untuk bidang ini, maka pembuatan pengguna akan gagal.
  • Pengguna POS: Opsional.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin: Opsional. Jika Anda memasukkan nilai untuk bidang ini, nilainya harus cocok dengan nomor telepon pengguna di profil mereka di admin Shopify Anda.
  • Pengguna POS: Wajib jika pengguna memiliki nomor telepon di akun mereka. Sertakan nomor tersebut jika tercantum di profil pengguna di admin Shopify Anda.
given_name

Nama depan pengguna.

Untuk membuat:

  • Pengguna admin: Biarkan kosong pada baris pembuatan agar pengguna admin dapat menambahkan nama depan mereka saat menerima undangan ke toko Anda. Jika Anda memasukkan nilai pada baris pembuatan untuk bidang ini, maka pembuatan pengguna akan gagal.
  • Pengguna POS: Wajib.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin: Opsional. Jika Anda memasukkan nilai, nilainya harus cocok dengan nama depan pengguna di admin Shopify Anda.
  • Pengguna POS: Wajib diisi. Harus sama dengan nama depan pengguna di admin Shopify Anda.
family_name

Nama belakang pengguna.

Untuk membuat:

  • Pengguna admin: Biarkan kosong pada baris pembuatan agar admin dapat menambahkan nama belakangnya saat menerima undangan. Jika Anda memasukkan nilai pada baris pembuatan, pembuatan pengguna akan gagal.
  • Pengguna POS: Wajib.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin: Opsional. Jika Anda memasukkan nilai, nilai tersebut harus sama dengan nama belakang pengguna di admin Shopify Anda.
  • Pengguna POS: Wajib diisi. Harus sama dengan nama belakang pengguna di admin Shopify Anda.
status

Status akun pengguna, seperti Active atau Suspended.

Untuk membuat:

  • Pengguna admin atau POS: Biarkan kosong. Proses impor otomatis mengatur pengguna POS baru menjadi Active dan pengguna admin baru menjadi Pending hingga mereka menerima undangan ke toko Anda.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Masukkan Suspended untuk menangguhkan pengguna, atau Active untuk mengaktifkannya kembali. Masukkan Suspended hanya saat status pengguna saat ini adalah Active atau Inactive. Masukkan Active hanya saat status mereka saat ini adalah Suspended. Jika status tidak sesuai dengan pola ini, impor akan gagal.
role_name

Nama peran yang ditetapkan ke pengguna. Nama peran harus ada dan valid untuk jenis pengguna tersebut. Baris dalam file CSV dapat menetapkan peran atau grup, tetapi tidak keduanya. Jika Anda memasukkan nilai di role_name dan group_name pada baris yang sama, impor untuk baris tersebut akan gagal.

Untuk membuat:

  • Pengguna Admin atau POS: Wajib, kecuali jika baris tersebut menetapkan pengguna melalui grup sebagai gantinya. Biarkan kolom ini kosong pada baris yang menetapkan grup, karena peran ditentukan oleh grup. Untuk mempelajari cara menetapkan grup, lihat Menetapkan grup ke pengguna dalam file CSV.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Biarkan kosong. Jika Anda memasukkan nilai, proses impor akan gagal untuk baris tersebut.
group_name

Grup yang ditetapkan ke pengguna. Grup hanya tersedia untuk organisasi pada paket Shopify Plus. Baris dalam file CSV dapat menetapkan grup atau peran, tetapi tidak keduanya. Jika Anda memasukkan nilai di group_name dan role_name pada baris yang sama, maka proses impor untuk baris tersebut akan gagal.

Untuk membuat:

  • Pengguna Admin atau POS: Opsional. Grup harus berisi setidaknya satu peran yang berlaku untuk jenis pengguna, dan Anda tidak dapat menetapkan grup yang kosong. Untuk mempelajari cara menetapkan grup, lihat Menetapkan grup ke pengguna dalam file CSV.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Biarkan kosong. Jika Anda memasukkan nilai, proses impor akan gagal untuk baris tersebut.
store_name

Toko yang dapat diakses oleh pengguna. Harus benar-benar sama dengan nama toko di admin Shopify Anda.

Untuk membuat:

  • Pengguna admin atau POS: Jika organisasi Anda hanya memiliki satu toko, impor secara default menggunakan toko tersebut. Jika organisasi Anda memiliki lebih dari satu toko, masukkan nama toko yang berlaku untuk baris ini. Beberapa baris untuk tingkat organisasi atau khusus grup tidak menyertakan nama toko di kolom ini.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Biarkan kosong. Jika Anda memasukkan nilai, proses impor akan gagal untuk baris tersebut.
pos_location_name

Lokasi POS yang dapat diakses oleh pengguna. Nama lokasi harus sama dengan lokasi di toko tersebut.

Untuk membuat:

  • Pengguna admin: Masukkan nama lokasi ketika baris ini memberikan izin akses POS kepada pengguna admin tersebut di lokasi spesifik. Jika tidak, biarkan kosong.
  • Pengguna POS: Bila Anda memberikan izin akses POS di lokasi tertentu, masukkan setiap nama lokasi di kolom ini pada barisnya masing-masing. Biarkan kosong pada baris yang aksesnya mencakup setiap lokasi saat ini dan mendatang di toko tersebut.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Biarkan kosong. Jika Anda memasukkan nilai, proses impor akan gagal untuk baris tersebut.
all_current_and_future_locations

Masukkan TRUE jika izin akses POS di baris ini mencakup setiap lokasi saat ini dan mendatang di toko. Masukkan FALSE jika izin akses hanya berlaku di lokasi yang disebutkan pada pos_location_name. Jika pos_location_name memiliki nilai, Anda tidak dapat memasukkan TRUE. Gunakan satu nilai TRUE atau FALSE pada setiap baris untuk pengguna yang sama di toko yang sama.

Untuk membuat:

  • Pengguna admin: Wajib diisi bila peran pada baris ini menyertakan izin akses POS. Jika tidak, biarkan kosong.
  • Pengguna POS: Wajib.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Biarkan kosong. Jika Anda memasukkan nilai, proses impor akan gagal untuk baris tersebut.
pin

PIN untuk masuk ke POS Shopify: terdiri dari 4–6 digit angka. PIN harus sama pada setiap baris di file CSV yang menetapkan izin akses POS bagi pengguna yang sama dalam satu toko. PIN boleh berbeda di setiap toko untuk pengguna yang sama. Di tiap toko, setiap PIN harus unik untuk satu akun pengguna.

Untuk membuat:

  • Pengguna admin: Opsional. Masukkan PIN hanya pada baris saat izin akses POS yang memerlukan PIN diatur pada tingkat toko, bukan pada baris saat izin akses hanya ada pada tingkat grup.
  • Pengguna POS: Opsional. Masukkan PIN hanya pada baris saat izin akses POS berada pada tingkat toko, bukan pada baris saat izin akses hanya ada pada tingkat grup.

Untuk menangguhkan atau mengaktifkan kembali:

  • Pengguna admin atau POS: Biarkan kosong. Jika Anda memasukkan nilai, proses impor akan gagal untuk baris tersebut.

Membuat pengguna baru dalam file CSV

Untuk membuat pengguna baru, biarkan id kosong pada baris tersebut. Setelah pengguna dibuat, proses impor akan menetapkan nilai pada id secara otomatis.

Untuk memberikan akses ke lebih dari satu lokasi, peran, atau toko kepada pengguna, lihat Menetapkan beberapa peran, lokasi, dan toko kepada pengguna.

Membuat pengguna POS

Untuk membuat pengguna POS, masukkan nilai pada kolom berikut:

  • Masukkan Point of sale di user_type.
  • Masukkan given_name dan family_name.
  • Untuk mengatur izin akses pengguna, masukkan nilai pada salah satu kolom berikut:
  • Untuk mengatur akses lokasi, masukkan nilai pada kolom berikut:
    • Untuk akses ke lokasi tertentu, masukkan pos_location_name, dan atur all_current_and_future_locations menjadi FALSE.
    • Untuk akses ke semua lokasi, atur all_current_and_future_locations menjadi TRUE, dan biarkan pos_location_name kosong.
  • Opsional: Masukkan email, phone, atau pin. PIN harus berupa angka 4–6 digit yang unik dalam sebuah toko.

Membuat pengguna admin

Untuk membuat pengguna admin, masukkan nilai pada kolom berikut:

  • Masukkan Admin di user_type.
  • Masukkan email.
  • Untuk mengatur izin akses pengguna, masukkan nilai pada kolom berikut:
    • role_name dan store_name: Jika organisasi Anda hanya memiliki satu toko, store_name tidak wajib diisi. Jika peran tersebut merupakan peran di tingkat organisasi, biarkan store_name kosong.
    • group_name: Hanya tersedia pada paket Shopify Plus. Untuk mempelajari cara menetapkan grup, lihat Menetapkan grup ke pengguna dalam file CSV.
  • Opsional: Jika role_name adalah peran kategori POS, Anda dapat memasukkan nilai untuk pin pada baris tersebut. Jika Anda tidak menentukan PIN, impor akan menghasilkan PIN untuk pengguna.
  • Jika role_name adalah peran kategori POS, Anda harus mengatur akses lokasi untuk pengguna tersebut. Masukkan nilai pada kolom berikut:
    • Untuk akses ke lokasi tertentu, masukkan pos_location_name, dan atur all_current_and_future_locations menjadi FALSE.
    • Untuk akses ke semua lokasi, atur all_current_and_future_locations menjadi TRUE, dan biarkan pos_location_name kosong.

Menangguhkan atau mengaktifkan kembali pengguna yang ada di file CSV

Anda dapat menangguhkan atau mengaktifkan kembali pengguna yang ada dengan menambahkan satu baris per pengguna ke file CSV manajemen pengguna Anda. Pengguna diidentifikasi berdasarkan id.

Untuk menangguhkan atau mengaktifkan kembali pengguna yang ada, masukkan nilai pada kolom berikut:

  • Masukkan id untuk pengguna tersebut.
  • Masukkan user_type untuk pengguna tersebut.
  • Jika pengguna tersebut merupakan pengguna admin, masukkan nilai pada kolom berikut:
    • email: Wajib diisi.
    • given_name: Opsional. Jika Anda memasukkan nilai, nilai tersebut harus sesuai dengan nama depan pengguna di admin Shopify Anda.
    • family_name: Opsional. Jika Anda memasukkan nilai, nilai tersebut harus sesuai dengan nama belakang pengguna di admin Shopify Anda.
    • phone: Opsional. Jika Anda memasukkan nilai, nilai tersebut harus sesuai dengan nomor telepon pengguna di admin Shopify Anda.
  • Jika pengguna tersebut merupakan pengguna POS, masukkan nilai pada kolom berikut:
    • given_name: Wajib diisi.
    • family_name: Wajib diisi.
    • email: Jika pengguna memiliki email pada akunnya, kolom ini wajib diisi.
    • phone: Jika pengguna memiliki nomor telepon pada akunnya, kolom ini wajib diisi.
  • status: Masukkan Suspended untuk menangguhkan pengguna, atau Active untuk mengaktifkan kembali pengguna. Anda hanya dapat menangguhkan pengguna saat statusnya saat ini adalah Active atau Inactive di admin Shopify Anda. Anda hanya dapat mengaktifkan kembali pengguna saat statusnya saat ini adalah Suspended.

Menetapkan beberapa peran, lokasi, dan toko untuk pengguna

Saat membuat pengguna baru, Anda dapat menetapkan lebih dari satu peran, lokasi POS, dan toko kepada pengguna tersebut dalam satu kali impor file CSV. Setiap kombinasi peran, lokasi, atau toko memerlukan barisnya sendiri di file tersebut.

Tambahkan satu baris untuk setiap nilai yang ingin Anda tetapkan ke pengguna yang sama. Pada setiap baris untuk pengguna tersebut, masukkan nilai identifikasi yang sama sehingga proses impor menerapkan setiap baris ke satu akun pengguna tersebut. Biarkan id kosong pada setiap baris. Proses impor akan menetapkan id setelah pengguna dibuat.

Nilai identifikasi wajib ada pada setiap baris

Agar proses impor dapat mengenali pengguna yang sama, masukkan nilai berikut di setiap baris file CSV Anda untuk pengguna tersebut:

  • Untuk pengguna admin, email dan user_type yang sama harus dimasukkan di setiap baris bagi pengguna tersebut.
  • Untuk pengguna POS, user_type, given_name, family_name, email, dan phone yang sama harus dimasukkan untuk pengguna tersebut di setiap baris.

Menetapkan beberapa peran untuk pengguna di toko yang sama

Satu pengguna dapat memiliki lebih dari satu peran pada toko yang sama apabila masing-masing peran direpresentasikan dalam barisnya sendiri di file CSV.

Untuk menetapkan lebih dari satu peran ke pengguna di toko yang sama, Anda harus menambahkan satu baris per peran dalam file CSV Anda. Pada setiap baris, masukkan nilai identifikasi yang sama untuk pengguna tersebut, lalu sertakan store_name dan role_name persis seperti yang tercantum di admin Shopify Anda.

Menetapkan beberapa lokasi POS di toko yang sama

Bila pengguna hanya boleh mengakses lokasi POS tertentu di sebuah toko, cantumkan tiap-tiap lokasi tersebut di baris terpisah.

Untuk memberikan akses kepada pengguna ke beberapa lokasi POS tertentu, Anda harus menambahkan satu baris per lokasi dalam file CSV Anda. Pada setiap baris, masukkan nilai identifikasi yang sama untuk pengguna tersebut, masukkan pos_location_name yang terdaftar di admin Shopify Anda, dan atur all_current_and_future_locations ke FALSE di setiap baris.

Contohnya, untuk memberikan peran yang sama ke pengguna di dua lokasi tertentu dalam satu toko, tambahkan satu baris per lokasi.

Contoh baris CSV yang menetapkan peran yang sama ke pengguna di dua lokasi POS tertentu dalam satu toko.
role_namepos_location_nameall_current_and_future_locations
KasirLokasi 1FALSE
KasirLokasi 2FALSE

Atau, untuk memberikan akses ke semua lokasi saat ini dan mendatang, gunakan satu baris dengan mengatur all_current_and_future_locations ke TRUE dan biarkan pos_location_name kosong. Gunakan nilai TRUE atau FALSE yang sama pada setiap baris untuk pengguna tersebut di toko yang sama. Anda tidak dapat mencampurnya antarbaris.

Menetapkan akses pengguna di beberapa toko

Organisasi dengan lebih dari satu toko dapat memberikan akses kepada orang yang sama di setiap toko yang mereka butuhkan.

Saat pengguna yang sama memerlukan akses di lebih dari satu toko, gunakan satu baris untuk tiap kombinasi peran-toko-lokasi. Pada setiap baris, Anda harus memasukkan nilai identifikasi yang sama untuk pengguna tersebut, beserta store_name yang sama persis dengan yang tercantum di admin Shopify Anda.

Anda dapat menetapkan beberapa peran dan beberapa lokasi POS kepada pengguna yang sama untuk setiap toko.

Untuk all_current_and_future_locations dan pos_location_name di baris pembuatan, gunakan pola baris yang sama seperti pada menetapkan beberapa lokasi POS di toko yang sama. Anda tidak dapat mengatur all_current_and_future_locations ke TRUE jika pos_location_name memiliki nilai di baris tersebut.

Contoh berikut memberikan akses lokasi yang berbeda ke pengguna POS yang sama di dua toko berbeda.

Contoh baris CSV yang menetapkan akses lokasi yang berbeda ke pengguna POS yang sama di dua toko.
store_namerole_namepos_location_nameall_current_and_future_locations
StoreName_USAKasirStoreName_USA_SF_01FALSE
StoreName_CANKasir TokoTRUE

Jika terdapat baris untuk pengguna yang gagal, semua baris untuk pengguna tersebut akan ditolak. Setelah Anda memperbaiki kesalahan, sertakan setiap baris untuk pengguna tersebut dalam impor berikutnya.

Menetapkan grup ke pengguna dalam file CSV

Grup hanya tersedia untuk organisasi pada paket Shopify Plus. Grup memaketkan satu atau beberapa peran, sehingga penetapan grup dapat memberikan beberapa peran ke pengguna pada waktu yang bersamaan.

Menetapkan grup atau satu peran

Setiap baris dalam file CSV dapat menetapkan satu grup atau satu peran tunggal, tetapi tidak keduanya:

  • Untuk menetapkan grup, masukkan grup di group_name dan biarkan role_name kosong.
  • Untuk menetapkan peran tunggal, masukkan peran di role_name dan biarkan group_name kosong.

Menetapkan grup ke pengguna yang memenuhi syarat

Anda dapat menetapkan grup ke pengguna ketika setidaknya ada satu peran di grup tersebut yang berlaku untuk jenis pengguna itu. Peran di dalam grup yang tidak berlaku untuk jenis pengguna itu tidak diberikan, namun hal tersebut tidak menyebabkan masalah. Grup tetap berhasil ditetapkan berdasarkan peran yang berlaku.

Anda tidak dapat menetapkan grup yang tidak memiliki peran.

Menetapkan grup di berbagai toko dan lokasi

Anda harus menyertakan baris dalam file CSV untuk setiap toko di mana grup tersebut memberikan peran POS. Di tiap-tiap baris tersebut, Anda juga harus mengatur akses lokasi:

  • Untuk akses ke lokasi tertentu, masukkan pos_location_name, dan atur all_current_and_future_locations ke FALSE. Untuk memberikan beberapa lokasi tertentu di satu toko, tambahkan satu baris per lokasi, dengan grup dan toko yang sama di setiap baris.
  • Untuk akses ke semua lokasi, atur all_current_and_future_locations menjadi TRUE, dan biarkan pos_location_name kosong.

Akses lokasi untuk grup divalidasi dengan cara yang sama seperti peran POS yang tidak ditetapkan melalui grup, termasuk di dalamnya tidak boleh bertentangan dengan akses lokasi yang diberikan ke pengguna yang sama pada baris lain.

Mengatur PIN saat menetapkan grup

PIN mengikuti aturan yang sama dan berlaku pada pengguna yang memiliki banyak peran:

  • Masukkan pin hanya di baris dalam file CSV Anda untuk toko tempat grup tersebut memberikan peran POS.
  • PIN harus unik di dalam satu toko, tetapi bisa berbeda antar-toko.
  • Jangan masukkan pin di baris bagi toko di mana grup tersebut hanya memberikan peran selain POS.

Menetapkan grup yang menyertakan peran organisasi

Ketika grup menyertakan peran organisasi yang memiliki izin akses POS, peran organisasi secara otomatis memberikan akses ke semua lokasi, sehingga persyaratan lokasi per toko tidak berlaku padanya. Anda dapat menetapkan jenis grup ini dengan salah satu cara berikut:

  • Baris tunggal khusus grup: Masukkan grup di group_name, dan biarkan store_name, pos_location_name, all_current_and_future_locations, serta pin kosong. Peran organisasi secara otomatis akan memberikan akses ke semua lokasi.
  • Baris toko secara eksplisit: Tambahkan satu baris untuk setiap toko di mana grup tersebut memberikan peran POS. Pada tiap-tiap baris ini, atur all_current_and_future_locations ke TRUE. Anda tidak bisa membatasi pengguna dengan peran organisasi hanya pada satu lokasi saja.

Contoh penetapan grup

Contoh berikut mengilustrasikan cara menetapkan satu grup di berbagai toko dan lokasi yang berbeda. Tiap baris mencantumkan nilai untuk group_name, store_name, pos_location_name, dan all_current_and_future_locations.

Pada contoh berikut, grup memberikan peran toko dan peran POS di Toko 1, serta peran POS di Toko 2:

  • Contoh 1 menetapkan grup dengan akses ke seluruh lokasi di dua toko. Karena grup tersebut memberikan peran POS di setiap toko, Anda perlu menambahkan satu baris per toko pada file CSV Anda.
Contoh baris CSV yang menetapkan grup dengan akses ke semua lokasi di dua toko.
group_namestore_namepos_location_nameall_current_and_future_locationspin
Nama grupToko 1TRUE
Nama grupToko 2TRUE
  • Contoh 2 menetapkan grup pada dua toko, tetapi grup tersebut memberikan peran POS hanya pada Toko 1 dan peran khusus toko pada Toko 2. Tambahkan baris dalam file CSV Anda hanya untuk toko dengan peran POS. Peran khusus toko di Toko 2 diberikan tanpa baris.
Contoh baris CSV yang menetapkan grup yang memberikan peran POS di satu toko dan peran khusus toko di toko lain.
group_namestore_namepos_location_nameall_current_and_future_locationspin
Nama grupToko 1TRUE
  • Contoh 3 menetapkan grup dengan akses ke lokasi tertentu pada dua toko. Anda harus menambahkan satu baris dalam file CSV Anda per lokasi.
Contoh baris CSV yang menetapkan grup dengan akses ke lokasi tertentu di dua toko.
group_namestore_namepos_location_nameall_current_and_future_locationspin
Nama grupToko 1Lokasi 11FALSE
Nama grupToko 1Lokasi 12FALSE
Nama grupToko 2Lokasi 21FALSE
Nama grupToko 2Lokasi 22FALSE
  • Contoh 4 menetapkan grup yang menyertakan peran organisasi dengan izin akses POS, selain peran toko dan peran POS. Anda bisa menetapkan grup ini menggunakan salah satu cara berikut:

    • Opsi pertama adalah satu baris khusus grup, dengan peran organisasi memberikan akses ke semua lokasi.
    • Opsi kedua menggunakan baris eksplisit untuk setiap toko tempat grup tersebut memberikan peran POS. Pada setiap baris, all_current_and_future_locations harus berupa TRUE, karena peran organisasi tidak bisa dibatasi hanya pada satu lokasi.
Contoh baris CSV yang menetapkan grup dengan peran organisasi menggunakan satu baris khusus grup.
group_namestore_namepos_location_nameall_current_and_future_locationspin
Nama grup
Contoh baris CSV yang menetapkan grup dengan peran organisasi menggunakan baris toko eksplisit.
group_namestore_namepos_location_nameall_current_and_future_locationspin
Nama grupToko 1TRUE
Nama grupToko 2TRUE

Impor file CSV manajemen pengguna dari admin Shopify Anda

Setelah Anda menyusun file CSV dan menyimpannya dalam format yang benar, Anda dapat mengunggahnya dari halaman Pengguna organisasi Anda. Impor dijalankan di admin Shopify Anda dan melaporkan baris apa pun yang tidak dapat diproses.

Langkah-langkah:

  1. Dari admin Shopify Anda, buka Pengaturan > Pengguna.

  2. Klik Impor.

  3. Opsional: Klik tautan untuk mengunduh file CSV sampel, lalu gunakan sebagai templat untuk file Anda sendiri.

  4. Klik Unggah file, lalu pilih file .csv Anda.

Setelah impor selesai, tinjau konfirmasi di admin Shopify Anda. Jika terdapat baris yang mengalami kesalahan, Anda akan menerima email berisi detail sehingga Anda dapat memperbaiki file dan mengimpornya kembali.

Solusi untuk masalah umum impor manajemen pengguna

Jika Anda mengalami masalah saat mengunggah file CSV manajemen pengguna, periksa apakah masalahnya tercantum dalam solusi berikut.

Jika Anda memerlukan bantuan terkait penyelesaian masalah pesan kesalahan tertentu, lihat Penyelesaian masalah pesan kesalahan impor.

Mengimpor ulang setelah memperbaiki kesalahan

Saat impor tidak berhasil, Anda akan menerima email yang mencantumkan baris yang gagal. Impor ulang file Anda dengan cermat agar Anda tidak membuat pengguna duplikat.

Impor ulang hanya pengguna yang mengalami kesalahan, bukan seluruh file. Gunakan praktik berikut:

  • Perbaiki baris yang gagal, lalu sertakan setiap baris untuk tiap pengguna yang terdampak ke dalam file baru Anda. Jika pengguna memiliki 3 baris dan 1 baris menyebabkan kesalahan, ketiga baris untuk pengguna tersebut akan ditolak. Sertakan ke-3 baris yang telah diperbaiki dalam impor ulang Anda.
  • Jangan sertakan pengguna yang telah berhasil diimpor. Akun-akun tersebut sudah ada. Mengimpornya lagi dapat menghasilkan kesalahan user already exists, membuat pengguna duplikat, atau keduanya.

Jika Anda mengimpor ulang keseluruhan file asli, termasuk baris untuk pengguna yang sebelumnya telah berhasil dibuat, Anda mungkin akan menemui hasil berikut:

  • Pengguna admin: Jika alamat email sudah digunakan, Anda mungkin akan menerima kesalahan user already exists atau email duplikat.
  • Pengguna POS: Sistem dapat membuat catatan pengguna POS duplikat. Pengguna POS dicocokkan menggunakan nama dan bidang terkait alih-alih email unik, sehingga pengguna kedua dapat terbuat dengan nama dan peran yang sama.
  • Batas pengguna: Jika impor menghitung pengguna yang sudah dibuat, Anda mungkin akan menerima kesalahan batas pengguna. Untuk mempelajari lebih lanjut, lihat jumlah maksimum pengguna untuk masing-masing paket harga.

Membuat beberapa pengguna POS dengan nama yang sama

Jika nilai identifikasi untuk pengguna POS cocok di beberapa baris dalam satu kali impor, termasuk baris yang tidak berurutan, proses impor akan menganggap baris-baris tersebut sebagai pengguna yang sama.

Untuk membuat pengguna POS terpisah dengan given_name dan family_name yang sama dalam satu kali impor, Anda harus memasukkan nilai yang berbeda pada setidaknya satu kolom berikut untuk masing-masing pengguna:

  • email
  • phone

Jika Anda tidak dapat membedakan beberapa pengguna dengan given_name dan family_name yang sama menggunakan nilai yang berbeda untuk email atau phone, Anda harus mengimpor masing-masing pengguna dalam file CSV yang terpisah.

Format file dan ukuran unggah

Masalah berikut berkaitan dengan format atau ukuran file CSV, bukan nilai dalam baris pengguna Anda:

  • Format file salah: File Anda harus berupa file .csv yang disimpan dengan penyandian yang dijelaskan di Membuka dan mengedit file CSV.
  • File terlalu besar: Jika file Anda memiliki banyak baris, bagi menjadi file yang lebih kecil lalu impor satu per satu.

Pengguna POS ditampilkan sebagai beberapa pengguna alih-alih satu pengguna multiperan

Proses impor mencocokkan baris ke pengguna POS yang sama jika user_type, given_name, family_name, email, dan phone cocok di setiap baris untuk orang tersebut. Jika salah satu dari nilai ini berbeda antarbaris, proses impor akan membuat pengguna yang terpisah.

Situasi berikut sering kali menyebabkan pengguna POS duplikat padahal Anda mengharapkan satu pengguna multiperan:

  • Email ada di satu baris, namun tidak di baris lain: Jika Anda menyertakan email pada baris pertama untuk pengguna POS namun membiarkannya kosong pada baris lain, impor akan membuat pengguna terpisah. Sertakan email pada setiap baris untuk pengguna tersebut, atau biarkan kosong pada setiap baris.
  • Salah ketik pada nama: Salah ketik pada baris nama mungkin akan membuat pengguna terpisah. Misalnya, Jane di satu baris dan jane di baris lainnya mungkin dianggap sebagai pengguna yang berbeda jika pencocokannya peka huruf besar/kecil. Tuliskan nama pengguna dengan cara yang sama pada setiap baris.
  • Nomor telepon di satu baris tetapi tidak di baris lainnya: Jika Anda menyertakan phone pada baris pertama untuk pengguna POS tetapi membiarkannya kosong pada baris lainnya, impor akan membuat pengguna yang terpisah. Sertakan phone pada setiap baris untuk pengguna tersebut, atau biarkan kosong di setiap baris.

Untuk menghindari duplikasi pengguna, pastikan user_type, given_name, family_name, email, dan phone identik di setiap baris untuk pengguna POS yang sama dalam file CSV Anda.

Kesalahan batas kursi

Batas kursi berlaku untuk pengguna admin pada paket harga organisasi Anda. Saat Anda menerima kesalahan batas kursi selama proses impor, impor akan menghitung berapa banyak pengguna admin baru yang akan dibuat oleh file Anda, dan memeriksa jumlah tersebut terhadap batas kursi paket Anda. Jika Anda berada pada atau mendekati batas kursi, kurangi jumlah pengguna admin baru dalam CSV Anda, atau tinjau batas pengguna untuk paket harga Anda sebelum Anda melakukan impor lagi.

Ekspor daftar pengguna Anda untuk menemukan pengguna POS ganda

Anda dapat mengekspor daftar pengguna Anda ke file CSV dan membandingkan baris dalam spreadsheet saat menduga ada pengguna POS ganda. Ekspor mencakup stempel waktu yang menunjukkan akun mana yang dibuat lebih dulu.

Untuk mempelajari cara ekspor dikirimkan dan siapa yang dapat mengunduhnya, lihat mengekspor informasi manajemen pengguna Anda sebagai file CSV.

Langkah-langkah:

  1. Dari admin Shopify Anda, buka Pengaturan > Pengguna.

  2. Klik Ekspor.

  3. Pada dialog Ekspor pengguna, klik Ekspor.

  4. Setelah menerima email, klik Unduh file untuk menyimpan CSV ke perangkat Anda.

  5. Buka file di aplikasi spreadsheet, lalu urutkan berdasarkan kolom GIVEN_NAME.

  6. Tinjau pengguna POS dengan nilai nama depan, nama belakang, email, dan telepon yang cocok dalam ekspor yang memiliki waktu CREATED_AT sama atau sangat berdekatan. Akun-akun ini kemungkinan besar merupakan duplikat.

Hapus pengguna POS duplikat secara manual

Anda dapat menghapus akun pengguna POS duplikat secara manual di admin Shopify Anda tanpa menggunakan file CSV.

Langkah-langkah:

  1. Dari admin Shopify Anda, buka Pengaturan > Pengguna.

  2. Pilih akun pengguna duplikat tersebut.

  3. Klik Hapus.

Hapus massal pengguna POS duplikat menggunakan file CSV

Anda dapat menangguhkan akun duplikat melalui impor CSV, lalu menghapus akun yang ditangguhkan tersebut secara massal dari halaman Pengguna di admin Shopify Anda. Menangguhkan akun terlebih dahulu akan membantu Anda mengonfirmasi akun yang dihapus sebelum Anda menghapusnya.

Langkah-langkah:

  1. Ekspor daftar pengguna Anda saat ini.
  2. Identifikasi akun duplikat menggunakan metode perbandingan yang dijelaskan di bagian Mengekspor daftar pengguna untuk membandingkan pengguna POS duplikat.
  3. Untuk setiap akun duplikat, salin nilai id, user_type, email, phone, given_name, dan family_name ke dalam file CSV baru. Gunakan struktur kolom yang sama seperti sampel file CSV manajemen pengguna.
  4. Atur status ke Suspended untuk setiap baris duplikat. Biarkan role_name, group_name, store_name, pos_location_name, all_current_and_future_locations, dan pin tetap kosong.
  5. Impor file CSV untuk menangguhkan pengguna tersebut.
  6. Buka Pengaturan > Pengguna.
  7. Jika tersedia, filter daftar pengguna ke akun yang Ditangguhkan. Pilih akun duplikat yang Anda tangguhkan, lalu hapus secara massal.

Penyelesaian masalah pesan kesalahan impor

Saat impor CSV manajemen pengguna gagal, Anda akan menerima email yang berisi pesan kesalahan dan baris yang terdampak. Bagian berikut menjelaskan arti setiap jenis pesan dan apa yang dapat Anda ubah dalam file CSV Anda sebelum melakukan impor kembali.

Jika Anda masih mengalami masalah dengan impor CSV, silakan hubungi Dukungan Shopify.

Kesalahan file CSV

CSV headers are missing or invalid

File ini tidak memiliki baris header atau header tidak dapat diurai. Gunakan sampel manajemen pengguna dari halaman Impor dan pertahankan baris pertama persis seperti yang disediakan.

CSV file is empty

File ini tidak memiliki baris data di bawah header. Tambahkan minimal satu baris atau konfirmasikan bahwa Anda telah mengekspor atau menyimpan seluruh file.

Missing required CSV headers

Satu kolom atau lebih yang diperlukan hilang. Impor memerlukan header berikut saat mengimpor file CSV manajemen pengguna:

  • id
  • user_type
  • email
  • phone
  • given_name
  • family_name
  • status
  • role_name
  • group_name
  • store_name
  • pos_location_name
  • all_current_and_future_locations
  • pin

Jangan menghapus atau mengganti nama kolom dari file CSV sampel manajemen pengguna.

Found extra CSV headers: [...]

File menyertakan kolom yang tidak ada dalam daftar yang diizinkan. Hapus tajuk apa pun yang tidak disertakan dalam templat file CSV manajemen pengguna.

Kesalahan identifikasi pengguna

user_type must be 'Admin' or 'Point of sale'

Nilai yang ditetapkan untuk user_type tidak diterima. Tetapkan user_type ke Admin atau Point of sale.

Kesalahan pembuatan pengguna admin atau POS

Langkah penyelesaian masalah berikut berlaku jika bidang id bagi pengguna dibiarkan kosong untuk membuat pengguna baru.

Status is required

Di baris pembuatan pengguna, biarkan kolom status kosong. Proses impor yang akan mengatur status untuk Anda. Jika Anda memasukkan nilai di kolom status pada baris pembuatan, maka impor akan gagal untuk pengguna tersebut. Pada baris penangguhan atau pengaktifan kembali, atur status ke Suspended atau Active sebagaimana mestinya.

user_type must be 'Admin' or 'Point of sale'

user_type yang Anda masukkan tidak valid. Anda harus memasukkan Admin atau Point of sale.

Kesalahan pembuatan pengguna admin

Langkah penyelesaian masalah berikut berlaku saat id kosong dan user_type ditetapkan ke Admin.

Email is required

Anda harus memasukkan nilai untuk email di setiap baris saat membuat pengguna admin.

Kesalahan pembuatan pengguna POS

Penyelesaian masalah berikut berlaku jika id kosong dan user_type diatur ke Point of sale.

given_name is required

Anda harus memasukkan nilai untuk given_name bagi setiap baris pengguna POS baru.

family_name is required

Anda harus memasukkan nilai untuk family_name bagi setiap baris pengguna POS baru.

Kesalahan penangguhan pengguna

Penyelesaian masalah berikut berlaku ketika id memiliki nilai dan Anda sedang mengubah status untuk pengguna yang sudah ada.

Suspend operation must have exactly 1 row.

Impor Anda menyertakan lebih dari satu baris yang menangguhkan atau mengaktifkan kembali pengguna yang sama. Sertakan hanya satu baris penangguhan atau pengaktifan kembali per pengguna dalam setiap impor.

Status is required

Bidang status kosong. Anda harus mengaturnya ke Suspended atau Active sebagaimana mestinya.

[...] does not match with user.

Kesalahan ini berarti nilai di baris Anda tidak cocok dengan yang disimpan untuk pengguna yang terkait dengan id di admin Shopify Anda. Konfirmasikan bahwa nilai yang Anda masukkan untuk setiap kolom ini di file CSV Anda sesuai dengan yang tercantum untuk pengguna tersebut di admin Shopify Anda:

  • email
  • given_name
  • family_name
  • phone
  • user_type
Status must be 'suspended' or 'active'.

Atur status ke Suspended atau Active.

[...] must be blank when suspending a user.

Pada baris tempat Anda hanya mengubah status, biarkan bidang berikut tetap kosong:

  • role_name
  • group_name
  • store_name
  • pos_location_name
  • all_current_and_future_locations
  • pin