Mapear colunas do fornecedor nos campos de produto do WooCommerce

Como mapear as colunas do fornecedor nos campos de produto do WooCommerce

Mapear as colunas do fornecedor nos campos de produto do WooCommerce significa decidir qual informação da tabela de preços se torna nome, SKU, preço, categoria, imagem ou atributo no catálogo. O arquivo do atacadista chega com os próprios rótulos: código do artigo, descrição comercial, família, EAN. O WooCommerce espera nomes de coluna diferentes e tipos de produto distintos. Sem uma tabela de correspondência, a importação cria fichas incompletas, duplicados e feeds que os canais rejeitam.

Um crawler lê o título visível, o texto da ficha, as imagens e os dados estruturados que o WooCommerce já disponibiliza na página. Se a coluna de descrição do fornecedor for parar no nome, o título vira um parágrafo. Se o SKU estiver ausente, a sincronização seguinte não terá uma chave. Se o EAN estiver em uma nota livre, o GTIN não entrará nos feeds. O mecanismo é visível: campos vazios ou no lugar errado, não um algoritmo misterioso.

Por que o arquivo do fornecedor nunca está pronto para o WooCommerce

A tabela de preços do fornecedor é uma ferramenta de venda por atacado, não um esquema de catálogo: os nomes das colunas, as casas decimais e as famílias de produtos não coincidem com os campos nativos do WooCommerce.

O atacadista otimiza a planilha para quem faz pedidos: código interno, descrição compacta, preço por faixa, unidades por caixa. O WooCommerce otimiza a ficha para quem compra e para quem indexa: nome legível, SKU estável, preço com um único separador decimal, categorias da loja, atributos visíveis nos filtros e imagens com URL pública. Os dois objetos compartilham os fatos (artigo, preço, código de barras), mas não o formato.

Um exemplo ilustrativo: uma loja com quarenta referências recebe um CSV com as colunas COD, DESCR, PZ, FAM, BARCODE. A linha DESCR contém «VASO ESMALTE AZUL D20 H18 PZ/CT 6». Esse texto não é um título, não é uma descrição e não é um conjunto de atributos. São três campos compactados em um só. Enquanto você não os separar, a importação publicará uma ficha que um assistente terá dificuldade para citar e que o Google Shopping lerá como um título confuso.

O texto da página e os dados estruturados trabalham juntos: a marcação confirma preço e disponibilidade quando coincide com a página.

Campos obrigatórios e opcionais de um produto WooCommerce

Para criar uma ficha basta um nome; para vendê-la são necessários preço e, se você gerencia o estoque, quantidade; para não criar duplicados é preciso o SKU; os demais campos determinam se a ficha está completa para a loja e os feeds.

O WooCommerce, no arquivo CSV nativo, reconhece rótulos fixos em inglês. Não é possível deixar os nomes do fornecedor no cabeçalho e esperar que o plugin de importação «entenda». Você precisa renomear as colunas ou usar a tela de correspondência em Produtos, Importar. Os campos usados quase sempre são estes.

• Name: título da ficha, visível na página e nos resultados.
• SKU: chave única da loja; sem SKU, cada reimportação pode criar um duplicado.
• Type: simple, variable, variation, grouped ou external.
• Regular price: preço de tabela no formato da loja, normalmente com ponto decimal.
• Description e Short description: texto longo na página e resumo na listagem.
• Categories e Tags: caminhos já existentes ou que devem ser criados antes da importação.
• Images: URLs públicas, uma ou mais, separadas conforme o CSV exige.
• Attribute n name / Attribute n value(s): atributos globais ou locais (cor, tamanho, material).
• Parent: SKU do produto-pai, apenas nas linhas variation.
• Stock e In stock?: quantidade e indicador de disponibilidade, se o gerenciamento de estoque estiver ativado.

Peso, comprimentos, classe de envio, classe de IVA e identificador global (GTIN, se você o tiver nos materiais do fornecedor) são opcionais para publicar, mas a ausência deles aparece imediatamente nos feeds e na ficha. Segundo o Google Search Central, existem duas classes principais de dados estruturados para produtos: a marcação que o WooCommerce já produz confirma os fatos apenas quando eles coincidem com o título, o preço e a disponibilidade escritos na página.

Quem importa tabelas de preços de vários fornecedores na mesma loja

Quem importa tabelas de preços de vários fornecedores na mesma loja deve tratar o SKU como um espaço de nomes. Dois atacadistas podem usar o mesmo código «1001». Adicione um prefixo ao SKU (FORN1-1001) ou mantenha uma coluna de fornecedor como atributo oculto, nunca como parte do título. O GTIN, quando presente e válido, continua sendo a identidade da peça física; o SKU continua sendo a identidade da linha no seu sistema de gestão.

Como ler e mapear as colunas do fornecedor uma por uma

Abra o CSV do fornecedor, liste cada cabeçalho e escreva ao lado o campo de destino do WooCommerce, com uma regra para os valores que precisam ser separados ou descartados.

Não comece pela importação. Comece por uma planilha de mapeamento com três colunas suas: cabeçalho original, campo do WooCommerce e regra de limpeza. A regra evita que a mesma coluna vá parar em dois campos ou em nenhum.

1. Abra o arquivo em uma planilha com codificação UTF-8. Se o Excel em português tiver usado ponto e vírgula, não converta de forma aleatória: anote o separador antes de salvar.
2. Congele a primeira linha e percorra os cabeçalhos. Marque CODICE, ART, ITEM, REF como candidatos a SKU. Marque DESCRIZIONE, NOME, ITEM NAME como candidatos a título. Marque EAN, GTIN, BARCODE, UPC como candidatos a identificador global.
3. Abra WooCommerce, Produtos, Importar e compare os rótulos nativos (Name, SKU, Regular price, Categories, Images, Attribute 1 name). Quando os nomes não coincidirem, renomeie o cabeçalho do CSV ou faça a correspondência manual no menu suspenso da tela de importação.
4. Para cada coluna ambígua, escreva a regra. Exemplo: FAMIGLIA vai para Categories somente depois que as mesmas categorias forem criadas na loja; COLORE e TAGLIA vão para atributos globais (Produtos, Atributos), não para o título.
5. Escolha o Type. Uma linha, um artigo vendável: simple. O mesmo modelo com vários tamanhos ou cores: um pai variable e linhas variation com Parent igual ao SKU do pai.
6. Normalize os números. O preço com vírgula decimal deve ser convertido para o formato esperado pela loja. Quantidades devem ser inteiras. O peso deve usar a unidade definida em WooCommerce, Configurações, Produtos.
7. Salve um CSV de teste com dez linhas, importe-o como rascunho, abra uma ficha e verifique nome, SKU, preço, estoque, atributos e imagem antes de mexer em todo o catálogo.

Um exemplo ilustrativo de antes e depois, declarado como tal. Antes, uma única célula: «CAMISETA ALGODÃO HOMEM AZUL M 19,90 8001234567897». Depois do mapeamento: SKU vindo do código do artigo; Name «Camisa de algodão azul, masculina»; atributo Material algodão, atributo Cor azul, atributo Tamanho M; Regular price 19.90; GTIN somente se o código de barras estiver nos materiais do fornecedor e passar pelo dígito de controle. A frase sobre a caixa não é o título.

Quem tem pouco tempo para a rotina diária

Quem tem pouco tempo para a rotina diária não mapeia cada nova linha manualmente. Congele a tabela de correspondência em uma planilha-modelo e, a cada tabela de preços, renomeie apenas o cabeçalho. Se o fornecedor adicionar uma coluna, trate-a como exceção: ignore-a ou vincule-a a um atributo já existente. O custo oculto não é a importação, mas refazer as regras toda segunda-feira.

Erros comuns

Os erros de mapeamento que prejudicam SEO e feeds são sempre os mesmos: título sujo, categoria do atacadista no lugar da categoria da loja, GTIN inventado ou no campo errado e variações separadas em produtos simples.

Título igual à descrição do fornecedor. Isso aparece assim: na vitrine surge um nome todo em maiúsculas, com unidades por caixa, códigos internos e medidas coladas. Isso acontece porque a coluna DESCR é a única coluna textual e acaba em Name. A solução é extrair um título curto (produto, material, característica distintiva) e mover o restante para Description ou para os atributos. O Title Case deve ser aplicado depois, não no lugar da limpeza.

Categoria do fornecedor copiada como categoria da loja. Isso aparece assim: em Produtos, Categorias surgem dezenas de entradas duplicadas («CERAMICA», «Cerâmica», «cerâmicas») e os filtros do tema não agrupam nada. Isso acontece porque FAMIGLIA não coincide com a taxonomia que você definiu. A solução é criar primeiro a árvore de categorias no WooCommerce e mapear com uma tabela de equivalência (FAMIGLIA «CER-VAS» → Categoria «Vasos»). A categoria da taxonomia do Google é um campo separado: não é o slug da loja e não deve ser improvisada no CSV se não tiver sido confirmada.

GTIN no lugar errado ou inventado. Isso aparece assim: o feed aponta identificadores ausentes, duplicados ou inválidos; na ficha, o código está nas notas. Isso acontece porque BARCODE foi colocado em Description ou porque alguém copiou um EAN de um site de terceiros. A solução é copiar o código somente dos materiais do fornecedor (coluna, foto da embalagem, PDF) e deixar o campo vazio se ele não estiver disponível. Um GTIN não deve ser procurado na web nem fabricado.

Variações importadas como produtos simples. Isso aparece assim: três fichas «mesmo suéter, três tamanhos», três URLs e três preços que divergem na primeira atualização. Isso acontece porque a tabela de preços tem uma linha para cada SKU-filho e a importação usa Type simple em todas elas. A solução é esta: uma linha-pai com Type variable e atributos usados nas variações; linhas-filhas com Type variation, Parent igual ao SKU do pai e um único valor de atributo por linha. Segundo o blog de desenvolvedores do WooCommerce, a partir da versão WooCommerce 11.1 as galerias de variação serão habilitadas para cada loja: faz sentido mapear também as imagens por variação, não apenas a do pai.

Um artesão que vende cerâmicas e gerencia cerca de quarenta referências

Um artesão que vende cerâmicas e gerencia cerca de quarenta referências costuma receber do ateliê uma planilha com esmalte, diâmetro e unidades por caixa na mesma célula. Aqui, o mapeamento é curto e deve ser feito uma vez: SKU próprio, nome com forma e cor, atributos Diâmetro e Esmalte, peso para o envio. Não é necessário um produto variável se cada vaso for uma peça única: Type simple, imagens diferentes e nenhum Parent.

Importação do CSV da planilha do fornecedor para o catálogo publicado

A importação nativa de CSV do WooCommerce publica apenas o que já foi mapeado: carregue um arquivo de teste, associe as colunas, verifique uma ficha em rascunho e só depois importe todo o catálogo.

O caminho no sistema de gestão é Produtos, Importar. O WooCommerce solicita o arquivo e depois mostra cada cabeçalho do CSV ao lado de um menu de campos conhecidos. Se você renomeou as colunas com os nomes nativos (Name, SKU, Regular price), a correspondência é quase automática. Se deixou COD e DESCR, deverá escolher manualmente. A opção de atualizar produtos existentes usa o SKU como chave: sem SKU, a atualização cria novas linhas.

1. Exporte primeiro um CSV de um produto já publicado (Produtos, Exportar) e use-o como modelo de colunas. Esse é o vocabulário que a importação entende sem ambiguidades.
2. Copie os valores do fornecedor para baixo desses cabeçalhos, não o contrário. A tabela de preços original continua sendo um arquivo de referência; o arquivo de importação é um derivado limpo.
3. Defina Published como -1 (rascunho) na primeira rodada. Assim, as fichas não vão para a vitrine com títulos sujos.
4. Carregue o arquivo, confira a correspondência coluna por coluna, inicie a importação e abra três fichas de amostra: uma simples, uma variação e uma sem imagem.
5. Corrija a planilha, não as fichas uma a uma, e reimporte atualizando por SKU. Quando nome, preço, estoque e atributos coincidirem, altere Published para 1.

Se o fornecedor não entregar um CSV, mas uma tabela de preços diagramada, o trabalho de extração vem antes do mapeamento. Nesse caso, passe do PDF aos dados do produto e só depois alinhe as colunas aos campos do WooCommerce. O mesmo vale para uma foto de etiqueta: primeiro os fatos visíveis, depois a associação a SKU, nome e atributos.

Como acelerar o mapeamento em catálogos grandes sem refazer tudo manualmente

Em catálogos grandes, o mapeamento fica mais rápido quando você congela as regras de correspondência, os atributos globais e as categorias antes da importação, atualizando depois apenas as colunas que o fornecedor realmente alterou.

A tentação é abrir duas mil linhas e limpar os títulos manualmente. Esse caminho não escala. Prepare a loja: em Produtos, Atributos, crie Cor, Tamanho, Material e Marca como atributos globais, com os valores já usados na vitrine. Em Produtos, Categorias, defina a árvore. Na planilha de mapeamento, estabeleça as equivalências do fornecedor com essas listas. A importação grava valores conhecidos; os valores novos ficam evidentes porque não correspondem à lista.

• Atualize por SKU apenas preço, estoque e disponibilidade quando a tabela de preços for uma renovação.
• Mantenha Name e Description fora da renovação automática se você já os reescreveu em português legível.
• Separe os arquivos: um para novos SKUs, um para atualizações e um para variações.
• Não misture produtos simples e variações no mesmo CSV enquanto a coluna Parent não estiver preenchida e coerente.
• Descarte do arquivo de importação as colunas que não têm um campo correspondente (descontos por faixa, pedido mínimo, notas internas do atacadista).

Um GTIN só deve ser lido nos materiais do comerciante, na foto da embalagem, no PDF ou na coluna do CSV, e deve passar pelo dígito de controle: não se inventa nem se procura na web.

Quem alinha a mesma tabela de preços a vários canais de venda

Quem alinha a mesma tabela de preços a vários canais de venda (Amazon, eBay, Etsy) precisa decidir quem é o responsável pelos fatos. O WooCommerce mantém SKU, título da loja, preço e estoque. Os marketplaces recebem uma exportação derivada, não o CSV bruto do fornecedor. Se você mapear o título da Amazon para o Name da loja, perderá a frase útil na vitrine. É melhor usar um atributo ou uma coluna de exportação por canal e um único Name pensado para a ficha do site.

Para um eventual feed destinado a assistentes de compra, permanecem os nove campos da especificação da OpenAI (item_id, title, description, url, brand, seller_name, image_url, availability, price com moeda). GTIN e MPN são opcionais. Esses campos são preenchidos depois do mapeamento do WooCommerce, não no lugar de Name e SKU. Os nomes link e image_link pertencem ao Merchant Center, não a esse feed.

Como a Katapic ajuda a levar a tabela de preços para os campos corretos

A Katapic importa de CSV, PDF e fotos, preenche apenas os campos vazios com fatos verificados e devolve as fichas ao WooCommerce com a sincronização bidirecional.

Se o fornecedor enviar uma planilha, a importação do CSV entra no catálogo de trabalho; se enviar uma tabela de preços diagramada, a leitura página a página extrai textos e imagens incorporadas e os associa aos produtos. Uma foto, uma ficha: a partir da foto, a Katapic reconhece o produto, a marca, a categoria e os atributos, e tudo continua editável antes de publicar. O preenchimento dos campos vazios é uma ação separada, solicitada explicitamente, com fonte.

A análise gratuita de um catálogo WooCommerce público, sem conta e somente leitura, mostra duas pontuações por ficha (pesquisa clássica e preparação para os assistentes), além de uma verificação da prontidão dos dados nos campos ausentes ou incorretos; a Relevância e a Completude ficam disponíveis com uma conta gratuita. A categoria da taxonomia do Google é proposta para cada categoria da loja: você confirma, e o identificador confirmado entra nos feeds. As prováveis variações (mesmo título com tamanho, cor, embalagem) são propostas como variações de um único produto e só são agrupadas mediante confirmação.

A sincronização do WooCommerce é bidirecional, com o plugin gratuito. A reescrita das fichas passa por um verificador de afirmações: marcas, certificações e história da marca não são inventadas; se uma medida encontrada na web contradiz o título do comerciante, prevalece o dado do comerciante. As correções gratuitas (Title Case nos títulos todos em maiúsculas, limpeza do HTML, condição, declaração sem GTIN do fabricante, agrupamento de variações, confirmação da categoria do Google) só são aplicadas com confirmação explícita e podem ser desfeitas. Para organizar o catálogo WooCommerce, o ponto de partida são os fatos que você já tem, não um texto gerado em seu lugar.

Perguntas frequentes sobre o mapeamento de CSV no WooCommerce

Quais campos são obrigatórios para um produto WooCommerce em uma importação de CSV?

Para criar a ficha, é necessário pelo menos o Name. Para vendê-la, são necessários Regular price e, se você ativar o estoque, Stock com In stock?. O SKU não é exigido pelo formulário de criação, mas sem SKU a importação não consegue atualizar e cria duplicados. Type é necessário assim que houver variações. Categorias, imagens, atributos e GTIN não impedem a publicação, mas uma ficha sem esses fatos fica pobre para a loja e os feeds.

Como mapear as colunas do arquivo do fornecedor nos campos de produto do WooCommerce?

Crie uma tabela de correspondência: cada cabeçalho da tabela de preços deve ter um campo de destino (SKU, Name, Regular price, Categories, Images, Attribute) e uma regra de limpeza. Depois, renomeie o cabeçalho do CSV com os nomes nativos ou faça a correspondência manual em Produtos, Importar. Teste com dez linhas em rascunho. Só quando título, preço e atributos coincidirem importe o restante, atualizando por SKU.

Onde colocar o código EAN do fornecedor na ficha do WooCommerce?

O EAN deve ir no identificador global do produto (GTIN), não no título nem na descrição. Copie-o apenas se ele aparecer nos materiais do fornecedor e passar pelo dígito de controle. Se a coluna estiver vazia, o campo permanece vazio: não procure um código na web nem invente um. Um EAN colocado nas notas não entra nos feeds nem ajuda a ficha.

Como importar um CSV de produtos do WooCommerce sem duplicar os SKUs?

Cada linha deve ter um SKU único na loja. Na importação, escolha a atualização dos produtos existentes: o WooCommerce usa o SKU como chave. Adicione prefixos aos SKUs se dois fornecedores compartilharem o mesmo código. Não importe duas vezes um arquivo sem SKU. Antes, verifique Produtos, Todos os produtos, pesquise pelo SKU e só depois inicie a atualização de preços e estoque.

Como atribuir a categoria do Google aos produtos do WooCommerce?

A categoria da loja (Produtos, Categorias) não é a categoria da taxonomia do Google. Primeiro, defina a árvore interna e mapeie a família do fornecedor para ela; depois, associe separadamente o ID confirmado do Google para uso nos feeds. Não cole a string FAMIGLIA do atacadista no campo do Google. Sem confirmação, você fica com uma categoria de vitrine útil para o tema, não com um ID de taxonomia nos canais.

O que acontece se as variações do fornecedor chegarem em linhas separadas?

Se cada tamanho ou cor estiver em uma linha e você os importar como simple, obterá fichas duplicadas e URLs distintos. O mapeamento correto é um pai variable com os atributos de variação e filhas variation com Parent igual ao SKU do pai. Use um único valor de atributo por linha-filha. As imagens de cada variação devem ser vinculadas à linha-filha, não apenas ao pai, para que a galeria mostre a peça correta.

É possível tratar uma tabela de preços em PDF como um CSV para mapear?

Sim, mas em duas etapas. Primeiro, extraia das páginas e tabelas os fatos (código, nome, preço e eventuais imagens incorporadas) para obter uma grade. Depois, essa grade segue as mesmas regras de mapeamento do CSV: SKU, Name, preço, categorias e atributos. Ignorar a extração e copiar manualmente de um PDF de cem páginas é o caminho que produz títulos sujos e campos vazios.