Você altera o preço ou o estoque de um item no ERP, a integração roda e, minutos depois, o anúncio perde exposição no Mercado Livre ou na Shopee. Ao abrir a página da oferta no canal, metade dos tamanhos sumiu ou a opção de cor virou um produto individual sem histórico de vendas. Entender a estrutura de variações de produto no marketplace passo a passo evita que atualizações de rotina quebrem suas ofertas principais e derrubem a taxa de conversão do catálogo.
O problema raramente está na criação do produto pai ou na descrição comercial. Na maioria das operações de e-commerce que atendemos no Grupo W3, o gargalo se concentra no desencontro entre o campo de texto preenchido no ERP e a tabela de atributos estruturados que a API de cada marketplace exige.
O sintoma do cadastro incorreto: variação presa e perda de posição
A falha na grade de variações se manifesta de forma silenciosa na maioria dos hubs de integração. O painel do hub exibe o status como "sincronizado com sucesso", mas a oferta no marketplace passa a apresentar comportamentos anômalos que afetam diretamente as vendas.
O primeiro sinal claro é a queda repentina no volume de impressões e cliques da oferta. Quando a API do marketplace recebe uma atualização de estoque para um SKU filho e não consegue associar a variação à categoria correta, a plataforma desindexa a variação do anúncio principal. Para o algoritmo do canal, aquele tamanho ou cor deixou de existir com as especificações exigidas para busca.
Outro sintoma frequente é o desmembramento automático da grade. Uma camiseta comercializada nas cores preta, branca e cinza com tamanhos do P ao GG deveria ocupar uma única página de produto com 12 SKUs filhos vinculados. Por falha de atributo, o marketplace separa as cores em três anúncios concorrentes entre si. O histórico de vendas, as avaliações dos clientes e a posição no ranking orgânico ficam divididos entre anúncios incompletos, reduzindo a relevância da oferta.
Por fim, ocorrem as rejeições silenciosas na fila de envio do hub. O preço do SKU pai é atualizado, mas as variações filhas permanecem com a precificação antiga ou com estoque zerado no canal. O cliente tenta selecionar a variação desejada na página do produto, encontra o botão cinza e inativo, e abandona a compra no checkout.
A causa real: envio de texto livre no lugar de atributos estruturados
Marketplaces não leem nomes comerciais da mesma forma que um consumidor lê. Se o seu ERP possui o cadastro da cor registrado como "Azul Marinho" ou "Azul Fechado" em um campo de texto simples, a integração enviará essa string direta para a plataforma. Se a API do marketplace exige a seleção de um valor de ID específico para a categoria de moda — como o ID 28316 para a cor azul —, a chamada é recusada ou o atributo é ignorado no processamento da página.
A ausência do mapeamento de-para entre a tabela do seu ERP e a tabela nativa do marketplace é o ponto central dessa falha. Cada canal possui sua própria taxonomia. A Shein exige atributos de variação específicos para tecidos e caimento; o Mercado Livre bloqueia anúncios na categoria de calçados se o atributo de gênero e tamanho não seguir a tabela oficial de medidas da plataforma.
A duplicidade de EAN e a quebra da matriz de SKU
A gestão de códigos identificadores é outro ponto cego frequente na operação diária das lojas. Repetir o mesmo código GTIN/EAN-13 do produto pai em todos os SKUs filhos é um erro gravíssimo de cadastro.
Produto Pai: Camiseta Polo Básica (Sem EAN ou EAN da marca)
├── SKU Filho 1: Camiseta Polo Preta P -> EAN: 7891234567890 (Único)
├── SKU Filho 2: Camiseta Polo Preta M -> EAN: 7891234567891 (Único)
└── SKU Filho 3: Camiseta Polo Azul P -> EAN: 7891234567892 (Único)
Quando dois SKUs filhos compartilham o mesmo EAN ou utilizam um código genérico invalidador, a API do marketplace entende que se trata de uma duplicidade de item. A plataforma retém a atualização daquele SKU específico para proteger a integridade do catálogo, mantendo a variação presa enquanto o resto do anúncio permanece ativo com dados desatualizados.
Além do EAN, o agrupamento de variações no hub frequentemente falha por desrespeito às regras da categoria nativa. Tentar enviar uma variação de "Voltagem" em uma categoria de e-commerce que só aceita "Cor" e "Tamanho" fará a carga ser rejeitada no ato do envio. O hub tenta forçar a transmissão de dados que o endpoint do marketplace não está preparado para receber naquela árvore de categorias.
O passo a passo para reestruturar a grade no ERP e no hub
A correção definitiva da grade de variações exige uma intervenção em três etapas na sua infraestrutura de dados. O processo começa no ERP e termina na validação da API no canal final.
-
Saneamento de EANs e códigos filhos no ERP: Acesse o cadastro da matriz de produtos no seu sistema de gestão (Bling, Tiny, TOTVS ou equivalente). Garanta que o produto pai atue apenas como agrupador lógico, sem estoque próprio e sem EAN preenchido. Cada SKU filho precisa ter seu próprio código interno único e um código EAN-13 individual e válido, gerado via GS1.
-
Mapeamento da tabela de de-para no hub: Dentro do hub de integração (Anymarket, Plugg.to, Lexos ou similar), acesse a seção de mapeamento de atributos por canal de venda. Localize a categoria do produto e vincule os campos do seu ERP aos campos nativos exigidos pelo marketplace. Se o seu ERP usa "Tamanho: G", faça a associação direta com o valor nativo "G" ou "L" exigido pela plataforma de destino.
-
Carga de sobrescrita e validação da ficha técnica: Após salvar o de-para de atributos, force uma atualização de carga completa do catálogo a partir do hub. Não envie apenas atualização de saldo de estoque ou preço; selecione a opção de reenvio de dados cadastrais para sobrescrever a estrutura anterior no marketplace.
-
Conferência de logs na API do marketplace: Acesse a central de vendedores do canal (Seller Central) e verifique o painel de erros de integração de anúncios. Confirme se a ficha técnica de cada variação exibida na ponta contém todos os atributos obrigatórios preenchidos sem pendências.
Validação da correção e matriz de responsabilidade da equipe
A confirmação do ajuste deve ser feita diretamente no front-end do marketplace e no log da API em até 30 minutos após o reenvio do catálogo. Abra o anúncio em uma janela anônima do navegador. Alterne entre todas as opções de cores e tamanhos na página do produto e observe se a foto principal muda corretamente, se o SKU selecionado atualiza o preço na tela e se o botão de compra permanece ativo para todas as combinações com estoque.
Para evitar que novos cadastros quebrem as variações no futuro, a operação precisa estabelecer uma divisão clara de tarefas entre os times.
| Função na Operação | Atividade sob Responsabilidade | Frequência |
|---|---|---|
| Operador de Catálogo | Cadastrar SKUs filhos com EANs individuais e atribuir variações no ERP | Diária |
| Analista de Hub / Integrador | Realizar o de-para de atributos novos e mapear categorias por marketplace | Por novo lote / marca |
| Gestor de Marketplace | Auditar relatório de falhas de sincronização e monitorar desindexação de ofertas | Semanal |
A rotina semanal de auditoria deve verificar a taxa de erro de integração dentro do hub. Se mais de 1% dos SKUs da sua base apresentarem avisos de divergência de atributo no log, o time de catálogo deve estancar novos envios para tratar os mapeamentos pendentes. Manter cadastros limpos garante que suas alterações de preço e estoque reflitam instantaneamente na ponta, preservando a relevância orgânica e a margem de conversão dos seus anúncios em todos os canais.
Perguntas frequentes
O que fazer quando o marketplace não possui a cor ou o atributo exato do meu produto na lista oficial?
Se o valor exato não existir na lista pré-definida da plataforma, selecione a opção de cor primária mais próxima na tabela nativa (por exemplo, selecione "Azul" para um produto cadastrado como "Azul Turquesa"). Utilize o campo de atributo secundário de texto livre ou a foto do SKU filho para especificar a variação exata ao consumidor sem quebrar a validação da API.
É possível alterar a estrutura de variação de um anúncio que já possui histórico de vendas sem perder as avaliações?
Não é recomendável alterar a estrutura primária (por exemplo, transformar um anúncio simples em um anúncio com variação) diretamente no anúncio ativo. Para preservar o histórico e as avaliações, adicione os novos SKUs filhos à grade existente no hub mantendo o SKU pai original conectado ao mesmo ID da oferta na plataforma.
Por que o estoque de uma variação zerada continua aparecendo como disponível no marketplace?
Isso ocorre quando a atualização de estoque no ERP é enviada com o ID do SKU pai ou sem a identificação correta do atributo do SKU filho no payload da API. O marketplace não consegue associar a baixa de saldo à variação específica e mantém a última quantidade gravada na oferta até que a grade seja sincronizada com os atributos corretos.