Envío de productos

Contenidos

→Modos de envío
→Especificaciones de cada país
→Averiguar los modos habilitados para un usuario
→Modos habilitados según la categoría de la publicación
→Preferencias de envío
→Métodos de envío
→Estado del envío
→Introducción a Mercado Envíos
→Diferencias entre ME1 y ME2
→No especificado
→Configurar Mercado Colecta para usuarios de prueba

Modos de envio

Cada site cuenta con un conjunto de métodos de envío disponibles. Presentan diferentes tiempos y costos de envío. Los vendedores pueden ofrecer envío gratis en uno o ambos métodos. Existe un recurso especial para ver los métodos disponibles por site. URL para Brasil

• not_specified (no especificado): significa que el vendedor no especificó ningún precio de envío para sus artículos y el comprador debe ponerse en contacto con el vendedor para acordar una opción de envío y el precio de la compra.
• custom: (personalizado): los vendedores pueden incluir una tabla con hasta 10 costos de envío en un artículo y el comprador debe entregar ese número al terminar y salir [checkout] del proceso.
• me1(Mercado Envíos modo 1): ofrece un calculador de envíos para calcular el costo de envío de cada pedido y permitir que el vendedor seleccione el servicio de envío de su preferencia, pero eligiendo un transportista. El vendedor se encarga de administrar el número de seguimiento.
• me2(Mercado Envíos modo 2): ofrece al vendedor una etiqueta prepaga y un código numérico de seguimiento con un transportista local predefinido en cada país. El vendedor no tiene que preocuparse de elegir un transportista ni de manejar el número de seguimiento. Es el modo más recomendado porque ofrece una experiencia excelente tanto para compradores como para vendedores. Mercado Libre elige la empresa de transporte.

Especificaciones de cada país

*(C) Comprimento
(L) Largo
(A) Alto

Averiguar los modos habilitados para un usuario

Al momento de hacer una publicación bajo una modalidad de envío, existen algunas restricciones en ciertas categorías. Utiliza el recurso de shipping_modes antes mencionado para verificar si un vendedor puede publicar un artículo con Mercado Envíos para una categoría determinada.
La respuesta indica si se encuentra disponible el modo ME2 y los métodos de envío que se pueden utilizar.
Se deberá hacer un GET incluyendo los atributos de la publicación, sin necesidad de enviar access token. La información sobre los atributos de la categoría se encuentra en:

curl -X GET https://api.mercadolibre.com/users/$USER_ID?access_token=$ACCESS_TOKEN

Esto devolverá gran cantidad de información sobre el usuario autenticado, incluido el atributo shipping_modes.

Respuesta:

"shipping_modes":[
    "custom",
    "not_specified",
    "me1",
    "me2"

]

Modos habilitados según la categoría de la publicación

Además, existen algunas restricciones en ciertas categorías. Utiliza el recurso shipping_modes para verificar si un vendedor puede publicar un producto en modo de envío ME2 para una determinada categoría. La respuesta indicará si el modo ME2 está disponible y qué métodos de envío pueden ser utilizados. Conoce los atributos de las categorías.

Llamada:

curl -X POST https://api.mercadolibre.com/users/$USER_ID/shipping_modes

Ejemplo:

curl -X POST https://api.mercadolibre.com/users/$USER_ID/shipping_modes
{
  "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"
    }
    ]

  }
}

Respuesta con 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"
   }
}

En el caso que un ítem esté publicado en una categoría que tenga habilitado me2 y el vendedor no haya realizado optin a Mercado Envíos, en la respuesta verás solo “mode”: “me2” y además el atributo “adoption”: “required” de la siguiente manera:

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

En este caso, comunícale al vendedor que debe ingresar a Mercado Libre, Mi cuenta, Ventas, Preferencias de venta y realizar la adopción a Mercado Envíos:

Preferencias de envío

También existe un recurso público que te permitirá conocer las preferencias de envío de cualquier usuario si lo necesitas. Simplemente, realiza la siguiente llamada:

curl -X GET 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": {
  }
}

Podrás consultar la configuración del envío gratis (más adelante presentaremos mayor información), modos, etc.

Métodos de envío

Cada site cuenta con un conjunto de métodos de envío disponibles. Presentan diferentes tiempos y costos de envío. Los vendedores pueden ofrecer envío gratis en uno o ambos métodos. Existe un recurso especial para ver los métodos disponibles por site. URL para Brasil.

https://api.mercadolibre.com/sites/MLB/shipping_methods

Respuesta:

{
    "id": 500645,
    "name": "Expresso",
    "status": "active",
    "site_id": "MLB",
    "free_options": [
        "country"
    ]
},
{
    "id": 501548,
    "name": "CBT MLB",
    "status": "active",
    "site_id": "MLB",
    "free_options": [
        "country"
    ]
},
{
    "id": 100009,
    "name": "Normal",
    "status": "active",
    "site_id": "MLB",
    "free_options": [
        "country"
    ]
},
{
    "id": 182,
    "name": "Expresso",
    "status": "active",
    "site_id": "MLB",
    "free_options": [
        "country"
    ]
}

Respuesta:

• id – el ID del método de envío se utiliza al publicar un artículo con envío.
• name – nombre del método de envío.
• site_id – el ID del sitio al que pertenece el método de envío.
• free_options– opciones gratis.

Estado del envío

El estado del envío puede variar en el pedido dependiendo del modo de envío seleccionado para el producto. Para modos que soportan seguimiento automático y monitoreo de los números de seguimiento, como con Mercado Envios modo 2 y modo 1 en ciertas configuraciones, nosotros actualizaremos el estado del envío, mientras que para el modo de envío personalizado y otras configuraciones de Mercado Envios modo 1, tú serás responsable de enviar un número de seguimiento y actualizar el estado del envío. Si bien no es obligatorio, te sugerimos que lo hagas para mejorar tus posibilidades de recibir mejor feedback de los compradores.

Estado:

to_be_agreed: el envío se acordará entre el vendedor y el comprador.
pending: los envíos se crean con este estado
handling: el pago para este envío fue recibido.
ready_to_ship: se recibió el código de autorización del transportista.
shipped: el transportista informó el despacho del envío.
delivered: el transportista informó la llegada del envío.
not_delivered: el transportista no pudo entregar el paquete.
cancelled: el envío fue cancelado.

Introducción a Mercado Envíos

Mercado Envíos es nuestra unidad de negocios que ayuda a los vendedores con numerosas facilidades para enviar sus productos; actualmente se encuentra activo en MLA, MLB, MLM, MLC y MCO. Como especificamos más arriba, existen dos opciones de Mercado Envíos que puedes elegir: modo 1 y modo 2.

Diferencias entre ME1 y ME2

No especificado

Al hacer un POST enviando Mercado Envío cuando la categoría no lo acepta y el usuario no lo tiene activo pero así mismo se agrega esta esta opción por defecto se publica el ítem como shipping modes “not_specified”. Por otro lado, si no mandas información sobre el envío para el artículo se marcará como "not_specified" por defecto. Además, si no existen modos que soporten las dimensiones de tu artículo, debes publicar bajo este modo. Puedes realizar una llamada a nuestra API con tu user_id en la categoría donde deseas publicar y las dimensiones de tu artículo para conocer los modos de envío disponibles; si no se soportan las dimensiones, solo tendrás el modo "not_specified" en la respuesta.

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/:user_id/shipping_modes?category_id=MLB74723&dimensions=10x50x100,30001

Respuesta:

[
   {
      "mode":"not_specified",
      "shipping_attributes":{
         "dimensions":"optional",
         "costs":"not_allowed",
         "accepted_methods":[

         ]
      }
   }
]

Configurar Mercado Colecta para usuarios de prueba

Para comenzar a usar Mercado Colecta con un usuario de prueba, envía los datos de tu usuario de prueba en este formulario.