Dashboard Mercado Livre ML00¶
Visão geral da integração com o Mercado Livre: status do serviço, contas conectadas, faturamento, pedidos, top produtos e gráficos de vendas. Ponto de partida para conectar uma conta nova ou monitorar o desempenho da operação.
Pré-requisitos¶
- Estar logado no sistema (veja Acessando o sistema)
meli-servicerodando (status visível no cartão Status do Serviço)- Para acessar dados: pelo menos uma conta do Mercado Livre conectada
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Mercado Livre → Dashboard (ou diretamente em Mercado Livre).
2. Conferir o status do serviço¶
O primeiro cartão mostra se o meli-service está Online (verde) ou Offline (vermelho). Quando offline, um aviso na parte inferior indica como reativar o serviço.
3. Cartões de KPIs¶
| Cartão | O que mede |
|---|---|
| Faturamento (30d) | Soma do total dos pedidos no período selecionado |
| Total Pedidos | Pedidos sincronizados (acumulado) |
| Ticket Médio | Faturamento dividido por nº de pedidos |
| Pendentes Importação | Pedidos que ainda não viraram pedido no ERP |
4. Selecionar o período¶
Os botões 7 dias / 30 dias / 90 dias alteram o período usado pelos KPIs e gráficos. O padrão é 30 dias.
5. Gráficos¶
| Gráfico | Conteúdo |
|---|---|
| Vendas por Período | Linha temporal com o faturamento por dia |
| Status dos Pedidos | Donut com a distribuição: paid, shipped, delivered, cancelled, pending |
| Top 10 Produtos | Tabela com os produtos mais vendidos no período (quantidade e faturamento) |
6. Conectar uma conta nova¶
Clique em Conectar Conta (amarelo, no cartão Contas Conectadas). Você é redirecionado para o login do Mercado Livre — entre com o usuário/senha da conta da loja e autorize o Sistemax a acessar pedidos, anúncios, perguntas e mensagens.
Ao voltar, a conta aparece na lista com:
- Nickname da conta
- ID do usuário no Mercado Livre
- Status: Conectado (verde) ou Token expirado (vermelho)
7. Desconectar uma conta¶
Clique em Desconectar na linha da conta. Após confirmar, o token é revogado — sincronizações pararão até reconectar.
Conta de teste¶
Se você conectou uma conta de teste do Mercado Livre (cadastrada no painel de developers), um banner amarelo avisa:
Contas de teste possuem restrições: mensagens e respostas a perguntas podem não funcionar. Conecte uma conta real para acesso completo.
Use contas de teste apenas para validar a integração antes de plugar a conta real.
Erros comuns¶
Serviço Offline
O meli-service está parado. Vá em Configurações → Serviços e inicie o serviço Mercado Livre.
Token expirado
O token OAuth do Mercado Livre tem validade e é renovado automaticamente. Se mostra "Token expirado", desconecte e reconecte a conta.
Nenhum dado no gráfico
Acabou de conectar a conta? Aguarde a primeira sincronização rodar (alguns minutos) e os pedidos serem importados.