Como importar produtos para o Shopify por CSV sem estragar o catálogo

Tens dezenas ou centenas de produtos para carregar no Shopify e não os queres criar um a um, ou queres mudar um campo em todos eles de uma vez. A importação por CSV faz isso, mas o mesmo ficheiro que cria cem produtos numa passagem também consegue apagar dados de cem produtos numa passagem. A diferença está na preparação.

O método que sigo tem três regras. Parte sempre de uma exportação real da tua loja, não de um ficheiro montado de cabeça. Importa primeiro um único produto e confirma-o no painel. Só depois importas o lote. Se fizeres isto, um erro no ficheiro estraga um produto, não o catálogo.

Antes de tocar no ficheiro: exporta o que já tens

Em Produtos, clica em Exportar e escolhe todos os produtos, em CSV para folha de cálculo. Guarda o ficheiro com a data no nome e não lhe mexas. Serve para duas coisas.

A primeira é ser o teu ponto de retorno. Uma importação não pode ser cancelada depois de começar, segundo a documentação de importação do Shopify. Se correr mal, é esta exportação, reimportada com a opção de substituir que explico mais abaixo, que te permite repor.

A segunda é dar-te os nomes exatos das colunas. O formato do ficheiro mudou ao longo do tempo: os cabeçalhos atuais são legíveis, como URL handle e Product image URL, e a exportação inclui os metacampos que definiste, com cabeçalhos do tipo Cor (product.metafields.custom.cor). Um ficheiro mestre construído há uns anos deixa de bater certo com a exportação atual: faltam-lhe colunas e as que tem podem ter outro nome. Se o usas para atualizar produtos, alinha-o com os cabeçalhos da exportação nova. Com milhares de produtos isso só é viável com automação; com dezenas, é copiar os cabeçalhos.

Se a loja está vazia, ou ainda não tens nenhum produto com metacampos e preços por mercado preenchidos, cria um produto de rascunho e preenche-o por completo: variantes, imagens, metacampos, preços por mercado. Exporta só esse produto. Tens assim um modelo real com as colunas que a tua loja usa, o que é muito mais fiável do que adivinhar o nome de coluna de um metacampo. O ficheiro de exemplo ligado no guia do formato CSV do Shopify também serve para ver a estrutura, mas não conhece os teus metacampos nem os teus mercados.

Preparar o ficheiro no Google Sheets

Trabalho sempre no Google Sheets e não no Excel. Já vi importações falharem porque o CSV exportado pelo Excel vinha com erros de formato; com o Google Sheets nunca me aconteceu. Abre a exportação no Sheets, trabalha lá e no fim usa Ficheiro > Transferir > Valores separados por vírgulas (.csv). O Sheets grava em UTF-8, que é o que o Shopify exige; é na conversão feita por outros programas que costumam aparecer caracteres estranhos nos acentos.

As colunas que mais decidem o resultado, com os nomes do formato atual (o Shopify continua a aceitar os nomes antigos, que indico entre parênteses quando diferem):

• URL handle (antes Handle): o identificador único do produto, que também é o fim do URL da página. Só letras, números e traços, sem espaços nem acentos. Se o deixares vazio num produto novo, o Shopify gera-o a partir do título. Em qualquer linha adicional do mesmo produto, o handle tem de estar preenchido, senão o Shopify não sabe a que produto pertence essa linha.
• Title e Description (antes Body (HTML)): título e descrição. O Title é a única coluna obrigatória para criar um produto simples, segundo o guia do formato CSV.
• Status: active, draft ou archived. Se a coluna está no ficheiro, tem de estar preenchida na primeira linha de cada produto; vazia ou com outro valor, a importação pára com a mensagem de que o estado não é válido. Sem a coluna, a documentação diz que o produto entra como active. Não confundas com Published on online store, que diz apenas se o produto está visível na loja online.
• Variantes: cada combinação de opções é uma linha. Três cores e três tamanhos dão nove linhas, com handle em todas e os valores em Option1 value e Option2 value. Se o produto não tem variantes, deixa as colunas de opção completamente vazias; um valor perdido nessas células cria uma variante que não querias.
• Imagens: coloca o URL completo em Product image URL (antes Image Src). O Shopify descarrega a imagem e guarda-a na loja, por isso o URL de origem pode desaparecer depois. Tem de ser um endereço público em https, sem palavra-passe. Para várias imagens, acrescenta uma linha por imagem só com handle, URL, Image position e Image alt text. A ordem vem de Image position.
• Weight value (grams): o peso é sempre em gramas e em número inteiro, mesmo que o painel mostre quilos. Um produto de 1,2 kg leva 1200.
• Price: usa ponto nos decimais, 19.90. Não tenho a certeza de que a vírgula dê sempre erro, mas nunca a uso.
• Tags: separadas por vírgula na mesma célula.
• Inventário: Inventory tracker com shopify ativa o controlo de stock, Inventory quantity é a quantidade e Continue selling when out of stock (antes Variant Inventory Policy) aceita deny ou continue, que corresponde à opção de continuar a vender quando esgotado.
• Product category: aceita o identificador da categoria na taxonomia do Shopify, do tipo hg-15-1-2, ou o caminho completo, como Home & Garden > Linens & Bedding > Bedding > Bed Sheets. Um valor inválido não trava a importação; o produto entra sem categoria e ficas sem o saber, a não ser que verifiques.
• Collection: esta coluna não vem na exportação nem no ficheiro de exemplo; acrescenta-a com esse nome exato. Só permite uma coleção por produto e, se a coleção não existir, o Shopify cria-a. Numa coleção automática, o produto só entra se cumprir as condições, mesmo com o nome na coluna.
• SEO title e SEO description: vazios, herdam o título e a descrição.

Metacampos importam-se com o cabeçalho exato que vês na exportação. Texto formatado (rich text) não é suportado na importação, e os metacampos de variante também não; para esses fica o editor em massa do painel. Mantém as linhas adicionais de variantes e imagens logo a seguir à primeira linha do produto: uma folha reordenada pode ter perdido a associação ao handle certo.

Testa com um único produto

Com o ficheiro completo pronto, não o importes. Cria um separador novo no Sheets, copia para lá a linha de cabeçalho e as linhas do primeiro produto (a primeira e as adicionais, se tiver variantes ou várias imagens) e transfere só esse separador como CSV.

1. Em Produtos, clica em Importar e depois em Adicionar ficheiro.
2. Decide as duas opções do ecrã. Publicar os novos produtos em todos os canais de vendas publica também no Shop, no Google, no ponto de venda e no que mais tiveres ligado; desmarcada, o produto fica só na loja online. Substituir produtos com identificadores correspondentes só interessa quando estás a atualizar produtos existentes; num produto novo deixa-a desmarcada.
3. Clica em Carregar e pré-visualizar. O Shopify valida o ficheiro e mostra um resumo do que vai importar. É aqui que aparecem os erros de estrutura, como o estado em falta.
4. Clica em Importar produtos.

Os nomes dos botões variam com a versão e o idioma do painel; na documentação em inglês o passo 3 chama-se “Upload and continue”.

Depois abre o produto no painel e na loja. Confere título, descrição, preço, variantes, ordem das imagens, coleção, categoria e stock. Se algo falhou, corriges no ficheiro principal e repetes com o mesmo produto, com a opção de substituir marcada para não o duplicares. Só quando o produto de teste sai limpo é que passas ao lote.

Importar o lote e o que esperar

Repete os mesmos passos com o ficheiro completo. O Shopify limita cada CSV a 15 MB e recomenda dividir em vários ficheiros quando o carregamento falha ou expira. Quando a importação termina, chega um email à conta que criou a loja.

Não há forma de cancelar a meio. Se percebeste um erro depois de clicar em importar, deixa terminar, exporta o estado atual com outro nome e compara com a exportação inicial antes de corrigir. Se o problema foram imagens que desapareceram, o artigo sobre imagens perdidas depois de um CSV explica como isolar a causa antes de reimportar.

Atualizar produtos existentes sem apagar o resto

A importação serve também para mudar um campo em centenas de produtos de uma vez, e é aqui que a regra das colunas mais conta:

• Uma coluna presente mas vazia apaga o valor que existia. Um Vendor vazio numa atualização deixa o produto sem fornecedor.
• Uma coluna ausente do ficheiro deixa o valor existente como está.

O procedimento que uso: exportar os produtos a alterar, apagar do ficheiro todas as colunas que não vou mexer, deixar URL handle, Title e a coluna a editar, fazer a alteração, e importar com Substituir produtos com identificadores correspondentes marcada. Sem essa opção, os produtos cujo handle já existe são ignorados e nada muda.

Dois avisos documentados pelo Shopify. Há colunas com dependências: se incluíres SKU ou o peso sem Option1 name e Option1 value, as variantes existentes são apagadas. E alterar os valores das opções nas colunas Option1 value, Option2 value ou Option3 value elimina as variantes antigas e cria novas, com identificadores novos; a Shopify avisa que isso pode quebrar integrações de terceiros que dependem desses identificadores. Testa primeiro com um produto, como em qualquer importação.

CSV ou conector de IA?

Se já ligaste um assistente de IA à loja por conector, tens uma segunda via para criar e atualizar produtos. A minha leitura: o CSV é mais controlado, porque cada célula foi vista por ti, mas dá mais trabalho manual e tem os erros de formato que viste acima. O conector reduz etapas e costuma dar menos erros de estrutura, mas o que entra na loja foi escrito pela IA, por isso a validação por amostra deixa de ser opcional. Escolhe dez registos alterados e confirma-os um a um; se um estiver errado, pára, pede nova análise e correção antes de continuar. A exportação de segurança é obrigatória nas duas vias; a checklist antes de deixar a IA alterar a loja detalha o resto.

Verificação final

• A exportação de segurança está guardada com data, separada do ficheiro em que estás a trabalhar.
• O produto de teste foi importado sozinho e conferido no painel e na loja antes do lote.
• Cada linha adicional de variante ou imagem tem o handle preenchido.
• Nenhuma coluna ficou presente e vazia numa atualização, a não ser que quisesses apagar esse campo.
• Depois do lote, abre uma amostra de produtos ao acaso, incluindo um com variantes e um com várias imagens, e vê a página no telemóvel.
• Abre alguns produtos e confirma a categoria: um valor inválido no ficheiro deixa o produto sem categoria, sem aviso na loja.

Se estás a criar a loja e é a tua primeira importação, vale a pena perceber antes como se cria e verifica um produto à mão; o CSV só repete, em massa, o que farias na ficha.

Este artigo foi preparado com base nos conteúdos da Academia Shopifyers.