Documentación Mercado Envíos
Descubre toda la información que debes conocer sobre las APIs de Mercado Envíos.
Documentación
Envíos Turbo
Envíos turbo es un servicio de entregas que se enfoca en proporcionar envíos rápidos en menos de 3 horas. Está diseñado para atender zonas cercanas al vendedor y se basa en el modelo logístico de Flex. Este servicio tiene como objetivo ofrecer una opción de entrega extremadamente rápida, lo que puede ser especialmente útil para mejorar la puntualidad en las entregas y brindar un servicio de alta calidad a los usuarios.
Conoce más sobre los Envíos Flex, cómo calculan los tiempos de entrega con envíos Turbo, preguntas frecuentes sobre envíos Turbo.
Áreas de cobertura por países
Para poder ofrecer envíos Turbo, la dirección de envío del vendedor debe estar habilitada para alguna de las áreas de cobertura según el país:
País | Cobertura |
---|---|
Argentina | - AMBA (Área Metropolitana de Buenos Aires) |
Consultar suscripciones de un usuario
Este endpoint permite consultar las suscripciones que tiene un usuario.
- Si el usuario activa ambos servicios, Flex y Turbo, tendrá dos suscripciones, ya que Flex es un requisito para acceder a Turbo.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/$SITE_ID/users/$USER_ID/subscriptions/v1
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/MLA/users/1438865529/subscriptions/v1
Respuesta:
[
{
"id": 111181,
"site_id": "MLA",
"user_id": 1438865529,
"mode": "FLEX",
"configuration_type": {
"coverage": "zone",
"delivery": "custom"
},
"service_id": 736230,
"status": {
"id": "in",
},
"creation_date": "2023-08-02T06:34:40Z"
},
{
"id": 111183,
"site_id": "MLA",
"user_id": 1438865529,
"mode": "TURBO",
"configuration_type": {
"coverage": "radius",
"delivery": "accurate"
},
"service_id": 738216,
"status": {
"id": "in",
},
"creation_date": "2023-08-02T06:35:30Z"
}
]
Parámetros de respuesta:
- id ID único de la suscripción.
- site_id Identificador del país.
- user_id ID del usuario.
- mode Tipo de suscripción (TURBO en este caso).
- configuration_type Tipo de configuración de la suscripción (TURBO en este caso).
- configuration_type.coverage Tipo de cobertura.
- configuration_type.delivery Tipo de entrega.
- service_id ID del servicio asociado a la suscripción.
- status Estado de la suscripción.
- status.id: Tipos de estados de la suscripción:
- in: La suscripción está activa. En este estado el usuario puede cambiar su configuración y recibirá pedidos de envíos para el modo de suscripción.
- out: La suscripción no está activa. En este estado el usuario no puede cambiar la configuración.
- pending: La suscripción está pendiente de activación. En este estado el usuario puede cambiar su configuración aunque no va a recibir pedidos para realizar envíos.
- creation_date Fecha de creación de la suscripción.
Códigos de estado de respuesta:
Código | Mensaje | Descripción | Recomendación |
---|---|---|---|
200 - OK | - | Se actualizó correctamente la configuración. | - |
400 - Bad Request | empty site id | El site_id está vacío. | Validar el site_id. |
400 - Bad Request | invalid site_id | Site_id inválido. | Validar si el site_id está habilitado para envíos Turbo. |
400 - Bad Request | can't access to resource | Site_id inválido. | Validar si el site_id está habilitado para envíos Turbo. |
404 - Not Found | user not found | No existe el usuario. | Validar el user_id. |
Identificar órdenes Turbo
Este endpoint determina si un envío se manejará mediante el servicio Turbo, permitiendo concluir la transacción de manera efectiva.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/42469883906
Respuesta:
"tags": [
"turbo"
]