Publicar anúncio: os erros mais comuns e o que fazer

O Mercado Livre recusou a publicação falando de “family_name”. O que é isso?

É uma regra do catálogo novo do Mercado Livre: anúncio migrado para “produto do usuário” não aceita receber o título numa atualização comum. O Hap reenviava o título em toda atualização, mesmo quando nada tinha mudado. Agora só vai o que você alterou de verdade — sem alteração, sai apenas preço e estoque.

E se eu quiser mesmo mudar o título?

Se o anúncio ainda não vendeu, o Hap manda o título e o campo que o ML exige junto. Se o anúncio JÁ teve vendas, o próprio Mercado Livre não permite trocar o título — e a tela avisa isso em português, em vez de mostrar o erro técnico da API.

Aparece “Escolha a categoria” num anúncio que já está no ar. Por quê?

Não aparece mais. A categoria só é necessária para CRIAR um anúncio; um anúncio já publicado é atualizado por um caminho que nem envia categoria — ela vive no anúncio lá no canal.

Diz “Marca: não informada”, mas a marca está preenchida.

Era leitura errada do resumo: cada canal grava a marca de um jeito (nome, código ou identificador), e o resumo só olhava um deles. Agora ele lê todos e, quando a marca vem do cadastro do produto em vez da configuração do canal, ele diz de onde veio.

A Magalu exige categoria?

Não. A Magalu categoriza sozinha pelo título e pelo EAN. A exigência era nossa e foi removida; se você informar a categoria, o Hap continua enviando.

As categorias da Shopee aparecem em inglês.

A árvore era buscada em inglês e ficava em cache. Depois da atualização, abra Marketplace > Canais > Shopee > Configuração e clique em “Sincronizar categorias” uma vez. A árvore volta em português.

Não consigo criar anúncio na Shopee.

Já dá. O caminho existia no sistema, mas o botão estava escondido por uma configuração interna. Lembrando que na Shopee vale um anúncio por produto: o botão “+ Novo anúncio” aparece enquanto não existir anúncio daquele produto no canal. Se faltar peso, dimensão, foto ou categoria, a recusa lista o que falta, item a item.

Sincronizei as campanhas do Mercado Livre e voltou “0 campanhas”.

Antes, quando a busca falhava, a tela dizia zero e engolia o motivo. Agora ela mostra a causa — credencial vencida, erro do canal — e só diz zero quando o canal respondeu de verdade e não há campanha aberta na conta.

E se a Magalu recusar mesmo assim, pedindo a categoria?

Aí a mensagem chega pronta para agir: o Hap reconhece a recusa por categoria e responde “abra o Estúdio de anúncio > Configuração do canal > Magalu e informe a categoria”, em vez de mostrar o erro técnico do canal. O mesmo vale para as outras recusas comuns: código de barras, preço, imagem, peso e dimensões, e credencial expirada. Quando o motivo não é reconhecido, o texto original do canal aparece inteiro — tradução errada seria pior que texto cru.

O Mercado Livre recusou o Tempo de garantia.

O Mercado Livre só aceita a garantia com número e unidade: dias, meses ou anos (por exemplo, 7 dias). Na Configuração do canal, o Tempo de garantia tem dois campos, o número e a unidade, escolhida numa lista. Se a garantia salva estiver só com o número, como “7”, a tela avisa “Falta a unidade” e oferece o botão Usar 7 dias. O Hap não escolhe a unidade sozinho, porque 7 pode ser dias ou meses: enquanto ela faltar, a Configuração do canal não salva e o envio avisa antes de chamar o Mercado Livre.

O Mercado Livre recusou as medidas ou o peso da embalagem.

Na embalagem, o Mercado Livre só aceita números inteiros: centímetros para altura, largura e comprimento, e gramas para o peso (por exemplo, 33 cm e 8000 g). O peso e as medidas do cadastro do produto já vão assim: o peso em quilos vira gramas (8 kg = 8000 g) e as medidas são arredondadas para cima. Na ficha técnica da Configuração do canal, ao sair do campo, o Hap converte o que dá para deduzir: “33” vira 33 cm, “33,5 cm” vira 34 cm e “0,8 kg” vira 800 g. Peso sem unidade (“8”) ou com ponto de milhar (“8.000”) não dá para deduzir: o aviso aparece embaixo do campo, com um exemplo.

Como funciona o “Sugerir pelo título”?

O Hap pergunta ao Mercado Livre quais categorias combinam com o título do produto e mostra as sugestões embaixo do campo, cada uma com o nome, o grupo e o código. Nada é gravado até você escolher: clique na que descreve o produto. Confira antes de escolher, porque a primeira sugestão do Mercado Livre nem sempre serve. Se nenhuma servir, busque por uma palavra do produto no campo de categoria ou use Digitar código.

O “Sugerir pelo título” não sugeriu nenhuma categoria.

A tela diz o motivo. “O Mercado Livre não encontrou categoria para este título” quer dizer que o canal respondeu e não achou nada: busque por uma palavra do produto (por exemplo, “vinho tinto”) no campo de categoria. “Não foi possível consultar o Mercado Livre agora” quer dizer que o canal não respondeu naquele momento: tente de novo em instantes. Se a tela pedir para reconectar a conta, a autorização da conexão com o Mercado Livre precisa ser refeita na configuração do canal. Em todos os casos dá para usar Digitar código e informar o código da categoria (ex.: MLB1055).

Onde vejo o que o canal escreveu, sem tradução?

Em cada problema do envio, abra Ver texto original do canal. Ali está o texto que o canal mandou, completo e sem cortes. A frase de cima é a tradução, com o lugar para corrigir. Se a frase for só o texto do canal, aquela recusa ainda não tem tradução: mande o texto original ao suporte.

Em que ordem os canais aparecem na tela de Canais?

Pela ordem em que você usa: conectados primeiro, depois os que têm conexão desativada, depois os disponíveis para conectar e, por último, os que ainda não estão implementados. Não é ordem alfabética.