Importazione di utenti in blocco tramite file CSV

Puoi importare un file CSV dal pannello di controllo Shopify per creare nuovi utenti admin o utenti Point of Sale (POS) per Shopify POS, oltre a gestirne l'accesso al negozio in blocco.

Puoi utilizzare un'importazione CSV per apportare le seguenti modifiche ai tuoi account utente:

• Creare nuovi utenti admin
• Crea nuovi utenti del punto vendita (POS) per Shopify POS con PIN assegnati
• Sospendere e riattivare account utente admin e POS esistenti

Considerazioni per il file CSV di gestione degli utenti

Alcune modifiche agli account utente non sono supportate da un'importazione CSV. Per gli aggiornamenti che non possono essere completati con l'importazione CSV, gestisci gli account utente manualmente nel pannello di controllo Shopify o nell'app Shopify POS. Tieni presente le seguenti considerazioni quando importi utenti tramite un file CSV:

• L'importazione del file CSV non supporta l'eliminazione in blocco degli utenti.
• Non puoi configurare o aggiornare i requisiti di autenticazione a due fattori per gli utenti.
• Non puoi modificare il PIN di un utente esistente per Shopify POS.
• Non puoi creare nuovi ruoli, gruppi o sedi da un'importazione CSV. I nomi dei ruoli, dei gruppi e delle sedi nel file devono corrispondere a quelli già esistenti nel pannello di controllo Shopify.
• Con un'importazione CSV puoi solo sospendere o riattivare gli utenti esistenti. Non puoi modificare il ruolo, il gruppo assegnato, la sede o l'accesso al negozio di un utente esistente.
• Non puoi modificare la tipologia di un utente, ad esempio convertendo un utente solo POS in un utente admin.

Scarica un file CSV di gestione degli utenti di esempio

Un file di esempio include le intestazioni di colonna richieste e dei valori di esempio per ogni colonna. Puoi utilizzarlo come punto di partenza prima di aggiungere i tuoi utenti.

Puoi scaricare e visualizzare un file CSV di esempio per la gestione degli utenti da questa pagina o scaricare un esempio dalla pagina Importa nel pannello di controllo Shopify.

Per scoprire come salvare e modificare i file CSV nella tua app di fogli di calcolo, fai riferimento a Aprire e modificare un file CSV.

Definizioni delle colonne per il file CSV di gestione degli utenti

La tabella seguente elenca ogni colonna nel file CSV di esempio per la gestione degli utenti. Ciascuna definizione spiega come viene utilizzata la colonna quando si creano utenti o quando si sospendono o riattivano utenti esistenti, incluse le differenze tra utenti del pannello di controllo e utenti solo POS.

Crea nuovi utenti in un file CSV

Per creare un nuovo utente, lascia vuoto id in quella riga. Dopo la creazione dell’utente, l’importazione assegna automaticamente un valore a id.

Per concedere agli utenti l’accesso a più di una sede, ruolo o negozio, consulta Assegnazione di più ruoli, sedi e negozi a un utente.

Crea un utente POS

Per creare un utente POS, inserisci un valore per i seguenti campi:

• Inserisci Point of sale in user_type.
• Inserisci given_name e family_name.
• Per impostare le autorizzazioni dell’utente, inserisci un valore per uno dei seguenti campi:
  • role_name e store_name: se la tua organizzazione ha più di un negozio, entrambi i campi sono obbligatori.
  • group_name: disponibile solo con il piano Shopify Plus. Per scoprire come assegnare un gruppo, consulta la sezione Assegnazione di un gruppo a un utente in un file CSV.
• Per impostare l’accesso alla sede, inserisci un valore per i seguenti campi:
  • Per l’accesso a sedi specifiche, inserisci pos_location_name e imposta all_current_and_future_locations su FALSE.
  • Per l’accesso a tutte le sedi, imposta all_current_and_future_locations su TRUE e lascia vuoto pos_location_name.
• Facoltativo: inserisci email, phone o pin. Il PIN deve essere un numero di 4-6 cifre univoco all’interno di un negozio.

Crea un utente del pannello di controllo

Per creare un utente del pannello di controllo, inserisci un valore per i seguenti campi:

• Inserisci Admin in user_type.
• Inserisci email.
• Per impostare le autorizzazioni dell’utente, inserisci un valore per i seguenti campi:
  • role_name e store_name: se la tua organizzazione ha un solo negozio, store_name non è obbligatorio. Se il ruolo è a livello di organizzazione, lascia vuoto store_name.
  • group_name: disponibile solo con il piano Shopify Plus. Per scoprire come assegnare un gruppo, consulta la sezione Assegnazione di un gruppo a un utente in un file CSV.
• Facoltativo: quando role_name è un ruolo di categoria POS, puoi inserire un valore per pin in quella riga. Se non specifichi alcun PIN, l’importazione ne genera uno per l’utente.
• Se role_name è un ruolo di categoria POS, devi impostare l’accesso alla sede per l’utente. Inserisci un valore per i seguenti campi:
  • Per l’accesso a sedi specifiche, inserisci pos_location_name e imposta all_current_and_future_locations su FALSE.
  • Per l’accesso a tutte le sedi, imposta all_current_and_future_locations su TRUE e lascia vuoto pos_location_name.

Sospendi o riattiva utenti esistenti in un file CSV

Puoi sospendere o riattivare un utente esistente aggiungendo una riga per utente al file CSV di gestione degli utenti. Gli utenti sono identificati tramite l’id.

Per sospendere o riattivare un utente esistente, inserisci un valore per i seguenti campi:

• Inserisci l’id dell’utente.
• Inserisci user_type per l’utente.
• Se si tratta di un utente del pannello di controllo, inserisci un valore per i seguenti campi:
  • email: campo obbligatorio.
  • given_name: campo facoltativo. Se inserisci un valore, deve corrispondere al nome dell’utente nel tuo pannello di controllo Shopify.
  • family_name: campo facoltativo. Se inserisci un valore, deve corrispondere al cognome dell’utente nel tuo pannello di controllo Shopify.
  • phone: campo facoltativo. Se inserisci un valore, deve corrispondere al numero di telefono dell’utente nel tuo pannello di controllo Shopify.
• Se si tratta di un utente POS, inserisci un valore per i seguenti campi:
  • given_name: campo obbligatorio.
  • family_name: campo obbligatorio.
  • email: se l’utente ha un’email nel proprio account, questo campo è obbligatorio.
  • phone: se l’utente ha un numero di telefono nel proprio account, questo campo è obbligatorio.
• status: inserisci Suspended per sospendere l’utente o Active per riattivarlo. Puoi sospendere un utente solo quando il suo stato attuale è Active o Inactive nel tuo pannello di controllo Shopify. Puoi riattivare un utente solo quando il suo stato attuale è Suspended.

Assegnazione di più ruoli, sedi e negozi a un utente

Quando crei un nuovo utente, puoi assegnargli più di un ruolo, sede POS e negozio in una singola importazione di file CSV. Ogni combinazione di ruolo, sede o negozio necessita di una propria riga nel file.

Aggiungi una riga per ogni valore che desideri assegnare allo stesso utente. In ogni riga per tale utente, inserisci gli stessi valori di identificazione in modo che l'importazione applichi ogni riga a quell'account utente. Lascia vuoto il campo id in ogni riga. L'importazione assegna l'id dopo la creazione dell'utente.

Valori di identificazione obbligatori in ogni riga

Affinché l'importazione identifichi lo stesso utente, inserisci i seguenti valori in ogni riga del file CSV per quell'utente:

• Per gli utenti admin, è necessario inserire lo stesso email e user_type in ogni riga per quell'utente.
• Per gli utenti POS, in ogni riga devono essere inseriti gli stessi user_type, given_name, family_name, email e phone per tale utente.

Assegnazione di più ruoli a un utente nello stesso negozio

Un singolo utente può ricoprire più di un ruolo nello stesso negozio se ogni ruolo è rappresentato in una riga separata nel file CSV.

Per assegnare a un utente più di un ruolo nello stesso negozio, devi aggiungere una riga per ruolo nel file CSV. In ogni riga, inserisci gli stessi valori di identificazione per quell'utente, quindi includi il valore store_name e role_name esattamente come indicato nel pannello di controllo Shopify.

Assegnazione di più sedi POS nello stesso negozio

Se un utente deve accedere solo a determinate sedi POS in un negozio, elenca ciascuna sede in una riga separata.

Per assegnare a un utente l'accesso a più sedi POS specifiche, devi aggiungere una riga per ogni sede nel file CSV. In ogni riga, inserisci gli stessi valori di identificazione per tale utente, inserisci il pos_location_name riportato nel pannello di controllo Shopify e imposta all_current_and_future_locations su FALSE per ciascuna riga.

Ad esempio, per assegnare a un utente lo stesso ruolo in due sedi specifiche all'interno di uno stesso negozio, aggiungi una riga per sede.

In alternativa, per concedere l'accesso a tutte le sedi attuali e future, usa una singola riga con all_current_and_future_locations impostato su TRUE e lascia vuoto pos_location_name. Usa lo stesso valore TRUE o FALSE in ogni riga per tale utente in quel negozio. Non puoi combinare i due valori tra le righe.

Assegnazione dell'accesso utente su più negozi

Le organizzazioni con più di un negozio possono concedere alla stessa persona l'accesso a ogni negozio di cui ha bisogno.

Quando lo stesso utente necessita di accedere a più di un negozio, utilizza una riga per ogni combinazione di ruolo-negozio-sede. In ogni riga devi inserire gli stessi valori di identificazione per quell'utente, insieme all'esatto store_name elencato nel pannello di controllo Shopify.

Puoi assegnare più ruoli e più sedi POS allo stesso utente per ogni negozio.

Per all_current_and_future_locations e pos_location_name nelle righe di creazione, usa gli stessi schemi di riga descritti in assegnazione di più sedi POS nello stesso negozio. Non puoi impostare all_current_and_future_locations su TRUE quando pos_location_name contiene un valore nella riga.

L'esempio seguente assegna allo stesso utente POS accessi diversi alle sedi in due negozi differenti.

Se si verifica un errore in una riga relativa a un utente, tutte le righe di quell'utente vengono rifiutate. Dopo aver corretto l'errore, includi tutte le righe di quell'utente nell'importazione successiva.

Assegnazione di un gruppo a un utente in un file CSV

I gruppi sono disponibili solo per le organizzazioni con il piano Shopify Plus. Un gruppo racchiude uno o più ruoli, quindi l'assegnazione di un gruppo può concedere a un utente più ruoli contemporaneamente.

Assegnazione di un gruppo o di un ruolo singolo

Ogni riga di un file CSV può assegnare un gruppo o un singolo ruolo, ma non entrambi:

• Per assegnare un gruppo, inserisci il gruppo in group_name e lascia vuoto role_name.
• Per assegnare un singolo ruolo, inserisci il ruolo in role_name e lascia vuoto group_name.

Assegnazione di un gruppo agli utenti idonei

Puoi assegnare un gruppo a un utente quando almeno un ruolo nel gruppo è applicabile al tipo di quell'utente. I ruoli nel gruppo che non si applicano al tipo di utente non vengono concessi, ma non causano un errore. L'assegnazione del gruppo va comunque a buon fine in base ai ruoli applicabili.

Non è possibile assegnare un gruppo che non ha ruoli.

Assegnazione di un gruppo a più negozi e sedi

Nel file CSV devi includere una riga per ogni negozio in cui il gruppo concede un ruolo POS. Su ciascuna di queste righe, devi anche impostare l'accesso alla sede:

• Per l'accesso a sedi specifiche, inserisci pos_location_name e imposta all_current_and_future_locations su FALSE. Per concedere l'accesso a diverse sedi specifiche in un negozio, aggiungi una riga per ogni sede, con lo stesso gruppo e negozio su ciascuna riga.
• Per l’accesso a tutte le sedi, imposta all_current_and_future_locations su TRUE e lascia vuoto pos_location_name.

L'accesso alla sede per un gruppo viene convalidato nello stesso modo di un ruolo POS che non è assegnato tramite un gruppo, includendo il fatto che non può entrare in conflitto con l'accesso alla sede concesso allo stesso utente su un'altra riga.

Impostazione dei PIN durante l'assegnazione di un gruppo

Un PIN segue le stesse regole applicabili agli utenti con più ruoli:

• Inserisci un pin solo su una riga del file CSV per un negozio in cui il gruppo concede un ruolo POS.
• Un PIN deve essere univoco all'interno di un negozio, ma può essere diverso da un negozio all'altro.
• Non inserire un pin su una riga per un negozio in cui il gruppo concede solo ruoli non POS.

Assegnazione di un gruppo che include un ruolo organizzazione

Quando un gruppo include un ruolo organizzazione con autorizzazioni POS, il ruolo organizzazione concede automaticamente l'accesso a tutte le sedi, quindi il requisito di sede per ciascun negozio non si applica. Puoi assegnare questo tipo di gruppo in uno dei seguenti modi:

• Una singola riga di solo gruppo: inserisci il gruppo in group_name e lascia vuoti store_name, pos_location_name, all_current_and_future_locations e pin. Il ruolo organizzazione concede automaticamente l'accesso a tutte le sedi.
• Righe esplicite del negozio: aggiungi una riga per ogni negozio in cui il gruppo concede un ruolo POS. In ciascuna di queste righe, imposta all_current_and_future_locations su TRUE. Non puoi limitare un utente con un ruolo organizzazione a una singola sede.

Esempi di assegnazione di un gruppo

Gli esempi seguenti mostrano come assegnare un gruppo a negozi e sedi diverse. Ogni riga elenca i valori di group_name, store_name, pos_location_name e all_current_and_future_locations.

Negli esempi seguenti, il gruppo concede un ruolo per il negozio e un ruolo POS nel Negozio 1, e un ruolo POS nel Negozio 2:

• L'Esempio 1 assegna il gruppo con accesso a tutte le sedi in due negozi. Poiché il gruppo concede un ruolo POS in ogni negozio, è necessario aggiungere una riga per negozio nel file CSV.

• L'Esempio 2 assegna il gruppo in due negozi, ma il gruppo concede un ruolo POS solo nel Negozio 1 e un ruolo solo negozio nel Negozio 2. Aggiungi una riga nel file CSV solo per il negozio con un ruolo POS. Il ruolo solo negozio nel Negozio 2 viene concesso senza una riga.

• L'Esempio 3 assegna il gruppo con l'accesso a sedi specifiche in due negozi. Devi aggiungere una riga nel file CSV per ogni sede.

• L'Esempio 4 assegna un gruppo che include un ruolo organizzazione con autorizzazioni POS, oltre a un ruolo negozio e a un ruolo POS. Puoi assegnare questo gruppo in uno dei modi seguenti:

  • La prima opzione è una singola riga solo gruppo, in cui il ruolo organizzazione concede l'accesso a tutte le sedi.
  • La seconda opzione usa una riga esplicita per ogni negozio in cui il gruppo concede un ruolo POS. In ogni riga, all_current_and_future_locations deve essere TRUE, perché il ruolo organizzazione non può essere limitato a una singola sede.

Importa un file CSV per la gestione degli utenti dal pannello di controllo Shopify

Dopo aver creato il file CSV e averlo salvato nel formato corretto, puoi caricarlo dalla pagina Utenti della tua organizzazione. L'importazione viene eseguita nel pannello di controllo Shopify e segnala le eventuali righe che non è possibile elaborare.

Procedura:

1. Dal pannello di controllo Shopify vai a Impostazioni > Utenti.

2. Clicca su Importa.

3. Facoltativo: clicca sul link per scaricare un file CSV di esempio, quindi utilizzalo come modello per il tuo file.

4. Clicca su Carica file, quindi seleziona il file .csv.

Al termine dell'importazione, controlla la conferma nel pannello di controllo Shopify. Se sono presenti righe con errori, riceverai un'email con i dettagli per poter correggere il file e importarlo nuovamente.

Soluzioni ai problemi comuni di importazione per la gestione utenti

Se riscontri un problema nel caricamento del file CSV di gestione utenti, verifica se il problema è presente tra le soluzioni seguenti.

Quando hai bisogno di assistenza per la risoluzione dei problemi relativi a un messaggio di errore specifico, consulta Risoluzione dei problemi relativi ai messaggi di errore di importazione.

Reimportazione dopo aver corretto gli errori

Se un'importazione non va a buon fine, ricevi un'email che elenca le righe non elaborate. Reimporta il file con attenzione in modo da non creare utenti duplicati.

Reimporta solo gli utenti che presentavano errori, non l'intero file. Adotta le seguenti pratiche:

• Correggi le righe non elaborate, quindi includi ogni riga per ciascun utente interessato nel nuovo file. Se un utente aveva 3 righe e 1 riga ha causato un errore, tutte e 3 le righe per quell'utente sono state rifiutate. Includi tutte e 3 le righe corrette nella reimportazione.
• Non includere gli utenti importati con successo. Tali account esistono già. Importarli nuovamente può restituire l'errore user already exists, creare utenti duplicati o causare entrambi i problemi.

Se reimporti l'intero file originale, incluse le righe degli utenti già creati correttamente, potresti riscontrare i seguenti risultati:

• Utenti amministrativi: se un indirizzo email è già in uso, potresti ricevere l'errore user already exists o un errore di email duplicata.
• Utenti POS: il sistema può creare record di utenti POS duplicati. Gli utenti POS vengono abbinati tramite nome e campi correlati al posto di un'email univoca; di conseguenza, potrebbe essere creato un secondo utente con lo stesso nome e ruolo.
• Limiti di utenze: se l'importazione conteggia utenti che erano già stati creati, potresti ricevere errori per i limiti di utenze. Per saperne di più, consulta la sezione numero massimo di utenti per ogni piano tariffario.

Creazione di più utenti POS con lo stesso nome

Se i valori di identificazione di un utente POS corrispondono su più righe in un'importazione, incluse le righe non consecutive, l'importazione tratta quelle righe come lo stesso utente.

Per creare utenti POS distinti con lo stesso given_name e family_name in un'unica importazione, devi inserire un valore diverso in almeno uno dei campi seguenti per ogni utente:

• email
• phone

Se non riesci a distinguere più utenti con lo stesso given_name e family_name usando valori diversi per email o phone, devi importare ciascun utente in un file CSV separato.

Formato del file e dimensioni di caricamento

I problemi seguenti riguardano il formato o le dimensioni del file CSV, non i valori nelle righe degli utenti:

• Formato di file errato: il file deve essere in formato .csv, salvato con la codifica descritta in Aprire e modificare un file CSV.
• File troppo grande: se il file ha molte righe, suddividilo in file più piccoli e importali uno alla volta.

L'utente POS viene visualizzato come più utenti anziché come un utente multiruolo

L'importazione associa le righe allo stesso utente POS quando user_type, given_name, family_name, email e phone corrispondono in ogni riga per tale persona. Se uno qualsiasi di questi valori è diverso tra le righe, l'importazione crea utenti separati.

Le situazioni seguenti portano spesso a utenti POS duplicati quando ci si aspetterebbe un solo utente multiruolo:

• Email presente in una riga ma non in un'altra: se includi email nella prima riga per un utente POS ma la lasci vuota in un'altra, l'importazione crea utenti separati. Inserisci l'email in ogni riga per quell'utente, o lasciala vuota in tutte le righe.
• Errore di battitura nel nome: un refuso nelle righe del nome potrebbe creare utenti separati. Ad esempio, Jane in una riga e jane in un'altra potrebbero essere considerati come utenti diversi se l'abbinamento fa distinzione tra maiuscole e minuscole. Scrivi il nome dell'utente allo stesso modo in ogni riga.
• Phone in una riga ma non in un'altra: se includi phone nella prima riga di un utente POS ma lo lasci vuoto in un'altra riga, l'importazione crea utenti separati. Includi phone in ogni riga per quell'utente oppure lascialo vuoto in tutte le righe.

Per evitare di duplicare gli utenti, assicurati che user_type, given_name, family_name, email e phone siano identici in ogni riga per lo stesso utente POS nel file CSV.

Errori sul limite di postazioni

I limiti di postazioni si applicano agli utenti del pannello di controllo nel piano di abbonamento dell’organizzazione. Quando ricevi un errore sul limite di postazioni durante un’importazione, l’importazione conta quanti nuovi utenti del pannello di controllo creerebbe il file e confronta tale numero con il limite di postazioni del piano. Se hai raggiunto o sei vicino al limite di postazioni, riduci il numero di nuovi utenti del pannello di controllo nel CSV o controlla i limiti per gli utenti del piano di abbonamento prima di importare di nuovo.

Esporta l’elenco degli utenti per trovare utenti POS duplicati

Puoi esportare l’elenco degli utenti in un file CSV e confrontare le righe in un foglio di calcolo se sospetti la presenza di utenti POS duplicati. L’esportazione include timestamp che indicano quale account è stato creato per primo.

Per scoprire come vengono consegnate le esportazioni e chi può scaricarle, fai riferimento all’esportazione delle informazioni sulla gestione degli utenti in un file CSV.

Procedura:

1. Dal pannello di controllo Shopify vai a Impostazioni > Utenti.

2. Clicca su Esporta.

3. Nella finestra di dialogo Esporta utenti, clicca su Esporta.

4. Quando ricevi l’email, clicca su Scarica file per salvare il CSV sul dispositivo.

5. Apri il file in un’app per fogli di calcolo, quindi ordinalo in base alla colonna GIVEN_NAME.

6. Esamina gli utenti POS nell’esportazione che presentano valori corrispondenti per nome, cognome, email e telefono e che hanno tempi CREATED_AT uguali o molto simili. Questi account sono probabilmente dei duplicati.

Elimina manualmente gli utenti POS duplicati

Puoi rimuovere manualmente un account utente POS duplicato nel pannello di controllo Shopify senza utilizzare un file CSV.

Procedura:

1. Dal pannello di controllo Shopify vai a Impostazioni > Utenti.

2. Seleziona l’account utente duplicato.

3. Clicca su Rimuovi.

Elimina in blocco gli utenti POS duplicati utilizzando un file CSV

Puoi sospendere gli account duplicati tramite un’importazione CSV e in seguito eliminare tali account sospesi in blocco dalla pagina Utenti nel pannello di controllo Shopify. Sospendere gli account prima dell’eliminazione aiuta a confermare quali account si stanno per rimuovere.

Procedura:

1. Esporta l’elenco degli utenti attuale.
2. Individua gli account duplicati utilizzando il metodo di confronto descritto in Esporta l’elenco degli utenti per confrontare gli utenti POS duplicati.
3. Per ogni account duplicato, copia i valori di id, user_type, email, phone, given_name e family_name in un nuovo file CSV. Usa la stessa struttura di colonne del file CSV di esempio per la gestione degli utenti.
4. Imposta status su Suspended per ogni riga duplicata. Lascia vuoti role_name, group_name, store_name, pos_location_name, all_current_and_future_locations e pin.
5. Importa il file CSV per sospendere questi utenti.
6. Vai a Impostazioni > Utenti.
7. Se disponibile, filtra l’elenco degli utenti per gli account Sospesi. Seleziona gli account duplicati che hai sospeso ed eliminali in blocco.

Risoluzione dei problemi per i messaggi di errore di importazione

Quando l’importazione di un file CSV per la gestione degli utenti non va a buon fine, ricevi un’email che include il messaggio di errore e le righe interessate. Le sezioni seguenti spiegano cosa significa ogni tipo di messaggio e cosa puoi modificare nel file CSV prima di ripetere l’importazione.

Se continui a riscontrare problemi con l’importazione del file CSV, contatta l’Assistenza Shopify.

Errori nel file CSV

Errori di identificazione utente

Errori nella creazione di utenti admin o POS

La seguente procedura per la risoluzione dei problemi si applica quando il campo id dell’utente è vuoto per creare un nuovo utente.

Errori nella creazione di utenti admin

La seguente procedura per la risoluzione dei problemi si applica quando l’id è vuoto e user_type è impostato su Admin.

Errori di creazione di utenti POS

La seguente risoluzione dei problemi si applica quando id è vuoto e user_type è impostato su Point of sale.

Errori di sospensione degli utenti

La seguente risoluzione dei problemi si applica quando id contiene un valore e stai modificando status per un utente esistente.