Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
API TEST - Logística Dropoff
Durante el desarrollo e integración con Mercado Pago Delivery, es necesario poder simular los diferentes estados por los que pasa un pedido en el flujo logístico Dropoff. En producción, estos cambios de estado son enviados automáticamente conforme el repartidor avanza en el proceso de entrega.
Esta API de testing permite simular manualmente esos cambios de estado, facilitando las pruebas de integración. De esta manera, puedes verificar que tu sistema responde correctamente a cada notificación de cambio de estado.
Llamada
Para simular un cambio de estado, realiza un POST enviando el shipmentId del pedido y el notification (estado) que deseas simular.
curl -X POST \
'https://api.mercadopago.com/proximity-integration/v1/testing/notifications' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
"shipmentId": 42202706921,
"notification": "ON_ROUTE_TO_PICKUP"
}'
Parámetros de Request
Header
| Parámetro | Tipo | Descripción |
|---|---|---|
| Authorization (obligatorio) | string | Access Token de un usuario de prueba. |
| Content-Type (obligatorio) | string | Debe ser application/json. |
Body
| Parámetro | Tipo | Descripción |
|---|---|---|
| shipmentId (obligatorio) | number | Shipment ID del pedido al que se le desea cambiar el estado. |
| notification (obligatorio) | string | Estado al que se desea cambiar el pedido. Ver tabla de valores posibles. |
Valores posibles de notification
Los siguientes valores representan los estados del flujo logístico Dropoff que puedes simular:
| Valor | Estado resultante | Descripción |
|---|---|---|
ON_ROUTE_TO_PICKUP |
ready_to_ship/on_route_to_pickup |
El repartidor está en camino hacia el restaurante para recoger el pedido. |
PICKING_UP |
ready_to_ship/picking_up |
El repartidor llegó al restaurante y está recogiendo el pedido. |
SHIPPED |
shipped/out_for_delivery |
El repartidor ya salió del restaurante con el pedido y está en camino al cliente. |
DELIVERED |
delivered |
El pedido fue entregado exitosamente al cliente. |
Errores
| Código de Error | Mensaje | Descripción |
|---|---|---|
| 400 | Bad Request | El valor de notification no es válido o el pedido no está en un estado compatible para la transición solicitada. |
| 401 | Unauthorized | Access Token inválido o expirado. |
| 403 | Forbidden | El usuario no es un usuario de prueba o no tiene permisos para acceder a este recurso. |
| 424 | Not Found | No se encontró el pedido con el shipmentId especificado. |
| 500 | Internal Server Error | Error interno del servidor. Intenta nuevamente más tarde. |