Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação do

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 12/07/2024

Gerenciar Mercado Envios 1

Importante:
Atualmente, este método de envio está disponível para vendedores na Argentina, Brasil, México, Chile, Colômbia, Uruguai e Peru.

O Mercado Envíos 1 (ME1) é um modo de envio que permite aos vendedores vender produtos pesados ou volumosos através do Mercado Livre. Com esta opção, os vendedores podem gerenciar a sua própria logística ou utilizar serviços de terceiros para o envio de produtos que não são elegíveis para o Mercado Envíos 2 (ME2) . Isto proporciona uma maior visibilidade ao comprador em relação a custos, prazos de entrega e disponibilidade de cobertura.

Configurar usuários de teste

Para configurar o modo de envio ME1 para usuários de teste, siga estes passos:

  1. Entrar na página de desenvolvedores do Mercado Livre.
  2. Seleccione a categoria a consultar, neste caso: "Configurações de teste".
  3. Expanda a secao “Configurações” e escolha "Ativar ME1 a conta test".
  4. Preencher as informações necessárias sobre usuário de teste.
  5. Envie o pedido de ativação ME1 para a sua conta de usuário de teste.

País Enlace
Argentina Solicitud para ativar ME1 a conta test
Brasil Solicitud para ativar ME1 a conta test
México Solicitud para ativar ME1 a conta test
Chile Solicitud para ativar ME1 a conta test
Colombia Solicitud para ativar ME1 a conta test
Uruguay Solicitud para ativar ME1 a conta test
Perú Solicitud para ativar ME1 a conta test


Nota:
É importante lembrar que para realizar o teste de fluxo ME1 são necessários dois usuários de teste::
- Um usuário como vendedor, que deve ter o modo ME1 ativado em sua conta de teste.
- Outro usuário como comprador, para quem não é necessário ativar o ME1.
Considere que o processo de ativação do ME1 para usuários de teste é de 48 horas.Para obter mais detalhes sobre a criação de usuários de teste, recomendamos que você consultar la sección “Realização de testes”.

Ativar ME1 para um vendedor

O processo de ativação ME1 implica a colaboração do assessor comercial ou do Key Account Manager (KAM) da conta do vendedor. O vendedor deve seguir os seguintes passos:

  1. Inicialmente, o vendedor deve preencher a "Tabela de Contingência", que inclui a definição dos custos de envio para a ME1 e as áreas geográficas para onde planeia enviar essas pedidos.
  2. Assim que a tabela estiver preenchida, o vendedor deverá solicitar a ativação do ME1 ao seu assessor, incluindo detalhes do integrador de frete dinâmico, se este estiver disponível.
  3. O assessor gerenciará a solicitação de ativação junto à equipe interna, levando em consideração que esse processo pode levar aproximadamente 7 dias úteis a partir da solicitação.
  4. Después de este período, el vendedor puede solicitar el estado de su solicitud para confirmar que la modalidad ME1 está activa y lista para su uso. Após este período, o vendedor pode solicitar o estado da sua solicitud para confirmar que o modo ME1 está ativo e pronta para a ser utilizado.

Para mais detalhes, revise a seção Contingência do Mercado Livre.


Nota:
- O ME 1 é uma modalidade que necessita do apoio do assessor comercial para uma gestão adequada. Caso o vendedor não possua assessor comercial, poderá solicitar suporte para fornecer os dados de referência de cada país.
- É importante notar que todas as ativações do ME 1 requerem que o vendedor tenha ativado previamente a modalidade ME2. Ou seja, ambas as modalidades devem estar ativas na conta do vendedor. No entanto, é essencial compreender que o ME2 continuará sempre a ser sempre o modo de envio preferencial..
Importante:
Antes de publicar ou editar um item utilizando o modo ME1, é importante levar em consideração os seguintes aspectos:
1. Verifique se o vendedor já possui o elegível para ser enviado por ME1.
2. Verifique se o item é elegible para ser enviado por ME1.
3. Verifique se o item cumpla pelo menos uma das dimensões máximas estabelecidas:
  • Altura: 500 cm
  • Comprimento: 500 cm
  • Largura: 500 cm
  • Peso: 500000 gr = 500 kg
4. Lembre-se que se um item tiver a modalidade ME2 disponível, ele não poderá ser publicado pela modalidade ME1.

Estes passos asseguram o gerenciamento adequado dos itens do Mercado Livre e ajudam a oferecer a melhor experiência de compra aos usuários.

Publicar um item novo com ME1

Este endpoint permite publicar um item em Mercado Envíos 1.

chamada:

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

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items
[...]
{
  "shipping": {
    "mode": "me1",
    "local_pick_up": true,
    "dimensions": "189x72x96,58000"
  }
}
[...]

Resposta:

{
   "id": "MLA1644124644",
   "site_id": "MLA",
   "title": "Refrigeradora Samsung Side By Side 602lt Rs60t5200s9",
   "subtitle": null,
   "seller_id": 1459527474,
   "category_id": "MLA9458",
   "official_store_id": null,
   "price": 567803,
   "base_price": 567803,
   "original_price": null,
   "inventory_id": null,
   "currency_id": "ARS",
   "initial_quantity": 15,
   "available_quantity": 12,
   "sold_quantity": 3,
   "sale_terms": [
       {
           "id": "WARRANTY_TYPE",
           "name": "Tipo de garantía",
           "value_id": "2230279",
           "value_name": "Garantía de fábrica",
           "value_struct": null,
           "values": [
               {
                   "id": "2230279",
                   "name": "Garantía de fábrica",
                   "struct": null
               }
           ]
       },
       {
           "id": "WARRANTY_TIME",
           "name": "Tiempo de garantía",
           "value_id": null,
           "value_name": "6 meses",
           "value_struct": {
               "unit": "meses",
               "number": 6
           },
           "values": [
               {
                   "id": null,
                   "name": "6 meses",
                   "struct": {
                       "number": 6,
                       "unit": "meses"
                   }
               }
           ]
       }
   ],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_special",
   "start_time": "2020-09-16T15:06:56.000Z",
   "stop_time": "2040-09-11T04:00:00.000Z",
   "end_time": "2040-09-11T04:00:00.000Z",
   "expiration_time": "2021-01-11T19:28:44.000Z",
   "condition": "new",
   "permalink": "http://articulo.mercadolibre.com.ar/MLA-879036495-test-no-comprar-aire-acondicionado-3000-frigorias-_JM",
   "pictures": [
       {
           "id": "790234-MLA43483081743_092020",
           "url": "http://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-O.jpg",
           "secure_url": "https://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-O.jpg",
           "size": "246x120",
           "max_size": "246x120",
           "quality": ""
       }
   ],
   "video_id": null,
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "shipping": {
       "mode": "me1",
       "local_pick_up": false,
       "free_shipping": false,
       "methods": [],
       "dimensions": "189x72x96,58000",
       "tags": [
           "optional_me1_chosen"
       ],
       "logistic_type": "default",
       "store_pick_up": false
   },
   "international_delivery_mode": "none",
   "seller_address": {
       "id": 1131257838,
       "comment": "",
       "address_line": "falsa 123",
       "zip_code": "6000",
       "city": {
           "id": "",
           "name": "junin"
       },
       "state": {
           "id": "AR-B",
           "name": "Buenos Aires"
       },
       "country": {
           "id": "AR",
           "name": "Argentina"
       },
       "latitude": -34.5885499,
       "longitude": -60.94955400000001,
       "search_location": {
           "neighborhood": {
               "id": "",
               "name": ""
           },
           "city": {
               "id": "TUxBQ0pVTjE5NjM",
               "name": "Junín"
           },
           "state": {
               "id": "TUxBUFpPTmFpbnRl",
               "name": "Buenos Aires Interior"
           }
       }
   },
   "seller_contact": null,
   "location": {},
   "geolocation": {
       "latitude": -34.5885499,
       "longitude": -60.94955400000001
   },
   "coverage_areas": [],
   "attributes": [
       {
           "id": "ENERGY_EFFICIENCY",
           "name": "Eficiencia energética",
           "value_id": "98473",
           "value_name": "A",
           "value_struct": null,
           "values": [
               {
                   "id": "98473",
                   "name": "A",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "AIR_CONDITIONER_TYPE",
           "name": "Tipo de aire acondicionado",
           "value_id": "290203",
           "value_name": "Split",
           "value_struct": null,
           "values": [
               {
                   "id": "290203",
                   "name": "Split",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "SEER",
           "name": "SEER",
           "value_id": "-1",
           "value_name": null,
           "value_struct": null,
           "values": [
               {
                   "id": "-1",
                   "name": null,
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "COLOR",
           "name": "Color",
           "value_id": "52055",
           "value_name": "Blanco",
           "value_struct": null,
           "values": [
               {
                   "id": "52055",
                   "name": "Blanco",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "FRIGORIAS",
           "name": "Frigorías",
           "value_id": null,
           "value_name": "3000 fg",
           "value_struct": {
               "unit": "fg",
               "number": 3000
           },
           "values": [
               {
                   "id": null,
                   "name": "3000 fg",
                   "struct": {
                       "number": 3000,
                       "unit": "fg"
                   }
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "ITEM_CONDITION",
           "name": "Condición del ítem",
           "value_id": "2230284",
           "value_name": "Nuevo",
           "value_struct": null,
           "values": [
               {
                   "id": "2230284",
                   "name": "Nuevo",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "COOLING_CAPACITY",
           "name": "Capacidad de refrigeración",
           "value_id": null,
           "value_name": "3520 W",
           "value_struct": {
               "unit": "W",
               "number": 3520
           },
           "values": [
               {
                   "id": null,
                   "name": "3520 W",
                   "struct": {
                       "number": 3520,
                       "unit": "W"
                   }
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "INSTALLATION_PLACEMENTS",
           "name": "Lugares de colocación",
           "value_id": null,
           "value_name": "Pared",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "Pared",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "HEATING_CAPACITY",
           "name": "Capacidad de calefacción",
           "value_id": null,
           "value_name": "3520 W",
           "value_struct": {
               "unit": "W",
               "number": 3520
           },
           "values": [
               {
                   "id": null,
                   "name": "3520 W",
                   "struct": {
                       "number": 3520,
                       "unit": "W"
                   }
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "SELLER_SKU",
           "name": "SKU",
           "value_id": null,
           "value_name": "116078",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "116078",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "MODEL",
           "name": "Modelo",
           "value_id": null,
           "value_name": "F3000-T",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "F3000-T",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "BRAND",
           "name": "Marca",
           "value_id": "8039499",
           "value_name": "Tedge",
           "value_struct": null,
           "values": [
               {
                   "id": "8039499",
                   "name": "Tedge",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "GTIN",
           "name": "Código universal de producto",
           "value_id": null,
           "value_name": "1234567890418",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "1234567890418",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       },
       {
           "id": "AIR_CONDITIONING_TYPE",
           "name": "Tipo de climatización",
           "value_id": "83445",
           "value_name": "Frío/Calor",
           "value_struct": null,
           "values": [
               {
                   "id": "83445",
                   "name": "Frío/Calor",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros"
       }
   ],
   "warnings": [],
   "listing_source": "",
   "variations": [],
   "thumbnail_id": "790234-MLA43483081743_092020",
   "thumbnail": "http://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-I.jpg",
   "secure_thumbnail": "https://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-I.jpg",
   "status": "active",
   "sub_status": [],
   "tags": [
       "cart_eligible",
       "immediate_payment",
       "poor_quality_picture",
       "test_item"
   ],
   "warranty": "Garantía de fábrica: 6 meses",
   "catalog_product_id": null,
   "domain_id": "MLA-AIR_CONDITIONERS",
   "seller_custom_field": null,
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2020-09-16T15:06:56.000Z",
   "last_updated": "2020-10-28T16:40:58.491Z",
   "health": 0.83,
   "catalog_listing": false,
   "item_relations": []
}

Ativar ME1 em um item já publicado

Este endpoint permite ativar ME1 em itens configurados na modalidade de enviíos “Custom” ou “A combinar com o vendedor”.

Chamada:

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

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1644124644
{
  "shipping": {
    "mode": "me1",
    "local_pick_up": true,
    "dimensions": "189x72x96,58000"
  }
}

Códigos de estado de resposta:

A seguinte tabela fornece uma maior visibilidade sobre possíveis problemas na configuração de ME1. Certifique-se de revisar regularmente as recomendações para manter um fluxo de processo otimizado e proporcionar uma melhor experiência aos seus clientes.

Parâmetro Descrição Recomendação
4052 Esta sugestão será ativada quando um envio ME1 estiver disponível, porém for perdido devido a questões dimensionais. Permite identificar rapidamente os casos em que o ME1 não pode ser utilizado devido a restrições de tamanho ou peso. Valide se pelo menos uma das dimensões inseridas excede o limite ME1. Maior que 500 cm ou 500 kg.
4053 Se um vendedor não tiver a opção de envio ME1 habilitada em suas preferências de envio, esta sugestão será habilitada. Desta forma você pode verificar facilmente se ME1 está disponível para o vendedor. Valide as modalidades de envio ativas para o vendedor. Se ME1 não for exibido, entre em contato com o Key Account Manager (KAM) atribuído à conta.
4054 Esta sugestão alerta quando um produto não tem a opção de envio ME1 activada nas preferências do catálogo. Com esta informação, poderá identificar rapidamente os produtos que não são elegíveis para o ME1.. Valide as modalidades de envio do item,, domínio ou categoria.

Consultar envios ME1

Este endpoint permite consultar os envios ME1 do vendedor.

Chamada:

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

Exemplo:

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

Resposta:

{
[…]
    "receiver_id": 0987654332,
    "base_cost": 0,
    "status_history": {
        "date_shipped": "2024-02-02T16:31:31.184-04:00",
        "date_returned": null,
        "date_delivered": "2024-02-05T08:38:14.000-04:00",
        "date_first_visit": "2024-02-05T08:38:14.000-04:00",
        "date_not_delivered": null,
        "date_cancelled": null,
        "date_handling": null,
        "date_ready_to_ship": null
    },
    "type": "forward",
    "return_details": null,
    "sender_id": 474415116,
    "mode": "me1",
    "order_cost": 1699999,
    "priority_class": {
        "id": null
    },
    "service_id": 154,
    "shipping_items": [
        {
            "domain_id": null,
            "quantity": 1,
            "dimensions_source": {
                "origin": "seller",
                "id": "MLA1388902895__1"
            },
            "description": "Heladera Samsung Freezer Inf Multi Flow 400l Dispenser Inver",
            "id": "MLA1388902895",
            "user_product_id": null,
            "sender_id": 11111111,
            "dimensions": "180.0x76.0x77.0,84000.0"
        }
    ],
    "tracking_number": "0999-111111111",
    "cost_components": {
        "loyal_discount": 0,
        "special_discount": 0,
        "compensation": 0,
        "gap_discount": 0,
        "ratio": 0
    },
[…]
    "customer_id": null,
    "order_id": 2000007511222222,
    "quotation": null,
    "status": "delivered",
    "logistic_type": "default"
}

Alertas de fraude

Os pedidos do ME1 também podem ter alertas de fraude.Verifique se o pedido possui a tag fraud_risk_detected, pois neste caso o pedido não deve ser enviado ao comprador. Quando identificamos uma venda suspeita, alertamos o vendedor por front e por API por meio do feed de orders. Para mais informações, consulte nossa documentação de orders.


Nota:
Es posible usar el recurso de Cargar factura para disponibilizar la factura correspondiente para el comprador.

Siguiente: Estados de órdenes y seguimiento.