Documentação do Mercado Livre

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

Documentação do

Última atualização em 11/06/2024

Status de pedidos e rastreamento

A nova ferramenta de status de pedidos ME1 tem o objetivo de melhorar a experiência dos compradores no acompanhamento da entrega de seus pedidos. Neste recurso, será possível informar quando o produto foi enviado, se houve sucesso na entrega ou não além do número de rastreamento (tracking number).


Status e substatus de envio

As junções das informações do campo status e sub-status de envio determinam o que será notificado ao comprador. Agora é possível enviar a informação de pedido despachado (shipped) ou insucesso de entrega (not_delivered):

Status Substatus Descrição
shipped null Enviado
not_delivered returning_to_sender Não entregue - Retornado ao vendedor
delivered null Entregue ao comprador

Atualizar o status de um envio ME1

Para atualizar o status do envio, é necessário que conheça o shipment_id do pedido. Para obter esta informação, busque no recurso de order.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/shipments

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2339711980/shipments

Resposta:

{
    "id": 28264263908,
    "mode": "me1",
    "created_by": "receiver",
    "order_id": 2339711980,
    "order_cost": 99.9,
    "base_cost": 22.07,
    "site_id": "MLB",
    "status": "pending",
    "substatus": null,
    ...
}


Marcar pedido como despachado

Para marcar o pedido como despachado, é necessário informar o status como "shipped" e o substatus como "null".

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json'  \
{
  "payload": {
             "service_id": 154,
    "comment": "despachado",
    "date": "2023-01-16T13:03:51.175-04:00"
  },
  "tracking_number": "OP123456789AR",
  "tracking_url": "http://www.url.test/40886674732",
  "status": "shipped",
  "substatus": "null"
}
https://api.mercadolibre.com/shipments/28264263908/seller_notifications
Nota:
Cada país possui um código que deve ser usado no service_id para informar o tracking. Esse código representa ME1:
- MLB: 11
- MLA: 154
- MLM: 231876
- MLC: 282578
- MCO: 282579
- MLU: 282604
- MPE: 361180

Marcar pedido como não entregue

O status "not_delivered" é um status finalizador e irreversível. Só deve ser utilizado quando não houver mais tentativas de entrega. Dessa forma o vendedor tem que alinhar o fluxo para que seja feita a devolução do dinheiro do comprador.
Para marcar o pedido como não entregue, é necessário informar o status como "not_delivered" e o substatus como "returning_to_sender".


Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json'  \
{
   "payload":{
      "comment":"Não entregue",
      "date":"2020-03-05T16:17:51.175-04:00"
   },
   "status":"not_delivered",
   "substatus":"returning_to_sender"
}
https://api.mercadolibre.com/shipments/28264263908/seller_notifications

Marcar pedido como entregue

Ao receber a informação de que o produto foi entregue ao comprador, é necessário fazer a alteração do status da compra para entregue. Para isso utilize o status "delivered" com o substatus "null".
Este status também é finalizador e irreversível.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json'  \
 {
   "payload":{
      "comment":"Pedido entregue",
      "date":"2020-03-06T16:17:51.175-04:00"
   },
   "status":"delivered",
   "substatus":"null"
}
https://api.mercadolibre.com/shipments/28264263908/seller_notifications

Próximo: Frete dinâmico.