Grade de Tamanho
A tela Grade de Tamanho gerencia as tabelas de medidas (size charts) que os anúncios do canal de venda usam para identificar tamanhos — usadas principalmente em vestuário, calçados e acessórios no Mercado Livre. Cada grade é uma tabela com atributos por canal (peso, altura, busto, cintura, comprimento, etc.) e linhas que representam cada tamanho disponível (P, M, G ou 38, 40, 42, etc., com seus valores numéricos).
Cada grade é sincronizada bidirecionalmente com o Meli: pode ser criada localmente e enviada ao canal (recebendo um código externo no canal após o primeiro envio), ou importada de um guide já cadastrado no Meli. A vinculação entre os tamanhos da grade e os SKUs do catálogo idworks é feita posteriormente na tela de Anúncios — esta tela só descreve a tabela em si.
A tela tem uma lista CRUD e uma sub-tela de detalhe (aberta como nova aba) onde o operador edita o nome da grade, gerencia as linhas (tamanhos) e dispara as ações de sincronização com o canal. Essa parte de variações por tamanho é o vínculo de cada anúncio Meli a essa grade.
Esta tela não tem parametrizações próprias em Configurações → Parametrizações. A lista de atributos disponíveis (peso, busto, etc.) vem da própria categoria do canal — o operador apenas escolhe quais usar.
Índice
Conceito
- O que é a tela Grade de Tamanho?
- Para que serve a grade na operação?
- O que é o "Cód. externo" e quando aparece?
- Como a grade se vincula aos SKUs do catálogo?
Criação
- Como criar uma nova grade?
- Como importar uma grade já existente no canal?
- Quais campos são obrigatórios na criação?
- Cadastros que você precisa ter antes
Detalhe da grade (sub-tela)
- Como adicionar um tamanho (linha) à grade?
- Como editar um tamanho existente?
- Como enviar a grade para o canal pela primeira vez?
- Como sincronizar uma grade já enviada com o canal?
- Como excluir uma grade?
Regras de negócio
- Por que alguns atributos da grade têm "de–até" (intervalo)?
- O que significa "atributo principal" (
isMain)? - Por que algumas categorias do Mercado Livre exigem grade?
Referência rápida
O que é a tela Grade de Tamanho?
É a tela onde você cadastra as tabelas de medidas que descrevem os tamanhos disponíveis para produtos de vestuário, calçados e acessórios anunciados no Mercado Livre. Cada grade representa uma tabela (ex.: "Camiseta Masculina Brasil P-G"), e cada linha da grade descreve um tamanho específico com seus atributos numéricos (peso, busto, cintura, etc.).
📍 Onde: menu lateral → Integrações → Grade de Tamanho.
Para que serve a grade na operação?
O Mercado Livre exige que produtos de algumas categorias (camisetas, calças, calçados, vestidos, jaquetas) tenham uma grade de tamanhos cadastrada e vinculada ao anúncio. Sem a grade, o anúncio não publica ou não aparece nos filtros de tamanho da busca.
A grade serve para que o comprador filtre os anúncios por tamanho (mostrar apenas "M") e para que o sistema do canal saiba converter entre tamanhos diferentes (P vs S vs 38 vs 8). Cada linha da grade representa um tamanho que existe no anúncio — depois, no cadastro do anúncio, cada variação (SKU) é vinculada a uma dessas linhas.
O que é o "Cód. externo" e quando aparece?
A coluna Cód. externo mostra o identificador da grade no canal (no Mercado Livre é o ID do "size guide"). Quando vazio, significa que a grade foi criada localmente e ainda não foi enviada ao canal — o anúncio que depender dela não vai publicar até que o envio aconteça. Quando preenchido, indica que a grade já está sincronizada com o canal e pode ser referenciada em qualquer anúncio.
Na sub-tela de detalhe, o botão muda conforme esse status:
- Sem código externo: aparece Enviar Para o Canal — primeiro envio.
- Com código externo: aparece Sincronizar Canal — atualiza um lado para o outro.
Como a grade se vincula aos SKUs do catálogo?
A vinculação acontece em outra tela — Integrações → Anúncios (ou diretamente no editor do anúncio do produto). Quando você cria/edita um anúncio do Mercado Livre que tem variações de tamanho:
- Escolha a grade que descreve os tamanhos disponíveis.
- Para cada variação do anúncio (cada SKU vinculado), aponte qual linha da grade corresponde ao tamanho daquele SKU.
Esta tela só descreve a grade em si (qual a tabela). O mapeamento por SKU vive na tela de Anúncios.
Como criar uma nova grade?
- Acesse Integrações → Grade de Tamanho.
- Clique em Nova Grade → Criar Grade.
- Na 1ª etapa, preencha:
- * Conta (quando há mais de uma).
- * Integração — somente integrações Mercado Livre aparecem.
- * Categoria — categoria do canal (a lista de atributos disponíveis depende dela).
- * Gênero — masculino, feminino, unissex, infantil.
- Clique em Continuar. A 2ª etapa traz os campos:
- * Nome da grade — identificador interno (ex.: "Camiseta Masculina Brasil P-G").
- * Tipo de medida — Brasil, EUA, Europa, Internacional, etc. (vindo da configuração da categoria).
- Cards de atributos — cada atributo permitido pela categoria do canal aparece como um cartão (peso, altura, busto, cintura, comprimento). Preencha o valor desejado e (quando aplicável) marque se é atributo principal (
isMain).
- Clique em Salvar. A grade aparece na lista, ainda sem Cód. externo — para vinculá-la a anúncios, é preciso primeiro enviar ao canal.
Pré-requisito: privilégio Criar Grade de Tamanho.
Como importar uma grade já existente no canal?
Quando a empresa já tem grades cadastradas no Mercado Livre (criadas no painel do canal antes da integração), pode importá-las direto:
- Clique em Nova Grade → Importar Grade.
- Preencha:
- * Conta.
- * Integração Mercado Livre.
- * Cód. externo — o ID do guide no canal (consultar no painel do Meli).
- Clique em Salvar. O sistema chama um worker que busca a grade no canal e cria/atualiza o registro local com todos os atributos e linhas espelhadas.
Após importar, a grade fica imediatamente disponível para vincular a anúncios (já tem o Cód. externo preenchido).
Quais campos são obrigatórios na criação?
São obrigatórios:
- Conta — quando há mais de uma.
- Integração — Mercado Livre.
- Categoria — categoria do canal.
- Gênero — masculino, feminino, unissex, infantil.
- Nome da grade — identificador interno.
- Tipo de medida — sistema de medida (Brasil, EUA, etc.).
Os atributos individuais (peso, busto, etc.) só são obrigatórios conforme a configuração da categoria do canal — o sistema mostra os necessários para aquela categoria/gênero.
Cadastros que você precisa ter antes
- Integração Mercado Livre ativa — em Configurações → Integrações.
- Mapeamento de categoria (Hub Categorias) — recomendado para que o sistema saiba qual categoria do canal corresponde à categoria interna do SKU.
Como adicionar um tamanho (linha) à grade?
Cada linha da grade representa um tamanho disponível (P, M, G ou 38, 40, 42). Para adicionar:
- Abra a grade no detalhe (duplo clique ou ícone de Editar na lista).
- Na aba Geral, clique em Adicionar Tamanho.
- Preencha os valores de cada atributo para esse tamanho (peso de "tal a tal", busto de "tal a tal", etc.).
- Salve.
A linha aparece na tabela e fica disponível para ser referenciada em anúncios após a próxima sincronização com o canal.
Como editar um tamanho existente?
Na sub-tela de detalhe, clique no ícone de lápis na linha do tamanho que quer editar. Os mesmos campos do modal de criação ficam disponíveis. Após salvar, é necessário Sincronizar Canal para que a alteração propague para o Mercado Livre — anúncios já publicados continuam usando os valores antigos até a próxima atualização.
Pré-requisito: privilégio Editar Grade de Tamanho.
Como enviar a grade para o canal pela primeira vez?
Quando a grade foi criada localmente (não importada), o Cód. externo começa vazio. Para usar a grade em anúncios é necessário enviá-la ao canal:
- Abra a grade no detalhe.
- Clique em Enviar Para o Canal no topo (botão visível apenas quando Cód. externo está vazio).
- O sistema chama um worker que cria a grade no Mercado Livre via API e devolve o ID externo.
- O Cód. externo aparece preenchido — a grade está pronta para uso em anúncios.
A operação é assíncrona e pode demorar alguns segundos. Se a API do canal rejeitar (atributos inválidos para a categoria, valores fora do permitido), aparece mensagem de erro específica do Meli.
Como sincronizar uma grade já enviada com o canal?
Quando a grade tem Cód. externo preenchido, o botão Enviar Para o Canal vira Sincronizar Canal. Use sempre que:
- Editou atributos ou linhas da grade local e quer atualizar o canal.
- Suspeita que o canal mudou algo e quer puxar os dados atualizados.
A sincronização é bidirecional automática — o worker compara os dois lados e aplica as diferenças.
Como excluir uma grade?
Na lista, clique no ícone de lixeira na linha e confirme. A exclusão local não apaga a grade do canal — se a grade ainda estiver em uso em anúncios do Meli, eles continuam funcionando, mas você perde a capacidade de gerenciá-la pelo idworks.
Boa prática: antes de excluir, garanta que nenhum anúncio do canal está usando a grade (caso contrário, a sincronização futura pode reintroduzi-la).
Pré-requisito: privilégio Deletar Grade de Tamanho.
Por que alguns atributos da grade têm "de–até" (intervalo)?
Categorias com medidas corporais (camisetas, calças, vestidos) permitem que cada tamanho cubra uma faixa de medida em vez de um valor único — por exemplo: tamanho M cobre busto de 88 cm até 96 cm. O canal usa esse intervalo para filtrar anúncios quando o comprador procura por uma medida específica.
Quando o atributo permite intervalo (IntervalAllowed), aparecem dois campos (valor mínimo e valor máximo). Quando não permite, aparece um único valor.
O que significa "atributo principal" (isMain)?
Algumas categorias têm vários atributos descrevendo o mesmo tamanho (ex.: para camiseta — busto + cintura + comprimento) e o canal precisa saber qual desses atributos é o principal, ou seja, o que aparece como filtro de tamanho na busca. Marcando um atributo como principal (isMain), você diz ao canal: "quando exibir o filtro de tamanho desse anúncio, mostre busto" (por exemplo).
Cada grade pode ter apenas um atributo marcado como principal por linha de tamanho.
Por que algumas categorias do Mercado Livre exigem grade?
O Meli torna a grade obrigatória em categorias onde o tamanho é parte central da decisão de compra: roupas, calçados, acessórios. Sem grade:
- O anúncio não é publicado (erro no envio).
- O comprador não consegue filtrar por tamanho — perde-se relevância na busca.
- Não dá pra ter variações de tamanho no anúncio.
Categorias onde a grade não é obrigatória (eletrônicos, livros, brinquedos sem tamanho) não exigem essa tela.
Resumo de parametrizações
Esta tela não tem parametrizações próprias em Configurações → Parametrizações. A configuração relevante vive em:
| Onde configurar | O que define |
|---|---|
| Configurações → Integrações | Integrações Mercado Livre ativas que aparecem na lista. |
| Integrações → Hub Categorias | Mapeamento de categoria do canal (a grade depende da categoria). |
A lista de atributos disponíveis (peso, busto, cintura, etc.) é determinada pelo Mercado Livre conforme a categoria escolhida — não é configurável pelo lojista.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar Grade de Tamanho | Acesso à tela, à lista e ao detalhe das grades. |
| Criar Grade de Tamanho | Botão Nova Grade (criar e importar). |
| Editar Grade de Tamanho | Edição de uma grade existente, adição/edição de linhas, envio ao canal. |
| Deletar Grade de Tamanho | Exclusão de uma grade. |