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:

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:

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"
    ]