Integração Mercado Livre
Conecte sua conta do Mercado Livre ao Synchro Hub para receber pedidos em tempo real, com tarifas descontadas e desempenho por anúncio no dashboard.
Visão geral
Ao integrar o Mercado Livre, o Synchro Hub passa a:
- Receber notificações de pedidos, pagamentos, cancelamentos e devoluções em tempo real (
orders_v2,payments,shipments). - Consolidar cada pedido no dashboard com valor, itens, status e as tarifas do marketplace já descontadas — comissão da categoria, custo de envio e taxa por item.
- Atribuir o resultado ao anúncio (MLB) que originou a venda, permitindo ordenar seu catálogo por receita líquida.
Boa notícia: a conexão é 100% por autorização (OAuth). Você não precisa gerar App ID, Secret Key nem copiar qualquer credencial — basta autorizar o Synchro Hub na sua conta.
Tempo estimado: 3 minutos. O que você vai precisar:
- Uma conta de vendedor ativa no Mercado Livre, com acesso de administrador.
- Workspace já criado no Synchro Hub.
Pré-requisitos
- Estar logado no Synchro Hub com um workspace selecionado.
- Ter acesso à conta de vendedor em mercadolivre.com.br.
Passo 1 — Conectar a plataforma no Synchro Hub
- No Beacon, acesse Configurações → Integrações → Fontes de Venda.
- Clique em + Adicionar Plataforma.
- Selecione Mercado Livre e clique em Confirmar.
Passo 2 — Autorizar o Synchro Hub na sua conta
- No card do Mercado Livre, clique em Conectar (ou Atualizar credenciais).
- Você é redirecionado para o Mercado Livre. Faça login se necessário.
- Revise as permissões solicitadas (leitura de pedidos e anúncios) e clique em Permitir.
- O Mercado Livre devolve você ao Beacon com a integração conectada. O card passa a exibir Ativa / Conectado.
Por que autorizar? É essa autorização que dá ao Synchro Hub acesso somente de leitura aos seus pedidos, sem que você precise manusear tokens. O acesso vale até você desconectar a integração.
Atenção — conta certa: a autorização vale para a conta que estiver logada no navegador. Se você administra mais de uma conta de vendedor, confirme qual está ativa antes de permitir, ou use uma janela anônima.
Passo 3 — Ativar as notificações (automático)
- No card do Mercado Livre, clique em Configurar Webhook.
- Clique em Ativar Webhook.
O Synchro Hub registra automaticamente os tópicos de pedido e pagamento no Mercado Livre — nenhuma configuração manual é necessária. Ao concluir, o card passa a exibir Webhook ativo.
Verificação
- Gere um pedido de teste na sua conta (uma compra real de valor baixo em um dos seus anúncios).
- Abra Vendas no menu lateral do Synchro Hub.
- A venda deve aparecer em até 1 minuto após a confirmação do pagamento, com o valor líquido já calculado.
Limitações conhecidas
- Somente a partir de agora: pedidos anteriores à conexão não são importados. Só valem os eventos recebidos a partir da ativação.
- Uma conta por conexão: cada conta de vendedor exige a sua própria autorização. Contas diferentes ocupam vagas de conexão distintas no plano.
- Tarifas conforme o Mercado Livre informa: o valor líquido reflete os custos devolvidos pela plataforma no momento do pedido. Ajustes posteriores feitos pelo marketplace (como reembolso de frete) são refletidos quando a atualização chega.
Solução de problemas
| Sintoma | O que fazer |
|---|---|
| A autorização não conclui | Faça login com a conta de vendedor administradora e tente novamente. Contas de operador sem permissão não conseguem autorizar aplicativos. |
| Autorizei a conta errada | No card, clique em Remover e refaça a conexão em uma janela anônima, logado na conta correta. |
| Nenhuma venda chega após o pagamento | Confirme no card se está Webhook ativo. Se não, clique em Configurar Webhook → Ativar Webhook. |
| A integração pede autorização de novo | Esperado quando o acesso expira ou é revogado no Mercado Livre. Clique em Atualizar credenciais para renovar. |
| Vendas antigas não aparecem | Esperado — a integração é somente a partir da ativação (sem importação retroativa). |
Perguntas frequentes
Tenho dezenas de anúncios. Preciso integrar cada um? Não. A integração é por conta de vendedor. Todos os pedidos de todos os seus anúncios chegam pela mesma conexão, já separados por MLB.
Preciso criar um aplicativo no DevCenter do Mercado Livre? Não. O aplicativo é do Synchro Hub — você apenas autoriza o acesso à sua conta.
O valor que aparece no dashboard é o bruto ou o líquido? Você enxerga os dois. O Synchro Hub registra o valor do pedido e desconta comissão, envio e taxas para mostrar quanto de fato entrou.
Vendo também em loja própria e em outras plataformas. Dá para comparar? Sim. Essa é a proposta: Mercado Livre, loja própria e infoprodutos aparecem no mesmo painel, comparáveis no mesmo período.
Como desconecto a integração? No card do Mercado Livre, clique em Remover. O acesso do Synchro Hub à sua conta é encerrado.