Variação não é opcional aqui: onde o preço realmente mora no seu anúncio

Se você já anuncia na Shopee ou no Mercado Livre, variação é palavra conhecida e o hábito que vem junto com ela vai atrapalhar aqui. Naquelas plataformas variação é opcional: você cria quando tem tamanho, cor ou voltagem, e ignora quando não tem.

Aqui a lógica é outra e ela é imposta pelo servidor, não sugerida pela tela:

• O produto não tem preço. Não existe esse campo no formulário nem no banco. O preço só existe dentro da variação.
• Sem pelo menos uma variação, o anúncio não salva. O servidor recusa com uma mensagem dizendo que ao menos uma é obrigatória, cada uma com nome, preço numérico e estoque numérico.
• Deixar a garantia em branco não te dá um padrão generoso. Te dá uma publicação recusada.

O resto deste guia é o formulário na ordem em que o servidor valida. O passo a passo do cadastro em si, incluindo a armadilha que publica o anúncio com a descrição escrita "Product description", está no guia de cadastro de produto; esta página é a camada de arquitetura em cima dele.

Simple Mode ou Advance Mode, e o que a escolha custa

Da sua lista de produtos, Add New abre o formulário em /supplier/products/add. Ele começa em Simple Mode e há um botão para Advance Mode.

O modo simples mostra sete campos: categoria, subcategoria, nome, preço unitário, estoque base, uma caixa de contas e uma imagem. É rápido, e toma duas decisões por você. Ele força o tipo de entrega para estoque e cria uma variação única nos bastidores. Se o que você vende é estoque pré-carregado, esse é o formato certo e acabou aqui.

O modo avançado é o resto: tipo de entrega, fornecedor de origem, descrição completa, garantia, o editor de variações, opções de checkout, perguntas frequentes e SEO. Ele também exige a descrição traduzida para inglês antes de aceitar o envio. Qualquer coisa que não seja estoque simples precisa desse modo.

Onde o preço mora de verdade

O que você define é o preço de cada variação, e o valor que aparece na vitrine é o da variação ativa mais barata.

Isso pega gente desprevenida de um jeito específico: desative a sua variação mais cara e nada muda visualmente; desative a mais barata e o anúncio inteiro parece ter subido de preço da noite para o dia.

O editor fica em Product Variants (Subproducts) e o botão é Add Subproduct Variant. Os campos, com os rótulos que o formulário realmente usa:

• Variant Name, opcional. Vazio, ele cai para o nome de origem.
• Price, obrigatório, e o único lugar onde existe preço.
• Minimum Purchase Quantity, padrão um. É um piso do pedido, não um número de estoque.
• Stock, exibido nos tipos manual e automático, onde é um número que você mantém.
• Base Stock, exibido apenas no tipo estoque, onde ele infla o número mostrado ao comprador. Está detalhado no guia de cadastro; a regra curta é deixar em zero.
• Short Description, opcional, mostrado a quem está escolhendo entre variações.

Use variação quando a mesma mercadoria vem em faixas que precificam diferente: ano de registro, região, se traz caixa de email junto. Pense em múltiplos da sua própria variação mais barata em vez de pensar em valores, porque é ela que o comprador vê primeiro e tudo acima dela é lido como acréscimo sobre ela.

Uma cautela vinda dos dados da prateleira: acréscimo por idade da conta não é constante de mercado aqui. Separando por vendedor, alguns cobram várias vezes a própria base por um ano de registro declarado e outros cobram menos que a própria base pela mesma alegação. O múltiplo que você consegue sustentar é seu para estabelecer, não para copiar do vizinho.

Três tipos de entrega, e um deles é invisível para a maioria

O seletor Product Type, no modo avançado, é a decisão da qual o resto do anúncio depende. As três opções, com as descrições da própria plataforma:

• Inventory, entrega automática a partir das contas enviadas. Você sobe as credenciais antes, o estoque é o que não foi vendido, e os pedidos se atendem sozinhos.
• Manual, envio das contas depois do pedido. O estoque é um número que você declara. O pedido espera em processamento até você entregar, à mão ou por integração.
• Auto, gerenciado por integração externa. Estoque e entrega vêm os dois de uma fonte de fora.

A opção automática não está apenas desabilitada para a maioria: ela não é desenhada na tela. Aparece só para administradores e para fornecedores com a marcação de confiança, hoje vinte e nove contas no site inteiro. Escolhê-la acrescenta um campo obrigatório de endereço de origem.

Para dimensionar: nos 34.717 registros de produto do site, automático responde por 29.669, estoque por 3.259 e manual por 1.789. Os dois tipos que quase todo guia descreve são os dois menores.

O campo de garantia recusa o seu anúncio, e a caixa vazia é a armadilha

Esta é a causa mais comum de uma publicação falhar para um vendedor novo, e o motivo é contraintuitivo.

O campo se chama Warranty (Hours). Deixe em branco e a plataforma não assume um padrão generoso. Ela cai primeiro para a garantia padrão da sua loja, se você configurou uma, e na falta disso para um valor de reserva medido em fração de hora. Então roda uma segunda checagem: todo fornecedor sem a marcação de confiança precisa atingir a garantia mínima do site, hoje quatro horas, ou o envio é recusado com erro de garantia abaixo do mínimo.

Ou seja, a caixa vazia produz um valor muito abaixo do piso, e o piso recusa esse valor. Digite um número. Quatro horas é o mínimo atual, doze horas é a mediana de todos os anúncios ativos do site, e uma semana ou mais é raro fora de proxies.

A mesma regra vale retroativamente. Se o piso subir, os anúncios que ficarem abaixo dele são retirados da vitrine em vez de apagados: continuam no seu catálogo com a marcação de ativo removida, e elevar a garantia os traz de volta. Se os seus anúncios pararam de aparecer sem explicação, confira isso primeiro.

O que acontece quando você aperta publicar

Os dois botões são Publish Product e Save Draft. Na publicação, o servidor roda uma sequência que você não vê:

1. Assinatura. Criar produto exige assinatura de fornecedor ativa.
2. Variações. Pelo menos uma, cada uma com nome, preço numérico e estoque numérico. Variação do tipo manual ainda tem teto de estoque por variação.
3. Permissão de tipo. Manual e estoque para todos; automático só para conta de confiança ou administrador.
4. Teto de anúncios. Uma base mais um acréscimo por faixa de nível, mais as vagas de bônus que você tiver conquistado. Conta de confiança é ilimitada, e serviços de crescimento nunca entram nessa contagem.
5. Piso de garantia. Como acima.
6. Aprovação. Primeiro é consultada uma chave global de aprovação automática, depois a sua própria marcação de aprovação automática, e senão o produto entra como pendente. Essa chave global está ligada hoje, então a maioria dos anúncios novos vai direto para aprovado. Não construa processo em cima disso: é uma configuração e pode ser desligada.

Produto pendente é também produto inativo, então ele não aparece em lugar nenhum até ser aprovado. E se você subiu estoque junto com a criação, esse envio roda como tarefa em segundo plano e não na mesma requisição, então o estoque pode demorar um instante para aparecer mesmo em uma publicação bem-sucedida.

Dois campos que você não consegue definir

Compradores às vezes pedem ao vendedor para mudar o anúncio para entrega manual, ou para entregar por arquivo em vez de por lista. Nenhuma das duas coisas está disponível.

Tipo de entrega não está no formulário. Ele existe no modelo de dados, com instantâneo e manual como valores possíveis, mas não há campo nenhum na interface do fornecedor, e todos os 34.717 registros de produto do site estão como instantâneo. Entrega manual, como promessa ao comprador, não existe aqui.

Formato de conta tem um controle, o par de opções lista e arquivo dentro do envio de estoque, mas todos os 34.717 registros do site estão gravados como lista. O caminho de arquivo existe e, pela evidência atual, não é usado por ninguém.

A consequência prática vale escrever: se a descrição do seu anúncio promete entrega manual ou entrega em arquivo, ela está prometendo algo que a plataforma não expressa, e é exatamente o tipo de descompasso que vira chamado.

Cuidar do estoque depois que o anúncio está no ar

Em produto do tipo estoque, o número não é declarado, é derivado. Ele é a contagem de linhas que ainda não foram vendidas, então subir aumenta e vender diminui, e não há nada para manter sincronizado à mão. Cole as credenciais uma por linha, ou suba um arquivo com uma por linha. É comum separar caixa, senha e segredo de duas etapas com barra vertical, mas nada na plataforma interpreta a linha: ela é guardada exatamente como veio, e o que a sua descrição prometeu é o que o comprador vai esperar encontrar dentro dela.

As linhas de estoque têm cinco estados, não quatro. Disponível e vendida são os óbvios; reservada cobre a linha presa a um pedido em andamento; desativada cobre a linha que você ou o suporte retiraram; e substituída marca a linha trocada em um chamado de pós-venda. Se você está contando o seu próprio estoque, uma linha substituída não é disponível nem é venda normal, e tratá-la como qualquer um dos dois desalinha a sua conta.

Um cuidado de contagem se você usa as vendas por variação para decidir reposição: o contador de vendidos por variação só sobe. Ele nunca é reduzido por reembolso nem por substituição, então é um número bruto de vida inteira e não um número líquido.

Em produto manual, o estoque é um número que você digita e que cai conforme os pedidos entram. É uma promessa, não uma medição, então ele exige uma atenção que a contagem automática não exige.

Qual tipo escolher, pela evidência

A comparação honesta não é a que costuma ser feita, porque os dois tipos abertos a todo mundo diferem muito menos em velocidade do que os rótulos sugerem.

Pergunta	Estoque	Manual	Automático
De onde vem o estoque	Contado nas linhas não vendidas	Um número que você digita	Uma integração externa
Quem entrega	Ninguém, é automático	Você, depois do pedido	Sua integração
Quem pode escolher	Qualquer fornecedor	Qualquer fornecedor	Conta de confiança e administrador
Pedidos concluídos no site	28.898	6.649	48.567
Tempo típico até concluir	Menos de um segundo	Menos de trinta segundos	Menos de um minuto
Décimo mais lento	Praticamente nada	Cerca de nove horas	Poucos minutos
Passa de um dia	Um em duzentos	Um em quarenta e três	Um em quinhentos

Aquela mediana de menos de trinta segundos no manual não é erro de digitação e não é a plataforma sendo rápida em seu nome. É o que acontece quando os fornecedores com volume em anúncios manuais consultam a API de pedidos em intervalo curto em vez de olhar um painel. A diferença mora na cauda: cerca de um pedido manual em quarenta e três passa de um dia, contra praticamente nenhum no estoque pré-carregado.

Então escolha manual quando a mercadoria realmente precisa ser produzida por pedido, e ligue a integração na mesma semana. Escolha estoque quando dá para preparar antes, que é a maior parte dos casos e é também o único tipo que o modo simples entrega.

A versão curta

1. Modo avançado, a menos que você venda estoque pré-carregado direto.
2. Pelo menos uma variação com preço, porque o produto em si não tem nenhum.
3. Digite a garantia em horas. Em branco é recusa, não padrão.
4. Estoque se você prepara antes, manual se não dá, e nesse caso integre logo.
5. Estoque base é número de vitrine. O contador de vendidos nunca desce. Linha substituída não é nem venda nem estoque.

Com os anúncios no ar, o processamento de pedidos por integração está no guia da API de pedidos manuais, a fila de aprovação no guia de aprovação de produtos, e o que muda a cada faixa no guia de níveis de vendedor.