Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação
Convivência
Conteúdos
→Beneficios
→Como funciona?
→Pontos de atenção
→Principais mudanças operacionais
Beneficios
- Frete grátis para todo o país: 60% subsidiado pelo Mercado Envios. 40% pago pelo vendedor
- Maior relevância dos anúncios na busca da plataforma
- Dinheiro disponível 48h após a entrega
- 100% dos envios assegurados
- Rastreamento automático.
Como funciona?
O primeiro passo é verificar as preferências de envio disponíveis para o usuário do vendedor.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/users/$USER_ID/shipping_preferences'
No retorno, você irá notar duas diferenças. Uma na tag "modes", onde você poderá observar que o usuário possui os dois modos de envio:
"modes": [
"custom",
"not_specified",
"me1",
"me2"
]
E outra na tag "tags", onde você poderá observar que o modo ME2 está habilitado como opcional:
"tags": [
"optional_me2_allowed"
]
O vendedor sendo um vendedor com ME1 nativo, e possuindo a opção de ME2 opcional, o próximo passo é verificar se a categoria do anúncio a ser criado / atualizado possui a possibilidade de publicar com ME2.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/users/$USER_ID/shipping_modes?category_id=$CATEGORY_ID'
No retorno dessa chamada, se a categoria permite ME1 e ME2, você poderá perceber que serão retornados os detalhes desses dois modos. Ou seja, você pode publicar esse mesmo anúncio como ME1 ou ME2. Caso seja retornado apenas um dos modos, somente aquele modo será permitido nessa categoria. O próximo passo será a criação / atualização do anúncio como ME2 (no caso de vendedor com ME1 nativo).
Chamada (Criação):
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"title":"Samsung Galaxy S8 - ANUNCIO DE TESTE! NÃO OFERTAR!",
"category_id":"MLB264358",
"price":3000,
"currency_id":"BRL",
"available_quantity":1,
"buying_mode":"buy_it_now",
"listing_type_id":"gold_special",
"condition":"new",
"description": "ANUNCIO DE TESTE! NÃO OFERTAR!",
"warranty": "12 meses",
"shipping":
{
"mode":"me2"
}
}' 'https://api.mercadolibre.com/items'
O retorno no caso de criação será o JSON do anúncio criado com o modo de envio setado para ME2.
Chamada 1 (Atualização):
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"shipping":
{
"mode":"me2"
}
}' 'https://api.mercadolibre.com/items/$ITEM_ID'
O retorno no caso de atualização será o JSON do anúncio atualizado com o modo envio setado para ME2.
Chamada 2 (Atualização):
Para alterar o tipo de envio de um produto de ME2 para ME1, é importante realizar o PUT do recurso abaixo, para retirar o frete grátis que estava configurado por default neste item pelo programa de pontos. A não ser que o vendedor queira arcar com o valor de envio e deixar este item com o frete grátis.
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/ITEM_ID
{
"shipping": {
"mode": "me1",
"local_pick_up": false,
"dimensions":"20x20x20,900"
"free_methods": []
}
}
Mais detalhes de como trabalhar com Mercado Envios 2.
Pontos de atenção
- Vendas em ME2 serão contabilizadas para a métrica de Handling Time (despacho em até 24h) da reputação. Ou seja, um Handling Time maior que 24h sofrem penalização na reputação.Vendas ME1 não serão contabilizadas nessa regra.
- O endereço cadastrado no Mercado Livre precisa ser o mesmo endereço de postagem nos Correios.
Principais mudanças operacionais
- Utilização da etiqueta de Mercado Envios para todas as vendas de ME2.
- Configuração da impressão da etiqueta de Mercado Envios nas impressoras.
- Adaptar o processo operacional para utilização de nossa etiqueta.
- Fazer a postagem na agência dos Correios a sua escolha, podendo encaixar na coleta dos Correios caso tenha.
- Fazer a postagem 24h após a concretização da venda e aprovação do pagamento nas vendas por ME2.