Importar usuários em massa com um arquivo CSV

É possível importar um arquivo CSV pelo admin da Shopify para criar novos usuários do admin ou usuários de ponto de venda (POS) para o Shopify POS e gerenciar o acesso deles à loja em massa.

Use a importação por CSV para fazer as seguintes alterações nas contas de usuário:

• Criar novos usuários do admin
• Criar novos usuários do ponto de venda (POS) para o Shopify POS com PINs atribuídos
• Suspender e reativar contas de usuário existentes do admin e do POS

Considerações para o arquivo CSV de gerenciamento de usuários

Algumas alterações em contas de usuário não são compatíveis com a importação por arquivo CSV. Para atualizações que esse recurso não consegue concluir, gerencie as contas de usuário manualmente no admin da Shopify ou no app Shopify POS. Analise as seguintes considerações ao importar usuários usando um arquivo CSV:

• A importação de arquivo CSV não é compatível com a exclusão de usuários em massa.
• Não é possível definir nem atualizar os requisitos de autenticação de dois fatores para os usuários.
• Não é possível alterar o PIN do Shopify POS de um usuário existente.
• Não é possível criar funções, grupos ou locais com a importação por CSV. Os nomes de funções, grupos e locais no arquivo precisam corresponder ao que já existe no admin da Shopify.
• Com a importação por arquivo CSV, só é possível suspender ou reativar usuários já existentes. Não é possível alterar a função, o grupo atribuído, o local ou o acesso à loja de um usuário existente.
• Não é possível alterar o tipo de um usuário, como transformar um usuário apenas de POS em um usuário do admin.

Fazer download de um arquivo CSV de gerenciamento de usuários de exemplo

Um arquivo de exemplo inclui os cabeçalhos de coluna obrigatórios e valores de exemplo para cada coluna. É possível usá-lo como um ponto de partida antes de adicionar seus próprios usuários.

É possível fazer download e visualizar um exemplo de arquivo CSV de gerenciamento de usuários nesta página, ou fazer download de um exemplo na página Importar no admin da Shopify.

Para saber como salvar e editar arquivos CSV no app de planilha, consulte Abrir e editar um arquivo CSV.

Definições das colunas do arquivo CSV de gerenciamento de usuários

A tabela a seguir lista todas as colunas no arquivo CSV de gerenciamento de usuários de exemplo. Cada definição explica como a coluna é usada ao criar usuários ou ao suspender ou reativar usuários existentes, incluindo as diferenças entre os usuários do admin e os usuários apenas de POS.

Criar novos usuários em um arquivo CSV

Para criar um novo usuário, deixe o id em branco nessa linha. Depois que o usuário é criado, a importação atribui automaticamente um valor ao id.

Para conceder aos usuários acesso a mais de um local, função ou loja, consulte Atribuir várias funções, locais e lojas a um usuário.

Criar um usuário do POS

Para criar um usuário do POS, insira um valor nos seguintes campos:

• Insira Point of sale em user_type.
• Insira given_name e family_name.
• Para definir as permissões de usuário, insira um valor em um dos seguintes campos:
  • role_name e store_name: se a organização tiver mais de uma loja, ambos os campos serão obrigatórios.
  • group_name: disponível apenas no plano Shopify Plus. Para saber como atribuir um grupo, consulte Atribuir um grupo a um usuário em um arquivo CSV.
• Para configurar o acesso a locais, insira um valor nos seguintes campos:
  • Para acessar locais específicos, insira pos_location_name e defina all_current_and_future_locations como FALSE.
  • Para acessar todos os locais, defina all_current_and_future_locations como TRUE e deixe pos_location_name em branco.
• Opcional: insira email, phone ou pin. O PIN precisa ser um número de 4 a 6 dígitos e exclusivo na loja.

Criar um usuário do admin

Para criar um usuário do admin, insira um valor nos seguintes campos:

• Insira Admin em user_type.
• Insira email.
• Para definir as permissões de usuário, insira um valor nos seguintes campos:
  • role_name e store_name: se a organização tiver apenas uma loja, não será obrigatório preencher store_name. Caso a função seja no nível da organização, deixe store_name em branco.
  • group_name: disponível apenas no plano Shopify Plus. Para saber como atribuir um grupo, consulte Atribuir um grupo a um usuário em um arquivo CSV.
• Opcional: quando role_name for uma função da categoria POS, insira um valor para pin nessa linha. Se não especificar um PIN, a importação gerará um PIN para o usuário.
• Se role_name for uma função da categoria POS, é preciso definir o acesso a locais do usuário. Insira um valor nos seguintes campos:
  • Para acessar locais específicos, insira pos_location_name e defina all_current_and_future_locations como FALSE.
  • Para acessar todos os locais, defina all_current_and_future_locations como TRUE e deixe pos_location_name em branco.

Suspender ou reativar usuários existentes em um arquivo CSV

É possível suspender ou reativar um usuário existente adicionando uma linha por usuário ao arquivo CSV de gerenciamento de usuários. Os usuários são identificados por id.

Para suspender ou reativar um usuário existente, insira um valor nos seguintes campos:

• Insira o id do usuário.
• Insira o user_type do usuário.
• Se for um usuário do admin, insira um valor nos seguintes campos:
  • email: obrigatório.
  • given_name: opcional. O valor inserido precisa ser igual ao nome do usuário no admin da Shopify.
  • family_name: opcional. O valor inserido precisa ser igual ao sobrenome do usuário no admin da Shopify.
  • phone: opcional. O valor inserido precisa ser igual ao número de telefone do usuário no admin da Shopify.
• Se for um usuário do POS, insira um valor nos seguintes campos:
  • given_name: obrigatório.
  • family_name: obrigatório.
  • email: campo obrigatório se o usuário tiver um e-mail na conta.
  • phone: campo obrigatório se o usuário tiver um número de telefone na conta.
• status: insira Suspended para suspender o usuário ou Active para reativá-lo. Só é possível suspender um usuário quando o status atual for Active ou Inactive no admin da Shopify. A reativação só é possível para usuários com o status atual Suspended.

Atribuir várias funções, locais e lojas a um usuário

Ao criar um novo usuário, é possível atribuir a ele mais de uma função, loja e local de POS na importação de um único arquivo CSV. Cada combinação de função, local ou loja requer uma linha própria no arquivo.

Adicione uma linha para cada valor que você quer atribuir ao mesmo usuário. Em todas as linhas referentes a ele, insira os mesmos valores de identificação para que a importação aplique todas as linhas à mesma conta de usuário. Deixe o campo id em branco em todas as linhas. A importação atribui o id depois que o usuário é criado.

Valores de identificação obrigatórios em todas as linhas

Para que a importação identifique o mesmo usuário, insira os seguintes valores em todas as linhas do arquivo CSV referentes a ele:

• Para os usuários do admin, os mesmos campos email e user_type precisam ser inseridos em todas as linhas referentes ao usuário.
• Para usuários do POS, os mesmos user_type, given_name, family_name, email e phone devem ser inseridos para esse usuário em todas as linhas.

Atribuir várias funções a um usuário na mesma loja

Um único usuário pode ter mais de uma função na mesma loja quando cada função for representada em uma linha própria no arquivo CSV.

Para atribuir mais de uma função na mesma loja a um usuário, adicione uma linha por função no arquivo CSV. Em todas as linhas, insira os mesmos valores de identificação referentes ao usuário e, em seguida, inclua os campos store_name e role_name exatamente como constam no admin da Shopify.

Atribuir vários locais de POS na mesma loja

Quando um usuário precisar acessar apenas determinados locais de POS em uma loja, liste cada local em uma linha separada.

Para atribuir acesso a vários locais de POS específicos a um usuário, é necessário adicionar uma linha por local no arquivo CSV. Em cada linha, insira os mesmos valores de identificação para esse usuário, insira o pos_location_name listado no admin da Shopify e defina all_current_and_future_locations como FALSE em cada linha.

Por exemplo, para conceder a um usuário a mesma função em dois locais específicos de uma loja, adicione uma linha por local.

Como alternativa, para conceder acesso a todos os locais atuais e futuros, use uma única linha com all_current_and_future_locations definido como TRUE e deixe pos_location_name em branco. Use o mesmo valor TRUE ou FALSE em todas as linhas para esse usuário na respectiva loja. Não é possível misturá-los entre as linhas.

Atribuir acesso a pessoas usuárias em várias lojas

Organizações com mais de uma loja podem conceder à mesma pessoa acesso a cada loja, conforme necessário.

Quando a mesma pessoa usuária precisar de acesso a mais de uma loja, use uma linha por combinação de função, loja e local. Em cada linha, insira os mesmos valores de identificação da pessoa usuária, além do nome exato indicado para store_name no admin da Shopify.

É possível atribuir várias funções e vários locais de POS à mesma pessoa usuária em cada loja.

Para all_current_and_future_locations e pos_location_name nas linhas de criação, use os mesmos padrões de linha usados para atribuir vários locais de POS na mesma loja. Não é possível definir all_current_and_future_locations como TRUE quando pos_location_name tiver um valor na linha.

O exemplo a seguir atribui o mesmo usuário de POS com acesso a locais distintos em duas lojas diferentes.

Se alguma linha de uma pessoa usuária falhar, todas as linhas dela serão rejeitadas. Após corrigir o erro, inclua todas as linhas dessa pessoa usuária na próxima importação.

Atribuir um grupo a um usuário em um arquivo CSV

Os grupos estão disponíveis apenas para organizações no plano Shopify Plus. Um grupo reúne uma ou mais funções; portanto, a atribuição de um grupo pode conceder várias funções a um usuário ao mesmo tempo.

Atribuir um grupo ou uma função única

Cada linha em um arquivo CSV pode atribuir um grupo ou uma função única, mas não ambos:

• Para atribuir um grupo, insira-o em group_name e deixe role_name em branco.
• Para atribuir uma função única, insira-a em role_name e deixe group_name em branco.

Atribuir um grupo a usuários qualificados

É possível atribuir um grupo a um usuário quando ao menos uma função no grupo se aplica ao tipo desse usuário. As funções no grupo que não se aplicam ao tipo de usuário não são concedidas, mas também não causam erro. O grupo ainda é atribuído com sucesso de acordo com as funções aplicáveis.

Não é possível atribuir um grupo sem funções.

Atribuir um grupo em lojas e locais

É necessário incluir uma linha no arquivo CSV para cada loja em que o grupo conceda uma função de POS. Além disso, em cada uma dessas linhas, defina o acesso aos locais:

• Para ter acesso a locais específicos, insira pos_location_name e defina all_current_and_future_locations como FALSE. Para conceder acesso a vários locais específicos em uma loja, adicione uma linha por local, com o mesmo grupo e loja em cada linha.
• Para acessar todos os locais, defina all_current_and_future_locations como TRUE e deixe pos_location_name em branco.

O acesso a locais para um grupo é validado da mesma forma que uma função de POS que não é atribuída por meio de um grupo. Isso inclui a regra de não entrar em conflito com o acesso a locais concedido ao mesmo usuário em outra linha.

Definir PINs ao atribuir um grupo

Um PIN segue as mesmas regras aplicáveis a usuários com várias funções:

• Insira um pin apenas na linha do arquivo CSV referente a uma loja na qual o grupo conceda uma função de POS.
• Um PIN precisa ser exclusivo na loja, mas pode ser diferente em lojas distintas.
• Não insira um pin na linha referente a uma loja em que o grupo conceda apenas funções não relacionadas a POS.

Atribuir um grupo que inclua uma função na organização

Quando um grupo inclui uma função na organização com permissões de POS, ela concede automaticamente o acesso a todos os locais, não se aplicando assim o requisito de localização por loja. É possível atribuir esse tipo de grupo de uma das seguintes maneiras:

• Uma única linha apenas para o grupo: insira o grupo em group_name e deixe store_name, pos_location_name, all_current_and_future_locations e pin em branco. A função na organização concede acesso a todos os locais de forma automática.
• Linhas explícitas de lojas: adicione uma linha para cada loja em que o grupo conceda uma função de POS. Em todas elas, defina all_current_and_future_locations como TRUE. Não é possível limitar a um único local um usuário com uma função na organização.

Exemplos de atribuição de grupo

Os exemplos a seguir ilustram como atribuir um grupo a diferentes lojas e locais. Cada linha lista os valores de group_name, store_name, pos_location_name e all_current_and_future_locations.

Nos exemplos a seguir, o grupo concede uma função na loja e uma função de POS na Loja 1, bem como uma função de POS na Loja 2:

• O Exemplo 1 atribui o grupo com acesso a todos os locais em duas lojas. Como o grupo concede uma função de POS em cada loja, é necessário adicionar uma linha por loja no arquivo CSV.

• O Exemplo 2 atribui o grupo a duas lojas, mas o grupo concede uma função de POS apenas na Loja 1 e uma função apenas da loja na Loja 2. Adicione uma linha no arquivo CSV apenas para a loja com uma função de POS. A função apenas da loja na Loja 2 é concedida sem uma linha.

• O Exemplo 3 atribui o grupo com acesso a locais específicos em duas lojas. É necessário adicionar uma linha no arquivo CSV por local.

• O Exemplo 4 atribui um grupo que inclui uma função da organização com permissões de POS, além de uma função da loja e uma função de POS. É possível atribuir esse grupo de uma das seguintes maneiras:

  • A primeira opção é uma única linha exclusiva do grupo, em que a função da organização concede acesso a todos os locais.
  • A segunda opção usa uma linha explícita para cada loja em que o grupo concede uma função de POS. Em cada linha, all_current_and_future_locations deve ser TRUE, porque a função da organização não pode ser limitada a um único local.

Importar um arquivo CSV de gerenciamento de usuários no admin da Shopify

Após compilar e salvar o arquivo CSV no formato correto, é possível fazer upload dele na página Pessoas usuárias da organização. A importação é executada no admin da Shopify e relata as linhas que não podem ser processadas.

Passos:

1. No admin da Shopify, acesse Configurações > Pessoas usuárias.

2. Clique em Importar.

3. Opcional: clique no link para fazer download de um exemplo de arquivo CSV e usá-lo como modelo do seu próprio arquivo.

4. Clique em Fazer upload de arquivo e selecione o arquivo .csv.

Após a conclusão da importação, confira a confirmação no admin da Shopify. Se houver erro em alguma linha, você receberá um e-mail com as informações para poder corrigir o arquivo e importá-lo de novo.

Soluções de problemas comuns na importação do gerenciamento de pessoas usuárias

Caso tenha algum problema ao fazer upload do arquivo CSV de gerenciamento de pessoas usuárias, verifique se a solução está listada abaixo.

Quando precisar de ajuda com a solução de problemas de uma mensagem de erro específica, consulte Solução de problemas de mensagens de erro de importação.

Reimportação após a correção de erros

Quando uma importação falha, você recebe um e-mail com a lista de linhas com problemas. Faça a reimportação do arquivo com cuidado para evitar a criação de pessoas usuárias duplicadas.

Reimporte apenas as pessoas usuárias que apresentaram erros, não o arquivo inteiro. Use as seguintes práticas:

• Corrija as linhas com problema e inclua todas as linhas de cada pessoa usuária afetada no novo arquivo. Se uma pessoa tiver 3 linhas e uma delas causar um erro, as 3 serão rejeitadas. Por isso, é preciso incluir essas 3 linhas corrigidas na nova importação.
• Não inclua as pessoas usuárias importadas com sucesso, pois as contas delas já existem. Importá-las de novo pode retornar o erro user already exists, criar pessoas usuárias duplicadas ou ambas as situações.

Se você reimportar o arquivo original inteiro, incluindo as linhas das pessoas usuárias criadas com sucesso, poderá se deparar com os seguintes resultados:

• Pessoas usuárias do admin: se um endereço de e-mail já estiver em uso, você poderá receber o erro user already exists ou o de e-mail duplicado.
• Pessoas usuárias do POS: o sistema pode criar registros duplicados dessas pessoas, já que elas são pareadas por nome e campos relacionados, em vez de um e-mail exclusivo. Por esse motivo, uma segunda pessoa usuária pode ser criada com o mesmo nome e a mesma função.
• Limites de vagas: caso a importação contabilize pessoas usuárias já criadas, você poderá receber erros de limite de vagas. Para saber mais, consulte o número máximo de pessoas usuárias de cada plano de preços.

Criar vários usuários do POS com o mesmo nome

Se os valores de identificação de um usuário do POS coincidirem em várias linhas de uma importação, inclusive em linhas não consecutivas, a importação tratará essas linhas como sendo do mesmo usuário.

Para criar usuários do POS distintos com o mesmo given_name e family_name em uma mesma importação, é necessário inserir um valor diferente para pelo menos um dos seguintes campos de cada usuário:

• email
• phone

Se não for possível distinguir vários usuários com o mesmo given_name e family_name usando valores diferentes para email ou phone, será necessário importar cada um deles em um arquivo CSV separado.

Formato do arquivo e tamanho do upload

Os problemas a seguir estão relacionados ao formato ou tamanho do arquivo CSV, não aos valores nas linhas das pessoas usuárias:

• Formato de arquivo incorreto: é necessário usar um arquivo .csv salvo com a codificação descrita em Abrir e editar um arquivo CSV.
• Arquivo muito grande: se o arquivo tiver muitas linhas, divida-o em arquivos menores e importe um de cada vez.

A pessoa usuária do POS é exibida como várias pessoas, em vez de apenas uma com diversas funções

A importação faz a correspondência de linhas com o mesmo usuário do POS quando user_type, given_name, family_name, email e phone forem iguais em todas as linhas dessa pessoa. Se qualquer um desses valores for diferente entre as linhas, a importação criará usuários separados.

As situações a seguir costumam levar à duplicação de pessoas usuárias do POS, quando se espera apenas uma com diversas funções:

• E-mail em uma linha, mas não em outra: se você incluir email na primeira linha de uma pessoa usuária do POS, mas deixar em branco em outra, a importação criará pessoas usuárias separadas. Inclua email em todas as linhas dessa pessoa ou deixe em branco em todas elas.
• Erro de digitação no nome: um erro de digitação nas linhas de nome pode criar pessoas usuárias separadas. Por exemplo, Jane em uma linha e jane em outra podem ser tratadas como pessoas diferentes, caso haja distinção entre maiúsculas e minúsculas. Escreva o nome da pessoa da mesma forma em todas as linhas.
• Telefone em uma linha, mas não em outra: se você incluir phone na primeira linha de um usuário do POS, mas deixar o campo em branco em outra, a importação criará usuários separados. Inclua phone em todas as linhas desse usuário ou deixe o campo em branco em todas elas.

Para evitar a duplicação de usuários, certifique-se de que user_type, given_name, family_name, email e phone sejam idênticos em todas as linhas para o mesmo usuário do POS no arquivo CSV.

Erros de limite de licenças

Os limites de licenças se aplicam aos usuários do admin no plano da sua organização. Quando você recebe um erro de limite de licença durante uma importação, o sistema conta quantos novos usuários do admin o arquivo criaria e verifica esse número em relação ao limite do plano. Se você estiver no limite ou perto dele, reduza o número de novos usuários do admin no CSV ou revise os limites de usuários do seu plano antes de importar novamente.

Exporte a lista de usuários para encontrar usuários duplicados do POS

É possível exportar a lista de usuários para um arquivo CSV e comparar as linhas em uma planilha quando houver suspeita de usuários duplicados do POS. A exportação inclui marcações de data e hora que indicam qual conta foi criada primeiro.

Para saber como as exportações são entregues e quem pode fazer o download delas, consulte a seção Exportar as informações de gerenciamento de usuários como um arquivo CSV.

Passos:

1. No admin da Shopify, acesse Configurações > Pessoas usuárias.

2. Clique em Exportar.

3. Na caixa de diálogo Exportar usuários, clique em Exportar.

4. Ao receber o e-mail, clique em Fazer download do arquivo para salvar o CSV no seu dispositivo.

5. Abra o arquivo em um app de planilha e classifique-o pela coluna GIVEN_NAME.

6. Analise os usuários do POS com valores correspondentes de nome, sobrenome, e-mail e telefone na exportação que tenham horários CREATED_AT iguais ou muito próximos. Provavelmente, essas contas estão duplicadas.

Excluir usuários duplicados do POS manualmente

É possível remover a conta duplicada de um usuário do POS manualmente no admin da Shopify sem usar um arquivo CSV.

Passos:

1. No admin da Shopify, acesse Configurações > Pessoas usuárias.

2. Selecione a conta de usuário duplicada.

3. Clique em Remover.

Excluir usuários duplicados do POS em massa usando um arquivo CSV

É possível suspender contas duplicadas com uma importação de CSV e, em seguida, excluir essas contas suspensas em massa na página Usuários do admin da Shopify. A suspensão prévia ajuda a confirmar as contas que serão removidas antes da exclusão.

Passos:

1. Exporte a lista de usuários atual.
2. Identifique as contas duplicadas usando o método de comparação descrito em Exportar a lista de usuários para comparar os usuários duplicados do POS.
3. Para cada conta duplicada, copie os valores de id, user_type, email, phone, given_name e family_name em um novo arquivo CSV. Use a mesma estrutura de coluna que o exemplo de arquivo CSV de gerenciamento de usuários.
4. Defina status como Suspended para cada linha duplicada. Deixe role_name, group_name, store_name, pos_location_name, all_current_and_future_locations e pin em branco.
5. Importe o arquivo CSV para suspender esses usuários.
6. Acesse Configurações > Usuários.
7. Se disponível, filtre a lista de usuários para exibir apenas as contas Suspensas. Selecione as contas duplicadas que você suspendeu e as exclua em massa.

Solução de problemas de mensagens de erro de importação

Quando a importação de um CSV de gerenciamento de usuários falha, você recebe um e-mail com a mensagem de erro e as linhas afetadas. As seções a seguir explicam o significado de cada tipo de mensagem e o que pode ser alterado no arquivo CSV antes de importar novamente.

Se você ainda tiver problemas com a importação do CSV, entre em contato com o Suporte da Shopify.

Erros no arquivo CSV

Erros de identificação de usuário

Erros na criação de usuário do admin ou do POS

A solução de problemas a seguir se aplica quando o campo id do usuário está em branco para a criação de um novo usuário.

Erros na criação de usuário do admin

A solução de problemas a seguir se aplica quando o campo id está em branco e o user_type está definido como Admin.

Erros na criação de usuários do POS

A solução de problemas a seguir se aplica quando o id está em branco e o user_type está definido como Point of sale.

Erros na suspensão de usuários

A solução de problemas a seguir se aplica quando o id tiver um valor e você estiver alterando o status de um usuário existente.