Mercado Envios

É nossa unidade de negócio que ajuda os vendedores com muitas facilidades para enviar seus produtos. Atualmente se encontra ativo em MLA, MLB, MLM, MLC e MCO. Agora vamos ver as diferenças entre o Mercado Envios 1 e 2, e os detalhes de cada um. Saiba mais sobre frete para vendedores e assista ao nosso webinar para participar:





Conteúdos

→Modos de envios por país →Modos habilitados para um usuário →Modos habilitados de acordo com a categoria da publicação →Preferências de envio →Status do envio

Modos de envios por país

Cada site possui um conjunto de métodos de envio disponíveis, com diferentes tempos e custos de envio. Além do Mercado Envios 1 e 2, os vendedores podem oferecer Retiro em loja ou Envio Personalizado. Com a seguinte chamada, você pode verificar os modos de envio disponíveis em cada país:

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

Resposta:

[
  {
    "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"
  }
]

Campos de resposta:

id: ID do método de envio é usado ao postar um item com envio. . name: nome do método de envio. site_id: ID do site ao qual o método de envio pertence. free_options: opções grátis. shipping_modes: modos de envio.

  • me1: Mercado Envios 1 oferece uma calculadora de envios para obter o custo de envio de cada pedido e o vendedor seleciona o serviço de envio de sua preferência escolhendo uma transportadora. Além disso, estará encarregado de gerenciar o número de rastreamento (tracking number).
  • me2: Mercado Envios 2 é o modo mais recomendado, porque oferece uma melhor experiência para vendedores e compradores. O Mercado Livre gera uma etiqueta que o vendedor deve imprimir e um código de rastreamento com uma operadora local pré-definida, ou seja, o vendedor não precisa se preocupar em escolher uma transportadora ou gerenciar o número de rastreamento.
  • custom (personalizado): os vendedores podem incluir uma tabela com até 10 custos de envio em um item e o comprador deve fornecer esse número ao concluir e finalizar [checkout] de compra.
  • not_specified (não especificado):
    • Significa que o vendedor não especificou nenhum preço de frete para seus produtos e o comprador deve entrar em contato com o vendedor para combinar uma opção de envio e o preço.
    • Se você não enviar as informações de envio do item, ele será marcado como "not_specified" por padrão. Além disso, se não houver modos que suportem as dimensões do seu item, você deve publicar sob este modo.
    • Se a categoria não suportar as dimensões do seu produto, você terá apenas "not_specified" na resposta.
    • Por último, se a categoria possuir ME2, as dimensões enviadas serão ignoradas, uma vez que são consideradas as dimensões estabelecidas na categoria.

Consultar os modos habilitados para um usuário

Com o recurso shipping_modes você pode consultar se um vendedor pode publicar um item no Mercado Envios para uma categoria específica. A resposta indicará se o Mercado Envios 2 está disponível e os métodos que pode utilizar.
Assim, você precisará executar um POST incluindo os atributos de postagem. A informação sobre os atributos da categoria se encontra em:

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

Isso retornará muitas informações sobre o usuário autenticado, incluindo o atributo shipping_modes.

Resposta:

{
   "shipping_modes":[
      "custom",
      "not_specified",
      "me1",
      "me2"
   ]
}

Modos habilitados de acordo com a categoria da publicação

Além disso, existem algumas restrições em certas categorias, por isso recomendamos que você consulte os modos habilitados de acordo com a categoria dos produtos.

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

Execute um POST incluindo os atributos da publicação.

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
  "category_id": "MLA121212",
  "item_currency": "ARS", 
  "dimensions": "20x20x20,4000",
  "catalog":{
    "product_id": "MLB2323232",
    "domain_id": "MLB-TELEVISIONS",
    "attributes":[
    {
      "id": "SCREEN_TYPE",
      "value_name": "LED",
      “value_id”:”81830”
    },
    {
      "id": "SCREEN_SIZE",
      "value_name": “43 cm”,
      "value_id": null
    },
    {
      "id": "BRAND",
      "value_name": "LG",
      “value_id”:”215”
    }
    ]

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

Resposta com ME2:

{
   "mode":"me2",
   "logistic_types":[
      {
         "type":"cross_docking",
         "default":true,
         "attributes":{
            "dimensions":"clear",
            "costs":"not_allowed",
            "free":{
               "methods":"optional",
               "accepted_methods":[
                  73328
               ],
               "rules":[
                  {
                     "default":true,
                     "free_mode":"country",
                     "value":null,
                     "free_shipping_flag":true
                  }
               ],
               "flat":true
            },
            "local_pick_up":"optional"
         }
      }
   ],
   "shipping_attributes":{
      "dimensions":"clear",
      "costs":"not_allowed",
      "free":{
         "methods":"optional",
         "accepted_methods":[
            73328
         ],
         "rules":[
            {
               "default":true,
               "free_mode":"country",
               "value":null,
               "free_shipping_flag":true
            }
         ],
         "flat":true
      },
      "local_pick_up":"optional"
   }
}

Preferências de envio

Existe também um recurso público que permitirá saber as preferências de envio de qualquer usuário, caso seja necessário. Basta realizar a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_preferences
{
   "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":{
      
   }
}

Status de envio

Para determinados modos de envio, no Mercado Livre rastreamos e monitoramos automaticamente os números de rastreamento. Para Envio personalizado e outras configurações do Mercado Envios 1, você será responsável pelo envio de um número de rastreamento e pela atualização do status do envio.


Os status podem ser:

to_be_agreed: o envio será combinado entre o vendedor e o comprador.
pending: os envios são criados com este status.
handling: o pagamento do frete já foi recebido.
ready_to_ship: o código de autorização da transportadora foi recebido.
shipped: a transportadora já informou sobre o despacho do item.
delivered: a transportadora já informou sobre a chegada do item.
not_delivered: a transportadora não conseguiu fazer a entrega do pacote.
cancelled: envio foi cancelado.


ou registre-se para receber as últimas notícias sobre nossa API