Joay Agropecuária · equipe de cadastro

Manual de cadastro de produto

Checklist para cadastrar produto na loja. Feito para ficar aberto na segunda tela enquanto você trabalha no WordPress.

A regra de ouro: escolha da lista, nunca digite

Ao preencher o valor de um atributo — Tamanho, Cor, Embalagem/Peso — sempre selecione o termo que já existe na lista. Se você digitar um valor novo, o WooCommerce cria um termo duplicado em silêncio, e a variação correspondente fica órfã: some da página do produto, mas continua puxando o preço para o "a partir de R$ X" da vitrine. O cliente vê um preço que não consegue comprar.

Isso não é hipótese — aconteceu no teste. Digitar 75kg em vez de escolher o termo 7,5kg criou um segundo termo e derrubou a variação mais barata da página do produto, enquanto a loja seguia anunciando o preço dela na vitrine.

Se o valor que você precisa não existe na lista, crie o atributo primeiro em Produtos → Atributos, e só depois use no produto.

Campos obrigatórios

Todos. Sem exceção. Cada um deles quebra alguma coisa lá na frente se ficar em branco.

Campo	Onde fica	O que quebra se faltar
Nome	Topo da página	—
SKU	Dados do produto → Inventário	É a chave do feed de anúncio. Sem ele, o remarketing do Meta e do Google falha em silêncio.
Preço	Geral (ou por variação)	Produto publicado sem preço não vende.
Marca	Caixa Marcas, na lateral	É o filtro nº 1 da loja e o campo brand do Google Merchant. Marca não é atributo — não existe mais pa_marca.
Categoria	Caixa Categorias	Produto sem categoria não aparece na navegação.
Imagem	Imagem do produto	Card da loja e feed de anúncio ficam sem foto.
Peso	Envio	O Melhor Envio não cota sem peso.
Dimensões	Envio	Sem elas o frete sai errado — a transportadora cobra por peso volumétrico.
GTIN / EAN	Inventário	O Google Merchant cobra. Preencher agora é barato; corrigir 300 SKUs depois, não.

Peso e dimensões são do PACOTE FECHADO, não do conteúdo. Um saco de ração de 20 kg pesa uns 20,3 kg com a embalagem — e o que define o preço do frete é a caixa que sai da loja, com as medidas dela.

Padrão de SKU

CATEGORIA-MARCA-PRODUTO[-VARIAÇÃO] — maiúsculas, sem acento, separado por hífen.

RAC-SPD-VEG-20KG      ração · Special Dog · vegetais · 20 kg
PET-SUP-BENEFIT-450G  petisco · Supra · linha Benefit · 450 g
CAM-TF-AZUL-M         camisa · Texas Farm · azul · M

Em produto variável, cada variação tem o seu próprio SKU. O SKU do produto-pai é só o código da família.

Quando o produto é variável

Roupa com tamanho e/ou cor → variável (variação por Tamanho × Cor).
Ração vendida em vários pesos → variável (variação por Embalagem/Peso).
Uma foto por variação é opcional, mas ajuda: a página troca a imagem quando o cliente escolhe a cor.

Cada variação precisa de preço, SKU, peso e dimensões próprios. Sem isso, o frete daquela variação sai errado — e só daquela, o que é difícil de perceber depois.

Fotos

A galeria da página de produto tem slider com miniaturas — use quantas fotos quiser (o padrão da moda country é 4 a 6). A primeira vai em Imagem do produto; o resto vai na Galeria. Clicar na miniatura troca a imagem principal, e a lupa abre o zoom.

Antes de publicar em lote

Peça para rodarem a auditoria do catálogo. Ela varre a loja inteira e lista tudo que vai quebrar frete ou feed de anúncio — inclusive dentro das variações, que é onde é fácil esquecer.

tools/audit-catalogo.py

Se sair Nada pendente, o catálogo está pronto. Qualquer pendência aparece listada por produto, dizendo exatamente o que falta. Rodar isso leva segundos — descobrir na primeira venda que o frete saiu R$ 0,00 custa bem mais.

Pendência aberta hoje: os 5 produtos atuais (#704, #706, #708, #710, #712) estão sem peso e sem dimensões. Nenhum dos dois foi estimado de propósito: chute em peso ou medida vira prejuízo real em cada frete cotado. Precisamos do peso e das medidas do pacote fechado de cada um.