Estados de órdenes ME1

El nuevo recurso Estados de órdenes ME1 tiene el objetivo de mejorar la experiencia de los compradores en el acompañamiento de la entrega de los productos. Podrá informarse cuando el producto fuera enviado, si la entrega fue exitosa o no, además del número de seguimiento (tracking number).

Contenidos

→Estados y subestados de envío
→Actualizar el estado de un envío ME1
   ↳Informar código de seguimiento
   ↳Marcar compra como despachada
   ↳Marcar como no entregada
   ↳Marcar compra como entregada

Estados y subestados de envío

La fusión de la información del campo status y el subestado de envío determina qué se notificará al compradores. Ahora es posible enviar la información de la compra despachada (shipped) o la entrega fallida (not_delivered):

Estado	Subestado	Descripción
shipped	null	Despachado
not_delivered	returning_to_sender	No entregado - Devuelto al vendedor
delivered	null	Entregado al comprador

Actualizar el estado de un envío ME1

Para actualizar el estado del envío es necesario que conozcas el shipment_id de la orden. Para obtenerlo, consulta al recurso order.

Llamada:

curl -X GET https://api.mercadolibre.com/orders/$ORDER_ID/shipments?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/orders/2339711980/shipments?access_token=$ACCESS_TOKEN

Respuesta:

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

Nota:

Utilizamos el campo ID de esta respuesta.

Informar código de seguimiento

El código de seguimiento o tracking number debe ser informado antes de enviar las modificaciones en el status de la orden, para eso es necesario realizar un PUT al recurso /shipments:

Llamada:

curl -X PUT https://api.mercadolibre.com/shipments/$SHIPMENT_ID?access_token=$ACCESS_TOKEN

Ejemplo:

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

Respuesta:

{
[ ]
    "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:

El campo service_id = 11 es para todas las órdenes ME1.

Marcar compra como despachada

Para marcar la compra despachada es necesario informar el estado como "shipped" y el subestado como "null".

Llamada:

curl -X POST https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X POST https://api.mercadolibre.com/shipments/28264263908/seller_notifications?access_token=$ACCESS_TOKEN -H 'Content-Type: application/json'  \
{
   "payload":{
      "comment":"despachado",
      "date":"2020-02-28T16:03:51.175-04:00"
   },
   "status":"shipped",
   "substatus":"null"
}

Respuesta:

{
    "status": "OK"
}

Marcar compra como no entregada

El status "not_delivered" es un estado final e irreversible. Solo debe ser utilizado cuando no hubiera más intentos de entrega. De esa forma, el vendedor tiene que alinear el flujo para que la devolución del dinero del comprador sea realizada.
Para marcar la compra como no entregada, debes informar el estado como "not_delivered" y el subestado como "returning_to_sender".

Llamada:

curl -X POST https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X POST https://api.mercadolibre.com/shipments/28264263908/seller_notifications?access_token=$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"
}

Respuesta:

{
    "status": "OK"
}

Marcar compra como entregada

Al recibir la información de que un producto fue entregado al comprador, debes realizar un cambio en el estado de la compra para entregada. Para eso, utiliza el estado "delivered" con el subestado "null".
Este status también es finalizador e irreversible.

Llamada:

curl -X POST https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications?access_token=$ACCESS_TOKEN

Ejemplo:

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

Respuesta:

{
    "status": "OK"
}