Costos de envío y SLA

La gestión de costos de envíos implica dos aspectos muy relevantes: el primero ocurre al momento de publicar o editar un artículo, mientras que el segundo ocurre al momento de la compra.

Para la primera fase, es decir, al momento de publicar o editar un artículo, son necesarios los siguientes endpoints:

Consultar productos con envíos gratis

El primer endpoint proporciona la información necesaria para verificar si el vendedor ofrece envío gratuito en su publicación.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1122334488

Respuesta con free shipping optional:

"shipping": {
    "mode": "me2",
    "methods": [],
    "tags": [
        "self_service_in"
    ],
    "dimensions": null,
    "local_pick_up": false,
    "free_shipping": true,
    "logistic_type": "cross_docking",
    "store_pick_up": false
}

Recuerda que si la etiqueta "mandatory_free_shipping" no está presente, se puede enviar el atributo "free_shipping" como true o false. Esto se debe a que el vendedor puede optar por ofrecer o no envíos gratuitos de forma opcional.

Respuesta con free shipping mandatory:

"shipping": {
    "mode": "me2",
    "methods": [],
    "tags": [
        "mandatory_free_shipping"
    ],
    "dimensions": null,
    "local_pick_up": true,
    "free_shipping": true,
    "logistic_type": "xd_drop_off",
    "store_pick_up": false
}

• El tag “mandatory_free_shipping” se aplica exclusivamente a envíos realizados a través de Mercado Envíos 2 (ME2).
• En caso de que el parámetro "mandatory_free_shipping" esté presente, el requisito es obligatorio. Es crucial adherirse a este parámetro cuando el endpoint lo proporciona.
• Para Envíos Turbo, la opción de "mandatory_free_shipping" no estará disponible. En su lugar, Mercado Libre ofrecerá un descuento según corresponda.

Respuesta con free shipping fuera de me2:

"shipping": {
    "mode": "not_specified",
    "methods": [],
    "tags": [],
    "dimensions": null,
    "local_pick_up": true,
    "free_shipping": true,
    "logistic_type": "not_specified",
    "store_pick_up": false
}

En modalidades de envío que no corresponden a ME2, los vendedores tienen la libertad de establecer el costo de envío según sus preferencias.

Parámetros de respuesta:

• shipping.mode: Modalidad de envío configurado para el ítem.
• shipping.tags: Etiquetas de envío del ítem.

• Si indica "mandatory_free_shipping" es porque el ítem superó el límite de precio establecido por Mercado Libre. Para estos productos, el envío gratuito es una obligación. Los vendedores deben ofrecer envíos gratis o importantes descuentos en el envío.
• En cambio, para productos con un precio por debajo de ese límite de precio, el envío gratuito es opcional.

• shipping.dimensions: Dimensiones del producto, en el formato: altura x ancho x largo, peso.
• shipping.local_pick_up: Indicador booleano que muestra si está disponible la opción de retiro en persona.
• shipping.free_shipping: Indicador booleano que muestra si el envío es gratuito.
• shipping.logistic_type: Tipo de logística del envío.
• shipping.store_pick_up: Indicador booleano que muestra si está disponible la opción de recogida en tienda.

Para obtener una visión más detallada sobre el límite de precios para envíos gratis, te invitamos a consultar las siguientes páginas:

• Costos por ofrecer envíos gratis en Brasil
• Costos por ofrecer envíos gratis en Argentina
• Costos por ofrecer envíos gratis en México
• Costos por ofrecer envíos gratis en Chile
• Costos por ofrecer envíos gratis en Colombia
• Costos por ofrecer envíos gratis en Perú
• Costos por ofrecer envíos gratis en Uruguay
• Costos por ofrecer envíos gratis en Ecuador

Consultar costos de envíos al publicar o editar un ítem

Este endpoint permite conocer el precio aproximado que el vendedor pagará por el envío de un determinado ítem. Se puede utilizar también para simular costos de envíos al momento de publicar o editar un ítem.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_options/free?dimensions=$DIMENSIONES&verbose=$VERBOSE&item_price=$ITEM_PRICE&listing_type_id=$LISTING_TYPE&mode=$MODE&condition=$CONDITION&logistic_type=$LOGISTIC_TYPE

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/244878077/shipping_options/free?dimensions=9x17x22,462&verbose=true&item_price=300&listing_type_id=gold_pro&mode=me2&condition=new&logistic_type=drop_off

Parámetros de consulta aceptables:

Respuesta:

{
    "coverage": {
        "all_country": {
            "list_cost": 8106.49,
            "currency_id": "ARS",
            "billable_weight": 5828
        }
    }
}

Parámetros de respuesta:

• coverage: Representa la cobertura de envío y contiene información sobre los costos y la moneda utilizada para el envío.
• coverage.all_country: Dentro de "coverage", "all_country" especifica que la información se aplica a envíos a todo el país.
• coverage.all_country.list_cost: Costo de envío ofrecido al vendedor.
• coverage.all_country.currency_id: Moneda utilizada para el costo de envío.
• coverage.all_country.billable_weight: Peso facturable del envío.
• coverage.discount: Información sobre descuentos aplicados al envío.
• coverage.discount.rate: Tasa de descuento aplicada.
• coverage.discount.type: Describe el tipo de descuento.
• coverage.discount.promoted_amount: Monto o valor base sobre el cual se aplicará un cierto porcentaje de descuento. Por ejemplo, si tenemos un costo de envío de $200 y se aplica un descuento del 40%, en la respuesta final obtendríamos: list_cost = 120, rate: 0.4 y promoted_amount = 200.

Códigos de estado de respuesta:

En relación a MShops, es importante destacar que actualmente no contamos con un endpoint específico para consultar los costos de envíos. Sin embargo, queremos proporcionar valiosa información relacionada con las reglas de negocio que se aplican, así como los montos o umbrales establecidos para ofrecer envíos gratuitos:

• Costos por ofrecer envíos gratis en Brasil
• Costos por ofrecer envíos gratis en Argentina
• Costos por ofrecer envíos gratis en México
• Costos por ofrecer envíos gratis en Chile
• Costos por ofrecer envíos gratis en Colombia

Para la segunda fase o el proceso de compra de un artículo, debes utilizar los siguientes endpoints:

Consultar costos de envíos al comprar un artículo

Este endpoint proporciona una vista detallada de las opciones de envío disponibles junto con sus costos al momento de la compra de un artículo, adaptándose al destino del comprador.

Llamada por Código Postal:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/shipping_options?zip_code=$ZIP_CODE

Ejemplo por Código Postal:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1398714241/shipping_options?zip_code=1675

Llamada por Ciudad:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/shipping_options?city_to=$CITY_TO

Ejemplo por Ciudad:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1398714241/shipping_options?city_to=Q08tRENCb2dvdA

Respuesta:

{
  "destination": {
    "zip_code": "1675",
    "city": {
      "id": null,
      "name": null
    },
    "state": {
      "id": "AR-B",
      "name": "Buenos Aires"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    }
  },
  "buyer": {
    "id": 0,
    "loyalty_level": 1,
    "shipping_level": "1"
  },
  "options": [
    {
      "id": 3048556710,
      "option_hash": "708dd0837f1b1b6468c85d7079091889",
      "name": "Prioritario a domicilio",
      "currency_id": "ARS",
      "base_cost": 6023.99,
      "cost": 6023.99,
      "list_cost": 6023.99,
      "display": "recommended",
      "shipping_method_id": 510445,
      "shipping_method_type": "next_day",
      "shipping_option_type": "address",
      "estimated_delivery_time": {
        "type": "known",
        "date": "2024-04-20T00:00:00-03:00",
        "unit": "hour",
        "offset": {
          "date": null,
          "shipping": null
        },
        "time_frame": {
          "from": null,
          "to": null
        },
        "pay_before": "2024-04-20T14:00:00-03:00",
        "shipping": 0,
        "handling": 0,
        "schedule": null
      },
      "discount": {
        "promoted_amount": 0,
        "rate": 0,
        "type": "none",
        "show_loyal_benefit": false
      }
    },
    {
      "id": 1638980834,
      "option_hash": "0f1d5344a6cded1656403bfb6b4dbf50",
      "name": "Estándar a domicilio",
      "currency_id": "ARS",
      "base_cost": 6023.99,
      "cost": 6023.99,
      "list_cost": 6023.99,
      "display": "always",
      "shipping_method_id": 510645,
      "shipping_method_type": "three_days",
      "shipping_option_type": "address",
      "estimated_delivery_time": {
        "type": "known",
        "date": "2024-04-22T00:00:00-03:00",
        "unit": "hour",
        "offset": {
          "date": null,
          "shipping": null
        },
        "time_frame": {
          "from": null,
          "to": null
        },
        "pay_before": "2024-04-22T16:00:00-03:00",
        "shipping": 0,
        "handling": 0,
        "schedule           ": null
    },
    "discount": {
      "promoted_amount": 0,
      "rate": 0,
      "type": "none",
      "show_loyal_benefit": false
    }
  },
  {
    "id": 336095950,
    "option_hash": "027577b20d617392425136c0528cfb74",
    "name": "Estándar a sucursal de correo",
    "currency_id": "ARS",
    "base_cost": 10051.99,
    "cost": 10051.99,
    "list_cost": 10051.99,
    "display": "always",
    "shipping_method_id": 504345,
    "shipping_method_type": "standard",
    "shipping_option_type": "agency",
    "estimated_delivery_time": {
      "type": "known_frame",
      "date": "2024-04-24T00:00:00-03:00",
      "unit": "hour",
      "offset": {
        "date": "2024-04-29T00:00:00-03:00",
        "shipping": 72
      },
      "time_frame": {
        "from": null,
        "to": null
      },
      "pay_before": "2024-04-20T00:00:00-03:00",
      "shipping": 24,
      "handling": 48,
      "schedule": null
    },
    "discount": {
      "promoted_amount": 0,
      "rate": 0,
      "type": "none",
      "show_loyal_benefit": false
    }
  },
  {
    "id": 3594424224,
    "option_hash": "6f2e2eb2926b9e6a11c45fe07e9b8803",
    "name": "Estándar a domicilio",
    "currency_id": "ARS",
    "base_cost": 11409.99,
    "cost": 11409.99,
    "list_cost": 11409.99,
    "display": "optional",
    "shipping_method_id": 73328,
    "shipping_method_type": "standard",
    "shipping_option_type": "address",
    "estimated_delivery_time": {
      "type": "known_frame",
      "date": "2024-04-24T00:00:00-03:00",
      "unit": "hour",
      "offset": {
        "date": "2024-04-29T00:00:00-03:00",
        "shipping": 72
      },
      "time_frame": {
        "from": null,
        "to": null
      },
      "pay_before": "2024-04-20T00:00:00-03:00",
      "shipping": 24,
      "handling": 48,
      "schedule": null
    },
    "discount": {
      "promoted_amount": 0,
      "rate": 0,
      "type": "none",
      "show_loyal_benefit": false
    }
  }
],
"custom_message": {
  "display_mode": null,
  "reason": ""
}
}
}

Parámetros de respuesta:

• destination: Información sobre el destino del envío, incluyendo el código postal, la ciudad, el estado y el país.
• buyer: Información del comprador, como su identificación, nivel de lealtad y nivel de envío.
• options: Información de las opciones de envío.
• options.id: Identificador único de la opción de envío.
• options.option_hash: Hash único que identifica la opción de envío.
• options.name: Nombre o alias del modo de envío.
• options.currency_id: Identificador de la moneda utilizada para el costo del envío.
• options.base_cost: Costo base del envío.
• options.cost: Costo total del envío de cara al comprador, aplicando descuentos.
• options.list_cost: Costo real del envío antes de aplicar descuentos.
• options.display: Visualización de la opción de envío, puede tomar los valores “recommended”, “always” u “optional”.
• options.shipping_method_id: Identificador del método de envío utilizado.
• options.method_type: Tipo de método de envío utilizado.
• options.option_type: Tipo de opción de envío utilizado: address, agency o place.
• options.estimated_delivery_time: Información sobre el tiempo estimado de entrega, incluyendo la fecha estimada, y cualquier otra información relevante.
• options.discount: Información sobre descuento en el envío.
• custom_message: Este campo se usa para devolver avisos especiales y de cuestiones ajenas a MercadoLibre que puedan afectar o demorar el envío.

Códigos de estado de respuesta:

Fecha máxima de despacho (SLA)

Este endpoint proporciona la fecha y hora límite que tienen los vendedores para despachar sus ventas a tiempo, es decir, sin que se considere como una demora.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/sla

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/43416180080/sla

Respuesta:

{
    "status": "on_time",
    "expected_date": "2024-05-22T23:59:59-03:00",
    "last_updated": "2024-05-21T17:16:04Z"
}

Parámetros de respuesta:

• status: Indica el estado actual del envío. Puede tener valores como "on_time" (a tiempo), "delayed" (demorado), "early" (temprano).
• expected_date: Es la fecha y hora máximas para despachar el producto.
• last_updated: Representa la última vez que se actualizó la información del envío.

Códigos de estado de respuesta:

Conoce más sobre el manejo de despacho:

• Despachar a tiempo: la clave para una buena reputación
• Qué es y cómo funciona la reputación
• Qué se tiene en cuenta para calcular la reputación
• Cuánto tiempo tienes para despachar tus ventas
• Cómo tener el destaque "Llega mañana" en tus publicaciones
• Cómo enviar tus ventas usando las agencias de Mercado Libre.