Mercado Envíos 2
Contenidos
→Opta por ME2 →Ofrece ME2 en tus productos →Envío gratis →Costos de envío y handling time calculator →Consultar fecha de envío del producto →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 'Authorization: Bearer $ACCESS_TOKEN' -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
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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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.
Consultar fecha de envío del producto
Para evitar sobrepasar la capacidad de los transportistas (carriers) y que los compradores reciban los productos a tiempo, es necesario que consultes la fecha de envío de los productos. Identifica los envíos de este tipo realizando un GET a /shipments, incorporando el header 'X-Format-New: true' verificando el nodo “buffering”.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Format-New: true' https://api.mercadolibre.com/shipments/$SHIPMENT_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Format-New: true' https://api.mercadolibre.com/shipments/40173236996
Respuesta:
{
"id":40173236996,
"external_reference":null,
"status":"pending",
"substatus":"buffered",
"date_created":"2020-10-20T10:08:30.000-04:00",
"last_updated":"2020-10-20T15:09:22.000-04:00",
"declared_value":7000,
"dimensions":{
"height":14,
"width":19,
"length":38,
"weight":950
},
"logistic":{
"direction":"forward",
"mode":"me2",
"type":"xd_drop_off"
},
[]
"lead_time":{
"option_id":3628548109,
"shipping_method":{
"id":510545,
"name":"Express a domicilio",
"type":"two_days",
"deliver_to":"address"
},
"currency_id":"ARS",
"cost":0,
"list_cost":504.99,
"cost_type":"free",
"service_id":831,
"delivery_type":"estimated",
"estimated_schedule_limit":{
"date":null
},
"buffering":{
"date":"2020-10-21T20:18:26.000Z" ---> Fecha que podrá realizar el envío
},
"estimated_delivery_time":{
"type":"known",
"date":"2020-10-22T00:00:00.000-03:00",
"unit":"hour",
"offset":{
"date":null,
"shipping":null
},
"time_frame":{
"from":null,
"to":null
},
"pay_before":"2020-10-21T00:00:00.000-03:00",
"shipping":24,
"handling":24,
"schedule":null
},
"estimated_delivery_limit":{
"date":null,
"offset":null
},
"estimated_delivery_final":{
"date":null,
"offset":null
},
"estimated_delivery_extended":{
"date":null,
"offset":null
},
"estimated_handling_limit":{
"date":"2020-10-21T00:00:00.000-03:00"
}
},
"tags":[
"test_shipment"
]
}
En el campo buffering “date” del nodo “buffering” estará la fecha correspondiente que se tiene que despachar el paquete y ese mismo día disponibilizaremos la etiqueta para la impresión.
Imprime etiquetas de envío
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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID1,$SHIPPING_ID2&response_type=pdf
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,20182100995&response_type=pdf
Si deseas las etiquetas en formato ZPL, cambia response_type=pdf por response_type=zpl2:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID&response_type=zpl2
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648&response_type=zpl2
Este recurso devuelve un archivo ZIP que incluye un PDF con el PLP y un archivo TXT para impresora Zebra.
Consideraciones sobre los tipos de etiquetas por site
Tipo de impresión | Impresora | Sites disponibles | Tipo de respuesta | Salida |
---|---|---|---|---|
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. |