Mercado Envíos modo 2

Ya conoces algunas de las particularidades de optar por Mercado Envíos 2. Este tutorial te ayudará a publicar un producto con este modo y manejar todo el proceso de envío utilizando los recursos de nuestra API. Ten en cuenta que las dimensiones de los paquetes son estipuladas por ME2 y no pueden ser manipuladas por el usuario.

Contenidos

→Opta por ME2
→Ofrece ME2 en tus productos
→Envío gratis
→Costos de envío y handling time calculator
→Imprime etiquetas de envío
→Consideraciones sobre los tipos de etiquetas por site
→Estado del envío


Opta por ME2

Si deseas utilizar Mercado Envios modo 2, puedes activarlo. Por favor, consulta estos links:
Argentina: http://envios.mercadolibre.com.ar/

Brasil: http://envios.mercadolivre.com.br/

Colombia: http://envios.mercadolibre.com.co/

México: http://envios.mercadolibre.com.mx/

Chile: http://envios.mercadolibre.cl/

Uruguay:  https://envios.mercadolibre.com.uy/


Ofrece ME2 en tus productos

Una vez que optas por trabajar con ME, puedes agregar la opción a tus artículos. Cuando un comprador adquiera tu producto, necesitará ingresar una dirección al terminar y salir [checkout] y pagar el producto con los costos de envío incluidos. Realizaremos el seguimiento del paquete y nos aseguraremos de que llegue al destino correcto. El dinero del pago estará disponible en tu cuenta dos días después de la entrega exitosa. Podrás agregar envío gratis a tus artículos y esto impulsará tus publicaciones en la búsqueda. Publicar un producto con ME2 es muy fácil: solo publica un artículo de la forma habitual, incluyendo me2 en el conjunto de envío.

Example:

curl -X POST -H "Content-Type: application/json" -d '{
    "title": "Item de teste",
    "category_id": "MLA91727",
    "price": 1200,
    "currency_id": "ARS",
    "available_quantity": 2,
    "buying_mode": "buy_it_now",
    "listing_type_id": "bronze",
    "condition": "new",
    "description": "test",
    "pictures": [
        {
            "source": "http://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
        },
        {
            "source": "http://en.wikipedia.org/wiki/File:Teashades.gif"
        }
    ],
   "shipping": {
   "mode": "me2",
   "local_pick_up": false,
   "free_shipping": false,
   "free_methods": []
 }
}' https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Ten en cuenta que para publicar en categorías que estén marcadas como Frágil, el usuario también deberá estar marcado como "frágil", para esto deberá tener un acuerdo comercial. En las siguientes llamadas de la API deberás validar los campos que se muestran a continuación:

"trusted_user": true (API users)

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

"restricted": true (API category)

https://api.mercadolibre.com/categories/MCO7159/shipping_preferences
{
  "category_id": "MCO7159",
  "dimensions": {
    "weight": 50000,
    "height": 20,
    "width": 60,
    "length": 130
  },
  "logistics": [
    {
      "types": [
        "default"
      ],
      "mode": "me1"
    },
    {
      "types": [
        "drop_off",
        "xd_drop_off",
        "cross_docking",
        "fulfillment"
      ],
      "mode": "me2"
    },
    {
      "types": [
        "not_specified"
      ],
      "mode": "not_specified"
    },
    {
      "types": [
        "custom"
      ],
      "mode": "custom"
    }
  ],
  "restricted": true
}

Envío gratis

Los vendedores pueden publicar sus productos ofreciendo uno de los métodos de envío gratuito y Mercadolibre le cobra al vendedor el costo de envío. Conoce los detalles y cómo publicar con envío gratis.


Costos de envío y handling time calculator

En nuestro Marketplace, los vendedores tendrán un calculador de envíos en la página descripción de artículos; por eso, los compradores conocerán el costo de envío y el tiempo de manipulación estimado. Utiliza nuestros recursos para calcularlo en base a la información que tienes..


Imprime etiquetas de envío

Importante:
Te recomendamos consultar hasta 50 (cincuenta) shipment_ids. A partir del 4 de agosto de 2020, si superas la cantidad máxima permitida, recibirás un error 400.

En el proceso de venta, cuando el comprador finaliza su compra (checkout), el vendedor debe imprimir la etiqueta prepaga para realizar el envío. Esta etiqueta puede ser un archivo PDF o ZPL y puedes obtenerla consultando al recurso shipment_labels.
Realiza la siguiente llamada GET con la lista de IDs de envíos (shipping_id) y un access token. Cuando el estado de los envíos sea ready_to_ship sabrás que el pago fue procesado y la etiqueta prepaga está disponible.

Para obtener etiquetas en formato PDF, realiza la siguiente llamada:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID1,$SHIPPING_ID2&response_type=pdf&access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,20182100995&response_type=pdf&access_token=$ACCESS_TOKEN

Si deseas las etiquetas en formato ZPL, cambia response_type=pdf por response_type=zpl2:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID&response_type=zpl2&access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648&response_type=zpl2&access_token=$ACCESS_TOKEN

Este recurso devuelve un archivo ZIP que incluye un PDF con el PLP y un archivo TXT para impresora Zebra.

Nota:
Para reimprimir la etiqueta, realiza el mismo GET.

Consideraciones sobre los tipos de etiquetas por site

Tipo de impresión Impresora Sites disponibles Tipo de respuesta Salida
PDF Impresora común. Argentina (MLA), México (MLM), Brasil (MLB), Colombia (MCO), Chile (MLC) y Uruguay (MLU). response_type=pdf Etiqueta PDF
ZPL2 Impresora térmica. Argentina (MLA), México (MLM), Brasil (MLB), Chile (MLC), Uruguay (MLU), Colombia (MCO). response_type=pdf Archivo zip con la etiqueta en formato txt y resumen de impresión en formato PDF.

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, nosotros actualizaremos el estado del envío, mientras que para otros modos de envío, 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:

pending (pendiente): El envío se crea con este estado.

handling (en manejo): El pago para este envío fue recibido.

ready_to_ship (listo para envío): Se recibió el código de autorización del transportista.

shipped (enviado): El transportista informó el despacho del envío.

delivered (entregado): El transportista informó la llegada del envío.

not_delivered (no entregado): El transportista no pudo entregar el paquete.

cancelled (cancelado): El envío fue cancelado.