Usar arquivos CSV para importar e exportar produtos

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.

Fazer download de um arquivo CSV de amostra

É possível fazer download 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 o 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 ("Qtde de estoque da variante"), 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.

Considerações sobre o arquivo CSV do produto

Antes de usar o arquivo CSV do produto, analise as considerações a seguir.

Formatar o arquivo CSV do produto

Para que o arquivo CSV do produto funcione corretamente, verifique se ele atende aos seguintes critérios:

  • A primeira linha do arquivo CSV do produto precisa conter os cabeçalhos das colunas, conforme especificado na tabela de descrição do CSV do produto.

  • Cada coluna precisa ser separada por vírgula.

Colunas necessárias no arquivo CSV do produto

Estas colunas precisam estar presentes nas seguintes condições:

  • Quando você cria um arquivo CSV de produtos para importar novos produtos, a única coluna obrigatória é Title. Se estiver adicionando variantes, a coluna Handle também é obrigatória.

  • Quando você atualiza produtos com um arquivo CSV, as únicas colunas necessárias são Handle e Title.

Dependências de dados

Mesmo que as colunas Title e Handle sejam as únicas obrigatórias quando você atualiza produtos por meio de um arquivo CSV, os dados em algumas colunas dependem dos dados em outras.

Por exemplo, se você atualizar uma coluna relacionada a variantes, como Variant SKU ou Variant Grams, os dados delas dependem dos dados sobre as variantes correspondentes. Nesse caso, você também precisa incluir as colunas Option1 Name e Option1 Value.

Verifique antes se os dados de outras colunas dependem dos dados das colunas que você quer remover ou excluir. Se os dados dependerem de uma coluna ausente, você receberá um erro ao tentar importar o arquivo CSV de produtos.

Colunas CSV do Shopify Markets

Se o Shopify Markets estiver configurado na loja, a exportação no formato CSV refletirá os mercados exclusivos que você criou. Por padrão, o arquivo terá as colunas Price / International e Compare At Price / International. No entanto, International mudará no cabeçalho para o nome de seu próprio mercado caso você o use para substituir o mercado internacional.

Por exemplo, se você criar um mercado para cada continente e um dos nomes de mercado for South America, o cabeçalho da coluna Price / International será Price / South America e o título da coluna Compare at price / International será Compare at price / South America no arquivo de exportação CSV.

Colunas no arquivo CSV do produto que precisam conter valores

Além da coluna Title, algumas outras precisam ter um valor. Quando uma coluna exige um valor, mas está em branco, um valor-padrão é criado automaticamente nos seguintes casos:

  • A coluna está presente, mas os valores estão em branco.
  • A coluna não está presente no arquivo CSV, mas os valores não podem ficar em branco.

A tabela a seguir descreve quais colunas precisam ter um valor e o valor-padrão criado automaticamente se a coluna estiver em branco.

Colunas no arquivo CSV do produto que precisam ter um valor e os valores-padrão criados de modo automático se nenhum valor estiver presente.
Coluna Valor-padrão criado quando a coluna está em branco
Handle Criado com base no valor na coluna Title. Por exemplo, se o valor na coluna Title for Black Sun Glasses, o valor nesta coluna será black-sun-glasses.
Vendor O nome da loja conforme você inseriu quando criou a conta da Shopify. Por exemplo, John's Apparel ou johns-apparel. É o mesmo nome de loja que você usa para fazer login na Shopify.
Published TRUE, o que significa que o produto será publicado e estará disponível no canal de vendas Loja virtual.
Option1 Title
Option1 Value Default Title
Variant Inventory Quantity 0
Variant Inventory Policy

deny

Quando o valor é deny, indica que não é possível comprar o produto depois que o nível de estoque chega a zero.

Variant Fulfillment Service manual
Variant Price 0.0
Variant Requires Shipping

TRUE

Quando o valor é TRUE, indica que se trata de um produto físico.

Variant Taxable TRUE
Variant Grams 0.0
Variant Weight Unit kg
Price / International

Se você vende para o mercado internacional, é o preço do produto ou da variante. Inclua apenas o preço e não use símbolos monetários. Por exemplo, 9,99.

O nome da coluna varia de acordo com os Shopify Markets que você definiu na loja. O mercado-padrão é International, mas se você alterá-lo ou adicionar novos mercados, os nomes deles aparecerão nos cabeçalhos. Consulte a seção de considerações para saber mais.

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

Compare At Price / International

Se você vende para o mercado internacional, é a "Comparação de preços" do produto ou da variante. Inclua apenas o preço e não use símbolos monetários. Por exemplo, 9,99.

O nome da coluna varia de acordo com os Shopify Markets que você definiu na loja. O mercado-padrão é International, mas se você alterá-lo ou adicionar novos mercados, os nomes deles aparecerão nos cabeçalhos. Consulte a seção de considerações para saber mais.

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

Status Se esta coluna estiver presente, ela precisará ter um valor. Se não estiver presente, o status do produto será carregado automaticamente como active.

Para saber mais sobre essas e outras colunas, consulte a tabela para descrição de CSV do produto.

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. Nesse caso, quando os identificadores no arquivo CSV e no produto forem iguais, os valores nesse arquivo substituirão aqueles nas colunas correspondentes na atual lista de produtos. Entretanto, se a opção não for selecionada, os itens com um identificador existente igual 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.

  • 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.

Descrição do arquivo CSV do produto

Para saber mais sobre quais colunas são necessárias e quais exigem a inserção de valores, consulte as considerações sobre arquivos CSV de produtos.

Descrições das colunas no arquivo CSV do produto.
Coluna Descrição
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 no URL de cada produto.

Por exemplo, o identificador para "Prancha de snowboard feminina" seria womens-snowboard e o 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.

Title

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

Body (HTML)

A descrição do produto em formato HTML.

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

Vendor

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

Os valores precisam ter pelo menos dois caracteres.

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

Standardized product type

Uma etiqueta que descreve o tipo de produto. É necessário retirá-la da lista padronizada e predefinida de tipos de produto.

Existem duas maneiras de inserir o tipo-padrão de produto:

  • usando o caminho completo da Taxonomia de produtos da Shopify, por exemplo, Home & Garden > Linens & Bedding > Bedding > Bed Sheets
  • inserindo o ID numérico, por exemplo, 371

Saiba mais sobre como adicionar um tipo-padrão de produto.

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

Custom product type

Uma etiqueta personalizada que descreve a categoria de um produto. Não é necessário haver conformidade com formatos predefinidos.

Saiba mais sobre como adicionar um tipo de produto personalizado.

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".

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 está publicado, ou FALSE, se o produto está oculto.

Option1 Name

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

Se um produto tiver apenas uma opção, esse valor será Title.

Option1 Value

Aviso: 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.

Se um produto tiver apenas uma opção, esse valor será Default Title.

Nome da opção2

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

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

Valor da opção2

Aviso: 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.

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.

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

Valor da opção3

Aviso: 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.

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.

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 usar um serviço externo de processamento.

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.

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. Esta coluna é usada somente por lojas da Shopify que tenham um único local.

Atenção: Esta coluna só está disponível para lojas com apenas um local. Se a loja gerenciar o estoque em vários locais, esta coluna não estará incluída. Para importar ou exportar os volumes de estoque, use o arquivo CSV de estoque.

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.

Variant Fulfillment Service

O serviço de processamento de pedidos do produto ou da variante. Confira os valores válidos para esta coluna:

  • manual
  • shipwire
  • webgistix
  • amazon_marketplace_web

Adicione o nome do serviço personalizado de processamento de pedidos que você usa a esta coluna. Vale lembrar que só é possível usar letras minúsculas e que não é permitido usar espaços, que podem ser substituídos por traços (-). Além disso, pontos e outros caracteres especiais são removidos. Por exemplo, se o nome do 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.

Variant Price

O preço do produto ou da variante. Inclua apenas o preço e não use símbolos monetários. Por exemplo, 9,99.

Variant Compare at Price

A "Comparação de preços" do produto ou da variante. Inclua apenas o preço e não use símbolos monetários. Por exemplo, 9,99.

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 ou FALSE.

Variant Taxable

Aplicar tributação à variante. Os valores válidos são TRUE ou FALSE.

Variant Barcode

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

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

Image Src

Insira o 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.

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 você quer que uma determinada imagem seja a primeira a aparecer para um produto.

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á o SEO do site. Seja breve e descritivo. O máximo permitido é 512 caracteres, mas o ideal é usar 125 ou menos.

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 editar outras informações, como as colunas Body ou Tags e, depois, importar essas alterações. Só é possível criar e ativar um cartão-presente no admin da Shopify, já que a importação de um arquivo CSV de produto não oferece essa opção.

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. Esse recurso é alfanumérico e pode ter até 70 caracteres. Se você deixar este campo em branco ao importar o produto, o valor na coluna Title será inserido no campo Título da página da página de informações do produto.

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

SEO Description

A descrição de SEO é encontrada na página de informações do produto, no cabeçalho Pré-visualização da listagem do mecanismo de pesquisa, no campo Descrição. Esse recurso é alfanumérico e pode ter até 320 caracteres. Se você deixar esta coluna em branco na hora de importar o produto, o valor na coluna Body (HTML) será inserido no campo Descrição da página de informações do produto.

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

Google Product Category

Caso você use essa opção, experimente definir a categoria de produto do Google como tipo-padrão de produto na Shopify. Mesmo que seja possível trabalhar com as duas categorias, lembre-se de atribuir a mais específica possível a cada item.

A categoria de produto do Google (GPC, na sigla em inglês) usa taxonomia própria.

É possível inserir a categoria de produto do Google das seguintes maneiras:

  • usando o caminho completo da taxonomia, por exemplo, Apparel & Accessories > Clothing > Shirts & Tops
  • inserindo o ID numérico, por exemplo, 212

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

Metacampos do Google Shopping

Ainda que apps possam usar as colunas do Google Shopping para sincronizar produtos com o Google Merchant Center, o canal de vendas Google da Shopify não usa esses metacampos. Por isso mesmo, é aconselhável ignorar os valores das colunas com o Google Shopping no nome, a menos que um app diga para usá-los.

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

Variant Image

O URL das imagens das variantes. Ao adicioná-lo, verifique se o URL funciona.

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.

Variant Tax Code

Disponível para: plano Shopify Plus

Código da 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 Avalara AvaTax.

Quando você cria um arquivo CSV gerado pela exportação de produtos de uma loja que usa o Avalara, a coluna Variant Tax Code é preenchida. Na hora de importar o documento para um estabelecimento que não tenha o serviço configurado, ocorrerá uma falha.

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 variante. Inclua somente o custo e não insira símbolos de unidades monetárias. Por exemplo, 9,99.

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

Status

Indica se o produto está ou não disponível para os clientes. Os valores válidos sã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

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.

Quando você exporta um arquivo CSV, a coluna Collection não é incluída.

Descrição da coluna Collection no arquivo de importação CSV do produto.
Coluna Descrição
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.

O valor pode ficar em branco.

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

Criar seu arquivo CSV de produtos

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

  • Produto simples: não inclui variantes. Se você está enviando um produto sem variantes, insira todos os campos na primeira linha junto com o URL da primeira imagem. Nas linhas a seguir, insira apenas o identificador e o URL de cada imagem adicional.

  • Produto com variantes: se você fizer o upload de um produto com variantes, insira todos os campos na primeira linha junto com o URL da primeira imagem e, nas linhas seguintes, insira o identificador. Pule as colunas Title, Body (HTML), Vendor e Tags. Depois, preencha as informações restantes sobre as variantes e o 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, você precisa garantir que todas as imagens do produto estejam em um site já existente. Esses URLs de imagem são usados apenas durante o processo de importação do arquivo CSV e é possível excluí-los após a importação.

  • Se os arquivos estão apenas no computador, para vinculá-los ao URL, você precisa enviá-los à loja da Shopify ou a outro serviço de hospedagem de imagens.

  • Se você está migrando de outra plataforma para a Shopify, é possível copiar os URLs atuais das imagens e usá-los 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 a um arquivo CSV

Para adicionar mais imagens de produtos a um arquivo CSV, basta fazer o upload delas no admin da Shopify. No entanto, o processo será um pouco diferente se você estiver criando uma loja da Shopify com um arquivo CSV. 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 imagens dos produtos precisam estar em um URL com acesso público, ou seja, estar disponíveis por meio do protocolo https:// sem proteção de senha. Uma opção é fazer o upload das imagens para a página Arquivos do admin da Shopify, de modo que que os URLs sejam gerados automaticamente. Após clicar em Fazer upload de arquivos, é possível selecionar centenas de imagens para carregamento em massa.

Adicionar várias imagens de produtos a um arquivo CSV

  1. Insira novas linhas. Você precisa usar apenas uma linha por imagem.
  2. Copie e cole o identificador.
  3. Copie e cole os URLs da imagem.

Inserir uma nova linha

  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 a mesma quantidade de linhas que a de imagens adicionais incluídas.

    In a product CSV Google spreadsheet, the third and fourth row are highlighted.

  4. Enquanto as linhas estiverem em destaque, clique com o botão direito na área indicada e selecione Inserir X linhas acima.

    In a product CSV Google spreadsheet, the Insert 2 above option is selected.

Copiar e colar o valor Handle

  1. Copie e cole o valor Handle do produto exigido na coluna A das novas linhas.
    In a product CSV Google spreadsheet, the text black-shirt is entered under the handle column in the third and fourth rows.

Copiar e colar os URLS da imagem

  1. Na página Arquivos, faça o upload das imagens para a Shopify.

  2. Clique no ícone Copiar link e selecione um URL de imagem por vez.

    In the Shopify admin Files page, the link button is highlighted in the row of a black t-shirt image.

  3. No programa de planilha eletrônica, role para as últimas colunas do arquivo CSV.

  4. Na coluna Image Src, cole o URL da imagem em cada linha.

    In a product CSV Google spreadsheet, the black t-shirt product image URL is entered into a row in the Image Src column.

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

  6. Opcional: para melhorar o SEO, insira valores em todos os campos Image Alt Text. Saiba mais sobre o Texto alternativo da imagem.

  7. Salve o arquivo CSV e importe-o para a Shopify.

Tudo pronto para começar a vender com a Shopify?

Experimente de graça