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

Conteúdos

→Status e substatus de envio →Atualizar o status de um envio ME1       ↳Informar código de rastreio       ↳Marcar pedido como despachado       ↳Marcar como não entregue       ↳Marcar pedido como entregue


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,
    ...
}


Informar código de rastreio

Com o id da resposta anterior, você poderá informar o código de rastreamento ou tracking number, que deve ser informado antes de enviar as alterações no status do pedido.

Chamada:

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

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d 
{
	"service_id": 11,
	"tracking_number": "OP123456789BR"
}
https://api.mercadolibre.com/shipments/28264263908

Resposta:

{
[ ]
    "date_created": "2020-08-19T16:18:57.000-04:00",
    "last_updated": "2020-08-19T16:19:57.899-04:00",
    "tracking_number": "OP123456789BR",
    "tracking_method": "Otros",
    "service_id": 11,
    "carrier_info": null,
    "sender_id": 419059118,
[ ]
}
Nota:
O campo service_id = 11 é para todos os pedidos ME1.

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":{
      "comment":"despachado",
      "date":"2020-02-28T16:03:51.175-04:00"
   },
   "status":"shipped",
   "substatus":"null"
}
https://api.mercadolibre.com/shipments/28264263908/seller_notifications

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.

ou registre-se para receber as últimas notícias sobre nossa API