Usar arquivos CSV para importar e exportar produtos

Saiba como gerenciar as informações do fabricante.

Uma etiqueta que descreve o tipo de produto e que é usada para calcular a alíquota nos Estados Unidos. A etiqueta deve ser retirada da Taxonomia de produtos padrão da Shopify.

Uma categoria de produto padronizada válida pode ser identificada com:

• A trilha de navegação completa da categoria, por exemplo, Home & Garden > Linens & Bedding > Bedding > Bed Sheets
• O ID da categoria, por exemplo, hg-15-1-2

Uma etiqueta que descreve o produto caso você precise de uma categoria personalizada para manter os produtos organizados, além da categoria-padrão da Shopify. Por exemplo, se a categoria do produto for Bed Sheets, um tipo de produto útil poderia ser Cooling sheets. Essa etiqueta não precisa seguir um formato predefinido.

Saiba mais sobre como adicionar um tipo de produto.

Adicione palavras-chave para ajudar os clientes a encontrar o produto online ou para agrupar e filtrar produtos:

• Use letras, números e hifens
• Separe as tags na mesma célula com vírgulas. Por exemplo, Fall-2023, casual, vintage
• Adicione no máximo 250 tags a cada produto
• Evite caracteres acentuados e símbolos

A maioria dos aplicativos de planilha adiciona aspas automaticamente ao redor das tags. Se você usar um editor de texto simples, precisará adicioná-las manualmente. Por exemplo, tag1, tag2, tag3.

Saiba mais sobre os formatos de tag.

Indique se o produto deve ser publicado no canal de vendas da loja virtual. Os valores válidos são:

• true (padrão): o produto importado fica visível na loja virtual e pode ser vendido
• false: o produto importado não fica visível na loja virtual

Saiba mais sobre a publicação em uma loja virtual.

Indica se o produto está disponível para os clientes. Se essa coluna estiver presente, é preciso que ela tenha um valor. Caso a coluna não esteja presente, o status do produto será carregado automaticamente como active. Os valores válidos são:

• active (padrão): o produto está pronto para ser vendido
• draft: o produto ainda não está pronto para ser vendido
• archived: o produto não está mais disponível para venda

Saiba mais sobre status de produtos.

A Unidade de manutenção de estoque (SKU) de uma variante, usada para rastrear o estoque. A coluna SKU não pode ficar em branco se você usar um serviço de processamento de pedidos personalizado.

O código de barras, o Número padrão internacional de livro (ISBN) ou o Código universal de produto (UPC) da variante.

Saiba mais sobre códigos de estoque.

Crie variantes para um produto com mais de uma opção, como tamanho ou cor, inserindo o nome. Cada combinação de valores de nome da opção de um produto pode ser uma variante desse produto, como Size ou Color.

Um produto pode ter até 3 opções.

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

Saiba mais sobre a criação de variantes.

Se um produto tiver mais de uma opção, como tamanho ou cor, insira o valor dela. Por exemplo, um valor para uma opção de cor poderia ser Black. Um produto pode ter até 3 opções.

Se estiver vinculando a um metacampo de categoria com a coluna LinkedTo , o valor da opção poderá ser um identificador de metaobjeto ou um GID (não o nome de exibição).

Atenção: a alteração de dados nesta coluna exclui os valores de IDs de variantes existentes e cria novos IDs de variantes. Qualquer alteração nos valores de ID da variante pode corromper as dependências de terceiros nos IDs da variante.

Saiba mais sobre a criação de variantes de produto.

O preço do produto ou da variante. Inclua apenas o valor monetário, sem o símbolo da moeda. Por exemplo, 9.99. O valor-padrão é 0.00 se nenhum valor for inserido.

Saiba mais sobre preços de produtos.

Um preço fixo para esse produto no mercado de mesmo nome e na moeda desse mercado.

Saiba mais sobre as colunas de CSV para o International.

O preço original da variante, caso o preço tenha sido reduzido e você queira exibir a comparação de preços. Inclua apenas o valor monetário, sem o símbolo da moeda. Por exemplo, 9.99.

Saiba mais sobre a definição de preços de comparação.

Define um preço de comparação fixo para esse produto no mercado de mesmo nome e na moeda desse mercado. É necessário ter um preço fixo para um produto em um mercado para usar um preço de comparação fixo.

Saiba mais sobre as colunas de CSV para o International.

O custo para fabricar ou adquirir o produto ou a variante. Inclua apenas o valor monetário, sem o símbolo da moeda. Por exemplo, 9,99.

Saiba mais sobre como definir um custo por item.

Se o produto for tributável, configure tributos com base no local. Os valores válidos são:

• true (padrão): para cobrar tributo sobre o produto ou a variante
• false: para não cobrar tributo sobre o produto ou a variante

Indique qual serviço você quer usar para rastrear o estoque da variante. Os valores válidos incluem:

• shopify
• shipwire
• amazon_marketplace_web
• em branco, se o estoque não for rastreado

Se as opções de rastreamento de estoque existentes forem removidas, o estoque não será mais rastreado.

Serviços de processamento de pedidos de terceiros: para as variantes armazenadas em um serviço de processamento de pedidos de terceiros, o CSV exportado exibe shopify nesta coluna quando o rastreamento de estoque está habilitado e fica em branco quando não está. Os níveis de estoque e as atribuições de local permanecem iguais. Para gerenciar o estoque em locais específicos do serviço de processamento de pedidos, use o arquivo CSV de estoque. Ou, caso trabalhe com um desenvolvedor, use a Inventory API.

O número de itens do produto ou da variante que você tem em estoque. Isso se aplica apenas a lojas da Shopify com um único local.

O valor-padrão é 0 se nenhum valor for inserido.

Saiba mais sobre o gerenciamento do estoque disponível.

Indique se você quer permitir que os clientes comprem itens sem estoque. Os valores válidos são:

• deny (padrão): não permite que a variante seja comprada depois que o nível de estoque chegar a 0.
• continue: permite que a variante seja comprada depois que o nível de estoque chegar a 0, o que exibe níveis de estoque negativos.

Saiba mais sobre a venda de produtos sem estoque.

O peso do produto ou da variante, expresso em gramas.

Especifique apenas o valor numérico, sem a unidade de medida ou as casas decimais. Por exemplo, se a variante pesar: 5,125 quilos, insira 5125. Para 4 libras, insira 1814.

O valor-padrão é 0 se nenhum valor for inserido.

Use pesos precisos se você usa o frete calculado pela transportadora ou um serviço de processamento de pedidos de terceiros.

A unidade de medida na qual você quer que o peso do produto seja exibido na loja.

Os valores válidos são:

• g
• kg (padrão)
• lb
• oz

Indica se o produto é físico (em vez de digital, por exemplo) e, portanto, precisa ser enviado. Os valores válidos são:

• true (padrão): exige frete
• false: não exige frete

Saiba mais sobre os dados de frete.

O serviço de processamento de pedidos que você usa para um produto ou variante. Os valores válidos são:

• manual (padrão)
• shipwire
• webgistix
• amazon_marketplace_web

Se você usar um serviço personalizado de processamento de pedidos, insira o nome do serviço nesta coluna com as seguintes orientações:

• Use apenas letras minúsculas
• Substitua espaços por um hífen (-)
• Remova pontos e outros caracteres especiais

Por exemplo, se “Processamento da Joana” for o nome do seu serviço de processamento de pedidos, insira joans-fulfillment no arquivo CSV.

Você precisa ter um serviço de processamento de pedidos personalizado configurado no admin da Shopify para poder adicionar o nome do serviço nesta coluna.

Serviços de processamento de pedidos de terceiros: para as variantes armazenadas em um serviço de processamento de pedidos de terceiros, o CSV exportado exibe manual nesta coluna. As variantes de cartão-presente exibem gift_card em vez disso. As atribuições de serviço de processamento de pedidos e de local permanecem iguais.

Ao importar um CSV, definir esta coluna com o identificador de um serviço de processamento de pedidos específico (por exemplo, joans-fulfillment) ativa o estoque da variante no local desse serviço. Quaisquer outros locais em que a variante já esteja armazenada continuam com o estoque: nada é removido. Após a importação, esta coluna continua a exibir manual para essas variantes na reexportação. Para gerenciar o estoque de forma direta em locais específicos do serviço de processamento de pedidos, importe o arquivo CSV de estoque. Ou, caso trabalhe com um desenvolvedor, use a Inventory API.

Se você vende internacionalmente, esta coluna indica se o produto está incluído para venda em seu mercado principal. O valor-padrão é true.

O nome do cabeçalho desta coluna varia de acordo com o país ou a região definida como seu mercado principal no International. Se você alterar o mercado principal padrão, os cabeçalhos da coluna serão exibidos com o novo nome de mercado. Consulte a seção de considerações para mais informações.

Se você vende internacionalmente, esta coluna indica se o produto pode ou não ser vendido em seu(s) mercado(s) internacional(is). O valor-padrão é true.

O nome do cabeçalho desta coluna varia dependendo do International que você configurou em sua loja. O mercado padrão é International. Se você alterar o mercado padrão ou adicionar novos mercados, os cabeçalhos da coluna serão exibidos com esses nomes de mercado. Consulte a seção de considerações para mais informações.

Insira o URL da imagem do produto. A Shopify faz o download das imagens durante a importação e faz o upload delas novamente na sua loja.

Verifique se o nome do arquivo de imagem:

• é final: não é possível editá-lo depois que a imagem for carregada na loja
• Não inclui _thumb, _small, nem _medium sufixos

Esta coluna não é específica para variantes. Use a coluna de imagem da variante para adicionar imagens de variantes.

Insira o número que representa a ordem em que você quer que a imagem seja exibida na página do produto. As imagens são exibidas em ordem crescente, a partir de um valor de posição de imagem de 1. Por exemplo, se você quiser que a imagem seja exibida primeiro para esse produto, insira 1.

O texto alternativo (alt) descreve a imagem e o produto que ela representa. Se uma imagem não carregar no navegador por algum motivo, o texto alternativo será exibido no lugar. Ele também é usado por tecnologias assistivas para descrever uma imagem a clientes com deficiência visual que usam um leitor de tela, por exemplo. Incluir texto alternativo pode impulsionar o SEO do seu site.

Mantenha o texto alternativo breve e descritivo:

• o comprimento máximo é de 512 caracteres
• o tamanho ideal é de até 125 caracteres

Insira o URL das imagens da variante. Verifique se os URLs adicionados são URLs de imagem funcionais.

Indica se o produto é um cartão-presente. Os valores válidos são:

• false (padrão): o produto não é um cartão-presente
• true: o produto é um cartão-presente

Esta coluna também permite que você edite em massa outros detalhes do cartão-presente, como o Description ou Tags, mas não é possível criar um cartão-presente com a importação de um arquivo CSV de produto. Um cartão-presente só pode ser criado e ativado no admin da Shopify.

O nome do produto que é exibido nos resultados do mecanismo de pesquisa. O título de SEO que você insere pode ser alfanumérico e incluir até 70 caracteres. Títulos de SEO válidos são:

• alfanumérico
• até 70 caracteres

Se você deixar esta coluna em branco, o Title do produto será usado como título da página de listagem do produto no mecanismo de pesquisa.

Saiba mais sobre a edição de títulos de SEO.

A descrição de SEO também é encontrada na página de informações de um produto no cabeçalho Prévia da listagem em mecanismos de pesquisa, em Descrição. A descrição de SEO que você insere pode ser alfanumérica e incluir até 320 caracteres.

Se você deixar esta coluna em branco, o Description é usado.

Se você usa uma categoria Google do produto, pode usá-la como sua categoria de produto da Shopify. É possível usar a categoria do produto, a Categoria Google do produto ou ambas. Forneça a categoria mais específica possível para cada item.

A Categoria Google do produto (GPC) (google_product_category) usa a taxonomia de produtos do Google.

Você pode inserir a categoria Google do produto de uma das seguintes maneiras:

• Use a trilha de navegação completa da categoria, por exemplo, Vestuário e acessórios > Roupas > Partes de cima > Camisas
• Usar o ID da categoria, por exemplo, 212

Os cabeçalhos da coluna variam de acordo com o metacampo do Google Shopping que o valor incluído representa e são precedidos por Google Shopping / . Os metacampos incluídos nos cabeçalhos de coluna do CSV do produto são:

• Gender
• Age Group
• MPN
• Condition
• Custom Product
• Custom Label 0
• Custom Label 1
• Custom Label 2
• Custom Label 3
• Custom Label 4

As colunas do Google Shopping podem ser usadas por um app para sincronizar produtos com o Google Merchant Center. No entanto, o canal de vendas Google e YouTube não usa esses metacampos. Você pode ignorar os valores nas colunas de metacampos que incluem "Google Shopping" nos nomes, a menos que um app indique que você deve usá-los.

Esses metacampos de produto são criados na loja. A definição do metacampo de produto aparece no cabeçalho da coluna como NAME; (product.metafields.custom.KEY). Os seguintes tipos de metacampo são compatíveis com a importação ou exportação em massa por CSV:

• booleano
• cor (exemplo: #ff00cc)
• data
• data_hora
• dimensão (exemplo: 25.0cm)
• list.color (exemplo: #ff00cc; #cc0000)
• list.date (exemplo: 2023-12-02; 2023-12-03)
• list.date_time (exemplo: 2023-12-02T09:30:00; 2023-12-03T10:00:00)
• list.dimension (exemplo: 10.0cm; 3.0m)
• list.metaobject_reference (exemplo: gid://shopify/Metaobject/123; gid://shopify/Metaobject/456 ou os identificadores de metaobjeto, como blue; red)
• list.number_decimal (exemplo: 1.0; 2.1)
• list.number_integer (exemplo: 3; 4)
• list.product_reference (exemplo: gid://shopify/Product/123; gid://shopify/Product/456 ou os identificadores de produto, como boots; skis)
• list.url (exemplo: http://www.google.com; http://shopify.com)
• list.volume (exemplo: 10.0ml; 2.0l)
• list.weight (exemplo: 1g; 2.0lb; 3.0 kg)
• money (exemplo: 5.99 CAD)
• multi_line_text_field (exemplo:
  "Ingredients Flour Water Milk Eggs")
• number_decimal (exemplo: 1.0)
• number_integer (exemplo: 1)
• product_reference (exemplo: gid://shopify/Product/123 ou o identificador do produto, como boots)
• single_line_text_field (exemplo: single line)
• url (exemplo: http://shopify.com)
• volume (exemplo: 10.0ml)
• weight (exemplo: 10.0g)

Insira o nome da coleção à qual você quer adicionar este produto.

• Se for uma coleção automática existente, o produto precisará atender às condições da coleção.
• Se a coleção ainda não existir, uma coleção manual será criada.

Você pode adicionar um produto a apenas uma coleção.

Este valor pode ficar em branco.

O comprimento máximo é de 255 caracteres.

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