A importação de produtos WooCommerce não funciona: as soluções

O WooCommerce inclui um importador CSV decente, mas falha de formas que parecem uma extensão avariada quando o culpado é, na verdade, o ficheiro. A importação bloqueia nos 30 %, ou termina com metade dos produtos em falta, ou cria cada variação como um produto autónomo.

Eis o que se passa realmente.

A importação bloqueia ou expira

Os catálogos grandes são o caso clássico. O importador percorre o ficheiro por lotes através de pedidos AJAX sucessivos e, se os limites de PHP do seu servidor cortarem um lote, toda a execução para — normalmente sem qualquer erro, apenas uma barra de progresso que deixa de avançar.

A correção, pela ordem a tentar:

1. Divida o ficheiro. Duas mil linhas de cada vez é um tamanho seguro em alojamento partilhado.
2. Aumente max_execution_time e memory_limit no PHP. Muitos alojamentos expõem ambos no painel de controlo.
3. Se puder editar o functions.php do tema, reduza o tamanho dos lotes:

add_filter('woocommerce_product_import_batch_size', fn () => 10);

Comece por dividir o ficheiro. Resolve na maioria dos casos e não custa nada.

«Já existe um produto com este SKU»

Os SKU são únicos numa loja WooCommerce. O importador recusa qualquer linha cujo SKU já esteja ocupado e assinala-a como falhada.

Duas situações diferentes escondem-se atrás da mesma mensagem:

• Queria atualizar. Então a linha está correta: basta correr o importador em modo de atualização. No ecrã de envio, marque «Atualizar produtos existentes». A correspondência é feita primeiro por ID e depois por SKU.
• O seu ficheiro tem mesmo duplicados. Muito comum quando uma lista de fornecedor repete uma referência entre folhas. Remova duplicados antes de importar.

Para os encontrar no Excel: selecione a coluna SKU, Base → Formatação condicional → Regras de realce das células → Valores duplicados.

Tudo fica numa única coluna

O seu CSV está delimitado por ponto e vírgula. As versões portuguesa, francesa, alemã e espanhola do Excel escrevem ; porque a vírgula é o separador decimal.

A correção. O WooCommerce sabe lidar com isso — não precisa de reformatar. No ecrã de importação, abra as «Opções avançadas» e indique ; no campo do delimitador CSV. Em alternativa, guarde o ficheiro em CSV UTF-8 delimitado por vírgulas.

Acentos estragados

Café chega como Café quando o ficheiro está em Windows-1252 em vez de UTF-8. O WooCommerce não oferece opção de codificação: o ficheiro tem de estar correto.

A correção. No Excel, Guardar como → CSV UTF-8 (delimitado por vírgulas), a entrada de formato dedicada.

As variações são importadas como produtos separados

Os produtos variáveis exigem dois tipos de linha, ligadas entre si:

• O pai: Type com o valor variable, com Attribute 1 name (por exemplo Tamanho) e Attribute 1 value(s) a listar todas as opções separadas por vírgulas (S, M, L).
• Uma linha por variação: Type com o valor variation, Parent preenchido com o SKU do pai, e Attribute 1 value(s) a conter o valor dessa única variação (M).

Uma coluna Parent errada — ou vazia — e cada variação torna-se um produto autónomo. Garanta também que a linha do pai aparece antes das suas variações no ficheiro.

Categorias não criadas, ou criadas planas

A coluna Categories usa > para a hierarquia e , para separar várias categorias:

Mobiliário > Cadeiras, Saldos

O produto fica em Cadeiras (sob Mobiliário) e em Saldos. Usar / ou | cria simplesmente uma categoria plana com um nome estranho.

Preços ignorados

Regular price e Sale price têm de ser números puros, com ponto como separador decimal e sem símbolo monetário. 29,90 € não é lido como preço e o campo fica vazio.

A correção. Ponha as colunas de preço em formato Texto e escreva 29.90. Mudar a forma como o Excel apresenta o número não chega — verifique o que está mesmo no CSV guardado.

Imagens não associadas

A coluna Images aceita URLs públicos completos, separados por vírgulas, sendo o primeiro a imagem em destaque. O WooCommerce descarrega e importa cada uma durante a importação, o que explica também a lentidão dos ficheiros com muitas imagens. Os caminhos locais e os URLs atrás de autenticação são ignorados.

Lista de verificação antes de importar

• Ficheiro abaixo de ~2.000 linhas, ou limites de PHP aumentados
• SKU únicos, ou modo de atualização ativado deliberadamente
• Delimitador indicado nas opções avançadas, ou ficheiro com vírgulas
• Guardado em CSV UTF-8
• As linhas de variação levam um SKU Parent e seguem o seu pai
• Categorias com > e ,
• Preços em números puros com ponto
• URLs de imagem públicos e absolutos

Quando é um ficheiro de fornecedor recorrente

Montar isto uma vez para migrar um catálogo, tudo bem.

Reconstruí-lo todas as semanas a partir da tabela de preços de um fornecedor é onde deixa de ser razoável. A Importly mapeia as colunas do fornecedor para os nomes do WooCommerce (Name, SKU, Regular price, Categories, Weight (kg), Stock, Images), converte os preços em decimais simples, normaliza pesos, quantidades de stock e URLs de imagem, corrige a codificação e elimina as linhas vazias. Guarde o mapeamento uma vez como perfil e o ficheiro da semana seguinte passa por regras idênticas. As linhas de pai e variação continuam a seu cargo: a Importly limpa nomes de colunas e valores, não remodela a estrutura das linhas.

Limpar a sua primeira exportação gratuitamente →