Integração Mercado Livre para Bagy 3.0

Com milhões de acessos diários, o Mercado Livre é um dos maiores marketplaces do Brasil — uma vitrine poderosa para aumentar as vendas da sua loja. Neste artigo você vai encontrar tudo o que precisa para configurar e gerenciar a integração da sua loja Bagy com o Mercado Livre.

Antes de começar: você precisa ter uma conta ativa no Mercado Livre. Contas novas (sem nenhum anúncio publicado) precisam criar ao menos um anúncio diretamente no site do Mercado Livre antes de usar a integração.

Como integrar sua loja

• No painel da Bagy, acesse Marketplaces > Mercado Livre.
• Leia as informações apresentadas na tela — elas trazem avisos importantes que impactam diretamente nos seus anúncios. Depois, clique em Continuar.

• Uma janela será aberta para você entrar com o seu apelido e senha do Mercado Livre. Preencha os dados e clique em Continuar.

• Autorize a conexão clicando em Autorizar.

• Quando a autenticação for concluída com sucesso, você verá uma confirmação na tela. Clique em Continuar para prosseguir.

Pronto! A integração foi realizada. A partir daqui, se você já tiver anúncios no Mercado Livre, eles serão importados automaticamente para que você possa relacioná-los aos produtos da sua loja.

Atenção: o processo de importação pode levar alguns minutos, especialmente se você tiver muitos anúncios na conta.

Limite de contas: é possível integrar até 10 apelidos (contas do Mercado Livre) por loja. O mesmo apelido não pode ser integrado em duas lojas diferentes.

Dashboard

O dashboard da integração reúne os principais indicadores em um só lugar, para que você acompanhe a saúde da integração sem precisar filtrar anúncio por anúncio.

Veja o que cada indicador significa:

Vendas não inclusas Vendas realizadas no Mercado Livre cujo anúncio ainda não está relacionado a um produto da sua loja. Enquanto o relacionamento não for feito, o estoque não é atualizado automaticamente. Mantenha esse indicador sempre zerado.

Anúncios ativos Total de anúncios ativos no Mercado Livre, de todos os apelidos integrados.

Anúncios com falha Anúncios que não foram publicados corretamente. Clique no indicador para visualizar os detalhes e corrigir cada um.

Anúncios sem relacionar Anúncios criados diretamente no site do Mercado Livre que ainda não foram vinculados a um produto da sua loja. Sem o relacionamento, o estoque e o preço não são sincronizados automaticamente.

Produtos sem anúncio Produtos cadastrados na sua loja que ainda não foram enviados ao Mercado Livre.

Apelidos do Mercado Livre

Após a primeira integração, você pode adicionar outras contas do Mercado Livre à mesma loja — ou remover contas que não usa mais.

• Acesse Marketplaces > Mercado Livre > Apelidos Mercado Livre > Gerenciar apelidos.

• Na tela, você encontra duas ações:
  • Incluir apelido: adiciona uma nova conta do Mercado Livre. O processo é o mesmo da primeira integração.
  • Excluir: remove a integração com o apelido selecionado. Ao excluir, o relacionamento de todos os anúncios daquele apelido é perdido — não será mais possível gerenciá-los pelo painel da Bagy.

Regras importantes:

• Cada loja suporta até 10 apelidos integrados.
• O mesmo apelido não pode ser integrado em duas lojas diferentes.

Novos anúncios — incluir anúncios

Para enviar produtos da sua loja ao Mercado Livre como novos anúncios:

• Acesse Marketplaces > Mercado Livre > Novos anúncios > Incluir anúncios.
• Selecione o apelido de destino. Se você tiver apenas um apelido integrado, ele já vem selecionado.
• Escolha se deseja enviar por produto ou por categoria.
• Use o campo de busca para localizar produtos por código ou nome. Filtre também por produtos já anunciados ou não anunciados.

• Selecione o produto e escolha a categoria do Mercado Livre em que o anúncio será publicado.

• Configure as opções do anúncio:

Regra de preço

Escolha como o preço do anúncio se comporta em relação ao preço da sua loja:

Preço de promoção: se o produto entrar em promoção na loja e o anúncio usar preço igual, com acréscimo ou com desconto, o preço promocional também será refletido no anúncio.

Revisão de catálogo

Ao final da página de inclusão, o botão Criar os anúncios elegíveis como catálogo já vem ativado por padrão. Quando um produto for elegível ao catálogo, você será direcionado à tela de revisão.

Na revisão:

1. Confira as informações do seu produto (lado esquerdo) em relação ao anúncio de catálogo existente no Mercado Livre (lado direito).
2. Clique em Ver lista completa para revisar todas as variações e atributos.
3. Se for o seu produto, clique em Sim, incluir catálogo. Caso contrário, clique em Não é meu produto — o sistema criará um anúncio padrão.
4. Ao final, clique em Incluir catálogos.

Pontos de atenção:

• Quais produtos podem ser catálogo é definido pelo Mercado Livre, não pela Bagy.
• Se você criar um anúncio catálogo com variações e deixar de relacionar alguma delas, as variações relacionadas entram no catálogo e as demais viram um anúncio padrão separado.
• Anúncios do tipo catálogo não podem ser multiplicados.

Revisão de anúncios

Após configurar todas as opções, a tela de revisão reúne as informações finais antes da publicação:

• Nome do anúncio (como vai aparecer no Mercado Livre)
• Dados do produto cadastrado na loja
• Descrição (editável antes de publicar)

Preencha a ficha técnica e clique em Incluir anúncios.

Anúncio travado em "Em fila"? Se após 1 hora o anúncio ainda estiver com esse status, vá em Seus anúncios > Visualizar anúncios, filtre por Em fila, clique em Detalhes e use o botão Reenviar.

Tabela de medidas

Para anúncios de categorias de moda, é possível incluir uma tabela de medidas que ajuda os clientes a escolherem o tamanho certo — e reduz devoluções.

Na etapa de revisão do anúncio, clique em Associar tabela de medidas ou Criar tabela de medidas personalizada.

• Associar tabela: selecione uma tabela existente (por marca, do próprio Mercado Livre ou personalizada). Tabelas de marcas e do Mercado Livre não permitem edição.
• Criar tabela personalizada: defina nome, variação de tamanho e medida principal. Campos obrigatórios estão marcados com *.

Atenção: se um anúncio de moda que exige tabela de medidas receber uma atualização (preço, estoque etc.) sem a tabela associada, ele ficará com o status Sincronização pausada — o anúncio continua ativo no Mercado Livre, mas não recebe nenhuma atualização até que a tabela seja inserida.

Seus anúncios — visualizar anúncios

Após relacionar e configurar seus anúncios, você pode visualizá-los e editá-los a qualquer momento.

• Acesse Marketplaces > Mercado Livre > Seus anúncios > Visualizar anúncios.

• Use os filtros para localizar os anúncios desejados — por status, apelido, configuração ativa ou inativa, entre outros.
• Para exportar a lista, clique em Exportar Excel no canto superior direito.
• Localizou o anúncio? Você tem duas opções de edição:
  • Edição rápida: clique na seta ao lado do anúncio e selecione a ação desejada.
  • Edição completa: clique em Editar para acessar a página completa do anúncio com todas as opções disponíveis.
• Após fazer as edições, salve as alterações no final da página.

Seus anúncios — importar e relacionar anúncios

Se você já tinha anúncios publicados diretamente no Mercado Livre antes de integrar com a Bagy, é necessário relacioná-los aos produtos da sua loja para que o estoque e o preço sejam sincronizados.

• Acesse Marketplaces > Mercado Livre > Seus anúncios > Importar e relacionar anúncios.

• Você verá todos os anúncios ativos e pausados do apelido integrado. Selecione o anúncio que deseja relacionar e clique em Relacionar produto.
• Configure a regra de preço, estoque e template (as opções são as mesmas da etapa de incluir anúncios).

Escolha como deseja relacionar o anúncio:

• Relacionar a um produto existente na loja: vincula o anúncio a um produto já cadastrado. Todas as alterações no produto (preço, estoque etc.) serão refletidas automaticamente no anúncio.
• Criar como novo produto: o anúncio é importado como um produto novo na loja. Após a criação, acesse o produto para preencher as informações faltantes (como categoria da loja).

Pronto! A partir desse momento, você gerencia o anúncio diretamente pelo painel da Bagy.

Dica: o relacionamento feito pelo painel de importação é necessário apenas para anúncios criados diretamente no Mercado Livre. Anúncios criados pelo painel da Bagy já são relacionados automaticamente.

Seus anúncios — multiplicar anúncios

A multiplicação permite criar cópias de um anúncio já relacionado — seja dentro do mesmo apelido (com configurações de frete e preço diferentes) ou para outro apelido integrado.

• Acesse Marketplaces > Mercado Livre > Seus anúncios > Multiplicar anúncios.

• Escolha o tipo de multiplicação:
  • Dentro do mesmo apelido: cria uma cópia do anúncio com possibilidade de alterar frete e preço.
  • Entre apelidos: replica o anúncio para outro apelido integrado (ou para o mesmo apelido, duplicando-o).
• Selecione o anúncio que será multiplicado, configure as opções (regra de preço, estoque e sincronização) e clique em Incluir anúncios.

Atenção: somente anúncios já relacionados podem ser multiplicados. Anúncios do tipo catálogo não podem ser multiplicados.

Vendas não inclusas — relacionar produtos

Quando uma venda ocorre no Mercado Livre e o anúncio ainda não está relacionado a um produto da loja, ela fica pendente na seção de vendas não inclusas. O relacionamento é obrigatório para que o estoque seja atualizado e a venda entre no painel de pedidos.

• Acesse Marketplaces > Mercado Livre > Vendas não inclusas > Relacionar produtos.

• Localize a venda na listagem e clique em Relacionar produto.
• Identifique o anúncio sem relacionamento e clique novamente em Relacionar produto ao lado dele.
• Configure a regra de preço, estoque e template.
• Escolha como relacionar:
  • Relacionar a um produto existente: vincula o anúncio a um produto já cadastrado na loja. Todas as próximas vendas desse anúncio serão incluídas automaticamente.
  • Criar novo produto: cria um produto com base no anúncio. Lembre-se de acessar o produto depois para preencher as informações faltantes.

Esse processo é feito apenas uma vez por anúncio. A partir daí, todas as vendas futuras desse anúncio são incluídas automaticamente.

Template de anúncios

Os templates permitem criar modelos de descrição para usar nos anúncios do Mercado Livre. Isso agiliza o preenchimento e mantém a comunicação padronizada.

Importante: o Mercado Livre não aceita HTML nas descrições dos anúncios. Somente texto simples é permitido.

• Acesse Marketplaces > Mercado Livre > Template e configurações > Template de anúncios.

• Para criar um novo template, clique em Incluir template.
• Use as tags disponíveis na plataforma para inserir informações dinâmicas do produto (nome, preço, descrição etc.) — basta copiar e colar a tag no campo de texto.

• Ao finalizar, salve o template. Ele ficará disponível para seleção ao criar ou editar anúncios.

Configurações gerais

As configurações gerais definem o comportamento padrão da integração para todos os anúncios. Acesse em Marketplaces > Mercado Livre > Template e configurações > Configurações gerais.

Veja o que cada configuração faz:

Ativar integração de estoque Define se uma venda no Mercado Livre deve dar baixa automática no estoque do produto relacionado na loja.

Autoconfirmação do pedido Com essa opção ativa, os pedidos entram automaticamente no fluxo padrão da plataforma. Se desativada, os pedidos chegam com o status Pendente e precisam ser confirmados manualmente.

Vincular anúncios automaticamente em produtos com o mesmo nome Quando ativa, a plataforma relaciona automaticamente novos anúncios a produtos que já tenham um relacionamento com o mesmo nome. Esse vínculo automático não é aplicado retroativamente — vale somente para os próximos anúncios.

Pausar ou ativar anúncio de acordo com a disponibilidade do produto Com essa opção ativa, o anúncio no Mercado Livre é pausado quando o produto da loja fica inativo — e reativado quando o produto volta a ser ativo. Essa regra considera o status do produto (ativo/inativo), não o estoque.

Enviar e-mails do sistema Controla se os e-mails automáticos da plataforma (disparados por ações da integração) serão enviados ou não.

Adicionar frete grátis como desconto no pedido Quando ativa, o custo do frete grátis oferecido pelo Mercado Livre aparece como desconto nos relatórios de vendas e na ficha do pedido.

Tipo de garantia padrão nos anúncios Define se a garantia dos anúncios relacionados é do Fabricante ou do Fornecedor.

Importação de pedidos

A Bagy captura automaticamente os pedidos realizados no Mercado Livre. Você não precisa acessar o painel do Mercado Livre para isso.

Confira como funciona a importação em cada situação:

Pedido com produto já relacionado A venda entra automaticamente no painel de pedidos da Bagy, em Vendas > Pedidos realizados, com todos os dados do cliente, produto, frete e pagamento.

Pedido com produto não relacionado A venda fica em espera na seção Vendas não inclusas até que o relacionamento seja feito. Veja o passo a passo em Vendas não inclusas — relacionar produtos.

Pedidos cancelados Pedidos cancelados no Mercado Livre são capturados automaticamente pela Bagy e atualizados com o status Cancelado na loja — sem precisar de nenhuma ação manual.

Atenção: se um pedido cancelado tiver seu status alterado manualmente na Bagy para outro status e o Mercado Livre enviar uma nova notificação de cancelamento, o sistema voltará a alterar o pedido para Cancelado automaticamente.

Gestão de pedidos ME2 — etiqueta de envio

O Mercado Envios 2 (ME2) é a modalidade de frete padrão do Mercado Livre. Nela, o próprio Mercado Livre calcula o frete e disponibiliza a etiqueta de postagem.

Fluxo do pedido ME2:

1. Clique em Imprimir etiqueta, 
2. Embale o produto, cole a etiqueta e leve aos Correios.

A partir daí, o processo é automático: em até 1 dia útil após a postagem, o Mercado Livre informa a Bagy que o produto foi enviado. O pedido é atualizado com o código de rastreio e o status muda para Enviado automaticamente.

Frete grátis no ME2: anúncios com valor igual ou superior a R$ 79,00 têm frete grátis aplicado automaticamente pelo Mercado Livre. Você não precisa configurar nada — o custo do frete é descontado da sua conta no Mercado Pago.

Gestão de pedidos ME1 — rastreio e entrega

O Mercado Envios 1 (ME1) é uma modalidade disponível apenas para lojistas assessorados pelo Mercado Livre. Nela, o lojista é responsável por todo o fluxo de envio — desde o cálculo do frete até a geração da etiqueta e o contrato com os Correios ou transportadora.

Para verificar se sua conta tem acesso ao ME1, entre em contato com o Mercado Livre.

Fluxo do pedido ME1:

• O pedido entra na Bagy com o status A enviar (ou Pendente, se a autoconfirmação estiver desativada), com todos os dados do cliente, produto, frete e pagamento.
• Emita a etiqueta pelo seu contrato com os Correios ou transportadora, embale o produto e envie.
• Após o envio, informe o código de rastreio na ficha do pedido na Bagy. A plataforma replica o código automaticamente para o Mercado Livre.

XML do pedido: para pedidos ME1, o XML com os dados do pedido fica disponível na ficha do pedido para geração de nota fiscal e controle interno.

Upload de nota fiscal (NF-e)

O envio da nota fiscal é obrigatório para algumas modalidades de frete do Mercado Livre — como Mercado Coleta e Mercado Places — e recomendado para todas as demais como boa prática fiscal.

A Bagy envia os dados da nota fiscal automaticamente para o Mercado Livre assim que você preencher as informações na ficha do pedido. Não é necessário acessar o painel do Mercado Livre para fazer esse envio.

Como informar os dados da NF-e:

1. Acesse o pedido em Vendas > Pedidos realizados e abra a ficha do pedido.
2. Clique na aba Dados fiscais.

3. Preencha os dados da nota fiscal emitida pelo seu sistema ou ERP:

   • Número da NF-e
   • Série
   • Chave de acesso (44 dígitos)
   • Data de emissão

    

4. Salve. A Bagy encaminha os dados para o Mercado Livre automaticamente quando o pedido atingir o substatus invoice_pending.

Atenção: o envio da NF-e ocorre automaticamente no momento certo do fluxo do pedido — preencha os dados assim que o pedido estiver confirmado e pago para não atrasar o processo de envio.

Fulfillment: pedidos atendidos pelo serviço de Fulfillment do Mercado Livre têm a nota fiscal emitida automaticamente pelo próprio Mercado Livre. Nesses casos, você não precisa preencher nenhum dado fiscal — e a emissão via ERP externo não é suportada.