Estados de órdenes ME1
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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/shipments
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2339711980/shipments
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,
...
}
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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID
Ejemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/28264263908 -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,
[ ]
}
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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/28264263908/seller_notifications -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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/28264263908/seller_notifications -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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/seller_notifications
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/28264263908/seller_notifications -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"
}