Usar arquivos CSV

Use um arquivo CSV (valores separados por vírgulas) para importar e exportar produtos de sua loja da Shopify. Assim, é possível importar e exportar diversos produtos e as respectivas informações de uma só vez. Isso é útil para trocar informações entre a Shopify e outro sistema.

Saiba como abrir e editar um arquivo CSV.

Obter um exemplo de arquivo CSV

É possível baixar e visualizar um arquivo CSV de amostra de produto e utilizá-lo como modelo.

  • O arquivo de amostra contém um exemplo de produto e algumas variantes. É provável que seu arquivo de importação contenha um número muito maior de produtos e variantes. Se você usar o arquivo de amostra para criar seu próprio arquivo de importação, remova todas as amostras de produtos fictícios.

  • O arquivo de amostra inclui a coluna Variant Inventory Qty, usada apenas para lojas que têm um único local. Caso você tenha vários locais e queira importar ou exportar volumes de estoque, use o arquivo CSV de estoque.

Formato do arquivo CSV de produtos

A primeira linha do arquivo CSV precisa conter, na mesma ordem, os cabeçalhos de coluna incluídos no arquivo de amostra. Separe as colunas por vírgula. Nas linhas (ou registros) seguintes, precisam estar os dados do produto, nas mesmas colunas, seguindo a ordem original.

Substituir informações do produto com um arquivo CSV de importação

Ao importar um arquivo CSV, é possível selecionar a opção Substituir produtos existentes que tenham o mesmo identificador. Os valores serão usados para colunas ausentes. Caso tenha feito a seleção, os identificadores no documento substituirão aqueles das colunas correspondentes na atual lista de produtos. Se a opção de substituição não for selecionada, os itens iguais a um identificador existente serão ignorados durante a importação de CSV.

  • Caso uma coluna obrigatória do arquivo CSV de importação esteja vazia, o valor correspondente na lista de produtos será substituído, ficando em branco.

    Por exemplo, o valor de Type na lista de produtos existente é Snowboard. Porém, a coluna Type no arquivo CSV de importação está vazia. Assim, Snowboard será substituído por um valor em branco.

  • Se uma coluna não obrigatória não for incluída no arquivo CSV de importação, mas existir na lista de produtos, o valor permanecerá o mesmo.

    Por exemplo, se a coluna Variant Image existir na lista de produtos, mas não for incluída no arquivo CSV de importação, o valor permanecerá o mesmo.

Descrição do arquivo CSV de importação de produto

Descrição das colunas do arquivo de importação CSV do produto.
Coluna Descrição Requisitos de dados
Handle

Os identificadores são os nomes exclusivos de cada produto. Eles podem conter letras, traços e números, mas não espaços, acentos ou outros caracteres, incluindo pontos. Há um identificador na URL de cada produto.

Por exemplo, o identificador para "Prancha de snowboard feminina" seria womens-snowboard e a URL do produto seria https://yourstore.myshopify.com/products/womens-snowboard.

Cada linha do arquivo CSV que possui um identificador diferente é tratada como um novo produto. Para adicionar várias imagens a um item, é preciso incluir várias linhas com o mesmo identificador.

Obrigatório. Não pode estar em branco nem ausente.

Title

O título do produto. Por exemplo, Women's Snowboard.

Obrigatório. Não pode estar em branco nem ausente.

Body (HTML)

A descrição do produto em formato HTML. Também pode ser um texto simples, simples.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Vendor

O nome do fornecedor do produto. Por exemplo, Nevasca Equipamentos esportivos.

Obrigatório, mas pode ficar em branco.

Os valores inseridos precisam ter, pelo menos, dois caracteres.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Type

O tipo de produto. Por exemplo, Prancha de snowboard.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Tags

Uma lista de tags separadas por vírgula para classificar os produtos. A maioria dos apps de planilha já adiciona aspas às tags automaticamente. Caso você use um editor de texto simples, é preciso adicionar as aspas manualmente. Por exemplo, "tag1, tag2, tag3".

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Published

Indica se o produto foi publicado na loja virtual. Os valores válidos são: TRUE, se o produto for publicado na loja virtual. Ou FALSE, caso o produto esteja oculto na loja virtual.

Obrigatório. Deixar o campo em branco publicará o produto.
Option1 Name

Se o produto apresenta uma opção, insira o respectivo nome. Por exemplo, Cor.

Obrigatório. Não pode estar em branco nem ausente.

Para itens com apenas uma opção, o campo precisa ser definido como Title.
Option1 Value

Atenção: A alteração de dados na coluna exclui as identificações de variantes existentes e cria novas. Mudanças nesses valores poderão quebrar as dependências de terceiros em IDs de variantes.

Se o produto apresenta uma opção, insira o respectivo valor. Por exemplo, Azul.

Obrigatório. Não pode estar em branco nem ausente.

Para itens com apenas uma opção, o campo precisa ser definido como Default Title.

Nome da opção2

Se um produto apresenta uma segunda opção, insira o respectivo nome. Por exemplo, Tamanho.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Valor da opção2

Atenção: A alteração de dados na coluna exclui as identificações de variantes existentes e cria novas. Mudanças nesses valores poderão quebrar as dependências de terceiros em IDs de variantes.

Se um produto apresenta uma segunda opção, insira o respectivo valor. Por exemplo, Grande.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Nome da opção3

Se um produto apresenta uma terceira opção, insira o respectivo nome.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Valor da opção3

Atenção: A alteração de dados na coluna exclui as identificações de variantes existentes e cria novas. Mudanças nesses valores poderão quebrar as dependências de terceiros em IDs de variantes.

Se o produto apresenta uma terceira opção, insira o respectivo valor.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

SKU da variante

A SKU do produto ou da variante. Esta informação é usada para acompanhar o estoque por meio de serviços de acompanhamento especializados.

Não pode ficar em branco se um serviço personalizado de processamento de pedidos estiver sendo usado.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Variant Grams

O peso do produto ou da variante em gramas. Não especifique uma unidade de medida nem use decimais. Por exemplo, para um peso de 5,125 kg, insira 5125.

A Shopify sempre importa e exporta o peso em gramas, mesmo que você especifique outra unidade. Você precisa inserir o peso exato se pretende oferecer frete calculado por uma transportadora ou utilizar um serviço externo de processamento.

Obrigatório. Não pode estar em branco nem ausente.

É necessário inserir um valor, mesmo que seja 0.

Variant Inventory Tracker

Inclua o acompanhamento de estoque para a variante ou o produto. Os valores válidos são shopify, shipwire, amazon_marketplace_web. Deixe em branco se o estoque não tiver acompanhamento.

Obrigatório, mas pode ficar em branco.

Se as opções de acompanhamento de estoque atuais forem removidas, ele não será mais rastreado.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Variant Inventory Qty

O número de itens em estoque do produto ou da variante. Essa coluna é usada somente por lojas da Shopify que tenham um único local.

Se a sua loja gerencia o estoque em vários locais, esta coluna não estará incluída. Se você quiser importar ou exportar os volumes de estoque, utilize o arquivo CSV de estoque.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Variant Inventory Policy

Como lidar com pedidos quando o nível de estoque de um produto ou uma variante chega a zero. Com uma política de estoque em deny, não é possível comprar uma variante quando o nível de estoque chega a zero. Já com uma política de estoque em continue, é possível comprar uma variante com nível de estoque em zero, ou seja, é possível trabalhar com valores negativos.

Obrigatório. Não pode estar em branco nem ausente.

Variant Fulfillment Service

O serviço de processamento de pedidos do produto ou da variante utilizado. Os valores válidos são: manual, shipwire, webgistix e amazon_marketplace_web.

Se você usa um serviço personalizado de processamento de pedidos, adicione o nome do serviço a esta coluna. Use somente letras minúsculas para o nome personalizado. Não é permitido usar espaços. Substitua por traços (-). Pontos e outros caracteres especiais são removidos. Por exemplo, se o nome de seu serviço de processamento de pedidos for "Depósito da Joana", digite deposito-joana no arquivo CSV.

É preciso ter um serviço personalizado de processamento de pedidos já configurado no admin da Shopify antes de adicionar um nome na coluna.

Obrigatório. Não pode estar em branco nem ausente.

Variant Price

O preço do produto ou da variante. Não inclua símbolos de moeda, insira somente o preço. Por exemplo, 9,99.

Obrigatório. Não pode estar em branco nem ausente.

Variant Compare at Price

A "Comparação de preços" do produto ou da variante. Não inclua símbolos de moeda, insira somente o preço. Por exemplo, 9,99.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Variant Requires Shipping

Opção usada para exigir frete. Os valores válidos são: TRUE, FALSE ou em branco (que é igual a FALSE).

Obrigatório, mas pode ficar em branco.

Variant Taxable

Aplicar tributação à variante. Os valores válidos são: TRUE, FALSE ou em branco (que é igual a FALSE).

Obrigatório, mas pode ficar em branco.

Variant Barcode

O código de barras, ISBN ou UPC do produto.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Image Src

Insira a URL da imagem do produto. A Shopify baixa as imagens durante a importação e as recarrega na loja. Elas não são específicas das variantes. As que são específicas precisam ser indicadas na coluna de imagem de variante.

Não é possível alterar o nome do arquivo da imagem após o carregamento na loja. Não carregue imagens que têm os sufixos _thumb, _small ou _medium nos nomes.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Image Position

Insira o número que indica a ordem de exibição da imagem na página do produto. A ordem será seguida, da menor para a maior, a começar pelo valor de posição 1. Por exemplo, insira 1, se quiser que a imagem apareça primeiro para determinado produto.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Image Alt Text

O texto alternativo refere-se a uma imagem e é uma parte importante da descrição do produto. Caso ela não seja carregada por algum motivo, o texto alternativo será exibido. Ele também é usado pela tecnologia assistiva para descrever uma imagem a um cliente com deficiência visual. A inclusão desse tipo de recurso aumentará a SEO do site. Seja breve e descritivo. O máximo permitido é 512 caracteres, mas o ideal é usar 125 ou menos.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Gift Card

Indica se o produto é um cartão-presente ou não. Os valores válidos são TRUE ou FALSE. A inclusão dessa coluna também permite alterar outras informações, como "Corpo" ou "Tags" e, depois, importá-las. Use o admin da Shopify para criar e ativar um cartão-presente. Inicialmente, não é possível criar um por meio da importação de um arquivo CSV de produto.

Obrigatório, mas pode ficar em branco.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

SEO Title

O título de SEO é encontrado na página de informações do produto, no cabeçalho Pré-visualização da listagem do mecanismo de pesquisa, no campo Título da página. O limite para o título de SEO é de 70 caracteres (letras e números). Se você deixar este campo em branco ao importar o produto, ele será preenchido automaticamente com o título do produto.

Opcional.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

SEO Description

A descrição de SEO também pode ser encontrada na página de informações do produto, no cabeçalho Pré-visualização da listagem do mecanismo de pesquisa, no campo Metadescrição. O limite para a descrição de SEO é de 320 caracteres (letras e números). Se você deixar este campo em branco ao importar o produto, ele será preenchido automaticamente com a descrição do produto.

Opcional.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Metacampos do Google Shopping

Um app pode usar os campos do Google Shopping para sincronizar produtos com o Google Merchant Center. No entanto, o canal de vendas Google da Shopify não usa esses metacampos. Ignore os campos das colunas com o Google Shopping no nome, a menos que um app diga para usá-los.

Opcional.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Variant Image

A URL das imagens das variantes. Se você adicionar uma URL, ela precisa ser de uma imagem funcional.

Opcional.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Variant Weight Unit

Os valores válidos são g, kg, lb e oz.

Opcional.

Caso o campo seja deixado em branco, Variant Weight Unit será kg.

Variant Tax Code

Disponível para: plano Shopify Plus

Código Avalara para aplicar tributação ao produto. Este campo é válido somente para a importação ou exportação de uma loja que usa a integração do plano Shopify Plus com o AvaTax da Avalara.

Ao criar um arquivo CSV gerado pela exportação de produtos de uma loja que utiliza o AvaTax, o campo Variant Tax Code é preenchido. Ao importar o documento para um estabelecimento que não tenha o serviço configurado, ocorrerá falha na importação.

Opcional.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Cost per item

O preço de custo do produto ou da variante para você. Não inclua símbolos de moeda, insira somente o custo. Por exemplo, 9,99.

Opcional.

Saiba mais sobre como a substituição de produtos existentes afeta os dados na coluna.

Status Se um produto estiver disponível para os clientes, os valores válidos serão:
  • active: o produto está ativo e pronto para ser vendido
  • draft: o produto é um rascunho e precisa ser concluído
  • archived: o produto está arquivado e não está mais disponível para venda

Obrigatório.

Caso a coluna esteja ausente, todos os produtos serão carregados como active. Mas se ela estiver presente, os valores em branco farão com que o carregamento falhe, apresentando o seguinte erro: Status inválido. Defina o status como active, , draft ou archived

Collection exceção da coluna

Para organizar os produtos em coleções durante o carregamento do arquivo CSV, adicione uma nova coluna com o nome de cabeçalho Collection.

Descrição da coluna Collection no arquivo de importação CSV do produto.
Coluna Descrição Requisitos de dados
Collection Insira o nome da coleção em que o produto será adicionado.
  • Se for uma coleção automatizada, o produto precisará atender às condições da coleção.
  • Se ela ainda não existir, uma coleção será criada para você.

É possível adicionar o produto a somente uma coleção.

Pode ser deixado em branco.

Criar seu arquivo CSV de produtos

É preciso decidir se cada produto é simples ou apresenta variantes:

  • Produto simples (não apresenta variantes)

    Ao carregar um produto sem variantes, insira todos os campos (como descrito acima) do produto na primeira linha junto com a URL da primeira imagem. Nas linhas a seguir, insira somente o identificador e a URL de cada imagem adicional.

  • Produto com variantes

    Ao carregar um produto com variantes, insira todos os campos (como descrito acima) do produto na primeira linha junto com a URL da primeira imagem. Nas linhas seguintes, insira o identificador. Em seguida, pule as colunas "Título", "Corpo (HTML)", "Fornecedor" e "Tags". Preencha as informações restantes sobre as variantes e a URL de cada imagem.

Após adicionar os produtos e as imagens, salve o arquivo CSV no formato UTF-8 usando alimentação de linha (LF). Consulte a documentação de seu programa de edição de texto ou planilhas se desconhecer as codificações.

Para ver um exemplo de arquivo CSV, baixe esta amostra de arquivo CSV de produtos e abra-o nas Planilhas Google ou em outro programa semelhante.

Preparar suas imagens

Um arquivo CSV só pode conter texto. Portanto, é preciso verificar se todas as imagens dos produtos estão em um site já existente. As URLs das imagens são usadas somente durante o processo de importação do arquivo CSV. Assim, é possível excluí-las após a importação.

  • Se os arquivos estão apenas em seu computador, é preciso carregá-las para sua loja da Shopify ou outro serviço de hospedagem de imagens para vinculá-las a uma URL.

  • Se você está migrando de outra plataforma para a Shopify, é possível copiar as URLs atuais das imagens e usá-las no arquivo CSV.

  • Se o arquivo CSV de produtos foi gerado pela exportação de seus produtos da Shopify, não é preciso fazer mais nada, pois suas imagens já estão em nosso site.

Quando você tiver URLs para cada uma das imagens de produtos, é possível começar a criar seu arquivo CSV.

Adicionar várias imagens de produtos em um arquivo CSV

É possível adicionar mais imagens de produtos a um arquivo CSV. Basta carregar mais imagens no admin da Shopify. Se você está criando uma loja da Shopify com um arquivo CSV, o processo é um pouco diferente. Confira o que é preciso fazer:

  • É preciso saber editar um arquivo CSV. A Shopify recomenda usar o Planilhas Google para ver a versão formatada de seus arquivos CSV.

  • É possível adicionar até 250 imagens a um produto.

  • As images dos produtos precisam estar carregadas em uma URL com acesso público. Ou seja, elas precisam estar disponíveis por meio do protocolo https:// sem proteção de senha. Uma opção é carregar as imagens para a página Arquivos do admin da Shopify. As URLS são geradas automaticamente. Após clicar em Carregar arquivos, é possível selecionar cerca de 200 imagens para carregamento em massa.

Para adicionar várias imagens, é preciso:

  1. Inserir novas linhas (uma por imagem).
  2. Copiar e colar o "identificador".
  3. Copiar e colar as URLs da imagem.

Insira novas linhas (uma por imagem)

  1. Abra o arquivo CSV em um programa de planilha eletrônica, como o Planilhas Google.

  2. Localize os produtos aos quais você quer adicionar imagens.

  3. Na próxima linha, clique e arraste os números das linhas para selecioná-las. Selecione o número de linhas que corresponde ao número de imagens adicionais que você incluir.

  4. Embora as linhas estejam destacadas, clique com o botão direito na área realçada e escolha Inserir X linhas acima

    . A ação criará três linhas vazias abaixo do produto ao qual se pretende adicionar imagens.

Copiar e colar o "identificador"

Copie e cole o "identificador" do produto desejado na coluna A das novas linhas.

Copiar e colar as URLS da imagem

  1. Carregue suas imagens na Página de arquivos da Shopify.

  2. Em seguida, destaque e copie uma URL de imagem por vez.

  3. Retorne ao seu programa de planilha eletrônica e role lateralmente até as colunas finais do arquivo CSV.

  4. Na coluna "Image Src" (abreviação de "Origem da imagem") cole uma URL de imagem em cada linha.

  5. Repita os passos 2 a 4 para todas as imagens deste produto.

  6. (Opcional): preencha os campos da próxima coluna, "Texto alternativo da imagem", para potencializar a SEO. Clique aqui para saber mais sobre o Texto alternativo da imagem.

Em seguida, salve e importe o arquivo para a Shopify.

Pronto para começar a vender com a Shopify?

Experimente de graça