Mercado Envíos modo 1

En esta guía te explicamos cómo trabajar con todos los recursos que ofrece nuestra API para publicar y administrar las publicaciones con éxito utilizando el modo de envío me1. También aprenderás a publicar números de seguimiento para ofrecer información de seguimiento a los compradores.


Contenidos

Opta por utilizar ME1

Para comenzar a utilizar Mercado Envíos modo 1, debes ponerte en contacto con tu asesor comercial de Mercado Libre, porque este modo solo se encuentra disponible para usuarios VIP y es activado por nuestro equipo de desarrolladores de Envío para cada caso individual. Ofrece ME1 en tus productos Publicar un artículo con me1 es bastante fácil. Publica las opciones de envío gratis y las dimensiones del paquete cuando se encuentren disponibles. Si los vendedores no incluyen las dimensiones del paquete en su publicación, se utilizarán las dimensiones estándares de la categoría.
URL a POST

 https://api.mercadolibre.com/items?access_token=

JSON para el cuerpo

 {
   "title":"Item de teste",
   "category_id":"MLA48786",
   "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":{
  	"local_pick_up":false,
  	"mode": "me1",
      "dimensions":"10x10x20,700"
   }
}

Agrega dimensiones

Después de ser identificado con el modo me1, puedes agregar dimensiones a tus publicaciones existentes. Modificar las dimensiones de un artículo no afecta su relevancia en los resultados de búsqueda y no existe restricción alguna para modificar las dimensiones si el artículo tiene ventas. Si bien cada categoría cuenta con sus propias dimensiones estándares, puedes agregar los valores que desees, siempre que se encuentren dentro del rango de valores permitidos. Consulta esta tabla para conocer los valores permitidos para cada site. Conoce las dimensiones estándares para una categoría determinada Ejemplo:

 curl -X GET https://api.mercadolibre.com/categories/MLA9558/shipping_preferences

Agrega dimensiones

 curl -X PUT -H "Content-Type: application/json" -d ‘{
   "shipping":{
  	"dimensions":"10x10x20,700",
  	"mode": "me1"
   }
}’ https://api.mercadolibre.com/items/:item_id?access_token=


Envío gratis

Los vendedores tienen la opción de publicar artículos ofreciendo uno de los métodos de envío gratuito. Por favor, consulta esta entrada para conocer los detalles y cómo publicar con envío gratis.


Calculadora del Costo de Envío

Nuestra API tiene un recurso para calcular los costos de envío para una dimensión, categoría y código postal de destino determinados. El calculador de envíos puede elegir entre 2 recursos para adaptarse mejor a tus parámetros disponibles; ambos devuelven el mismo resultado. URL:

https://api.mercadolibre.com/users/:user_id/shipping_options?category_id=:category_id&dimensions=:dim&zip_code=13565905
https://api.mercadolibre.com/items/:item_id/shipping_options?zip_code=13565905

Respuesta:

{
  "destination": - {
	"zip_code": "01001000",
	"city": - {
  	"id": "BR-SP-44",
  	"name": "São Paulo",
    },
	"state": - {
  	"id": "BR-SP",
  	"name": "São Paulo",
	},
	"country": - {
  	"id": "BR",
  	"name": "Brasil",
	},
	"extended_attributes": - {
  	"address": "Praça da Sé",
  	"owner_name": null,
  	"zip_code_type": - {
    	"type": "LO",
    	"description": "Logradouro",
  	},
  	"city_type": "CP",
  	"city_name": "São Paulo",
  	"version": 6,
	},
  },
  "options": - [
	- {
  	"id": 18310062,
  	"name": "Normal",
  	"currency_id": "BRL",
  	"list_cost": 13.86,
  	"cost": 13.86,
      "tracks_shipments_status": "not_verified",
  	"display": "recommended",
  	"speed": - {
    	"shipping": 72,
    	"handling": 24,
  	},
	},
	- {
  	"id": 18310061,
  	"name": "Expresso",
  	"currency_id": "BRL",
  	"list_cost": 14.88,
  	"cost": 14.88,
      "tracks_shipments_status": "not_verified",
  	"display": "always",
  	"speed": - {
    	"shipping": 24,
    	"handling": 24,
  	},
	},
  ],
}


Descripción de atributos

  • currency_id Moneda en la cual se cobra el precio.

  • costo de publicación Costo para esta opción de envío.

  • costo Costo real a pagar; el costo para "envío gratis" es 0.

  • tracks_shipments_status Indica cómo se podrá realizar el seguimiento de este método.

  • tracks_shipments_status.verified Se puede realizar el seguimiento a nivel interno.

  • tracks_shipments_status.not_verified La información de seguimiento debe ser entregada por el vendedor.

  • tracks_shipments_status.no No se puede realizar seguimiento.

  • speed.shipping Promesa de tiempo de entrega, expresada en horas.

  • speed.handling Promesa de tiempo de manejo, expresada en horas.


Estado del envío

Algunas configuraciones de ME1 soportan seguimiento automático, por eso nosotros actualizaremos el estado del envío. Si éste no es tu caso, entonces serás responsable de enviar un número de seguimiento y de 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. shipped (enviado) El transportista informó el despacho del envío.


Actualizar el estado del envío

Para actualizar el estado del envío en el pedido, debes realizar una solicitud PUT al envío. Para conocer el shipment_id, puedes realizar una llamada a pedidos de esta manera: Ejemplo:

curl -X GET https://api.mercadolibre.com/orders/{Order_id}/shipments

El estado inicial del envío es “pending” (pendiente). Una vez identificado el shipping_id, puedes actualizarlo a otro estado.


Actualiza el estado a handling (en manejo)

Ejemplo:

curl -X PUT -H "Content-Type: application/json" -d  ‘{
  "tracking_number": "TR1234567891",
  "service_id": 11,
  "status": "shipped"
}’

Agregar el número de seguimiento y marcar como despachado

Es fundamental que los vendedores provean el número de seguimiento para que los compradores puedan saber el estado de los paquetes y el tiempo de entrega estimado. En esta etapa, es incluído el número de rastreo y se actualiza el estado del pedido para despachado. Por tal motivo, deberás realizar el siguiente PUT con los atributos, service_id, tracking_number y el estado. Ejemplo:

curl -X PUT -H "Content-Type: application/json" -d  ‘{
  "tracking_number": "TR1234567891",
  "service_id": 11,
  "status": "shipped"
}’

Actualizar el estado de entrega

En este modo de envío no es posible actualizar el pedido para "entregado" (delivered). Pero, es posible ejecutar la validación de la compra para actualizar en el front en el parte de "concretadas" e instantáneamente el comprador recibirá la solicitación de confirmación. Importante: El procedimiento a seguir sólo debe ser realizando cuando exista información que el producto fue entregado. Si el comprador marca como negativo, será perjudicial para la reputación del vendedor. Para realizar este procedimiento deberás hacer el siguiente PUT:

"curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d JSON { "fulfilled": true, "rating": positive } https://api.mercadolibre.com/orders/{orderId}/feedback?access_token=$ACCESS_TOKEN"

Cambiar de ME1 a ME2

Si tienes habilitado trabajar con ambos modos de envío, para poder migrar de una opción a otra deberás hacer el siguiente PUT.

curl -X PUT -H "Content-Type: application/json" -d ‘{
   "shipping":{
      "mode" : "me2", "free_methods": {"id": 500345, "rule":{"free_mode":"country","value": null
   }
}’ https://api.mercadolibre.com/items/:item_id?access_token=

Nota: Podrás hacerlo aún cuando las publicaciones estén activas.

Forma parte de nuestra comunidad