Ativando a integração na wBuy
Primeiramente, vamos instalar o módulo do Mercado Livre no painel wBuy. Busque por "Mercado Livre" no menu Aplicativos e clique em Instalar.
Após isso, aparecerá na tela uma mensagem em vermelho, escrito “Esse aplicativo está inativo na loja. Para começar a instalação, clique no botão ao lado”.
Vamos clicar nesse botão (que está escrito “iniciar configuração”), ativar o Status na loja e, então, clicar em Gravar.
Nessa mesma tela você poderá escolher se deseja importar ou não os pedidos do Mercado Livre.
Você ainda poderá configurar uma mensagem automática de pós-venda, caso deseje.
Sempre que um pedido feito através do Mercado Livre for importado na wBuy, a plataforma enviará a mensagem configurada automaticamente para o comprador no ambiente do Mercado Livre.
Cada lojista pode vincular até 10 contas do Mercado Livre e criar anúncios para cada uma delas através do painel wBuy.
Autorizando a integração
Agora precisamos autorizar a integração com o Mercado Livre. Ainda no seu painel wBuy clique no botão Administrar contas, depois no botão Adicionar contas do Mercado Livre na wBuy.
Na tela seguinte, dê ao Mercado Livre as permissões que serão pedidas e valide sua conta através de SMS, e-mail ou whatsapp.
Importando produtos do Mercado Livre para a wBuy
Antes de importar os produtos, precisamos fazer algumas configurações na plataforma wBuy. Acesse Aplicativos > Mercado Livre > Configurar De/Para, e configure os campos necessários.
No campo “De”, deve ser colocado o nome da Variação exatamente da forma como está no Mercado Livre. Considerando acentos, letras maiúsculas e minúsculas.
Após isso, acesse a opção “Importar produtos Mercado Livre para a wBuy”.
Nessa seção, aparecerão todos os seus anúncios no Mercado Livre. Selecione os anúncios que deseja importar, e então clique em “Importar selecionados”.
Quais informações do produto são importadas?
Nome, código, descrição, dimensões e peso, variações (se configuradas corretamente no De/Para), fotos, marca.
Anunciando produtos wBuy no Mercado Livre
Para anunciar os produtos da wBuy no Mercado Livre, clique na opção Criar um novo anúncio no Mercado Livre.
Nas telas seguintes você escolhe os produtos que deseja anunciar, e as categorias em que eles entrarão no Mercado Livre.
Na tela seguinte preencha as informações que se pedem e, ao final da tela, clique em Publicar anúncio.
Ao anunciar um produto a wBuy irá enviar as fotos separadas por variação, porém o Mercado Livre tem um limite de até 6 fotos por anúncio. Isso pode fazer com que os anúncios sejam feitos com fotos em ordem errada ou que nem todas as fotos sejam cadastradas no anúncio.
ID da Guia de Tamanhos
Neste passo, você aprenderá a encontrar o ID de uma guia de tamanhos já existente ou criar uma nova no Mercado Livre para adicioná-la ao seu anúncio na wBuy.
Para isso, acesse sua conta no Mercado Livre e vá até o módulo Resumo.
Em seguida, vá para o módulo Vendas > Preferências de venda e localize a seção Guias de tamanhos:
Agora, basta localizar as guias já criadas ou criar uma nova guia conforme necessário.
Erros comuns
Pedido importado com endereço mascarado (XXX)
Pedidos do Mercado Livre que ainda não tiveram o pagamento aprovado podem ser disponibilizados com o endereço do comprador parcialmente oculto, contendo trechos como XXX.
Nesses casos, ao importar o pedido para a wBuy, o endereço poderá ficar incompleto ou incorreto. Para evitar esse comportamento, nas configurações do aplicativo, no painel da wBuy, ative a opção: Não importar pedido se o endereço do cliente estiver mascarado com XXX
Com essa configuração habilitada, o pedido será importado somente quando o Mercado Livre disponibilizar o endereço completo, normalmente após a confirmação do pagamento.
Mensagens de erro em inglês ou pouco descritivas
As mensagens retornadas pelo Mercado Livre são enviadas diretamente pela API oficial da plataforma. Em muitos casos, elas aparecem em inglês e com descrições genéricas, sem detalhar claramente a causa do problema.
Se ocorrer erro ao publicar ou editar um anúncio:
- utilize o Google Tradutor para auxiliar na interpretação da mensagem: https://translate.google.com/
- revise os dados do anúncio
- verifique se todos os atributos obrigatórios foram preenchidos
- e, se necessário, entre em contato com o suporte da wBuy informando a mensagem completa retornada pelo Mercado Livre
Produto não vincula ao anúncio do Mercado Livre
A vinculação entre produtos da wBuy e anúncios do Mercado Livre é realizada com base no ID/SKU das variações.
Exemplo:
Se a variação do produto na wBuy possuir o ID: 1234
O campo SKU correspondente no anúncio do Mercado Livre deverá conter exatamente o mesmo valor: 1234
Essa vinculação é necessária para a sincronização automática de:
- estoque
- pedidos
- código de rastreio
- e atualização de informações entre as plataformas
Estoque não atualiza entre wBuy e Mercado Livre
A sincronização de estoque ocorre automaticamente e em tempo real, desde que o produto esteja corretamente vinculado ao anúncio do Mercado Livre.
Se o estoque não estiver sendo atualizado, verifique:
- se o SKU do anúncio corresponde ao ID da variação na wBuy
- se o anúncio está vinculado corretamente
- e se a integração está ativa e autorizada
Código de rastreio não foi atualizado
Dados logísticos, como código de rastreamento e status de envio, são sincronizados automaticamente entre a wBuy e o Mercado Livre.
Caso a informação não seja atualizada, valide:
- se o pedido está devidamente vinculado
- se o código de rastreio foi informado na plataforma
- e se o pedido já foi processado pela integração
Erro ao publicar anúncio com variações agrupadas
Quando um produto possui múltiplas variações e é publicado utilizando a opção: Agrupar variações em um único anúncio
O Mercado Livre exige que:
- todas as variações possuam o mesmo preço
- cada variação tenha atributos válidos e únicos
- e a categoria escolhida aceite esse tipo de variação
Exemplos de atributos aceitos
- Cor
- Modelo
- Material
- Voltagem
- Cor da armação ou moldura.
Exemplo de erro comum: Se duas variações tiverem exatamente os mesmos atributos (por exemplo, mesma cor, mesmo material e mesmo modelo), o Mercado Livre poderá considerar as variações duplicadas e rejeitar o anúncio.
Como resolver
- publicar cada variação em anúncios separados;
- ou utilizar uma categoria compatível com o tipo de variação desejada.
Erro ao enviar imagens do produto
As imagens enviadas ao Mercado Livre devem seguir algumas boas práticas para evitar rejeições ou falhas de processamento.
Verifique se:
- as imagens estão disponíveis em URLs pública
- não existem imagens duplicadas no mesmo anúncio
- os arquivos estão preferencialmente em formato JPG ou JPEG
- os nomes dos arquivos não são excessivamente longos
- e as imagens carregam normalmente no navegador
Erro ao enviar a descrição do anúncio
Descrições muito extensas ou com excesso de formatação podem ser rejeitadas pelo Mercado Livre.
Recomendações
- utilizar textos objetivos e organizados
- evitar excesso de emojis e símbolos especiais
- evitar copiar conteúdo diretamente de editores formatados
- revisar caracteres especiais incomuns
- e validar previamente se a descrição está sendo exibida corretamente
Atributos obrigatórios não aparecem ou são rejeitados
Os atributos disponíveis e obrigatórios são definidos pelo próprio Mercado Livre conforme a categoria selecionada.
Por esse motivo:
- alguns campos podem ser exibidos automaticamente
- determinados atributos são obrigatórios
- e cada categoria pode limitar quais tipos de variação são permitidos
Se um atributo estiver ausente ou for rejeitado, revise a categoria selecionada e consulte os atributos exigidos pelo Mercado Livre para aquele tipo de anúncio.