Documentación Mercado Envíos

Descubre toda la información que debes conocer sobre las APIs de Mercado Envíos.
circulos azuis em degrade

Documentación

Última actualización 03/11/2023

Envíos Turbo

Importante:
Actualmente, esta modalidad de envío está en fase de lanzamiento piloto, siendo exclusiva solo para algunos vendedores de Argentina.

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.


Nota:
- Es fundamental respetar el límite de 1000 rpm en todas las llamadas a los recursos de Turbo. Mantener este límite garantiza un uso eficiente y equitativo de los recursos disponibles.
- La app de envíos Flex de Mercado Libre es necesaria para escanear las entregas y hacer los recorridos de entregas. Sin embargo, no está disponible para integraciones, por lo que las empresas logísticas deberán adaptarse.

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


Nota:
En el contexto de las suscripciones, cada una de ellas cuenta con un identificador único llamado service_id. Este identificador es fundamental para poder acceder a la configuración de la suscripción y realizar cambios en ella. Para este caso, el que se utilizará será el service_id de la modalidad 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"
    ]
Nota:
- Es importante aclarar que Turbo no es un tipo de logística en sí mismo. Esto significa que cuando estés interactuando con nuestros endpoints, el atributo logistic_type seguirá devolviendo el valor de self_service y no Turbo.
- Asimismo, se podrá encontrar esta misma diferencia en las tags de:
- https://api.mercadolibre.com/users/$USER_ID/shipping_preferences
- https://api.mercadolibre.com/orders/$ORDER_ID/shipments