O comprador pergunta no chat se tem o 38. Tem, no preto e no azul, mas o anúncio do Tênis Runner é um só, com os 14 pares somados. Ele compra, e você não sabe qual dos dois baixou.

A informação se perdeu na tradução da grade para o canal. O Shop Control 9 guarda cor e tamanho por combinação. Só que cada marketplace representa variação do seu jeito.

No Shop 9, quem tem saldo é a combinação

O produto pai, o Tênis Runner, carrega as combinações de cor e tamanho. Cada uma tem saldo próprio e código de barras próprio (e, às vezes, custo próprio). Na loja, a pergunta é “tem o 39 preto?”, nunca “tem o tênis?”.

Mercado Livre e Magalu não montam a variação igual

A lógica é a do Shop 9, mas o formato técnico muda de canal para canal, e é nessa tradução que uma integração genérica costuma errar.

Mercado Livre: no modelo de User Products, descrito na documentação para desenvolvedores, os itens de uma família compartilham o nome de família e aparecem como seletores na mesma página. Cada combinação tem item, saldo e fotos próprios. As exigências variam por categoria.
Magalu: as combinações são SKUs de um mesmo grupo de variações, com atributos de variação e saldo próprio. O canal confirma a publicação de forma assíncrona: o Hub envia e depois lê o resultado.

Três erros que derrubam a venda

Grade achatada. Um anúncio sem variações, com o estoque somado, como o do Runner. Vendeu, e você não sabe qual numeração baixou.
Combinações soltas. Duas cores e seis tamanhos viram 12 anúncios do mesmo produto, competindo entre si na busca. Agrupado, tudo fica na mesma página.
Variação sem saldo próprio. Você vende o 42 que já acabou. Vem cancelamento, reclamação e reputação em queda.

O Gumo Hub parte da grade do Shop 9

Quem manda é a grade do Shop 9, lida pela API oficial. O anúncio só a espelha.

O produto pai vira um grupo por canal, com as combinações como variações.
Cada combinação espelha o saldo da sua posição na grade, e a venda reserva e baixa a combinação certa. A atualização de saldo também é por combinação (a sequência está em sincronização de estoque).
O código de barras de cada numeração, registrado no Shop 9, vai como GTIN/EAN da combinação nos canais que pedem.
Na revisão, você ajusta título, ficha e nome das variações do jeito que o comprador busca: “Preto”, não “PTO”.
Cadastro antes da revisão. O checklist do Shop 9 para marketplace cobre SKU por combinação, grade íntegra e GTIN/EAN por variação.

O caminho certo: combinações agrupadas, cada uma com seu saldo.

Na prática: o Tênis Runner preto 38 tem 5 unidades no Shop 9. Saiu uma venda dele no Mercado Livre? A baixa cai no preto 38, e o preto 39 segue com as 2 dele.

Chegou grade nova? Cadastre o produto no Shop 9, o Hub o traz para a revisão, você aprova e ele entra na fila de publicação.

O que cada canal pede na publicação?

Mercado Livre: em moda, o guia de medidas pede uma linha da tabela para cada tamanho. Cadastre as medidas antes de levar o lote para a revisão, que mostra o que ainda falta.
Magalu: o grupo de variações e os atributos que diferenciam cada combinação. O preço vem da tabela de preço do canal e vale para todas as combinações.

O resto do cadastro, como categoria, marca, NCM, dimensões, peso e EAN, está no checklist do Shop 9 para marketplace e, para o Magalu, no texto sobre o Shop Control 9 com o Magalu.

Teste com a grade mais difícil do seu catálogo

Pegue o produto com mais cores e numerações, aquele que dá mais preguiça de cadastrar, e leve-o até a revisão. Depois confira:

As combinações aparecem agrupadas na mesma página, com nomes que o comprador entende?
Cada uma mostra o seu saldo e o código de barras certo?
Os campos da categoria, como medidas, NCM, dimensões, peso e marca, estão preenchidos?
Uma venda de teste baixou a combinação certa na grade do ERP?

Teste na categoria em que você vai vender. Uma grade simples de camiseta não prova que a de calçado passa. Se a integração passa nesse teste, é sinal de que entende o Shop 9; a que falha ali tende a falhar com o catálogo inteiro.