Mercado Envíos modo 1

Esta guía explica 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 explica cómo publicar números de seguimiento para ofrecer información de seguimiento a los compradores.

Contenidos:

Opta por utilizar ME1

Para comenzar a utilizar MercadoEnvios modo 1, debes ponerte en contacto con tu asesor comercial de MercadoLibre, 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/MLM165702/shipping

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.

Agrega un número de seguimiento

Es esencial que los vendedores entreguen el número de seguimiento de sus envíos para que los compradores puedan conocer el estado de sus paquetes y el tiempo de entrega estimado.
Todo lo que debes hacer es realizar una solicitud PUT al envío con los atributos service_id y tracking_number.

curl -X PUT -H "Content-Type: application/json" -d  ‘{
  "tracking_number": "TR1234567891",
  "service_id": 1
}’  https://api.mercadolibre.com/shipments/:shipment_id?access_token=&ACCESS_TOKEN

Actualiza 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 '{"status": "handling"}' https://api.mercadolibre.com/shipments/{Shipment_id}

Actualiza el estado a shipped (enviado)

Ejemplo:

curl -X PUT -H "Content-Type: application/json" -d '{shipping_option: {id:27569508},receiver_address: {"contact":"Roberto Gomez Bolaño","phone":"12345", address_line:"Avenida siempre viva updated", comment:"Casa azul.",zip_code:"90040060", "city": {"id": "TUxCQ1BPUjgwZTJl","name": "Porto Alegre"}, "state": {"id": "BR-RS","name": "Rio Grande do Sul"}, country: {id:"BR", name:"Argentina"}}}' https://api.mercadolibre.com/shipments/{Shipment_id}

Please rate this