Mercado Envíos 1

Este modo de envío permite que el vendedor trabaje con su propia logística para enviar los productos brindando una experiencia al comprador similar a Mercado Envíos, la experiencia de logística de Mercado Libre.
¿Cómo funciona ME1?

  • El precio y plazo de envío son presentados en la pantalla del producto y cobrados junto con el pedido.
  • El trackeo del pedido es similar a los de Mercado Envíos, pero con información enviada por el integrador.
  • Existe la posibilidad de tener las cotizaciones de fuentes externas (integradas).

Contenidos

→Publicar o activar ítems para ME1
    ↳Publicar un ítem nuevo con ME1
    ↳Activar ME1 para un ítem ya publicado
→Consultar órdenes con ME1
→Identificar el transportista del pedido
→Cambiar estados e informar numero de rastreo (tracking number)
→Alertas de fraude
→Configurar ME1 para usuarios de prueba


Publicar o activar ítems para ME1

Un ítem puede ser publicado como ME1 o puede ser convertido a ME1.

Por ejemplo:


Publicar un ítem nuevo con ME1

Al momento de realizar el POST, informa el modo de envío y las dimensiones. Para esto, debes incluir los siguientes campos en el body de la publicación:

[...]
"shipping":{
  	"local_pick_up":false,
  	"mode": "me1",
      "dimensions":"10x10x20,700"
      }
[…]

Activar ME1 para un ítem ya publicado

Para un ítem ya publicado pero como CUSTOM o Entrega a acordar con el vendedor, debes hacer un put informando las dimensiones, peso e el tipo de envío:

Llamada:

curl --location --request PUT 'https://api.mercadolibre.com/items/$ITEM_ID' \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "shipping":{
      "local_pick_up":false,
      "mode":"me1",
      "dimensions":"$alturax$anchurax$longitud,$peso"
   }
}'

Ejemplo:

curl --location --request PUT 'https://api.mercadolibre.com/items/MLA879036495' \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"shipping":{
     "local_pick_up":false,
     "mode": "me1",
     "dimensions":"10x10x20,70"
   }
}'

Respuesta:

{
   "id": "MLA879036495",
   "site_id": "MLA",
   "title": "Test No Comprar - Aire Acondicionado 3000 Frigorías",
   "subtitle": null,
   "seller_id": 645417996,
   "category_id": "MLA1644",
   "official_store_id": null,
   "price": 50000,
   "base_price": 50000,
   "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": "10x10x20,700",
       "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": []
}

Consultar órdenes con ME1

Para identificar pedidos ME1 consulta el campo "mode" en el recurso /shipments/shipment_id/.

Llamada:

curl --location --request GET 'https://api.mercadolibre.com/shipments/$SHIPMENT_ID' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl --location --request GET 'https://api.mercadolibre.com/shipments/40070866801' \
--header 'Authorization: Bearer $ACCESS_TOKEN'
Respuesta:
{
   "id": 40070866801,
   "mode": "me1",
   "created_by": "receiver",
   "order_id": 4001889439,
   "order_cost": 99.9,
   "base_cost": 22.07,
   "site_id": "MLB",
   "status": "shipped",
[…]
}

Identificar el transportista del pedido

También en el recurso /shipments/shipment_id/ la info estará en shipping_option, Id. Debes considerar el tercero y cuarto campo del código como id del transportista (carrier).

Llamada:

curl --location --request GET 'https://api.mercadolibre.com/shipments/$SHIPMENT_ID' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl --location --request GET 'https://api.mercadolibre.com/shipments/40070866801' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Respuesta:

[…]
{
   "shipping_option":{
      "id":101757341000001
       […]
   }
[…]
}

En el ejemplo "17" es el código utilizado en la planilla de costo o enviado por la integración de flete dinámico para identificar la transportista.


Cambiar estados e informar tracking number

Para brindar una experiencia completa de ME1, te recomendamos tener integrado los cambios de estado y envío de tracking number. Esto ayuda a reducir reclamos y contactos por parte del comprador preguntando dónde está el paquete.


Alertas de fraude

Los pedidos ME1 también pueden tener alertas de fraude. Revisa si el pedido tiene el tag fraud_risk_detected ya que en este caso, el pedido no debe ser enviado al comprador. Cuando identificamos una venta sospechosa, alertamos al vendedor por front y API a través del feed de orders. Para más información consulta nuestra documentación de órdenes.


Configurar ME1 para usuarios de prueba

Para comenzar a utilizar el Mercado Envios modo 1 en un usuario productivo, el vendedor debe contactar a su asesor comercial. Para probar el Mercado Envios modo 1 en un usuario de prueba, primero debe ingresar una dirección válida en la cuenta del usuario test y registrar en el panel de configuración como una dirección de ventas. Luego, cargue sus datos de usuario de prueba en el formulario para solicitarnos la funcionalidad.


Siguiente: Estados de órdenes ME1.

o regístrate para recibir las últimas novedades sobre nuestra API