Ajuda
Fazer login

Importação de produtos com um arquivo CSV

Importar produtos para sua loja na Shopify com um arquivo de valores separados por vírgula (CSV) é útil quando você migra de outra plataforma para a Shopify ou quando quer fazer muitas alterações nos produtos ou no estoque.

Ao importar produtos, os dados do arquivo CSV são convertidos em produtos, e é possível selecionar se você quer publicar os novos produtos em todos os canais de vendas ou apenas na loja virtual.

Nesta página

Antes de começar

Antes de importar produtos com um arquivo CSV, leia os seguintes tópicos:

As importações de produtos por arquivo CSV não podem ser canceladas após iniciadas, e não é possível ver um histórico de importações anteriores. Para analisar as alterações recentes feitas por uma importação, consulte o log de atividades da loja.

Testar importações com uma loja de desenvolvimento

Se você é um parceiro da Shopify e está realizando uma importação em grande escala para um lojista, teste primeiro um pequeno subconjunto de alterações em uma loja de desenvolvimento antes de realizar o trabalho de importação completo.

Considerações para sobrescrever as informações do produto com um arquivo de importação CSV

Ao importar um arquivo CSV, é possível selecionar a opção Sobrescrever produtos com identificadores correspondentes. Se você selecionar essa opção, quando um identificador no arquivo CSV de importação corresponder a um identificador existente na sua lista de produtos, os valores do arquivo CSV sobrescreverão os valores das colunas correspondentes na lista de produtos existente. Se a opção de sobrescrever não for selecionada, os produtos que correspondem a um identificador existente serão ignorados durante a importação do CSV.

  • Se uma coluna não obrigatória no arquivo CSV de importação estiver em branco, o valor correspondente na lista de produtos será sobrescrito e ficará em branco.
    • Por exemplo, se a coluna Vendor tiver o valor John's Apparel na sua lista de produtos, mas a coluna Vendor estiver em branco no arquivo CSV que você importa, o valor John's Apparel será sobrescrito e ficará em branco.
  • Se uma coluna não obrigatória não for incluída no arquivo CSV de importação, mas estiver incluída na lista de produtos existente, o valor na lista de produtos permanecerá o mesmo.
    • Por exemplo, se a Variant image URL coluna estiver incluída na lista de produtos existente, mas não no arquivo CSV de importação, o valor na lista de produtos permanecerá o mesmo.
  • Se o arquivo CSV de importação incluir uma coluna não obrigatória que dependa de dados de outra coluna não incluída, os dados existentes serão excluídos ou removidos.
    • Por exemplo, se a coluna SKU for incluída no arquivo CSV de importação, mas as colunas Valor da opção 1 e Nome da opção 1 não, a opção de variante do produto será excluída.
  • Arquivos CSV não podem ser usados para excluir produtos em massa. Para fazer isso, use as ações em massa na seção Produtos do admin.
  • Arquivos CSV não podem ser usados para atualizar em massa a disponibilidade de produtos em outros canais de vendas. Saiba mais sobre como definir a disponibilidade de produtos em outros canais de vendas.

Importar produtos de outra loja

Se você tiver um arquivo CSV exportado de outra loja ou de outra fonte, verifique se ele corresponde ao formato de arquivo CSV. Se o formato não corresponder ou se houver cabeçalhos ausentes, a importação falhará.

O CSV do produto não pode exceder 15 MB. Se ocorrer um erro ao tentar fazer o upload de um novo arquivo CSV ou se o upload expirar, divida o arquivo CSV em vários arquivos menores e faça o upload de cada um.

Etapas:

  1. No admin da Shopify, acesse Produtos.

  2. Clique em Importar.

  3. Clique em Adicionar arquivo e selecione o arquivo CSV que você quer importar.

  4. Opcional: caso queira publicar novos produtos apenas na loja virtual, e não em todos os canais de vendas, desmarque a opção Publicar novos produtos em todos os canais de vendas.

  5. Opcional: para alterar os URLs sobrescrevendo os valores dos identificadores existentes, selecione Sobrescrever produtos com identificadores correspondentes. Os valores existentes serão substituídos em todas as colunas incluídas no CSV.

  6. Clique em Fazer upload e continuar.

  7. Analise as informações sobre a importação e clique em Importar produtos.

Quando o upload do arquivo CSV for concluído, você receberá um e-mail de confirmação da Shopify na conta de e-mail que usou para configurar a loja na Shopify. Leia algumas soluções para problemas comuns.

Importar produtos com um arquivo CSV

Para fazer alterações nos produtos com um arquivo CSV, primeiro você precisa exportar os produtos. Depois, pode fazer alterações no arquivo CSV em um programa de planilhas, como o Google Sheets, e importar o CSV atualizado para o admin da Shopify.

Etapas

  1. No admin da Shopify, acesse Produtos.

  2. Clique em Importar.

  3. Clique em Adicionar arquivo e selecione o arquivo CSV que você quer importar.

  4. Opcional: caso queira publicar novos produtos apenas na loja virtual, e não em todos os canais de vendas, desmarque a opção Publicar novos produtos em todos os canais de vendas.

  5. Opcional: para alterar os URLs sobrescrevendo os valores dos identificadores existentes, selecione Sobrescrever produtos com identificadores correspondentes. Os valores existentes serão substituídos em todas as colunas incluídas no CSV.

  6. Clique em Fazer upload e continuar.

  7. Analise as informações sobre a importação e clique em Importar produtos.

Após a conclusão do upload do arquivo CSV, você receberá um e-mail de confirmação da Shopify na conta de e-mail usada para configurar a loja na Shopify. Leia algumas soluções para problemas comuns.

Solução de problemas de importações de CSV

Se você estiver com problemas ao importar um arquivo CSV, analise as informações de solução de problemas a seguir.

Se você notar caracteres ou símbolos inesperados nas descrições de produtos, nos títulos ou em outro conteúdo depois de importar um arquivo CSV, é possível que o arquivo não tenha sido salvo com a codificação UTF-8 (Formato de Transformação Unicode – 8 bits).

A codificação UTF-8 é necessária para evitar que caracteres inesperados apareçam no conteúdo. Por padrão, o Google Sheets salva os arquivos com codificação UTF-8 automaticamente. Outros softwares de planilha podem exigir uma etapa a mais para salvar com a codificação UTF-8.

Corrigir os itens afetados manualmente

Analise cada produto afetado e altere ou remova manualmente os caracteres. Essa é a melhor solução quando apenas alguns itens são afetados.

Importar uma versão mais antiga

Se tiver uma versão anterior do arquivo CSV salva com a codificação adequada, importe essa versão.

Salvar novamente com a codificação adequada

Abra o arquivo CSV codificado incorretamente e salve-o novamente com a codificação UTF-8. O processo varia de acordo com o sistema operacional e o programa de planilhas. Para ver as instruções, consulte Arquivos CSV.

Se você receber a mensagem de erro Erro de rede: token inesperado < em JSON na posição 0, significa que os títulos da coluna do CSV não correspondem exatamente aos cabeçalhos obrigatórios do modelo de CSV. Os nomes dos cabeçalhos das colunas diferenciam maiúsculas de minúsculas.

Analisar e corrigir os cabeçalhos das colunas

  1. Consulte o guia de formato CSV para obter a formatação correta do CSV.
  2. Compare os títulos da coluna do CSV com o arquivo de amostra.
  3. Confirme se os cabeçalhos do arquivo CSV correspondem exatamente ao arquivo de amostra, incluindo a diferenciação entre maiúsculas e minúsculas. Por exemplo, use Handle em vez de handle.
  4. Corrija os cabeçalhos do arquivo CSV para que correspondam aos do arquivo de amostra. É possível fazer o download de uma cópia do arquivo de amostra no guia de formato CSV.

Um erro de aspas inválidas ocorre quando há vírgulas e aspas não codificadas em UTF-8 no arquivo CSV.

Para um CSV de produto ser importado corretamente, todas as aspas e apóstrofos precisam estar codificados em UTF-8 e na posição correta. Por exemplo, aspas não codificadas em UTF-8 são curvas: “ ”, e as codificadas em UTF-8 são retas: " ".

Salvar o arquivo com codificação UTF-8

Salve o arquivo original com a codificação UTF-8 antes de importar.

Se você receber um erro indicando que linhas específicas são inválidas, sem outros detalhes, o problema pode ser causado por conflitos com as opções de variantes de produto existentes. Isso ocorre ao tentar alterar um valor de opção de uma posição para outra.

O que causa esse problema

A importação de CSV falha quando um arquivo tenta atribuir um valor de opção existente a uma nova posição de opção, criando um conflito, pois as opções de variante precisam ser exclusivas. Por exemplo, se você tentar mover Size da Opção 1 para a Opção 2 e adicionar Type como a nova Opção 1, o banco de dados valida se há nomes duplicados antes de importar novos valores, e o processo falha.

Resolver o conflito

Use um nome de opção temporário durante a importação e atualize-o depois:

  1. No arquivo CSV, use um nome temporário alternativo para a opção que está causando o conflito. Por exemplo, use Size. (com um ponto) em vez de Size.
  2. Importe o arquivo CSV com o nome da opção temporário.
  3. Depois que a importação for concluída, crie um novo arquivo CSV que altere o nome da opção temporário para o nome desejado.
  4. Importe o arquivo CSV atualizado para aplicar o nome final da opção.