Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 09/08/2023

Convivência

Visando uma melhor experiência logística na plataforma do Mercado Livre, agora vendedores com logística Mercado Envios 1 (ME1), ou seja, com logística própria, podem também ter a logística Mercado Envios padrão (ME2) em seus produtos, tudo em uma só conta! Para poder usar as duas opções, primeiro deverá haver um acordo diretamente com o assessor comercial, pois no momento, não é uma funcionalidade pública. Outra observação é que somente cadastros que já são ME1 poderão* ter ME2 também. *Respeitando a informação do acordo prévio com o assessor comercial.

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).

Importante:
Se o vendedor possui ME1 nativo, e no JSON da criação não ser enviado o modo de envio, a API irá criar o anúncio com modo ME1. Para que seja ME2, na chamada é obrigatório enviar o modo ME2 de forma explícita.

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.

Importante:
Uma vez que um anúncio foi criado como ME2, seguirá o fluxo de ME2 que é diferente do ME1. Basicamente no ME2 o vendedor só precisa estar atento a imprimir as etiquetas de envio. Isso deverá acontecer quando o status do envio (shipment) fica como "ready_to_print".

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.