Mercado Envíos

Shipping modes by site

Each site has a set of shipping methods available and these have different shipping times and costs. In addition to Mercado Envios 1 and 2, sellers can offer Custom shipping.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/shipping_methods

Response:

[
  {
    "id": 502845,
    "name": "Retiro en sucursal OCA Prioritario",
    "type": "express",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": null,
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 501045,
    "name": "Retiro en OCA",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500240,
    "company_name": "OCA",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 501145,
    "name": "Estándar",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 505545,
    "name": "Envío internacional",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": 17502940,
    "company_name": "CBT Argentina",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 505045,
    "name": "Retiro en Andreani",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17502540,
    "company_name": "Andreani",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 504845,
    "name": "Seller local",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 506245,
    "name": "Rápido a domicilio",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 0,
    "max_time": 24,
    "currency_id": "ARS"
  },
  {
    "id": 501146,
    "name": "Prioritario",
    "type": "express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 73330,
    "name": "Prioritario a domicilio",
    "type": "express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500240,
    "company_name": "OCA",
    "min_time": 0,
    "max_time": 72,
    "currency_id": "ARS"
  },
  {
    "id": 73328,
    "name": "Normal a domicilio",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500240,
    "company_name": "OCA",
    "min_time": 72,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 504245,
    "name": "Normal a domicilio",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17500940,
    "company_name": "Reprocesos Carrito",
    "min_time": 72,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 510445,
    "name": "Prioritario a domicilio",
    "type": "next_day",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 24,
    "max_time": 24,
    "currency_id": "ARS"
  },
  {
    "id": 511545,
    "name": "Estándar a domicilio",
    "type": "four_days",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 96,
    "max_time": 96,
    "currency_id": "ARS"
  },
  {
    "id": 510245,
    "name": "Devolución Estándar",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17501440,
    "company_name": "Correo Argentino",
    "min_time": 24,
    "max_time": 96,
    "currency_id": "ARS"
  },
  {
    "id": 510545,
    "name": "Express a domicilio",
    "type": "two_days",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 48,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 510945,
    "name": "Estándar a sucursal de correo",
    "type": "three_days",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 72,
    "max_time": 72,
    "currency_id": "ARS"
  },
  {
    "id": 506345,
    "name": "Rápido a domicilio",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 0,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 507045,
    "name": "Test Flex [NO USAR]",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 2160,
    "max_time": 2400,
    "currency_id": "ARS"
  },
  {
    "id": 506445,
    "name": "Rápido a domicilio",
    "type": "super_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 24,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 513146,
    "name": "Proximity Express",
    "type": "proximity_express",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 0,
    "max_time": 99,
    "currency_id": "ARS"
  },
  {
    "id": 503045,
    "name": "Retiro en Correo Argentino",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17501440,
    "company_name": "Correo Argentino",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 512747,
    "name": "Prioritario a domicilio",
    "type": "same_day",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 1,
    "max_time": 1,
    "currency_id": "ARS"
  },
  {
    "id": 511546,
    "name": "Estándar a sucursal de correo",
    "type": "four_days",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 96,
    "max_time": 96,
    "currency_id": "ARS"
  },
  {
    "id": 510845,
    "name": "Express a sucursal de correo",
    "type": "two_days",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 48,
    "max_time": 48,
    "currency_id": "ARS"
  },
  {
    "id": 510645,
    "name": "Estándar a domicilio",
    "type": "three_days",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 72,
    "max_time": 72,
    "currency_id": "ARS"
  },
  {
    "id": 510745,
    "name": "Prioritario a sucursal de correo",
    "type": "next_day",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": null,
    "company_name": null,
    "min_time": 24,
    "max_time": 24,
    "currency_id": "ARS"
  },
  {
    "id": 504945,
    "name": "Normal a domicilio",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me2"
    ],
    "company_id": 17502540,
    "company_name": "Andreani",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 505645,
    "name": "Envío internacional",
    "type": "standard",
    "deliver_to": "address",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": [
      "me1"
    ],
    "company_id": 17502940,
    "company_name": "CBT Argentina",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  },
  {
    "id": 504345,
    "name": "Retiro en una sucursal",
    "type": "standard",
    "deliver_to": "agency",
    "status": "active",
    "site_id": "MLA",
    "free_options": null,
    "shipping_modes": null,
    "company_id": 17500940,
    "company_name": "Reprocesos Carrito",
    "min_time": null,
    "max_time": null,
    "currency_id": "ARS"
  }
]

Response fields:

id: Shipping Method ID is used when listing an item with shipping.
name: shipping mode name.
site_id: ID of the site to which the shipping method belongs.
free_options: free options.
shipping_modes: shipping modes.

• me1: Mercado Envíos 1 offers a shipping calculator to obtain the shipping cost of each order and the seller selects the shipping service of his choice by choosing a carrier. Also, it will be in charge of managing the tracking number.
• me2: Mercado Envíos 2 is the most recommended mode because it offers a better experience for sellers and buyers. Mercado Libre generates a label that the seller must print and a tracking code with a predefined local carrier, that is, the seller does not have to worry about choosing a carrier or managing the tracking number.
• custom (personalizado): sellers can include a table with up to 10 shipping costs on an item and the buyer must provide that number at checkout.
• not_specified (no especificado): means that the seller did not specify a shipping price for their items and the buyer should contact the seller to agree on a shipping option and purchase price. If you don't submit shipping information for the item it will be marked as "not_specified" by default. Also, if there are no modes that support the dimensions of your article, you should publish under this mode. If the category does not support the dimensions of your product, you will only have "not_specified" in the response. Finally, if the category has ME2, the dimensions sent will be ignored, since the dimensions established in the category are taken into account.

Shipping modes according to the category of the publication

Remember that there are some restrictions in certain categories, so we recommend you check the enabled modes according to the product category.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Send a POST including the post attributes.

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 'x-multichannel: true' 'X-Format-New: true' -H "Content-Type: application/json" -d
{
    "buying_mode": "buy_it_now",
    "category_id": "MLB437616",
    "channels": [
        {
            "id": "marketplace"
        }
    ],
    "condition": "new",
    "dimensions": null,
    "is_internal": true,
    "is_new_listing": false,
    "item_currency": "ARS",
    "item_id": null,
    "item_price": 3500,
    "listing_type_id": "gold_special",
    "new_format": true,
    "sale_terms": [],
    "seller_id": 419059118,
    "site_id": "MLB",
    "source": "",
    "title": "Titulo de teste",
    "local_pick_up": false,
    "to_catalog_internal": false,
    "to_modes_internal": false,
    "traced": false,
    "verbose": false
}


https://api.mercadolibre.com/users/$USER_ID/shipping_modes

Response:

{
    "channels": {
        "marketplace": {
            "available_modes": [
                {
                    "mode": "me1",
                    "logistic_types": [
                        {
                            "type": "default",
                            "default": true,
                            "attributes": {
                                "dimensions": "optional",
                                "costs": "not_allowed",
                                "adoption": "not_required",
                                "free_shipping": "optional",
                                "local_pick_up": "optional",
                                "tags": []
                            }
                        }
                    ],
                    "shipping_attributes": {
                        "dimensions": "optional",
                        "costs": "not_allowed",
                        "adoption": "not_required",
                        "free_shipping": "optional",
                        "local_pick_up": "optional",
                        "tags": []
                    }
                },
                {
                    "mode": "me2",
                    "logistic_types": [
                        {
                            "type": "cross_docking",
                            "default": true,
                            "attributes": {
                                "dimensions": "clear",
                                "costs": "not_allowed",
                                "adoption": "not_required",
                                "free_shipping": "mandatory",
                                "local_pick_up": "optional",
                                "tags": []
                            }
                        }
                    ],
                    "shipping_attributes": {
                        "dimensions": "clear",
                        "costs": "not_allowed",
                        "adoption": "not_required",
                        "free_shipping": "mandatory",
                        "local_pick_up": "optional",
                        "tags": []
                    }
                }
            ],
            "warnings": null,
            "channel_id": "marketplace"
        }
    }
}

Shipping preferences for a user

Know the shipping preferences of any user.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_preferences

Response:

{
   "local_pick_up":false,
   "modes":[
      "custom",
      "not_specified",
      "me1",
      "me2"
   ],
   "trusted_user":true,
   "custom_calculator":false,
   "picking_type":"cross_docking",
   "thermal_printer":null,
   "option":"in",
   "tags":[
      
   ],
   "carrier_pickup":false,
   "items_combination":"enabled",
   "services":[
      311,
      591,
      671,
      801,
      881,
      1181,
      1191,
      136261
   ],
   "logistics":[
      {
         "mode":"me1",
         "types":[
            {
               "type":"default",
               "carrier_pickup":[
                  
               ],
               "services":[
                  21,
                  23,
                  22,
                  11
               ],
               "default":true
            }
         ]
      },
      {
         "mode":"me2",
         "types":[
            {
               "type":"cross_docking",
               "carrier_pickup":[
                  17501840
               ],
               "services":[
                  311,
                  591,
                  671,
                  801,
                  881,
                  1181,
                  1191
               ],
               "default":false
            },
            {
               "type":"self_service",
               "carrier_pickup":[
                  
               ],
               "services":[
                  136261
               ],
               "default":false
            }
         ]
      },
      {
         "mode":"custom",
         "types":[
            {
               "type":"custom",
               "carrier_pickup":[
                  
               ],
               "services":null,
               "default":true
            }
         ]
      },
      {
         "mode":"not_specified",
         "types":[
            {
               "type":"not_specified",
               "carrier_pickup":[
                  
               ],
               "services":null,
               "default":true
            }
         ]
      }
   ],
   "content_declaration_disabled":false,
   "conciliation":{
      "type":null
   },
   "mandatory_invoice_data":false,
   "site_id":"MLA",
   "free_configurations":[
      {
         "condition":{
            "value":null,
            "type":"all"
         },
         "rule":{
            "default":true,
            "free_mode":"country",
            "value":null
         }
      }
   ],
   "mandatory_settings":{
      
   }
}

Shipping status

For certain modes of shipment, from Mercado Libre we carry out automatic tracking and monitoring of tracking numbers. The states are internal and altered by Mercado Libre.

They may be:

pending: shipments are created with this status
handling: payment for this shipment was received.
ready_to_ship: carrier authorization code received.
shipped: the carrier reported the clearance of the shipment.
delivered: the carrier reported the arrival of the shipment.
not_delivered: The carrier was unable to deliver the package.
cancelled: the shipment was canceled.

For Custom Shipping and other Mercado Envios 1 settings, you will be responsible for send a tracking number and update the status of the shipment.
For cases without Mercado Envíos (or Envíos Not_Specified) there is no shipment_id, so you must have the feedback of the sale to close it.

Learn more about Mercado Envíos.

Next: Mercado Envios 1.