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 de acordo com a categoria da publicação
→Preferências de envio para um usuário
→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.

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
{
    "seller_id": $seller_id,
    "item_price": 3690,
    "item_id": "MLA921542253",
    "item_currency": "ARS",
    "category_id": "MLA405115",
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "condition": "new",
    "title": "Caja 2 Combo Para Delivery Biodegradable (90 Un)",
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "value_id": "6150835",
            "value_name": "Sin garantía"
        }
    ],
    "catalog": {
        "category_id": "MLA405115",
        "product_id": null,
        "domain_id": "MLA-PACKAGING_BOXES",
        "attributes": [
            {
                "id": "BRAND",
                "value_name": "CEMAVE"
            },
            {
                "id": "DEPTH",
                "value_name": "20.5 cm"
            },
            {
                "id": "HEIGHT",
                "value_name": "7.5 cm"
            },
            {
                "id": "ITEM_CONDITION",
                "value_id": "2230284",
                "value_name": "Nuevo"
            },
            {
                "id": "MANUFACTURER",
                "value_name": "DPACK"
            },
            {
                "id": "MATERIAL",
                "value_name": "Cartulina Biodegradable"
            },
            {
                "id": "UNITS_NUMBER",
                "value_name": "90"
            },
            {
                "id": "WIDTH",
                "value_name": "25 cm"
            }
        ]
    },
    "shipping_mode": "me2",
    "logistic_type": "xd_drop_off",
    "tags": []
}'

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_shipping”: “optional”,
            "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_shipping”: “optional”,
      "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 de um usuário

Saiba as preferências de envio de qualquer usuário.

Chamada:

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

Resposta:

{
   "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. Os status são internos e alterados pelo Mercado Libre.


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.


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.


Conheça mais sobre Mercado Envios.


Siguiente: Mercado Envios 1.

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