O Mercado Livre é o maior marketplace da América Latina. A integração usa OAuth 2.0 e importa vendas pagas como shipments.
Conectando
1. Autorizar OAuth
- Acesse Integrações > Mercado Livre
- Clique em Conectar Mercado Livre
- Você será redirecionado para o ML — faça login e autorize
- O ML retorna para o BulkRoute com o token de acesso
2. Mapear carriers
O Mercado Livre usa o campo shipping_option.name para identificar o carrier. Mapeie:
3. Ativar sincronização
Ative a sincronização automática (padrão: 30 minutos).
O que é importado
Cubagem
O Mercado Livre não envia dimensões por item. O BulkRoute usa cubagem padrão por categoria do ML:
- Eletrônicos pequenos: 20×15×10 cm, 1 kg
- Eletrodomésticos: 50×40×30 cm, 8 kg
- Móveis: 100×60×40 cm, 15 kg
- Outros: 30×30×30 cm, 3 kg
Você pode ajustar esses valores em Integrações > Mercado Livre > Mapeamento de categorias.
Sincronização de tracking
O BulkRoute envia o tracking code para o ML via POST /shipments/:id/tracking. O cliente final vê o tracking dentro do ML ou pelo link do BulkRoute.
Mercado Envios vs frete próprio
Se você usa Mercado Envios (frete gerenciado pelo próprio ML), o ML já gera o tracking e despacha. Nesse caso, o BulkRoute apenas importa o pedido para centralização — não despacha nem gera etiqueta.Se você usa frete próprio no ML (envio combinado), o BulkRoute despacha normalmente e sincroniza o tracking de volta.
Troubleshooting
